Load Map Command

Handles deep-link/startup commands to load a specific map with optional camera position. Parses level paths and camera transforms from structured command data.

Public Functions

Command Data Format

-- URL format: beamng:v1/openMap/{...}
local data = {
  level = "levels/gridmap/info.json",    -- Level path (required)
  camPos = {58.78, -181.10, 604.18},     -- Camera position (optional)
  camRot = {0.50, -0.49, 0.49, 0.50},   -- Camera quaternion (optional)
  track = "trackName"                     -- Track to load (optional)
}
core_loadMapCmd.set(data)

Flow

1. set() parses the level path and stores arguments
2. If mod manager is ready, immediately calls changeMap()
3. Otherwise, onModManagerReady triggers changeMap() later
4. After world loads (state 2), camera is positioned and optional track loaded
5. A toast notification confirms the jump

Notes

• The ignoreStartupCmd flag prevents GE reloads from re-executing the command.
• If the map is already loaded in freeroam, skips to camera positioning directly.
• Uses freeroam_freeroam.startFreeroam() to load the level.
• Supports the util/trackBuilder/splineTrack extension for loading tracks.

See Also

• levels - Level discovery and loading API
• globals - FS, getMissionFilename