Extended Hotbar

A Hytale server plugin that extends the hotbar system to support multiple switchable hotbars with customizable names.

Update for Hytale Update 3 (v0.3.17)

Overview

Extended Hotbar gives players up to 9 switchable hotbars (81 total slots!) with custom naming and a graphical interface for easy management. Perfect for organizing different gameplay styles like combat, building, mining, and more.

Key Features

✓ Multiple Hotbars - Up to 9 switchable hotbars per player
✓ Custom Names - Organize with names like "Combat", "Building", "Mining"
✓ Graphical UI - Easy-to-use visual hotbar manager
✓ Persistent Storage - All hotbars saved automatically per-player
✓ Server Configurable - Admins control hotbar counts and slot limits
✓ Permission Support - Fine-grained access control for commands

Quick Start

1. Place the JAR file in your server's mods/ directory
2. Restart the server (config auto-generates)
3. Players use /hbm to open the hotbar manager
4. Click hotbars to switch, rename them as needed

Commands

/hotbar - Main Hotbar Command

Examples:

/hotbar --number 2

/hotbar --name Combat

/hotbar --setname "Base Building"

/hotbarmenu or /hbm - Graphical Interface

Opens the Hotbar Manager UI with visual controls:

• View all your hotbars at a glance (Currently displays name and index)
• Click to switch between hotbars instantly
• Rename hotbars using the built-in input field
• Clear hotbar names when needed

GUI Overhaul, added ItemStacks (v0.3.15)

Installation

1. Download the plugin JAR file
2. Place it in your server's mods/ directory
3. Restart or start your server
4. Configuration file auto-generates on first run

Configuration

Config File Location

mods/Ghraken_ExtendedHotbar/config.json

Default Configuration

{
  "MaxSlotsPerHotbar": 9,
  "MaxHotbarCount": 9,
  "DefaultSlotsPerHotbar": 9,
  "DefaultHotbarCount": 9
}

Configuration Settings

Recommended Settings

Note: Future versions will extend the game UI for additional slots. For now:

• Keep MaxSlotsPerHotbar at 9 (matches vanilla UI)
• Adjust MaxHotbarCount between 1-9 based on preference

Permissions

Available Permissions

Managing Permissions

All permissions default to allowed for all players.

To revoke access:

/perm user remove {uuid} -extendedhotbar.command.hotbar

/perm user remove {uuid} -extendedhotbar.command.hotbarmenu

To restore access:

/perm user add {uuid} -extendedhotbar.command.hotbar

/perm user add {uuid} -extendedhotbar.command.hotbarmenu

How It Works

Hotbar Synchronization

• Your in-game hotbar is always synced with the active extended hotbar
• Switching hotbars saves current items and loads the new hotbar's contents
• The game manages the active hotbar; this plugin adds multiple hotbar support

Data Persistence

• Automatic saving when switching hotbars
• Empty slots preserved for sparse hotbar layouts
• All data stored per-player in JSON format

Naming Conventions

Underscores: Multi-word names using underscores
Example: Combat_Gear displays as "Combat_Gear"

Spaces: Supported with quotes in commands
Example: /hotbar --setname "Base Building"

Note: The UI handles spaces automatically when renaming via /hotbarmenu or /hbm

Player Data Storage

Storage Location

Local instances - data will be stored in the world mods

UserData\Saves\{world}\mods\Ghraken_ExtendedHotbar\playerdata\{uuid}.json

Dedicated servers - data will be saved in the server mods

\mods\Ghraken_ExtendedHotbar\playerdata\{uuid}.json

Stored Data

Each player's JSON file contains:

• Hotbar contents - Item IDs and quantities for all inactive hotbars
• Custom names - All hotbar name assignments
• Active selection - Currently selected hotbar number

Releases

• 0.1.20 - Initial chat command release - Hotbar management using slash commands
• 0.2.12 - Added GUI /hotbarmenu - Hotbar management interface and additional commands
• 0.2.39 - Major GUI overhaul - Refactored to use Pages and import styles from base game
• 0.3.15 - Added ItemStacks to the GUI - Items on each hotbar can now be seen in the GUI
• 0.3.17 - Resolve server version target warning - Compatibility fix for Update 3