Skip to content

Coordinates, mapping and collision ​

The framework deliberately leaves server-specific positions unset. Search the source for the exact marker:

sh
rg -n "TODO: set coordinates for your map" gamemodes

Place your important services ​

Work through the search results and record the coordinates, facing angle, interior and virtual world each feature needs. Typical locations include spawns, DMV, admin jail, arrest/release points, hospitals, job depots and shops. A value of 0, 0, 0 is a placeholder, not a recommended destination.

Set a safe public spawn first. Place staff jail and emergency-service locations before testing punishments or medical transport. Keep an ordinary character available for checking these flows without administrator shortcuts.

Add a map ​

Use gamemodes/visuals/maps/template.pwn as the module pattern and include your new map in visuals/maps/header.pwn. Keep model registration, world object creation and stock building removal in the appropriate startup hooks. Avoid putting an entire unrelated mapping filterscript back into the release.

Use stock model IDs by default. If your map needs custom objects, provide your own assets, register them in the model-loading path and configure artwork downloads. Do not assign a removed custom ID to a stock object merely because a previous server used it.

Intentional stock-world exceptions ​

Fuel pumps, vending machines and basketball courts have stock removals/replacements associated with their gameplay systems. These are intentionally retained. Broad stock graffiti removal is disabled unless FEATURE_REMOVE_STOCK_GRAFFITI is enabled.

Look at gamemodes/visuals/remove.pwn and each relevant gameplay module before deleting a removal. Restoring a stock object can create overlap with a replacement interaction/model.

ColAndreas collision data ​

Generate ColAndreas.cadb with the ColAndreas Wizard, using a GTA: San Andreas installation you own. Place it exactly at:

text
scriptfiles/colandreas/ColAndreas.cadb

Linux paths are case-sensitive. The directory is lowercase colandreas. This external binary database is excluded from the source repository; it is not an SQL import or a Pawn include.

The ColAndreas plugin reads the stock collision data. Startup now checks CA_Init() and exits with a clear diagnostic if initialization fails. A non-empty file is not proof that it is valid; verify a successful initialization in log.txt.

Interiors and virtual worlds ​

The same XYZ position in another interior/world is a different gameplay location. Lockers and businesses may check those fields as well as distance. When testing a missing pickup or unusable service, check all five values rather than adjusting only Z.

Create and test exits as well as entrances. Ensure emergency release points and administrative teleports do not return players below the world or into restricted interiors.

Open-source roleplay foundations for open.mp. Bring your own world.