Quick Reference

Commands, keybindings, tips for hosts, and compact lookup tables for everything in the system.

---

Commands

Command	Category	What it does
open_race	Player	Opens the Race Menu (create or join a race)
my_vehicles	Player	Opens Race Menu directly to MY VEHICLES
check_invitation	Player	Opens pending race invitations
quit_race	Player	Leaves the current race or spectator session
open_creator 🔒	Admin	Opens the raycin_creator track editor — admin/owner permission required
/tag <raceid> [list \| add \<t\> \| remove \<t\> \| set \<t1,t2\> \| clear]	Admin	Manage organisational tags on a track. /tag 759 lists current tags; add/remove modify one tag; set replaces all; clear removes all. Tags are purely for filtering — no effect on race defaults. See Track Tags.
raycin_check	Player	Diagnoses your client-side admin status — prints _isAdmin to chat. Useful when Dev Tools should be unlocked but isn't.
raycin_admin_check	Player	Definitive server-side check — prints your license + every ACE result + the verdict + which ACE matched. The first stop when admin gates don't behave as expected. See Raycin Menu (Admin).

Tip: All commands also appear in F10 → Quickish Race Sessions.

---

Key Bindings Reference

All bindings are configurable in FiveM Settings → Key Bindings → FiveM.

Binding name	Default	Action
open_race	(set by player)	Open the Race Menu
my_vehicles	(unbound)	Open the Race Menu directly to MY VEHICLES
check_invitation	(set by player)	Open pending race invitations
quit_race	(set by player)	Quit the current race
open_creator 🔒	(set by player)	Open raycin_creator track editor (admin/owner permission required)
raycinmenu	F10	Open the native Raycin Menu
raycinrace	F3	Open the in-race native menu

Nitro: Not a FiveM key binding. Uses native GTA vehicle controls — Left Shift on keyboard (configurable in Race Settings) and L3 (Left Stick click) on controller. Auto-detected — no setup needed.

---

Race Settings — Quick Settings Reference

Setting	Category	What it does	Key options
Vehicles Mode	Core	How vehicles are assigned	Default / Specific / Personal / Random
Vehicle Classes	Core	Restricts class pool	Any GTA vehicle class
Synchronised Roll	Rotation	All players get same vehicle	ON = synced; OFF = individual
Per-Checkpoint Re-roll	Rotation	Controls sync frequency	OFF = one vehicle per lap; ON = one vehicle per checkpoint
No Repeats	Rotation	No vehicle used twice	ON / OFF
Fair Start	Race Start	All spawn at P1	ON / OFF
Reversed Track	Modifier	Run track backwards	ON / OFF
Hot Lap Mode	Format	Solo timed run	ON / OFF
Staggered Start	Race Start	Players depart in sequence	ON + Delay (seconds)
🏁 F1 Lights-Out	Race Start	5 red lights + random 0.5–3.0s hold + lights-out = GO. Throttle during hold = 5s freeze + invisibility penalty.	ON / OFF (auto-suppressed when Staggered Start is ON)
Ghost On Contact	Safety	Auto-ghost after prolonged contact	ON + Delay (seconds)
Named Vehicle Ghost	Safety	Auto-ghost troll vehicles	ON + Delay (seconds)
Death Respawn Ghost	Safety	Brief ghost after respawn	ON + Duration (seconds)
Catch-Up	Boost	Power adjusted by position	ON + Boost/Penalty multipliers
Fastest Lap	HUD	Track and announce fastest lap	ON / OFF
Nitro (NOS)	Boost	Boost system	ON + Boost/Drain/Regen settings
Vehicle Transform	Rotation	Swap vehicle at trigger points	ON + up to 4 events
Fuel System	Endurance	Vehicles consume fuel	ON + Drain rate / Start level
Tire Wear	Endurance	Grip degrades each lap	ON + Wear per lap / Min grip
Slipstream	Boost	Drafting charges a boost	ON + Speed/Time/Duration
Overtake Bonus	Boost	Boost when gaining position	ON + Power/Duration
Explode on Impact	Special	Binary damage — perfect drive or instant detonation	ON + Threshold (5–50 m/s)
Weather Event	Modifier	Mid-race weather change	ON + Trigger + Weather type
Timed Race	Format	Clock-based instead of laps	ON + Time limit / Grace period
Mandatory Pitstop	Endurance	Required pit stops	ON + Mode (Lap/CP/Zone)
Destroy Last Place	Special	Last place explodes on countdown	ON + Grace/Warning/Min players
Elimination Mode	Special	Last place eliminated periodically	ON + Interval/Warning/Survivors
Drag Race	Mode	Christmas-tree start	ON (auto-sets laps to 1)
Drift Score Mode	Mode	Score for sustained slides	ON + Duration
Hot Lap Challenge	Format	Open time trial session	ON + Duration
Cannonball Mode	Mode	Players spawn on foot	ON
Ranked (ELO)	Competitive	Results affect skill rating	ON (min 3 players)
Team Race	Competitive	Score for crew totals	ON (requires Crews)
Tuning Window	Format	Pre-race tuning time	ON + Duration (15/30/60 s)

