🪛Installation & Configuration
Configuration:
Config = {}
-- Sets the language/locale used for all UI text and notifications.
-- Available options: 'en' (English), 'es' (Spanish), 'fr' (French), 'de' (German)
Config.Lan = 'en'
--========================================================
-- Framework integrations (set to the resource you use)
--========================================================
Config.Notifications = "ox_lib" -- Notification system to use ("ox_lib", "qb-core")
Config.Inventory = "ox_inventory" -- Inventory system to use ("ox_inventory", "qb-inventory", "ps-inventory")
Config.Target = "ox_target" -- Target system to use ("ox_target", "qb-target")
Config.ProgressBar = "ox_lib" -- Progress bar System to use ("ox_lib", "qb-core")
-- Hide your HUD while inside RC Customs/Flying Drone/Driving RC - You must set you hud at the bottom of the config
Config.HideHud = false
--========================================================
-- RC Customs locations & access
--========================================================
Config.rcCustomsCoords = vector4(-146.3614, -596.6284, 166.0000, 270.2807) -- This is where the player will be teleported when customizing their RC car.
Config.RCCustomizationZones = {
{
-- 🛠 Example Customization Zone #1 (City)
center = vec3(735.0612, -1065.3237, 22.1684), -- Center of the zone (coords where players stand)
radius = 6.0, -- Size of the interaction area (larger = more forgiving)
},
{
-- 🛠 Example Customization Zone #2 (Sandy Shores)
center = vec3(1991.3525, 3793.5391, 32.1808),
radius = 6.0,
},
}
Config.RCTargetCustomizationZones = {
{
-- 🛠 Example Zone #1 — Job & Citizen Restricted
center = vec3(-323.6004, -129.4949, 39.0100), -- Center of the interaction zone
radius = 1.0, -- How far from the center players can interact
debug = false, -- Enable to visualize the zone in-game (dev use only)
-- Restrict access by job or specific CitizenIDs
groups = { 'mechanic', 'bennys' }, -- Only players with these jobs can use this zone
citizenID = { 'ABC12345', 'XYZ67890' }, -- Only these CitizenIDs can use (leave empty for none)
-- Enable repairs at this location
CanRepairDrone= true, -- Allow repairing drones here
CanRepairRcCar= true, -- Allow repairing RC cars here
-- Optional prop to spawn a physical bench at this zone
Prop = {
enabled = false, -- true = spawn a bench/prop
model = `gr_prop_gr_bench_04a`, -- Prop model to spawn
heading = 0.0, -- Rotation of the prop
offset = vec3(0.0, 0.0, 0.0), -- Offset from the center if you want to adjust placement
frozen = true, -- Prevent the prop from being moved
invincible = true, -- Make the prop indestructible
distance = 2.0, -- How close players must be to interact
},
},
{
-- 🛠 Example Zone #2 — Public Access
center = vec3(-199.8964, -1321.0529, 31.0894),
radius = 1.0,
debug = true, -- Debug ON to visualize this zone (useful for setup)
-- No group/citizen restrictions: anyone can access this
groups = {}, -- Leave empty for public
citizenID = {}, -- Leave empty for public
CanRepairDrone= true,
CanRepairRcCar= true,
Prop = {
enabled = true, -- This zone spawns a visible bench
model = `gr_prop_gr_bench_04a`,
heading = 180.0,
offset = vec3(0.0, 0.0, 0.0),
frozen = true,
invincible = true,
distance = 2.0,
},
},
}
--========================================================
-- RC Car Definitions
--========================================================
Config.RcCars = {
['rc_car'] = {
Label = "RC Car",
maxRange = 300, -- control range (meters)
batteryItem = 'rccar_battery', -- item used to recharge/swap battery
batteryregen = 100, -- amount restored on recharge/swap
BaseBattery = 90.0, -- starting battery (%)
BaseHealth = 95.0, -- starting health (%)
Abilities = {
canToggleCamera = true, -- enable in-vehicle camera switching
nightVision = true,
thermalVision = true,
},
-- Damage from physical collisions
Collision = {
Enabled = true,
SpeedThreshold = 0.15, -- minimum m/s to count as a hit
CooldownMs = 3000, -- min delay between hits
Min = 10, -- min damage per hit
Max = 25, -- max damage per hit
ScaleBySpeed = false, -- scale damage by speed if true
ScaleMultiplier = 0.15, -- extra dmg per m/s (if ScaleBySpeed)
},
-- Repair cost settings at customs/benches
Repair = {
enabled = true,
costPerPercent= 10, -- cost per 1% health restored
minimumCost = 5000, -- floor price
maximumCost = 10000, -- cap price
},
Speed = {
Enabled = true, -- true = override stock handling at runtime; false = use the model's default handling
MaxSpeed = 45.0, -- fInitialDriveMaxFlatVel (meters/second). Higher = higher top speed. (also set SetVehicleMaxSpeed(veh, MaxSpeed) to remove residual caps.)
Acceleration = 0.22, -- fInitialDriveForce (~0.18 is around stock rcbandito). Higher = faster acceleration.
BrakeForce = 0.30 -- fBrakeForce Higher = stronger brakes / shorter stopping distance.
}
}
}
--========================================================
-- Drone Definitions
--========================================================
Config.Drones = {
['drone'] = {
Label = "Dynyx Aero",
DroneProp = `reh_prop_reh_drone_02a`, -- spawned world prop
DroneSound = true, -- enable looped prop sound
maxRange = 300, -- control range (meters)
batteryItem = 'drone_battery', -- item used to recharge/swap
batteryregen = 100, -- amount restored on recharge/swap
BaseBattery = 100.0, -- starting battery (%)
BaseHealth = 100.0, -- starting health (%)
Abilities = {
canTogglePOV = true, -- Allow switching between 1st person and 3rd person camera views
nightVision = false, -- Enable/disable night vision mode for this drone/RC car
thermalVision = false, -- Enable/disable thermal vision mode (heat signatures)
spotlight = false, -- Enable/disable a controllable spotlight feature
},
-- Damage from players shooting the drone
PlayerShotImpact = {
Enabled = true, -- enable bullet damage
hitDamageMin = 2, -- min damage per bullet
hitDamageMax = 5, -- max damage per bullet
},
-- Damage from physical collisions
Collision = {
Enabled = true,
SpeedThreshold = 0.15, -- minimum m/s to count as a hit
CooldownMs = 3000, -- min delay between hits
Min = 10, -- min damage per hit
Max = 25, -- max damage per hit
ScaleBySpeed = false,
ScaleMultiplier = 0.15,
Effect = true, -- enable/disable the effect (true = on, false = off)
EffectScale = 0.5 -- effect intensity multiplier; 1.0 = default, <1.0 softer, >1.0 stronger
},
-- Damage while touching water
Water = {
Enabled = true, -- disable to make waterproof
DamagePerSecond = 25, -- DPS while in water
TickMs = 1000, -- damage interval
FirstTickInstant = true, -- apply damage immediately on first contact
Effect = true, -- enable/disable the effect (true = on, false = off)
EffectScale = 1.0 -- effect intensity multiplier; 1.0 = default, <1.0 softer, >1.0 stronger
},
-- ✈️ Flight tuning (feel/response)
FlightTuning = {
maxSpeed = 0.25, -- forward/back m/s
strafeSpeed = 0.05, -- left/right m/s
verticalSpeed = 0.08, -- up/down (Q/E) m/s
accel = 0.012, -- W/S acceleration
decel = 0.012, -- W/S deceleration
strafeAccel = 0.010,
verticalAccel = 0.008,
mouseSensitivity = 1.0, -- camera turn rate
},
-- Placement preview outline
PlacementSystem = {
DrawOutline = true,
DrawOutlineColor = { r = 255, g = 215, b = 0, a = 255 },
},
},
['drone_mini'] = {
Label = "Dynyx V1-Lite",
DroneProp = `xs_prop_arena_drone_02`,
DroneSound = true,
maxRange = 150,
batteryItem = 'drone_battery',
batteryregen = 100,
BaseBattery = 50.0,
BaseHealth = 65.0,
Abilities = {
canTogglePOV = false,
nightVision = false,
thermalVision = false,
spotlight = false,
},
PlayerShotImpact = {
Enabled = true,
hitDamageMin = 2,
hitDamageMax = 5,
},
Collision = {
Enabled = true,
SpeedThreshold = 0.15,
CooldownMs = 3000,
Min = 10,
Max = 25,
ScaleBySpeed = false,
ScaleMultiplier = 0.15,
Effect = true,
EffectScale = 0.5
},
Water = {
Enabled = true,
DamagePerSecond = 25,
TickMs = 1000,
FirstTickInstant = true,
Effect = true,
EffectScale = 1.0
},
FlightTuning = {
maxSpeed = 0.20,
strafeSpeed = 0.05,
verticalSpeed = 0.08,
accel = 0.008,
decel = 0.008,
strafeAccel = 0.005,
verticalAccel = 0.004,
mouseSensitivity = 1.5,
},
PlacementSystem = {
DrawOutline = true,
DrawOutlineColor = { r = 255, g = 215, b = 0, a = 255 },
},
},
['police_drone'] = {
Label = "Dynyx PD-01",
DroneProp = `ch_prop_casino_drone_02a`,
DroneSound = true,
maxRange = 450,
batteryItem = 'drone_battery',
batteryregen = 100,
BaseBattery = 100.0,
BaseHealth = 100.0,
Abilities = {
canTogglePOV = true,
nightVision = true,
thermalVision = true,
spotlight = true,
},
PlayerShotImpact = {
Enabled = true,
hitDamageMin = 1,
hitDamageMax = 3,
},
Collision = {
Enabled = true,
SpeedThreshold = 0.15,
CooldownMs = 3000,
Min = 10,
Max = 25,
ScaleBySpeed = false,
ScaleMultiplier = 0.15,
Effect = true,
EffectScale = 0.5
},
Water = {
Enabled = true,
DamagePerSecond = 25,
TickMs = 1000,
FirstTickInstant = true,
Effect = true,
EffectScale = 1.0
},
FlightTuning = {
maxSpeed = 0.50,
strafeSpeed = 0.05,
verticalSpeed = 0.08,
accel = 0.008,
decel = 0.015,
strafeAccel = 0.005,
verticalAccel = 0.004,
mouseSensitivity = 1.0,
},
PlacementSystem = {
DrawOutline = true,
DrawOutlineColor = { r = 255, g = 215, b = 0, a = 255 },
},
},
}
--========================================================
-- Spotlight (police drone / spotlight ability)
--========================================================
Config.SpotlightSettings = {
Color = { r = 255, g = 255, b = 200 }, -- warm white
Distance = 35.0, -- beam length (meters); 25–50 recommended
Brightness = 12.0, -- intensity; increase for daytime visibility
Hardness = 1.0, -- edge hardness (0.0–1.0)
Radius = 20.0, -- spot radius; lower for tighter beam (4–10 feels realistic)
Falloff = 5.0, -- brightness falloff from center (3–10)
Shadow = 1, -- set 0 if your build shows more consistent results without shadows
}
-- Toggle your external HUD when entering/exiting RC Customs
function ToggleHud(state)
if Config.HideHud then
exports['hud']:ToggleVisible(state)
end
end
Last updated