Minimap Vehicles

Renders player and other vehicles on the minimap with role-based styling.

Overview

ui_apps_minimap_vehicles draws all visible vehicles on the minimap as directional triangles or circles. Player vehicle, police, usable, and other vehicles each get distinct colors and layers.

Extension path: lua/ge/extensions/ui/apps/minimap/vehicles.lua

Exports (M)

Internals

Vehicle Shapes

drawVehicle(pos, fwd, color, size, asCircle, layer) renders two shapes:

• Circle mode (asCircle=true) - For walking/unicycle: circle body + forward triangle
• Diamond/arrow mode - For vehicles: two triangles forming an arrow shape pointing forward

Both have a white border (from navBg style color) and colored fill.

Player Drawing

The player vehicle uses velocity-based dynamic zoom:

local dynamicScale = clamp(velSmoother:get(vel > 10 and 3.0 or 1, dtReal), 1, 1.75)
local walkScale = walkSmoother:get(isWalking and 0 or 1, dtReal)

• Walking uses gameplay_walk.getPosXYZ() and walking rotation
• Driving uses map.objects[vehId].pos and dirVec
• Free camera draws a cone-shaped indicator with lookahead offset

Other Vehicle Filtering

Vehicles are filtered by debug settings and role:

Additionally:

• Props, Unknown, Utility, PropTraffic, and Traffic types are skipped via ignoredTypes
• Blacklisted vehicles (gameplay_walk.isVehicleBlacklisted) are colored gray

Color Assignment

Police vehicles flash using math.sin(os.clock()*5) for alternating red/blue.

How It Works

1. Main minimap calls setMinimapState() to sync camera data
2. drawOtherVehicles() iterates all active vehicles, filters by role/settings
3. Each vehicle is drawn as an arrow or circle with role-based color
4. drawPlayer() draws the player with dynamic zoom scaling based on velocity
5. Returns adjustedScale so the minimap can zoom out at higher speeds

Additional Exports

The following exports are available but not yet documented in detail:

• M.drawOtherVehicles
• M.drawPlayer
• M.setMinimapState