San Andreas Locations

WIP JSON dataset of useful GTA: San Andreas locations for SA-MP, open.mp, and other community projects.

Warning

The dataset is not release-ready. Every current record is pending in-game review. Coordinates may place a player inside collision or otherwise be unsuitable as a spawn.

Current status

• 151 candidate locations
• 29 location records
• 0 approved records
• v1 target: 100 approved records

Run python3 tools/status.py for current counts.

Data

Locations are JSON arrays stored under:

data/<region>/<category>.json

Each record contains:

• id
• names
• category
• region
• spawn
• flags
• review

The schema is schema/location.schema.json. See docs/DATA_FORMAT.md for field conventions.

Spawn safety

A map coordinate is not automatically a safe spawn. It can land inside a building, object, doorway, road, water, or other collision. Before approval, the exact saved coordinate must be tested in an unmodified game world.

Approved pedestrian spawns must:

• land on stable walkable ground;
• be visibly offset from buildings and other collision;
• allow immediate movement in every direction;
• avoid traffic, water, steep slopes, and unsafe edges;
• face a useful direction;
• work without custom map objects.

The validator checks JSON structure and metadata. It cannot inspect game collision.

Repository layout

data/       Location records
planning/   Candidate list and geographic coverage targets
schema/     JSON schemas
tools/      Validation and status scripts
tests/      Python tests
docs/       Data-format notes

Checks

Python 3.11 or newer is required.

python3 tools/validate.py
python3 -m unittest discover -s tests -v
python3 tools/status.py

python3 tools/validate.py --release is expected to fail until at least 100 records are approved and the required geographic coverage is present.

Limitations

• All current records are pending review.
• Coverage is incomplete and uneven across regions.
• Casino candidates do not yet have location records.
• Whetstone does not yet have a location record.
• Only pedestrian arrivals are in scope. A record is not vehicle-safe unless flags.vehicleSafe is true.

Contributing

Read CONTRIBUTING.md before changing coordinates. Do not approve a record without testing its exact JSON values in-game.

License

Non-commercial use, modification, and redistribution are permitted under the PolyForm Noncommercial License 1.0.0. Commercial use requires prior written authorization from the copyright holder; see COMMERCIAL_LICENSE.md.

This is source-available software and data, not OSI-approved open source, because commercial use is restricted.