---

🔒 Permissions & Admin Access

Some features in raycin_races / raycin_creator are restricted by the server's permission system (FiveM ACE). If you try to use one and nothing happens (or you see "permission required"), you need to ask the server owner or an admin to grant you access.

What's restricted

Feature	Default ACE permission	Who needs it
🛠 Track Creator (open_creator)	raycin_creator.access	Anyone wanting to build / edit tracks
🛠 Category Manager in creator	Admin only (server-defined)	Renaming / merging / deleting track categories
🛠 Featured tracks management	Admin (config)	Pinning tracks to the top of the browser
📊 Server-wide stats overrides (manual ELO edits)	Admin (DB access)	Adjusting player ratings, fixing mistakes
🌐 /cr_weather admin command	Admin / mod	Forcing mid-race weather change
🛡 Race Director tools in-race	Admin / mod	Forcing respawn, yellow flag, freeze, etc.
🎛 Dev tools (Dev Tools menu in rralan_nativemenu)	Admin (config)	Fake-driver injection, frame diagnostics
🧪 /cr_diag debug command	Generally open to all (host-only insights)	Frame-time / diagnostics

How a server owner grants access

In server.cfg (or via txAdmin console), use FiveM's standard ACE system:

# Grant by license to a single player:
add_ace identifier.license:abc123def456...  raycin_creator.access allow

# Or grant to a whole admin group at once:
add_principal identifier.license:abc123def456...  group.admin
add_ace group.admin raycin_creator.access allow

Some servers use a SQL-based whitelist instead (the resource ships with setgroup_creator_permission <license> <group> as a server console command).

How to check if you have access

• Run open_creator in F8 — if a track-editor menu opens, you have it
• If nothing happens or a "permission denied" toast shows, you don't
• Ask the server owner: "Can I get raycin_creator.access?" — they'll know what to do

Why permissions exist

Track creation is a server-shared activity: tracks built by one player are visible to everyone in the lobby browser. Admins gate access so trolls / griefers can't spam the browser with junk tracks. The same applies to admin tools (race director, weather override, etc) — those affect every player in the race, so they're gated.

---

Race Creation — Quick Reference

Setting	Options
Laps	1 – 20
Weather	Clear, Overcast, Rain, Thunder, Foggy, Snow, Blizzard, Extra Sunny
Time	00:00 – 23:00 (hourly)
Traffic	OFF / ON
DNF	OFF / 1–10 min
Accessibility	Public / Private
Game Mode	Normal / GTA Mode / F2F
Vehicles	Default / Specific / Personal / Random
Race Message	Up to 120 characters (shown at GO! signal)

---

In-Race HUD Elements

Element	Description
Position	Current race position
Lap	Current lap / total laps
Checkpoint	Next checkpoint number
Current Lap	Running time of current lap
Time	Total elapsed race time
Speed	MPH or KPH
NOS bar	Remaining nitro charge (Race Settings Nitro only)
Vehicle	Current vehicle name
Pit Stops	Completed / required (Race Settings Pitstop only)
▲ AHEAD	Name, vehicle, gap to player ahead
▼ BEHIND	Name, vehicle, gap to player behind
🚩 BLUE FLAG	Lapping driver approaching (backmarker only)
Weather Grip	Grip % during degraded-traction weather
PB	Personal best with live +/− delta
⏱ Timed Race Timer	Top-right countdown chip — MM:SS remaining. Pulses red at 30 s. Timed Race only.
⏱ TIME EXPIRED	Replaces timer at 0:00, fades after ~8 s. Signals final lap.
››› Slipstream	Green pulsing chevrons — you are in draft range charging a boost.
BOOST!	Gold flash when slipstream boost fires automatically.
🔀 Transform banner	Centre-screen announce + optional 5-second countdown before each vehicle swap.
⚠ SWAP WARNING	Shown ~1 lap before next vehicle swap in Sync rotation. Names the incoming vehicle.

