View source for HUD

<translate>
<!--T:1-->
DragonMineZ draws its own '''HUD''' for your '''Health''', '''Ki''', '''Stamina''' and '''Power Release''', plus extra panels for your party, quests, techniques and special fights. You can choose between four HUD styles, and every element can be moved, resized, mirrored or hidden in the '''HUD Editor'''.
</translate>

{{Note|type=tip|<translate><!--T:2--> Open the editor from the Character Menu ({{Key|V}}) → '''Config''' → '''Interface''' → '''HUD Layout'''. Right after you create your character, a short tutorial points at your HUD and offers to open the editor.</translate>}}

<translate>
== HUD styles == <!--T:3-->

<!--T:4-->
Pick the style with the '''Style''' button at the top of the HUD Editor.
</translate>

{| class="wikitable"
! <translate><!--T:5--> Style</translate> !! <translate><!--T:6--> What it looks like</translate>
|-
| <translate><!--T:7--> '''Xenoverse''' (default)</translate> || <translate><!--T:8--> One compact block in the top-left corner with your bars and form and release info.</translate>
|-
| <translate><!--T:9--> '''Modern'''</translate> || <translate><!--T:10--> A head portrait of your character next to Health, Ki and Stamina stacked in one block, drawn in the metallic style of the DragonMineZ menus, with each bar split into four sections.</translate>
|-
| <translate><!--T:11--> '''Compact'''</translate> || <translate><!--T:12--> Three separate small bars ('''Health''', '''Ki and Release''', '''Stamina''') that you place one by one.</translate>
|-
| <translate><!--T:13--> '''Vanilla'''</translate> || <translate><!--T:14--> Minecraft-style blocks beside the hotbar: '''Health and Stamina''' on the left, '''Ki and Release''' on the right. They stay glued to the hotbar (and follow the offhand slot) unless you drag them away; snap them back onto the hotbar to glue them again.</translate>
|}

<translate>
<!--T:15-->
Every style shares the same bar animations:
</translate>

