Sites Manager

Extension that manages loading, caching, and lifecycle of *.sites.json files across all levels. Provides utility functions for finding sites files and best parking spots.

Public API

Extension Hooks

Internals

• sitesCache: Map of filepath → Sites object (cached after first load)
• sitesByLevel: Map of levelName → array of sites file paths
• currentLevel: Current level identifier

How It Works

1. onModManagerReady scans all levels via core_levels.getList() for *.sites.json files
2. loadSites reads a file, deserializes into a Sites object, calls finalizeSites(), and caches it
3. Cache is cleared on mission end to free memory
4. Serialization/deserialization support enables hot-reload without re-scanning

-- Load sites for a specific file
local sites = gameplay_sites_sitesManager.loadSites("/levels/west_coast_usa/main.sites.json")

-- Find by name
local filepath = gameplay_sites_sitesManager.getCurrentLevelSitesFileByName("main")
local sites = gameplay_sites_sitesManager.loadSites(filepath)

-- Find best parking spot
local spots = sites.parkingSpots.sorted
local best = gameplay_sites_sitesManager.getBestParkingSpotForVehicleFromList(vehId, spots)
best:moveResetVehicleTo(vehId)

Dependencies

• gameplay/sites/sites - Sites container class
• core_levels - level listing and paths

Notes

• loadSites with force=true bypasses cache; ignoreCache=true loads without storing in cache
• getBestParkingSpotForVehicleFromList checks vehicleFits and hasAnyVehicles, falls back to last spot
• Sites file naming convention: <name>.sites.json

See Also

• Sites Custom Fields - Related reference
• Sites Location - Related reference
• Sites Parking Spot - Related reference
• Gameplay Systems Guide - Guide