---

Weather Grip Effects

Weather	Traction	Braking
Clear / Extra Sunny	100%	100%
Overcast / Foggy / Smog	100%	100%
Rain	75%	85%
Thunder	65%	80%
Blizzard / Snow / Snow Light	60–70%	75–82%

Pitstop freeze duration × 1.5 during Rain / Thunder / Blizzard/Snow.

---

Tips for Hosts

• Use Vehicles Mode → Personal if you want players to race custom builds saved in MY VEHICLES.
• Use the Race Settings to restrict to a specific vehicle class or individual model.
• Random re-rolls a fresh random vehicle from the selected class for each race.
• Fair Start in Race Settings puts all players at grid position 1 — skill only, no grid-position luck.
• Weather and time of day can be changed mid-race without pausing via the native menu.
• AFK Kick is useful for longer races to auto-remove disconnected or idle players.
• Sin Bin is lighter than Disqualify — use it for minor incidents or to slow a dominant leader.
• Mandatory Pitstop adds a strategic element to longer races.
• The Race Director button only appears during an active race — not in the lobby.
• Use the Race Message (MOTD) field to communicate race rules (e.g. "No ramming — clean race only") — shown to all players at the GO! signal.
• Reversed Track is a quick way to get a second race out of a well-known track — no track editing needed.
• Hot Lap Mode is ideal for time-attack sessions or helping new players learn a track without pressure.
• Use Race Series for league nights — queue the tracks in advance and the server handles transitions automatically.
• Use the Circuit / P2P filter pills in the race browser to narrow the track list before picking — the 🎲 Random button also respects the active filter.
• Staggered Start is great for handicap formats — put the fastest driver at the back of the grid.
• Catch-Up is for casual/party sessions only — never enable it in ranked races.

---

Track Records Board

A Track Records panel is displayed in the race lobby showing the top-10 best times ever set on the selected track. Records update automatically as new personal bests are set.

• Open the race browser, select a track.
• Scroll past the track thumbnail — the 🏆 Track Records section lists the all-time top-10: position, player name, time, vehicle, and date.
• The section collapses / expands with a single click.

---

Stats Site — Pages & Features

The stats site is a web dashboard that shows race data pulled from the server. Ask your admin for the URL.

Page	What it shows
Home	Server status, online players, top 5 points leaders, 5 recent track records
Servers	Full online player list (auto-refreshes every 30 s) + connect button
Tracks	Browse all tracks with map view, best times, and ★ favourites
Cars	Vehicle usage bar chart from recent records; click a bar to filter
Lap Times	Last 50 track records, filterable by track / player / vehicle
Live Race	Real-time race view showing positions, laps, best laps (auto-refreshes 10 s)
Race History	Full log of every race result with date/player/position filters
Players	Searchable leaderboard of all players — click any name for their profile
Track Records	One row per track showing the all-time record holder + time
Head to Head	Side-by-side stat comparison for two players + per-track H2H
Guide	In-site help explaining every page

Live Race Banner

A pulsing green banner appears at the top of every stats page when a race is currently active. It shows the track name and a "Watch Live →" link to jump straight to the Live Race page.

Track Favourites

On the Tracks page, click ☆ next to any track to save it as a favourite. Saved tracks are stored in your browser (localStorage) and persist between visits. Use the ★ Favs button in the Tracks filter bar to show only your favourited tracks.

Player Profiles

Click any player name in the Players leaderboard, Track Records table, or Head to Head results to open that player's profile page. The profile shows:

• Race Points, ELO rating, Season Points, races hosted
• Win count, podium count, win rate
• Full recent race history (last 30 races) with finish position, times, and RP

---

Discord Logging Setup

raycin_races can post Discord embeds to a webhook whenever key race events occur — no bot required.

Setup

1. In Discord: Channel Settings → Integrations → Webhooks → New Webhook → copy the webhook URL.
2. Open config/config_server.lua → find Config.RaceLog.
3. Set Enabled = true and paste your URL into WebhookURL.
4. Restart the resource.

Events

Event	What gets posted
Race Room Opened	Track name, host, mode, laps
Race Started	Track name, lap count, all driver names
Player Finished	Position medal, total time, best lap, vehicle, RP earned
Fastest Lap	HUD
Race Ended	Track name, top-3 podium

Individual event types can be toggled on/off in the Events config block. Set any flag to false to stop posting that embed type.

---

GTA Vehicle Classes — ID Reference