* <translate><!--T:16--> Damage leaves a fading "chip", healing grows the bar, and the numbers pulse when they change. Big hits shake the Xenoverse, Modern and Compact HUDs.</translate>
* <translate><!--T:17--> '''Health''' shifts smoothly from green to yellow to red as it drops, '''Ki''' uses your ki color and '''Stamina''' is orange.</translate>
* <translate><!--T:18--> Every few seconds a light shine sweeps across your bars, cascading from Health to Ki to Stamina.</translate>
* <translate><!--T:19--> Ki bars (yours, your party's and the Ki Sense panels) ripple with a flowing light that speeds up and brightens while you charge ki.</translate>
* <translate><!--T:20--> Below '''25% health''' the Health bar beats like a heart (faster the lower it gets) and its frame flashes red.</translate>
* <translate><!--T:21--> The whole HUD freezes while the game is paused (including the Escape menu in multiplayer).</translate>
* <translate><!--T:22--> Numbers and labels use the DragonMineZ font, in a compact, easy-to-read format.</translate>

{{Note|<translate><!--T:23--> Coming from version 2.1: if you used the old ''alternative HUD'', you start on the '''Vanilla''' style; otherwise on '''Xenoverse'''.</translate>}}

<translate>
== HUD elements == <!--T:24-->

=== Main elements === <!--T:25-->

<!--T:26-->
These are placed separately for each style.
</translate>

{| class="wikitable"
! <translate><!--T:27--> Element</translate> !! <translate><!--T:28--> Shown when</translate>
|-
| <translate><!--T:29--> '''Main HUD''' (or the Compact and Vanilla blocks)</translate> || <translate><!--T:30--> Always.</translate>
|-
| <translate><!--T:31--> '''Power Reserve'''</translate> || <translate><!--T:32--> [[Special:MyLanguage/Frost Demon|Frost Demons]]: your stored ki reserve, in your ki color.</translate>
|-
| <translate><!--T:33--> '''Rage Meter'''</translate> || <translate><!--T:34--> Mutants (dark green) and the [[Special:MyLanguage/Saiyan|Saiyan]] False Super Saiyan charge (red).</translate>
|-
| <translate><!--T:35--> '''Party'''</translate> || <translate><!--T:36--> You are in a party: up to '''3''' allies (nearest first) with name, health and ki. Live bars when they are nearby, their face and distance when they are far away. A downed ally is marked.</translate>
|-
| <translate><!--T:37--> '''Technique 1–4'''</translate> || <translate><!--T:38--> The four rows of the '''technique hotbar''' (see below).</translate>
|}

<translate>
<!--T:39-->
Side meters such as the Power Reserve and the Rage Meter '''slide out of the screen''' while they are empty or don't apply to you, if they are placed against a screen edge; elements lined up behind them move up to fill the gap.

=== Extras === <!--T:40-->

<!--T:41-->
Switch the editor to the '''Extras''' view to place these. They are shared by every style.
</translate>

{| class="wikitable"
! <translate><!--T:42--> Element</translate> !! <translate><!--T:43--> What it shows</translate>
|-
| <translate><!--T:44--> '''Notifications'''</translate> || <translate><!--T:45--> One stack (top-right by default) for quest notices, party invites, update alerts, the '''tracked quest''', the tutorial hint and the live [[Special:MyLanguage/Tournaments|tournament]] status (see below).</translate>
|-
| <translate><!--T:46--> '''Scouter'''</translate> || <translate><!--T:47--> The scouter readout while you wear a [[Special:MyLanguage/Scouters|scouter]] (not available in the Compact style).</translate>
|-
| <translate><!--T:48--> '''Baba Temporary Revive'''</translate> || <translate><!--T:49--> The time you have left in the world of the living when [[Special:MyLanguage/Fortuneteller Baba|Fortuneteller Baba]] brought you back temporarily (shows ''Paused'' or ''KO'' when relevant). See [[Special:MyLanguage/Otherworld|Otherworld]].</translate>
|-
| <translate><!--T:50--> '''Boss Contribution'''</translate> || <translate><!--T:51--> During a [[Special:MyLanguage/World Bosses|world boss]] fight: the contribution ranking of the fighters.</translate>
|}

<translate>
=== Notifications === <!--T:52-->
</translate>

* <translate><!--T:53--> '''Pinned''' entries stay while they apply: your '''tracked quest''' (title, the current objective with progress, a direction arrow and distance for location objectives, and the time left on timed quests), the '''"Press [V] to begin your adventure!"''' hint before you create a character, and the live tournament notice.</translate>
* <translate><!--T:54--> '''Temporary''' entries (quest started, failed, objective done or completed, party invites, quest start errors and "update available") slide in for '''5 seconds'''; at most 5 are shown at once. Newer ones push older ones down.</translate>
* <translate><!--T:55--> If you place the stack at the bottom of the screen, it grows upwards.</translate>

<translate>
=== Technique hotbar === <!--T:56-->

<!--T:57-->
Your 8 technique slots are shown as '''four rows''' (Technique 1–4), shared by '''Bar 1''' ({{Key|Alt}} + 1–4) and '''Bar 2''' ({{Key|Ctrl}} + 1–4):
</translate>

* <translate><!--T:58--> Holding a bar's modifier shows that bar's four slots, with the key and the technique name.</translate>
* <translate><!--T:59--> When you let go, the rows fade out, except slots on '''cooldown''', which stay half-visible until they are ready, blink, and fade out a moment later.</translate>

<translate>
=== Ki Sense panels === <!--T:60-->

<!--T:61-->
While [[Special:MyLanguage/Ki Sense|Ki Sense]] is in '''Combat''' mode ({{Key|F4}}, see [[Special:MyLanguage/Skills|Skills]]), every living being you sense gets a small panel floating above its head, built like the Modern HUD:
</translate>

* <translate><!--T:62--> '''Players''' show Health, Ki (with the charging effect when they charge) and Stamina; any other creature shows only its Health bar.</translate>
* <translate><!--T:63--> The Health number is always shown, even with '''Hide HUD Numbers''' on; the Ki and Stamina numbers follow your HUD number options.</translate>
* <translate><!--T:64--> The panel shows the target's '''Battle Power''' above it, plus the damage and healing you see it take (summed up while '''Ki Sense - Accumulative Damage''' is on, as single popups otherwise; in % of max health with '''Adv. Desc. (Percentage)''' on).</translate>
* <translate><!--T:65--> Panels shrink with distance (down to a readable minimum), fade in and out as targets enter or leave your sense range, and stay hidden in the HUD Editor.</translate>

<translate>
<!--T:66-->
A being at 0% Power Release can't be sensed.

=== Party markers === <!--T:67-->
</translate>
{{Config|General Server Config|partyMarkerRange}}
<translate>
<!--T:68-->
With '''Party Markers''' on (Config → Interface), a pin with the ally's face over a tinted arrow floats over each party member's head, at any distance and through walls. Idle pins are small and slightly transparent; the pin closest to your crosshair grows and shows the ally's name and distance. Markers behind the camera are hidden.

<!--T:69-->
The server only shows allies in the '''same dimension''' within '''2,000 blocks''' who are alive and not hidden: an [[Special:MyLanguage/Anti-Ki Cloaking Device|Anti-Ki Cloaking Device]] (see [[Special:MyLanguage/Items|Items]]), a god form you can't sense, or 0% Power Release hides them. Markers turn red when the ally is down.
</translate>

<translate>
== Numbers on the HUD == <!--T:70-->
</translate>

{| class="wikitable"
! <translate><!--T:71--> Option (Config → Interface)</translate> !! <translate><!--T:72--> Effect</translate>
|-
| <translate><!--T:73--> '''Always Visible HUD Values'''</translate> || <translate><!--T:74--> Off (default): the numbers on your bars appear when a value changes and fade out about 2.5 seconds later. On: they are always shown.</translate>
|-
| <translate><!--T:75--> '''Hide HUD Numbers'''</translate> || <translate><!--T:76--> Hides the numbers on your bars, side meters and party rows completely (bars only).</translate>
|}

<translate>
== The HUD Editor == <!--T:77-->

<!--T:78-->
Opening the editor dims the screen and shows every HUD element of the current view with sample values (empty meters and an empty party are filled in so you can place them).
</translate>

{| class="wikitable"
! <translate><!--T:79--> Action</translate> !! <translate><!--T:80--> How</translate>
|-
| <translate><!--T:81--> '''Move'''</translate> || <translate><!--T:82--> Drag an element. It soft-snaps (5 px) to screen edges, the screen centre and other elements, with guide lines.</translate>
|-
| <translate><!--T:83--> '''Resize'''</translate> || <translate><!--T:84--> Drag one of the 8 handles around the selected element.</translate>
|-
| <translate><!--T:85--> '''Nudge'''</translate> || <translate><!--T:86--> The arrow keys move the selected element by 1 (hold {{Key|Shift}} for 5).</translate>
|-
| <translate><!--T:87--> '''Mirror'''</translate> || <translate><!--T:88--> Right-click an element to flip it horizontally. Available for the Main HUD of the Xenoverse and Modern styles, the Party panel, the Scouter and the technique rows.</translate>
|-
| <translate><!--T:89--> '''Show / Hide'''</translate> || <translate><!--T:90--> Hide an element you don't want, or show it again.</translate>
|-
| <translate><!--T:91--> '''Reset'''</translate> || <translate><!--T:92--> Resets the selected element (or, with nothing selected, every element of the current view) to its default placement.</translate>
|-
| <translate><!--T:93--> '''Undo / Redo'''</translate> || <translate><!--T:94--> Buttons at the top, or {{Key|Ctrl}} + {{Key|Z}} / {{Key|Ctrl}} + {{Key|Y}} ({{Key|Ctrl}} + {{Key|Shift}} + {{Key|Z}} also redoes). The last 5 changes are kept.</translate>
|-
| <translate><!--T:95--> '''Style'''</translate> || <translate><!--T:96--> Cycles the HUD style.</translate>
|-
| <translate><!--T:97--> '''Extras'''</translate> || <translate><!--T:98--> Switches between the main elements and the extras (and back with '''Main HUD''').</translate>
|-
| <translate><!--T:99--> '''Done''' / {{Key|Esc}}</translate> || <translate><!--T:100--> Saves the layout.</translate>
|-
| <translate><!--T:101--> '''Cancel'''</translate> || <translate><!--T:102--> Restores the layout and style you had when you opened the editor.</translate>
|}

<translate>
<!--T:103-->
'''Technique rows''' move as a group: hold {{Key|Shift}} while dragging to move all four rows, right-clicking one row mirrors all of them, resizing a row rescales the group, and Reset on a row resets all four.

<!--T:104-->
Positions and sizes are stored relative to your screen height, so a layout covers the same share of the screen at any window size or GUI scale (the Vanilla and Compact blocks keep their pixel size because they sit next to the hotbar).

== Sharing a layout == <!--T:105-->

<!--T:106-->
Your style and every placement are saved in their own file on your computer, <code>config/dragonminez/hud_layout.json</code>. To share your layout, send this one file. Drop a received file into your <code>config/dragonminez</code> folder and '''open the HUD Editor''': it re-reads the file when it opens, so no restart is needed. Servers never send this file, so every player keeps their own layout.
</translate>

<syntaxhighlight lang="json">
{
  "configVersion": "...",
  "style": "xenoverse",
  "layout": {
    "xenoverse": { "main": { "anchorX": 0.0, "anchorY": 0.0, "offsetX": 3.0, "offsetY": 3.0, "scale": 1.2, "visible": true, "hotbar": false, "mirrored": false } },
    "extras": { "notifications": { "anchorX": 1.0, "anchorY": 0.0, "offsetX": -6.0, "offsetY": 6.0, "scale": 0.9, "visible": true, "hotbar": false, "mirrored": false } }
  }
}
</syntaxhighlight>

* <translate><!--T:107--> <code>style</code>: <code>xenoverse</code>, <code>modern</code>, <code>compact</code> or <code>vanilla</code>.</translate>
* <translate><!--T:108--> <code>layout.&lt;style&gt;.&lt;element&gt;</code>: <code>main</code>, <code>compact_health</code>, <code>compact_ki</code>, <code>compact_stamina</code>, <code>minecraft_left</code>, <code>minecraft_right</code>, <code>party</code>, <code>reserve</code>, <code>rage</code>, <code>skill_1</code> … <code>skill_4</code>. <code>layout.extras.&lt;element&gt;</code>: <code>notifications</code>, <code>scouter</code>, <code>baba_timer</code>, <code>boss_contribution</code>.</translate>
* <translate><!--T:109--> Each placement: <code>anchorX</code> and <code>anchorY</code> (0 = left or top, 0.5 = centre, 1 = right or bottom), <code>offsetX</code> and <code>offsetY</code>, <code>scale</code>, <code>visible</code>, <code>hotbar</code> (Vanilla blocks glued to the hotbar) and <code>mirrored</code>. Missing entries use the default placement.</translate>

{{Navbox Mechanics}}