Why drive a car when you can drive a duck?

Your city has supercars, tanks and flying bikes. What it’s been missing is a 4-metre mallard you can sit in.

Quackmobil adds three drivable ducks to FiveM. They waddle, they quack, they swim and they fly. They’re also free, so there’s no bill to pay. (The ducks bring their own.)

Get it free on Tebex · Documentation · Discord

Meet the flock

Three separate add-on vehicles that share one handling. They nest happily in any spawner, shop or garage.

Features (no fowl play)

It’s alive!

• The webbed feet paddle faster the faster you drive, kick wildly in the air and tap impatiently at red lights
• The head bobs with every stroke, looks into curves and looks around curiously while you wait
• The bill opens with every quack, and the head lifts proudly
• Total it and the head droops. Very dramatic. Real ducks would approve.

Quack, the horn

• Your horn is now a real recorded mallard, heard by everyone nearby (louder up close, of course)
• Every duck quacks at a slightly different pitch, and does a little hop of joy

Up, up and a-wing (default key X)

• The wings unfold smoothly from the flanks and flap faster the faster you fly
• Glides on the way down, tucks its feet back and stretches its neck like a pro
• Arcade flight: W/S speed, A/D bank and turn, Space climb, Ctrl descend
• Synced for every player, so everyone can watch you flap past their window
• Optional flight licence: limit flying to jobs (ESX, QBCore or Qbox) and/or an ACE permission (checked on the server, no duck-dodging)
• Optional Discord log for your staff: who took off, and who tried to without a licence

Just add water

• The ducks are amphibious: drive straight off the pier into lakes, rivers or the sea
• They float, bob on the waves and steer like a boat. Finally, a car that belongs in the water.
• Take off from the water or land on it. Very majestic. Mostly.

Eye see you

• The headlights shine from the duck’s eyes and turn with the head. Look into the curve, light into the curve.
• Low and high beam, plus a soft glow in the eyes for that “I know what you did” look at night

Fowl play detection

• Crash hard and a burst of feathers flutters to the ground. Your insurance won’t cover it, but it looks amazing.

Clean model

• No visible wheels: the duck sits low, like it’s floating even on asphalt
• Padded cockpit with bucket seats, dashboard gauges and a steering wheel with a duck emblem
• Full LOD chain plus a _hi model, so a whole flock doesn’t eat your frames
• Custom rims from LS Customs or garages get removed automatically. Ducks don’t do rims.

Light as a feather

• Parked ducks cost nothing. They nap until someone gets in, quacks or bumps into them
• Ducks off-screen are skipped, and far-away ducks update less often, independent of the player’s FPS
• Head, bill and feet are only re-attached when they actually moved
• The horn is a key binding, so nothing polls input every frame while driving
• 3 graphics presets (performance / balanced / quality), and players can pick their own with /quackquality
• Simple mode: one switch turns the ducks into plain vehicles with practically no client load. For servers that like their ducks calm.

Get your ducks in a row

Everything lives in the open config.lua: texts for translation, keys, horn, flight physics and permissions, water driving, head, wings, eye lights, feathers and graphics presets. The Discord webhook sits in config_server.lua, which never reaches the players. The included README and the documentation explain every single option, so nobody has to wing it.

Config.SimpleMode = false            -- true = ducks behave like normal vehicles (practically no client load)

Config.Locale = {                    -- every text players see
    VehicleNames = {
        quackmobil = 'Quackmobil',
        quackmobil_hen = 'Quackmobil Hen',
        quackmobil_rubber = 'Quackmobil Rubber Duck',
    },
    MakeName = 'Squeak & Co.',
    FlightDenied = 'You are not allowed to fly the Quackmobil.',
    -- ...
}

Config.Horn = {
    KeyMapping = true,               -- false = classic horn polling (controller players)
    DefaultKey = 'E',
    Volume = 0.8,
    HearDistance = 45.0,
    PitchVariation = 0.05,
    Cooldown = 350,
    HopForce = 3.0,
}

Config.Flight = {
    Enabled = true,
    DefaultKey = 'X',
    AllowedJobs = {},                -- e.g. { 'police', 'ambulance' } (ESX, QBCore or Qbox)
    AcePermission = false,           -- e.g. 'quackmobil.fly'
    MaxSpeed = 38.0,                 -- m/s (~137 km/h)
    Acceleration = 8.0,
    TurnRate = 75.0,
    ClimbRate = 7.0,
    DiveRate = 10.0,
    -- ...
}

Config.Swim = {
    Enabled = true,
    MaxSpeed = 9.0,                  -- m/s on water (~32 km/h)
    TurnRate = 50.0,
    Grip = 1.5,
    -- ...
}

Config.Head = { SteerFactor = 0.9, BeakOpen = 22.0 }
Config.Wings = { UnfoldTime = 0.8, FoldTime = 0.7 }

Config.EyeLights = {
    Color = { 255, 240, 214 },
    LowBeam = { Distance = 40.0, Brightness = 4.0, Radius = 24.0, Falloff = 6.0 },
    HighBeam = { Distance = 70.0, Brightness = 6.0, Radius = 18.0, Falloff = 6.0 },
    Glow = { Range = 0.45, Intensity = 3.0 },
}

Config.FeatherEffect = { Lifetime = { 2.2, 3.4 }, MaxActive = 40 }

Config.Preset = 'balanced'           -- 'performance', 'balanced' or 'quality'
Config.AllowPlayerChoice = true      -- players pick their own preset with /quackquality
Config.Override = {}                 -- e.g. { Feathers = 0 }

Config.Presets = {
    balanced = {
        PropDistance = 300.0,        -- head, wings and feet up to this distance
        DetailDistance = 120.0,      -- head and feet animated up to this distance
        UpdateRates = { { 35.0, 0 }, { 80.0, 30 }, { 150.0, 15 }, { math.huge, 8 } },
        IdleLookAround = true,
        FootTapping = true,
        LightDistance = 120.0,
        EyeLightSpots = 1,
        EyeGlow = true,
        Feathers = 10,
        -- ...
    },
    -- performance = { ... }, quality = { ... }
}

How to waddle

All keys are FiveM key bindings, so every player can rebind them in Settings → Key Bindings → FiveM.

From checkout to quack

1. Grab it on Tebex (free). It is added to your Cfx.re account automatically.
2. Download it from the Cfx.re Portal under Granted Assets
3. Drop the quackmobil folder into your resources
4. Add ensure quackmobil to your server.cfg
5. Hatch one with /car quackmobil, or add the three models to your vehicle shop

That’s it. No eggs were harmed.

One thing to know: your server has to run with a license key from the same Cfx.re account that owns the resource. That’s how FiveM’s asset escrow works.

For developers

Exports, in open files you may change:

• Client: isDuck(vehicle), isFlying(), stopFlying(), getQuality(), setQuality(name, save)
• Server: canFly(source), isDuck(entity), getFlier(netId)

All of them are explained in the documentation.

Grab your duck

Get it free: Tebex
Documentation: organized-chaos.gitbook.io
Support / Discord: discord.gg/aGks2EPx3

Found a bug? Report it. Found a feature? Report that too. Found a real duck in your server? That one’s on you.

_{Attention: Quack sound might be too quacky.}