ID	Class	ID	Class	ID	Class
0	Compact	8	Motorcycle	16	Plane
1	Sedan	9	Off-road	17	Service
2	SUV	10	Industrial	18	Emergency
3	Coupe	11	Utility	19	Military
4	Muscle	12	Van	20	Commercial
5	Sport Classic	13	Cycle	22	Open Wheel
6	Sport	14	Boat
7	Super	15	Helicopter

---

Common Race Setups — At a Glance

Goal	Key Settings
Fairest competitive race	Vehicles: Specific · Fair Start: ON
Fun random car chaos	Class · Sync OFF · No Repeats OFF
Same random car per lap — all players	Class · Sync ON · Per-Checkpoint Re-roll OFF · No Repeats ON
Same random car per checkpoint — all players	Class · Sync ON · Per-Checkpoint Re-roll ON · No Repeats ON
New car every lap — individual	Class · Transform: Every Lap · No Repeats ON
New car every lap — all same (preset)	Specific · Transform Events: Lap 2/3/4/5
Keep field close	Catch-Up: ON · 1.3× / 0.92×
Reward overtaking	Slipstream: ON · Overtake Bonus: ON
Pressure on last place	DLP: ON or Elimination Mode: ON
Strategy & pit timing	Pitstop (Zone) + Fuel + Tyre Wear
Practice / time trial	Hot Lap Challenge: ON · 600 s
Pure party chaos	Cannonball Mode: ON
Scored drift session	Drift Score Mode: ON · 300 s
F2F — same vehicle for all, swap every checkpoint, no repeats	Game Mode: F2F · Vehicles: Random · VP Vehicle Classes: pick your class · Sync: ON · No Repeats: ON
Drag strip	Drag Race: ON · Vehicles: Specific
Safe public race	Ghost on Contact: ON · Named Vehicle Ghost: ON
Grid by skill	Start Qualifying → then start race
Skill-rating competition	Ranked (ELO): ON · min 3 players
Crew vs crew	Team Race: ON · Crews enabled
Night race	Time: 22:00 · Weather: Clear
Wet track	Weather: Rain · or mid-race Weather Event

---

Useful Admin Commands (Server Console)

Command	Category	Effect
importgto	Admin	Import new GTA:O tracks from gto_import/ folder
importgto update	Admin	Force re-import all GTA:O tracks
/archive_season_standings	Admin	Archive current season standings and reset season points
/cr_weather [type]	Admin	Change weather mid-race (if Weather Event trigger = admin)
/cr_diag	Diagnostic	Print frame-time + race-state diagnostics to F8 console (requires Config.DebugLogging = true)
/cr_serverperf	Diagnostic	Server-side performance diagnostics (admin only)

---

Debug Logging — Config Flag

Both raycin_races and raycin_creator have detailed diagnostic logging that's off by default to keep the console clean during normal play. Toggle it on when troubleshooting:

File: raycin_races/config/config_client.lua

Config.DebugLogging = false  -- default: false

When set to true, you'll see tagged messages in the F8 console covering: - [StartRace] — grid-load and SVOGP (set-vehicle-on-ground-properly) tracing - [MidRace] — force-collision events on prop tracks - [Emergency] — fall-physics detector firings + respawn triggers - [Respawn] — post-respawn snap logic - [RespawnGhost] — ghosting timer events - [cr_diag] — frame-time stats from /cr_diag command - [SCOREBOARD] — final race-points calculation - [GetRandomVehicleModel] — vehicle class pool fallbacks

Genuine errors (vehicle model not found, prop model invalid, etc.) always print regardless of this flag — they're not part of the gated output.

---

Configurable HUD Durations

These values in config/config_client.lua control how long certain in-race banners and chips stay on screen. All values are in seconds.

Config key	Default	What it controls
Config.Notifications.swapWarnDuration	5	Swap warning banner (upcoming vehicle change)
Config.Notifications.fastestLapDuration	5	Fastest Lap toast (Race Director)
Config.Notifications.timedRaceExpiredDuration	8	⏱ TIME EXPIRED chip after timed race clock hits zero
Config.VehicleTransform.notifyDuration	4	🔀 Transform announce banner
Config.Pitstop.warnDuration	10	Pitstop reminder at race start (mandatory pit is active)

Example — making the TIME EXPIRED chip stay longer: Open config/config_client.lua, find Config.Notifications.timedRaceExpiredDuration and change it from 8 to 12. Restart the resource.

---

Track Type Admin Tool

