> For the complete documentation index, see [llms.txt](https://docs.akiraghost.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.akiraghost.com/product-guides/akira-jni/features/visuals/hud.md).

# HUD

The *HUD* (heads-up display) is a collection of on-screen widgets — health readout, radar, notifications, watermark, keybinds list, target panel, coordinates, nearby players, CPS graph, session stats, now playing, and more — that surface the information you need without pausing the game. Every widget can be positioned freely by dragging it in the in-game HUD editor. By default the HUD hides when a menu opens; turn on **Show In Screens** (off by default) to keep every widget rendering while the inventory, chat, or any other screen is open.

## Notifications

Pop-up alerts that appear when modules are toggled or notable events occur, shown as a stacked list (on by default).

* **Notification Size** — scale of the popups, from `0.5` to `2.0×` (default `1.0`).
* **Notification Time** — how long each stays visible, from `1.0` to `10.0 s` (default `3.0`).
* **Notification Max Stack** — how many appear at once, from `0` to `20` (default `5`); set to `0` for unlimited.
* **Background Opacity** — transparency of the notification background, from `0.00` to `1.00` (default `1.00`).

## Watermark

A draggable corner widget showing the client name and version, plus optional stat readouts (on by default).

* **Show FPS** — include the current frame rate (on by default).
* **Show Ping** — include the current server ping (on by default).
* **Show Time** — include a real-world clock (on by default).
* **Time Format** — the clock display, either **24 Hour** (`HH:MM`, e.g. `14:32`, the default) or **12 Hour** (`hh:MM AM/PM`, e.g. `2:32 PM`); shown when **Show Time** is on.
* **Show Build** — include the client build number (on by default).
* **Watermark Size** — scale of the widget, from `0.5` to `2.0×` (default `1.0`).
* **Show Background** — draw a panel behind the watermark (on by default).
* **Background Opacity** — opacity of that panel, from `0.00` to `1.00` (default `1.00`).

## Keybinds widget

A live on-screen list of modules and their assigned keys (on by default).

* **Keybinds Size** — scale of the list, from `0.5` to `2.0×` (default `1.0`).
* **Keybinds Display** — which modules appear: **Only Enabled** (currently active, the default), **All Bound** (every module with a key assigned), or **Active Only** (modules currently being held or triggered).
* **Show Mode** — display each entry's bind trigger mode — "Hold", "Toggle", or "Always" (on by default).
* **Show Key** — display the bound key name, e.g. "\[R]", next to each module (on by default).

## Health display

Shows your current HP as a HUD element, separate from the vanilla hotbar (on by default).

* **Text Shadow** — draw a drop shadow behind the health text (off by default).
* **Shadow Size** — offset of that shadow, from `0.0` to `4.0` (default `1.5`), shown when **Text Shadow** is on.
* **Shadow Intensity** — opacity of that shadow, from `0.00` to `1.00` (default `0.70`), shown when **Text Shadow** is on.

## Low health warning

Overlays a pulsing color vignette around the screen edges when your health drops low, giving you an urgent visual alert (off by default).

* **Health Threshold** — the HP value (out of 20) at or below which the warning activates, from `2` to `16` (default `8`).
* **Low Health Color** — color of the vignette flash.
* **Pulse Speed** — frequency of the pulse, from `0.5` to `5.0` (default `2.0`); higher pulses faster.

## Radar

A circular mini-map with dots for nearby players relative to your position and facing direction (off by default).

* **Radar Size** — scale of the widget, from `0.5` to `2.0×` (default `1.0`).
* **Background Opacity** — opacity of the radar background, from `0.00` to `1.00` (default `1.00`).

## Target HUD

A dedicated panel showing the player you are currently targeting — their name, HP bar, and optionally their skin (on by default).

* **Target HUD Size** — scale of the panel, from `0.5` to `2.0×` (default `1.0`).
* **Follow Player** — the panel tracks the target's screen position rather than sitting in a fixed corner (on by default).
* **Combo Counter** — show how many consecutive hits you have landed on the target (on by default).
* **Show Status** — compare your HP and armor to the target's and show "Winning" or "Losing" (on by default).
* **Show Skin** — render a small profile picture or skin preview of the target (on by default).
* **Show Armor Durability** — add a slim bar below the target's health bar showing their overall armor durability (off by default).
* **Armor Bar Color** — color of that armor durability bar.
* **Background Opacity** — opacity of the Target HUD background, from `0.00` to `1.00` (default `1.00`).

## Local player position

Displays your current world position on screen (off by default).

* **Local Player Pos Size** — scale of the display, from `0.5` to `2.0×` (default `1.0`).
* **Show Coordinates** — toggle the X / Y / Z numbers (on by default).
* **Show Facing** — show the cardinal direction you're facing — N / NE / E / SE / S / SW / W / NW based on your yaw (on by default).

## Nearby players

A widget listing player names within a scan radius, sorted by distance (off by default).

* **Nearby Players Size** — scale of the list, from `0.5` to `2.0×` (default `1.0`).
* **Nearby Players Radius** — scan distance; players beyond it are excluded, from `5.0` to `100.0 m` (default `20.0`).
* **Nearby Players Max** — maximum entries shown at once, from `1` to `50` (default `10`).
* **Nearby Players MC Colors** — render names with Minecraft team colors, applying `§` color codes from each player's display name or team (off by default).
* **Background Opacity** — opacity of the list background, from `0.00` to `1.00` (default `1.00`).

## Off-screen arrows

Chevron arrows at the screen edge, rotated toward players outside your field of view (off by default).

* **Mode** — how arrow color is determined: **Color** (a static color from the picker, the default), **Distance Color** (fades with distance), or **Health Color** (reflects the target's remaining HP).
* **Arrow Color** — the arrow color, used when **Mode** is **Color**.
* **Alpha Based On Distance** — make arrows more transparent the further the target is (off by default).
* **Scan Radius** — distance to scan for off-screen players; those beyond it aren't shown, from `1.0` to `100.0` (default `40.0`).
* **Arrow Size** — size of each arrow glyph, from `1.0` to `20.0` (default `10.0`).
* **Arrow Radius** — distance from screen center where arrows are placed, from `1.0` to `300.0` (default `100.0`); controls how close to the edges they sit.

## CPS graph

A scrolling bar graph of your click rate over the last few seconds (off by default).

* **CPS Graph Size** — scale of the graph, from `0.5` to `2.0×` (default `1.0`).
* **Background Opacity** — opacity of the graph background, from `0.00` to `1.00` (default `1.00`).

## Session stats

A draggable panel showing kills, deaths, K/D ratio, wins, total damage dealt, and elapsed session time (off by default).

**Layout** sets the panel style: **List** (label / value rows, the default), **Header** (a titled accent panel), or **Strip** (a single horizontal bar).

Choose which stats appear — all included by default:

* **Show Session Time** — elapsed time.
* **Show Kills** — kill count.
* **Show Deaths** — death count.
* **Show K/D** — kill/death ratio.
* **Show Wins** — win count.
* **Show Damage** — total damage dealt.

Then style the panel:

* **Font Size** — text size, from `8.0` to `24.0` (default `14.0`).
* **Text Color** — color of stat labels and values.
* **Accent Color** — accent color for values in the List and Header layouts.
* **BG Color** — background color of the panel.

## Now playing

A media widget showing the currently playing track from Spotify (or other supported media) — song title, artist, and optionally album art and a progress bar (off by default).

* **Show Album Art** — display the album art thumbnail (on by default).
* **Show Artist** — display the artist name (on by default).
* **Show Album Title** — display the album name (off by default).
* **Show Progress Bar** — display a playback progress bar (on by default).
* **Progress Color** — color of the progress bar fill, shown when **Show Progress Bar** is on.
* **Progress BG Color** — color of the progress bar's background track, shown when **Show Progress Bar** is on.
* **Art Size** — size of the album art thumbnail, from `24` to `96 px` (default `48`).
* **Scale** — overall scale multiplier for the widget, from `0.5` to `2.0×` (default `1.0`).
* **Opacity** — opacity of the widget background, from `0.00` to `1.00` (default `1.00`).
* **Rounding** — corner rounding of the widget, from `0.0` to `20.0` (default `6.0`).
* **Title Color** — color of the song title text.
* **Artist Color** — color of the artist name text.
* **Background Color** — background color of the widget.

## HUD font

Turn on **Custom HUD Font** (off by default) to replace the default Roboto font used across all HUD widgets with a system or custom font.

* **HUD Font Size** — size of the HUD text, from `8.0` to `32.0` (default `14.0`), shown when **Custom HUD Font** is on.
* **Text Shadow** — draw a drop shadow behind HUD text (off by default).
* **Shadow Size** — offset of that shadow, from `0.5` to `3.0` (default `1.0`), shown when **Text Shadow** is on.
* **Shadow Intensity** — opacity of that shadow, from `0.10` to `1.00` (default `0.60`), shown when **Text Shadow** is on.

## Armor HUD

**Background Opacity** controls how opaque the panel behind your own armor display is, from `0.00` to `1.00` (default `1.00`).