Jorg
f3e10f27d2
- Add controller hotbars: 8 cross bars (L2/R2 style), separate from normal hotbars 1-8 - Controller bar slot data stored in config (not game StandardHotbars) so layouts can differ per mode - Drag-and-drop on controller bars: from game, shift+drag rearrange, release outside to clear - Independent controller bar keybinds with modifier+trigger combinations (e.g. L2+South) - Optional 'Sync bar mode with game client': follow Character Config Mouse/Gamepad toggle (PadMode) - Clone/copy actions: normal hotbars ↔ controller bars - Restore controller bar layout button; deploy to devPlugins on Release build Made-with: Cursor
HSUI
A modern HUD replacement for Final Fantasy XIV, built for customization.
HSUI provides a highly configurable HUD replacement, recreated from DelvUI using KamiToolKit, FFXIVClientStructs, and Dalamud. Replace and customize your entire in-game HUD with a clean, flexible interface.
Features
- Unit Frames — Player, target, focus target, target of target with customizable health bars, labels, and icons
- Castbars — Player and target castbars with interrupt indicators
- Job Gauges — All job-specific gauges (DRK, WAR, MNK, NIN, etc.)
- Party Frames — Configurable party list with health, buffs, debuffs, and cooldowns
- Nameplates — Customizable enemy and friendly nameplates
- Status Effects — Player and target buff/debuff display
- Enemy List — Enhanced enemy list with debuff tracking
- Hotbars — Configurable action bars with:
- Multiple layout options (12×1, 6×2, 4×3, 3×4, 2×6, 1×12)
- Drag-and-drop from game UI (Actions, Macros, Inventory)
- Shift+drag to rearrange, release outside to clear
- Cooldown overlays and combo highlighting
- Profiles — Save and load configurations, import from DelvUI
- Other Elements — Experience bar, GCD indicator, limit break, pull timer, MP ticker
Installation
Via Custom Plugin Repository (Recommended for FC/local installs)
- Open XIVLauncher → Dalamud Settings → Experimental
- Add a custom plugin repository:
https://raw.githubusercontent.com/Knack117/HSUI/main/pluginmaster.json - Open the Plugin Installer, enable "Show custom plugin repositories", and install HSUI
Manual Installation
- Download the latest release from Releases
- Extract the contents to your Dalamud plugins folder:
%AppData%\XIVLauncher\installedPlugins\HSUI\
Commands
| Command | Description |
|---|---|
/hsui |
Open HSUI settings |
/hui |
Alias for /hsui |
Publishing a Release (for FC/custom installs)
To make HSUI available via the custom plugin repository:
- Build:
dotnet build -c Release - Create the release zip:
.\create-release.ps1(includes Assets, DLLs — required for hotbars and config) - Create a GitHub Release (e.g. tag
v1.0.2.1) - Upload
bin/Release/HSUI/latest.zipas a release asset - Update
pluginmaster.jsonif the version changed, then commit and push
FC members add this custom repo in XIVLauncher → Dalamud Settings → Experimental → Custom Plugin Repositories:
https://raw.githubusercontent.com/Knack117/HSUI/main/pluginmaster.json
Building from Source
Prerequisites
- .NET 10 SDK
- KamiToolKit (cloned to
../repos/KamiToolKit-master/)
Build
dotnet build -c Release
The built plugin will be in bin/Release/.
Project Structure
HSUI/
├── Config/ # Configuration system
├── Enums/ # Shared enumerations
├── Helpers/ # Utilities and managers
├── Interface/ # HUD elements and configs
├── Media/ # Fonts, images, default profiles
├── HSUI.json # Plugin manifest
├── changelog.md # Version history
└── README.md
Credits
- DelvUI — Original design and inspiration
- KamiToolKit — UI framework
- FFXIVClientStructs — Game data structures
- Dalamud — Plugin framework
License
HSUI is a derivative of DelvUI and is licensed under the GNU Affero General Public License v3 (AGPL-3.0). See the LICENSE file for the full text.
- DelvUI — Original work (Copyright © 2021 JD Smith), AGPL-3.0
- MOActionPlugin — Code used in InputsHelper (GPL-3.0). See file headers for notices.