> For the complete documentation index, see [llms.txt](https://devmosaic.gitbook.io/devmosaic/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://devmosaic.gitbook.io/devmosaic/resources/devmosaic-dm-hud/player-settings.md). # What Players Can Change The settings menu and layout editor, exactly as a player sees them. Press **`F7`**. Everything below is theirs to change, and their choices save to their own machine. {% hint style="info" %} You decide the starting point in [`shared/defaults.lua`](/devmosaic/resources/devmosaic-dm-hud/defaults.md), and you can take any of it away in [`shared/policy.lua`](/devmosaic/resources/devmosaic-dm-hud/policy-and-locks.md). This page is what remains. {% endhint %} ## The tabs
TabContains
GeneralPerformance, units, size, opacity, ultrawide, clock
Map and compassMinimap shape, zoom, when it shows, compass style
Player statusBar style, size, when each bar appears, bar colours
CarsSpeedometer layout, gauges, speed limit sign, waypoint
MotorcyclesMotorcycle dash layout
BicyclesCadence and heart rate
AircraftArtificial horizon, altitude, climb rate, landing gear
BoatsHeading and trim
Player infoJob, gang, ID, clock, cash, bank, voice
WeaponAmmo counter and its colour
Vehicle controlsDim the screen behind the panel
SoundMaster, volume, and each sound separately
## General | Setting | Options | | ----------------------- | -------------------------------------------------- | | Performance mode | Ultra · Balanced · Performance · Resource saver | | Measurement system | Imperial (MPH, miles, feet) · Metric (KM/H, km, m) | | HUD size | 70% to 130% | | HUD opacity | 30% to 100% | | Full width on ultrawide | On · Off | | Real-time clock | On · Off | ### What performance mode actually changes | Mode | Best for | | ------------------ | --------------------------------------------- | | **Ultra** | Strong machines. Smoothest needles and bars | | **Balanced** | The default. What most players should stay on | | **Performance** | Older machines. Fewer updates per second | | **Resource saver** | Weak machines. The bare minimum | It only changes how often the HUD redraws. Nothing disappears on any setting. ## Map and compass | Setting | Options | | ---------------------- | ------------------------------ | | Minimap shape | Rectangular · Circular | | Minimap zoom | 600 (close) to 1600 (far) | | Show on foot | On · Off | | Show in vehicle | On · Off | | Show north marker | On · Off | | Compass style | Bearing ruler · Location chips | | Compass follows camera | On · Off | | Show on foot | On · Off | | Show nearest postal | On · Off | | Show crossing name | On · Off | ## Player status | Setting | Options | | ---------------- | -------------------------------------------- | | Style preset | Halo · Hex · Badge · Ledger · Wave · Pitline | | Status size | 30 to 70 | | Show server logo | On · Off | | Logo size | 30 to 160 | ### Display range Each bar gets a **from** and **to**. The bar is on screen only while the value sits inside it. | Range | Result | | ---------- | ----------------------------- | | `0 – 100` | Always visible | | `0 – 99` | Hides when full | | `10 – 100` | Hides until it climbs past 10 | ### Colours Every bar has two colours a player can set: the **progress** fill and the **icon** on top. ## Cars | Setting | Options | | ------------------------- | ---------------------------------------------------------- | | Car layout | Racing dash · Sprint digital · Corner cluster · Sport dial | | Speedometer accent | Any colour | | Speed limit sign | US sign · EU sign · Hidden | | Flash sign when speeding | On · Off | | Show distance to waypoint | On · Off | | Show fuel gauge | On · Off | | Show engine gauge | On · Off | ## Motorcycles, bicycles, aircraft and boats {% tabs %} {% tab title="Motorcycles" %} | Setting | Options | | ----------------- | --------------------------------------------------------- | | Motorcycle layout | Centre runway · Corner cluster · Sport dial · Racing dash | | {% endtab %} | | {% tab title="Bicycles" %} | Setting | Options | | ------------------ | -------- | | Show pedal cadence | On · Off | | Show heart rate | On · Off | | {% endtab %} | | {% tab title="Aircraft" %} | Setting | Options | | ----------------------- | -------- | | Show artificial horizon | On · Off | | Show altitude | On · Off | | Show climb rate | On · Off | | Show landing gear | On · Off | | {% endtab %} | | {% tab title="Boats" %} | Setting | Options | | ------------- | -------- | | Show heading | On · Off | | Show trim | On · Off | | {% endtab %} | | | {% endtabs %} | | ## Player info | Setting | Options | | ----------------- | -------- | | Show cash | On · Off | | Show bank balance | On · Off | | Voice mode | On · Off | | Player ID | On · Off | | In-game clock | On · Off | | Job name | On · Off | | Gang name | On · Off | {% hint style="info" %} **Chips you added yourself appear here too**, each with its own switch, labelled with the name you registered it under. Nothing to set up — see [Adding your own](/devmosaic/resources/devmosaic-dm-hud/extending.md). {% endhint %} ## Weapon and controls | Setting | Options | | ------------------------------------ | ---------- | | Show ammo panel | On · Off | | Ammo accent colour | Any colour | | Dim game screen when a panel is open | On · Off | ## Sound | Setting | Options | | ------------------------------ | -------- | | Enable HUD sounds | On · Off | | Volume | 0 to 100 | | Indicator tick | On · Off | | Seatbelt on | On · Off | | Seatbelt off | On · Off | | Seatbelt warning while driving | On · Off | ## The layout editor **Settings → Adjust layout**, or `/dashlayout`. Drag anything anywhere. | Action | How | | ----------------- | ---------------------------------------- | | Move one thing | Drag it | | Move several | Shift-click to select, then drag | | Nudge precisely | Arrow keys — hold Shift for bigger steps | | Ignore snapping | Hold Alt while dragging | | Reset one element | Right-click it | | Resize | Drag its corner grip | | Hide or show | Its eye icon | | Undo and redo | The toolbar buttons | ### Toolbar | Control | Does | | -------------------- | --------------------------------------------- | | Snap to grid | Elements jump to grid lines | | Grid size | How fine the grid is | | Show safe zone | Draws the TV-safe boundary | | Show anchors | Draws the anchor regions | | Show hidden elements | Ghosts in the things that are hidden | | Align and distribute | Line elements up, or space them evenly | | Presets | Default · Streamer · Minimal · Compact | | Reset to defaults | Everything back to your `defaults.lua` layout | | Cancel changes | Throw away this session's edits | | Save and close | Keep them | {% hint style="success" %} **Presets are the fast path.** Streamer keeps the screen clear for a webcam overlay, Minimal strips it to the essentials, and Compact pulls everything tighter into the corners. {% endhint %} {% hint style="warning" %} Lock `layout` in [`shared/policy.lua`](/devmosaic/resources/devmosaic-dm-hud/policy-and-locks.md) to take the editor away entirely. {% endhint %} ## Restore defaults The button at the top of the settings menu. It throws away everything the player has changed and puts them back on your [`shared/defaults.lua`](/devmosaic/resources/devmosaic-dm-hud/defaults.md) values — settings and layout together. {% hint style="info" %} This is also the answer when you change a default and existing players still see the old one. Their saved choice wins until they reset. {% endhint %}