Gameplay Areas and Points of Interest

BeamNG levels use helper objects for gameplay interaction areas and points of interest:

These objects are commonly used by fuel stations, dealerships, deliveries, garages, parking, and other interaction locations.

BeamNGGameplayArea example

{
  "class": "BeamNGGameplayArea",
  "name": "garage_area_01",
  "__parent": "garage_interaction",
  "position": [100, 200, 5],
  "rotationMatrix": [1, 0, 0, 0, 1, 0, 0, 0, 1],
  "scale": [2, 4, 2],
  "area2D": false
}

BeamNGPointOfInterest example

{
  "class": "BeamNGPointOfInterest",
  "name": "garage_icon_01",
  "__parent": "garage_interaction",
  "position": [100, 200, 7],
  "title": "Garage",
  "desc": "Vehicle service location",
  "type": "garage"
}

Important fields

Dynamic fields

Many shipped gameplay areas and points of interest are driven by Lua systems and related files.

Additional fields may be saved on these objects depending on the feature that owns them.

Tool notes

For tools that generate gameplay areas:

• Keep related area and POI objects in the same group.
• Preserve persistentId values unless creating new objects.
• Preserve unknown dynamic fields.
• Align the POI position with the visible icon/interaction point.
• Make the gameplay area large enough for the intended vehicle interaction.
• Validate related sites, facilities, or mission data when moving these objects.

Common issues

• Interaction does not appear because the POI type or related gameplay metadata is missing.
• Vehicle cannot interact because the area is too small or misplaced.
• Icons appear in the wrong place because the POI position is separate from the area center.
• Generated objects lose dynamic fields used by gameplay scripts.

Validation criteria

• Area volume covers the intended interaction space.
• POI position is readable on the map/UI.
• Related gameplay data references the correct area/POI names where applicable.
• Unknown dynamic fields are preserved by tools.

See also: Fuel Stations , Facilities , Gameplay Data , Sites , Level object files (items.level.json) .