Description
🔹 UnioCustomCommands
UnioCustomCommands is a lightweight yet powerful command alias system and commands browser UI for Hytale, built on TaleLib.
It allows server owners to create custom command aliases, manage them in-game via UI, and provide players with a clean, organized command browser to easily access and use commands without confusion.
🎯 Purpose & Background
UnioCustomCommands was originally developed for the Uniotale Hytale Server to solve a core usability problem:
Players struggle to find and use commands efficiently.
Hytale’s default /help screen is often cluttered with hundreds of commands, many of which are irrelevant to players. This creates confusion, slows gameplay, and forces players to memorize or type long command chains.
The main goals of this plugin are:
-
Give players a single, clean screen where they can access all relevant commands
-
Shorten long or complex commands using aliases
-
Prevent players from wasting time typing long commands in chat
Instead of /help, which is crowded and hard to navigate, this plugin provides a simple, elegant, and functional command UI designed for real gameplay usage.
🌍 Free & Open Usage
Although this plugin was developed specifically for the Uniotale Hytale Server, it is released for all Hytale server owners to use.
-
Lifetime free license
-
No restrictions
-
No server lock-in
-
Free for commercial and community servers
Anyone can install and use UnioCustomCommands to improve player experience and command usability.
✨ Features
-
Create custom command aliases
-
Supports multi-word aliases
-
Automatically forwards all arguments to the target command
-
Built-in permissions per alias
-
/uccmanagement command (reload + UI) -
/commandsUI to browse available commands -
In-game UI editor for aliases (
/ucc ui) -
Alias self-loop protection
-
Uses Hytale Common UI assets for a native look & feel
🖥️ User Interface
UnioCustomCommands includes multiple in-game UIs built with Hytale Common UI assets, providing a clean and native experience.
📋 Commands Browser UI
Browse all available commands in a categorized interface and click to send them directly to chat.
⬇️ Screenshot: Commands Browser UI
Features:
-
Automatic command categorization
-
Clean, readable command cards
-
Click-to-send interaction
-
Alias-aware display (aliases shown instead of original commands)
🔍 Example Categories
-
Island — island and Skyblock-related commands
-
Economy — money, trade, and shop commands
-
Teleport — movement and warp commands
-
Utility — general-purpose server commands
For example, on a Skyblock server, all island-related commands are automatically grouped under the Island category.
✏️ Alias Manager UI
Create, edit, and manage command aliases directly in-game, without restarting the server.
⬇️ Screenshot: Alias Manager UI
Features:
-
List all registered aliases
-
Add new aliases directly in-game
-
Edit target commands and descriptions
-
UI-based workflow via
/ucc ui
🧩 Alias Editor UI
Edit individual aliases using a dedicated UI screen.
⬇️ Screenshot: Alias Editor UI
Features:
-
Modify command targets
-
Update alias descriptions
-
Built-in validation and self-loop protection
🎨 UI Design Notes
-
Uses Hytale Common UI styling
-
Clean layout with consistent spacing
-
Designed for readability and speed
-
Optimized for real in-game usage
⚙️ Configuration & Alias Management
Aliases can be managed in two different ways:
✅ Recommended: In-Game UI
The primary and recommended way to manage aliases is through the in-game UI:
-
Add, edit, and remove aliases instantly
-
No server restart required
-
Safer and faster workflow for live servers
Use:
-
/ucc ui— open the alias manager UI
⚙️ Advanced: config.json
For advanced users, aliases can also be edited manually via config.json.
The file is generated automatically on first run.
Example config.json
{
"aliases": {
"example alias": {
"command": "target command",
"description": "Description of your command"
},
}
}
Notes:
-
Aliases are matched by the longest command key
(multi-word aliases supported) -
If an alias exists, the alias is shown instead of the original command in the UI
-
Alias descriptions fall back to the target command’s description when available
-
After manual edits, run
/ucc reload
🧭 Commands
-
/ucc reload
Reload configuration and register aliases -
/ucc ui
Open alias manager UI -
/commandsor/c
Open commands browser UI
🔐 Permissions
All permissions use the unio.ucc prefix:
-
unio.ucc.ucc— Use/ucc -
unio.ucc.commands— Use/commandsand/c -
unio.ucc.<alias>— Use a specific alias -
unio.ucc.*— Full access to all UnioCustomCommands permissions
📥 Installation
-
Download the latest UnioCustomCommands
.jarfile -
Place the jar file into your server’s
modsfolder -
Start or restart the server
Configuration files will be generated automatically on first launch.
💡 Tips
-
Use
/commandsto browse commands and click to paste them into chat -
Use
/ucc uito manage aliases in real time -
If you edit the config manually, always run
/ucc reload
🧩 Dependencies
-
TaleLibs (required)



