Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/ikeepcalm/coi-client/llms.txt

Use this file to discover all available pages before exploring further.

COI Client’s HUD is fully configurable — you can move the ability slot row anywhere on screen, resize slots, toggle labels and glow effects, and even scale the entire overlay up or down. All settings live in config/coi_hud.json and are loaded once on startup, but the easiest way to tune them is through the HUD Settings screen built into the mod, which lets you preview changes live without reloading the game.

​
HUD Settings Screen

1

Open the Ability Binding screen

Press K in-game to open the Ability Binding screen.
2

Click HUD Settings

Click the HUD Settings button in the top-right corner of the Ability Binding screen. This opens the dedicated HUD configuration screen.
3

Adjust sliders, fields, and toggles

Use the sliders for numeric values (drag left/right) or type a precise value directly into the text field next to each slider. Check or uncheck the toggle options to enable or disable individual visual elements.
4

Save and close

Click Done to write all changes to config/coi_hud.json and return to your game. Click Cancel to discard any unsaved changes.

​
Available Settings

​
enabled
boolean
default:"true"
Master toggle for the entire ability HUD. When set to false, no ability slots are rendered at all. The HUD Settings screen shows a warning banner when this is off so you don’t accidentally hide your HUD.
​
hudX
int
default:"10"
Horizontal position of the leftmost ability slot in pixels, measured from the left edge of the screen. Valid range: 0–500. Adjust this alongside hudScale — the renderer divides this value by hudScale before positioning.
​
hudYOffset
int
default:"60"
Vertical offset from the bottom of the screen in pixels. The ability row is anchored to the bottom edge: the actual Y position is calculated as (screenHeight - hudYOffset) / hudScale. Valid range: 0–200.
​
slotSize
int
default:"40"
Width and height of each ability slot icon in pixels (slots are square). Valid range: 20–100. Larger slots make icons easier to read; smaller slots save screen space.
​
slotSpacing
int
default:"50"
Horizontal distance in pixels between the left edge of one slot and the left edge of the next. Must be at least as large as slotSize to avoid overlapping slots. Valid range: 30–100.
​
showKeybinds
boolean
default:"true"
When enabled, the bound key name (e.g. Z, X) is rendered below each slot so you can see at a glance which key triggers which ability.
​
showAbilityNames
boolean
default:"true"
When enabled, the English display name of the bound ability is shown beneath its slot. Disable this for a cleaner, icon-only HUD.
​
showGlowEffect
boolean
default:"true"
When enabled, a colored glow pulses around a slot when its ability comes off cooldown and is ready to use. The glow color matches the ability’s pathway color. Disable this if you prefer a static HUD or want to reduce visual noise.
​
hudScale
float
default:"1.0"
A multiplier applied to the entire HUD. 1.0 is native size; 0.5 halves everything; 2.0 doubles it. Valid range: 0.5–2.0. Both position values (hudX, hudYOffset) are divided by this scale before rendering, so the physical screen position stays roughly stable as you scale.
​
wheelSlots
int
default:"8"
The number of segments shown on the Ability Wheel. Valid range: 2–16 (hard maximum is MAX_WHEEL_SIZE = 16). Only the first wheelSlots entries from your wheel bindings are displayed on the radial.
​
epilepsyMode
boolean
default:"false"
When enabled, disables flashing and rapidly-cycling visual effects that could trigger photosensitivity issues. This toggle is available in the HUD Settings screen and does not affect ability icons or the cooldown overlay.
​
showMadnessBar
boolean
default:"true"
When enabled, renders the Madness bar on screen. Disable this if you do not use the madness mechanic or want a cleaner HUD.
​
madnessYOffset
int
default:"55"
Vertical offset in pixels used to position the Madness bar. Interpreted relative to the anchor point set by madnessAnchor. Valid range: 0–200.
​
madnessAnchor
string
default:"TOP_LEFT"
Corner of the screen the Madness bar is anchored to. Accepted values: TOP_LEFT, TOP_CENTER, BOTTOM_LEFT, BOTTOM_CENTER.

​
Presets

The HUD Settings screen includes four built-in presets you can cycle through by clicking the Preset button at the bottom of the screen. Each click advances to the next preset and applies it immediately:
PresetDescriptionslotSizeslotSpacinghudScaleNamesGlow
DefaultBalanced layout for most screen sizes40501.0✔✔
CompactSmall slots, no names, reduced scale30350.8✘✘
LargeOversized slots and generous spacing55651.2✔✔
MinimalTiny icons only — maximum screen space25300.7✘✘
Applying a preset overwrites all layout fields and most visual toggles (showKeybinds, showAbilityNames, showGlowEffect, showMadnessBar, madnessYOffset, madnessAnchor) with the preset values, but does not change the enabled flag or epilepsyMode. You can then fine-tune individual values after applying a preset.

​
Manual Config

If you prefer to edit the file directly, config/coi_hud.json uses standard JSON. Here is the file with all fields set to their defaults: 
{
  "enabled": true,
  "hudX": 10,
  "hudYOffset": 60,
  "slotSize": 40,
  "slotSpacing": 50,
  "showKeybinds": true,
  "showAbilityNames": true,
  "showGlowEffect": true,
  "hudScale": 1.0,
  "wheelSlots": 8,
  "epilepsyMode": false,
  "showMadnessBar": true,
  "madnessYOffset": 55,
  "madnessAnchor": "TOP_LEFT"
}
Any field missing from the file falls back to its default value when the mod loads, so you only need to include fields you want to change. The file is re-written whenever you save from the HUD Settings screen or when a preset is applied.
Changes made in the HUD Settings screen take effect immediately — the HUD re-reads its settings on every render frame. You can leave the settings screen open, drag a slider, and watch the ability bar reposition in real time behind the transparent overlay. No Minecraft restart is needed.

Build docs developers (and LLMs) love

Get started for freeTalk to us