The Raycin World — Zone-Based Ambient Traffic¶
Raycin's roads aren't empty. Each area of Los Santos has its own ambient vehicle pool: luxury supercars cruise Vinewood Hills, heavy trucks roll through the Docks, dirt bikes tear down Mount Chiliad. This page covers how it works and how to interact with it.
The 25 zones¶
There are 25 active zones split into two types:
| Type | Count | Where defined | Editable how |
|---|---|---|---|
| 🏗 Permanent | 6 | config.lua in the resource |
Edit file + restart |
| 📋 Community | 19 | data/runtime_zones.json |
Web editor at dashboard, in-game /zsadd, or Crew suggestion |
Both types behave the same in-world. The split just controls how they're edited.
Full zone list¶
| Zone | Theme | Type |
|---|---|---|
| 🏔 Vinewood Hills | Luxury supercars | Permanent |
| ⚓ Docks | Industrial trucks | Permanent |
| 🏜 Sandy Shores | Rural / dirt bikes | Permanent |
| 🌴 Vespucci Beach | Beach cruisers | Permanent |
| 🌆 Downtown LS | Urban sedans | Permanent |
| 🏘 Paleto Bay | Small-town rural | Permanent |
| 🛫 LSIA Airport | Taxis + airport service | Community |
| 🏘 Grove Street | Lowriders, gang vehicles | Community |
| ⛰ Mount Chiliad | Mountain off-road | Community |
| 🎡 Del Perro Pier | Convertibles, beach cars | Community |
| 🎩 Mirror Park | Hipster oddballs | Community |
| 🚜 Grapeseed | Farming country | Community |
| 🏍 Stab City | Biker gang (Lost MC) | Community |
| 🏢 Pillbox Hill | Executive class | Community |
| ⛵ Marina Yacht Club | Exotic supercars | Community |
| 🛣 Route 68 Desert | Muscle / Americana | Community |
| 🚓 Mission Row PD | Police district | Community |
| 🏘 Strawberry | Mid-LS commuter | Community |
| 🔧 Rancho Industrial | Workshops + lowriders | Community |
| 🎪 Maze Bank Arena | Event vehicles | Community |
| 🏎 La Mesa | Tuner cars | Community |
| 🌆 Burton | Mid-Vinewood designer | Community |
| 💨 Cypress Flats | Drift / street race | Community |
| 🔭 Galileo Observatory | Exotic supercars (date-spot) | Community |
| ⛰ Tataviam Mountains | Hunting / off-road | Community |
See the live interactive map at raycin.com/zones/ for the visual overview.
How spawning works¶
- As you drive, your client checks every 2.5 seconds whether you're inside any zone (point-in-circle, or point-in-polygon for irregular zones)
- If you're in a zone and there's room (under the zone's
maxActivecap), it picks a vehicle from that zone's pool weighted by theweightsarray, then spawns it at a road node 50–180m away from you - As you leave the zone, your spawned vehicles get culled gradually
- Vanilla GTA traffic is partially suppressed in the zone so the themed vehicles dominate without feeling empty
Driver behaviour¶
Spawned drivers behave like vanilla GTA NPCs: - Brake for the player when they walk into the road - Stop at traffic lights in city zones - Obey traffic ahead of them - Get carjacked normally — they'll flee to the side and you can take the vehicle - Per-zone driving feel — Stab City bikers drive slightly more aggressively, Docks trucks crawl slowly, Vinewood supercars cruise a touch faster
Each zone defines its own cruiseSpeed (m/s) and drivingStyle
(bitfield from the TaskVehicleDriveWander native).
Achievements¶
You build up zone visits as you drive around:
| Badge | Goal | Effect |
|---|---|---|
| 🌍 Globetrotter | Visit 10 distinct zones | Chat announcement when earned |
| 🏆 World Explorer | Visit every active zone | Chat announcement when earned |
Your visit log is tracked at raycin.com/garage/ → your gallery → "Zone book" expandable section.
Chat commands¶
| Command | What |
|---|---|
/zonebook |
Print your top 10 zone visits + total count |
/zonebadges |
Print which achievements you've earned |
/garage |
Print top 10 most-spotted Raycin vehicles + total sightings |
Admin commands (ACE raycin_races.admin required)¶
| Command | What |
|---|---|
/zsdebug |
Toggle verbose F8 logs (spawn / despawn timings, zone-change events, etc.) |
/zslist |
Print all active zones (config + runtime) |
/zscheck |
Print nearest vehicle's lock state + owner |
/zscull |
Wipe all raycin-spawned vehicles |
/zsrace on\|off |
Manually toggle race-mode (cull + suspend spawning) |
/zsadd <name> <radius> <pool-csv> |
Add a CIRCLE zone at your position |
/zsremove <name> |
Delete a runtime zone |
/zswipe |
Wipe all runtime zones (must type twice within 5s) |
/zspoly start <name> |
Begin polygon-zone edit |
/zspoly add |
Drop a vertex at your current position |
/zspoly undo |
Remove last vertex |
/zspoly save <pool-csv> |
Save the polygon zone |
/zspoly cancel |
Abort edit |
/zspoly preview |
Toggle persistent zone overlay in-world |
Race integration¶
When raycin_races starts a race, the zone-spawning system
auto-suspends. All spawned vehicles get culled and no new ones spawn
until the race ends. This prevents zone NPCs from interfering with
race traffic.
The hook fires from raycin_races via export:
exports.raycin_zonespawns:setRaceMode(true) -- starts
exports.raycin_zonespawns:setRaceMode(false) -- ends
Event-driven zone boosts¶
When admin creates an event on raycin.com with the Zone link
field set (e.g. "Vinewood Cruise Night" → linked to Vinewood Hills),
during the event window the linked zone gets:
- Spawn cap doubled (e.g. 8 → 16 max active)
- Spawn interval halved (more frequent spawns)
This is a public marketing hook — the linked zone shows a "🔥 BOOSTED
NOW" badge on /zones/. Encourages players to log in during events.
How to add a new zone¶
See the admin reference for the full editor workflow. Quick summary:
- In-world: drive to where you want the centre, type
/zsadd MyZoneName 350 fugitive,sentinel,asea - Web editor: open
localhost/dashboard/zonespawns.php(dev), click the interactive map to drop a centre, fill in the form, save - Crew suggestion: Crew members can pitch zones via raycin.com/crew/ → "Suggest a Zone" tab. Admin approves → it goes live.
Web-side links¶
| Page | What |
|---|---|
| raycin.com/zones/ | Public interactive map + zone cards |
| raycin.com/garage/ | Vehicle spotting gallery (see next page) |
| raycin.com/crew/ | Crew benefits + Suggest a Zone form |