Auto Park

A hologram-based parking automation system. The driver places a translucent ghost of their car anywhere within range, rotates it to taste, and the vehicle drives itself into the spot — with precision-snap on arrival for pixel-perfect placement.

How It Works

1. Tap Auto Park in the dock (or open the autopark module)
2. A hologram of your vehicle appears at your aim point — translucent, the same model as your current vehicle
3. Click to confirm position, scroll to rotate
4. Confirm — the vehicle drives itself toward the hologram using the FiveM driving native
5. When the vehicle is within arrivalThreshold meters, it switches from physics driving to a precise teleport-snap into the exact hologram position and rotation
6. If the vehicle gets stuck for stuckTimeout seconds, the system retries automatically

Features

• Live hologram preview — the placement ghost is the actual vehicle model, not a generic prop
• Mouse-scroll rotation at configurable speed
• Configurable max placement distance (default 50 m)
• Configurable drive speed (default 15 km/h — slow enough for tight spots)
• Precision-snap arrival — switch from drive to instant placement at threshold
• Stuck detection — auto-retry if the vehicle hasn't moved
• Hologram alpha — adjust transparency

Configuration

lua

Config.AutoPark = {
    enabled = true,
    maxDistance = 50.0,          -- max hologram placement distance (meters)
    driveSpeed = 15.0,           -- parking drive speed (km/h)
    precisionSnap = true,        -- snap to exact position on arrival
    arrivalThreshold = 3.0,      -- distance to switch from driving to snap (meters)
    hologramAlpha = 150,         -- 0-255 transparency
    rotateSpeed = 3.0,           -- degrees per scroll wheel tick
    stuckTimeout = 15,           -- seconds before retry

    jobs = {},                   -- empty = everyone allowed
    discordRoles = {},
}

Tuning Recommendations

Setting	Recommendation
driveSpeed	Keep low (10-20 km/h) — the AI driving native struggles with tight spaces fast
arrivalThreshold	3-5 m — too low and the AI never reaches snap distance, too high and the snap is jarring
precisionSnap	Leave true for clean placement — disable only if you want fully physical parking
hologramAlpha	150 is a balanced default; bump to 200 for low-light environments

Permission Gating

Auto Park supports both job and Discord role gating via the jobs and discordRoles arrays. See Permission System.

Module Toggle

Option	Default	Description
Config.Modules.AutoPark	true	Show auto park module
Config.DockButtons.autoPark	true	Show auto park dock button

Tip

Auto Park works best on flat surfaces with no obstacles. The AI driving native does not handle stairs, kerbs, or other peds well — give the vehicle a clear corridor between its current position and the hologram.