Configuration — ns-rcs
Everything is in config.lua (left readable by the escrow). Restart the resource after a change.
Units: speeds m/s, accelerations m/s², angles degrees, times ms unless written otherwise.
General
| Key | Default | Meaning |
|---|
Framework | 'auto' | 'qbox', 'qbcore', 'esx', 'standalone' |
Locale / FallbackLocale | 'tr' / 'en' | texts from locales/<code>.lua |
Debug | false | true prints state changes and spin values to F8 (category rcs) |
Notifications.provider | 'auto' | 'ox_lib', 'qbox', 'qbcore', 'esx', 'native', 'custom' |
Access and vehicles
| Key | Default | Meaning |
|---|
Access.mode | 'everyone' | 'everyone', 'ace' (needs Access.ace or admin), 'job' (needs Config.Job) |
Access.ace | 'ns-rcs.use' | add_ace group.vip ns-rcs.use allow |
Job.name / minGrade / requireOnDuty | 'mechanic' / 0 / false | used by mode 'job' |
Vehicles.mode | 'list' | 'list' (spawn names in models), 'classes' (class ids in classes), 'all' |
Vehicles.models | { 'tesroad20', 'neon' } | spawn names |
Vehicles.classes | { 6, 7 } | GTA vehicle classes (6 sports, 7 super) |
Vehicles.blacklist | {} | spawn names that never get thrusters |
Motorcycles, cycles, boats, helicopters, planes and trains never get thrusters.
Features
Config.Features: Tricks, Flight, Boost, Suction, Stabiliser, LandingAssist, Hud, Sound, all true.
Controls
| Key | Default | Meaning |
|---|
Keys.thrust / lift / boost | 'Q' / 'SPACE' / 'E' | default keys; each player can rebind in Settings > Key Bindings > FiveM. FiveM keeps the first default a player saw: changing it later only affects new players |
Gestures.tapWindow | 220 | pause after the last tap before the count is final |
Gestures.holdTime | 320 | held this long = flight |
Gestures.taps | 1 hop, 2 rollRight, 3 rollLeft, 4 flipForward, 5 suction | actions: hop, rollRight, rollLeft, flipForward, flipBack, suction. The highest number is reported at once |
Physics
| Key | Default | Meaning |
|---|
Tricks.hopSpeed / trickHopSpeed | 6.5 / 8.5 | upward speed of a hop / before a trick |
Tricks.spinTime | 850 | one full roll / flip |
Flight.liftOffHeight | 1.2 | metres it rises when flight starts on the ground |
Flight.climbSpeed / verticalAccel | 7.0 / 14.0 | climb speed with lift, vertical response |
Flight.forwardAccel / brakeAccel / maxSpeed | 11 / 14 / 45 | flight thrust along the heading |
Flight.driftDamping | 3.0 | 1/s, removes sideways sliding |
Flight.yawRate / bank / pitch | 95 / 12 / 6 | turn rate, bank and nose-down at full input |
Boost.accel / maxSpeed | 22 / 100 | 100 m/s = 360 km/h |
Stabiliser.delay | 250 | airborne this long before it acts (small bumps are ignored) |
Stabiliser.strength / maxRate / response | 4.5 / 300 / 7.0 | how hard / how fast it rights the car |
LandingAssist.height / triggerSpeed / targetSpeed / decel | 7 / 13 / 6 / 30 | brakes a fall faster than triggerSpeed within height m of the ground |
Suction.attachDistance / detachDistance | 1.4 / 2.2 | metres from the car's centre to the surface under it |
Suction.detachGrace | 300 | no surface this long = let go |
Suction.pull | 15.0 | pull into the surface on walls and ceilings (gravity is cancelled there) |
Suction.floorAngle | 35.0 | degrees; surfaces flatter than this are left to the game, so the car drives as normal |
Propellant
| Key | Default | Meaning |
|---|
Propellant.enabled | true | false = endless |
Propellant.reserve | 30 | % kept for the stabiliser and landing assist; moves stop here |
Propellant.rechargeSeconds / rechargeDelay | 5.0 / 350 | empty → full on all four wheels, after this delay |
Propellant.cost.hop / roll / flip | 10 / 18 / 20 | % per move |
Propellant.cost.flightPerSecond / liftPerSecond / boostPerSecond | 9 / 7 / 12 | % per second |
Propellant.cost.stabilisePerTurn / landingPerSpeed | 6 / 0.5 | per 360° of corrected spin / per m/s of braked fall |
Visuals, sound, HUD
| Key | Default | Meaning |
|---|
Effects.enabled | true | jets under the car |
Effects.asset / jet | 'core' / 'ent_sht_steam' | looped particle |
Effects.scale / minStrength | 1.4 / 0.6 | size at full thrust; the weakest jet keeps this share of size and opacity |
Effects.rotation / tilt | vector3(180, 0, 0) / 40 | orientation (points down); side jets lean outward by tilt degrees (negative if they lean into the car) |
Effects.sideInset / height | 0.95 / 0.3 | nozzle position: share of the half-width (1.0 = body edge), metres above the bottom of the body |
Effects.flightTilt | 0.0 | side jet tilt while flying; 0 = straight down |
Effects.boostAsset / boostJet / boostScale | 'core' / 'ent_amb_steam' / 1.0 | looped particle out of the rear while boosting |
Effects.boostRotation | vector3(90, 0, 0) | boost jets pointing backward. With Config.Debug = true, /rcsjet <rx> <ry> <rz> [scale] [jet] [asset] tries values in game and prints the config line |
Effects.boostSpread / boostHeight | 0.45 / 0.55 | boost nozzles: share of the half-width (0 = one spot in the middle), metres above the bottom of the body |
Effects.renderDistance | 120.0 | other cars' jets are drawn within this range |
Sound.volume / range | 0.35 / 40.0 | hiss volume, distance where other cars fade out |
Hud.position | 'bottom-center' | 'bottom-center', 'bottom-left', 'bottom-right' (bottom-left covers the minimap) |
Hud.offsetX / offsetY | 0 / 24 | px |
Texts
All texts are in locales/en.lua and locales/tr.lua. Copy one to locales/<code>.lua, translate it, add it to
fxmanifest.lua and set Config.Locale.
