> 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/hud-editor.md).

# HUD Editor

The HUD editor gives you a full-screen canvas to place every on-screen element wherever you like. Move, resize, and configure each one independently — no restarting, no guessing at coordinates.

## Opening the editor

Inside the menu, go to the **HUD** section. A miniature preview of your current layout sits in the panel — it shows every enabled element scaled down to a 16:9 thumbnail. Click the preview (labeled **Edit HUD Layout** on hover) to open the full-screen editor overlay.

## Moving and resizing

{% stepper %}
{% step %}

### Click and drag an element's body to move it

Hover over any element on the canvas; it highlights with a label above it. Click and drag to reposition it. It stays within the screen boundary and snaps according to the active snap mode (see below).
{% endstep %}

{% step %}

### Drag the corner handle to resize

When you hover a resizable element, a small triangle appears at its bottom-right corner. Drag that handle to scale the element up or down. Not all elements are resizable — the handle only appears when the element supports it.
{% endstep %}

{% step %}

### Right-click an element for its options

Right-clicking an element opens a context menu with settings specific to that element: an **Enabled** toggle, a **Size** (or **Scale**) slider, and any element-specific options such as what information to display or extra visual toggles. Changes apply live.
{% endstep %}
{% endstepper %}

## Snap modes

The editor has three snap behaviors. Press **TAB** to cycle through them, or pick one from the settings panel (gear icon). The active mode is shown in a pill at the bottom-left of the editor.

| Mode              | What it does                                                                                                                        |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| **Free**          | Elements move freely to any pixel position with no snapping.                                                                        |
| **Snap to Edges** | Elements snap near screen edges, screen center, and element corners. Useful for aligning neatly to the borders or dead-center.      |
| **Grid**          | Elements snap to a fixed grid. When this mode is active, you can also choose a grid size (8, 16, or 32 px) from the settings panel. |

## Settings panel

Click the **gear icon** in the top-right corner of the editor to open the settings panel. It slides in as a centered popup and contains:

* **Snap Mode** — the same three-way selector, also reachable with TAB.
* **Grid Size** — visible only in Grid mode; choose 8, 16, or 32 px.
* **Show Hotbar** — overlays a Minecraft hotbar image at the bottom of the canvas as a positioning reference.
* **Widgets** — a checkbox for every HUD element. Use this to enable or disable elements without leaving the editor.
* **Overlays** — toggles for non-element overlays that appear in the editor as previews (Aim Assist FOV circle, Off-Screen Arrows).
* **Reset Positions** — resets all element positions to their defaults. The button is red and acts immediately.

## Editable elements

The editor shows every enabled HUD element. The elements available include: Watermark, Array List, Keybinds widget, Health Display, CPS Graph, Radar, Notifications, Local Player Pos, Nearby Players, Target HUD, Now Playing, Armor HUD, Session Stats, and Recording Indicator.

For details on what each element displays, see the [HUD feature page](/product-guides/akira-jni/features/visuals/hud.md).