A web-based admin page lets you view and change the Circuit / P2P flag for any track without touching phpMyAdmin directly.

Link: Vehicle Database → Dev panel → Race Track Types tab (requires admin login)

Features

• Stats bar — total tracks, circuit count, P2P count at a glance
• Filter — search by name, filter by category, filter by Circuit or P2P
• Per-row toggle — click → Circuit or → P2P on any row to flip that track's type instantly
• Bulk change — tick checkboxes (or Select All), choose a type from the dropdown, click Apply to selected

After making changes, run ensure raycin_races in the server console so the in-game race browser picks up the updated values.

---

Stats Site — Sync & Admin Tips

The stats site (raycin.com/stats / localhost/stats) reads live from the same database as raycin_creator and raycin_races. No manual sync is needed — changes appear on the next page load.

What syncs automatically

Action	Result on stats site
Publish / update a track	Track metadata updates immediately
Delete a track	Track disappears immediately
Rename category (Category Manager in-game)	All tracks update to new name immediately
Merge category (Category Manager in-game)	Tracks move to target category immediately
New track record set in a race	Lap Times and best-holder update immediately
Race results logged	Race History and Results update immediately
Player earns race points	Leaderboard updates immediately

Renaming a category

Recommended: Use the in-game Category Manager (Race Creator main menu → Category Manager). One rename updates every track in that category in a single operation.

Alternative (phpMyAdmin): Run a direct SQL update if the server is offline or you prefer working in the database:

UPDATE custom_race_list SET category = 'New Name' WHERE category = 'Old Name';

Both methods have identical results — the stats site does not care which was used.

Useful database queries (phpMyAdmin)

Task	SQL
Rename a category	UPDATE custom_race_list SET category = 'New' WHERE category = 'Old';
List all categories and track counts	SELECT category, COUNT(*) as tracks FROM custom_race_list GROUP BY category ORDER BY tracks DESC;
Find tracks with missing images	SELECT raceid, route_file FROM custom_race_list WHERE route_image IS NULL OR route_image = '';
Find duplicate track names	SELECT route_file, COUNT(*) FROM custom_race_list GROUP BY route_file HAVING COUNT(*) > 1;
See all Circuit-flagged tracks	SELECT raceid, route_file FROM custom_race_list WHERE lap = 1;
See all P2P tracks	SELECT raceid, route_file FROM custom_race_list WHERE lap = 0;
Bulk-set all tracks in a category to Circuit	UPDATE custom_race_list SET lap = 1 WHERE category = 'YourCategory';
Reset a player's race points	UPDATE custom_race_users SET race_points = 0 WHERE license = 'license:XXXXXXX';

---

Map Not Showing Up — Troubleshooting

How maps are stored

Format	Location	Purpose
.xml in raycin_creator/xml_imports/	Props/objects only	Spooner/Menyoo prop placements — loaded inside the creator editor
.json in raycin_races/custom_files/	Race data	Checkpoints, laps, distance — the actual map
custom_race_list DB row	Published flag	What raycin_races reads to display maps in the browser

A map only appears in raycin_races if it has a row in custom_race_list and is published (not a draft).

Common reasons a map doesn't appear

Symptom	Likely cause	Fix
Map never appears in the browser	Never published in raycin_creator	Open creator → Save → Publish
Map was visible, now gone	Accidentally reverted to draft	Re-publish in the creator
Map saved in creator but no DB row	Save step failed (check server console for errors)	Re-save and publish
XML file placed in the folder manually	XML is props only — not a race map	Build the track in the creator; import the XML props inside the editor

DB check — confirm a map exists and is published

SELECT raceid, route_file, category, published
FROM custom_race_list
ORDER BY raceid DESC
LIMIT 20;

• published is not 'x' → map is live and visible in-game
• published = 'x' → still a draft — open the creator and publish it
• Row is missing entirely → the save never completed — re-save and publish

To make a map appear (step-by-step)

1. Open raycin_creator and load or build your track.
2. If the track uses props from an XML file — use Import XML inside the creator to pull them in from xml_imports/.
3. Place checkpoints, the start grid, and the finish line.
4. Save the track — writes the JSON file to custom_files/.
5. Publish the track — inserts the row into custom_race_list.
6. The map appears in the raycin_races browser on the next list refresh.

---

Stats site requires FiveM to be running

The stats site fetches all data from the FiveM HTTP API at runtime. If the FiveM server is offline, the stats pages will show empty. There is no cached fallback. This applies to both localhost/stats and raycin.com/stats.