promotional bannermobile promotional banner
premium banner
Custom command aliases and a commands browser UI for Hytale, built on TaleLib.

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

  • /ucc management command (reload + UI)

  • /commands UI 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

  • /commands or /c
    Open commands browser UI


🔐 Permissions

All permissions use the unio.ucc prefix:

  • unio.ucc.ucc — Use /ucc

  • unio.ucc.commands — Use /commands and /c

  • unio.ucc.<alias> — Use a specific alias

  • unio.ucc.* — Full access to all UnioCustomCommands permissions


📥 Installation

  1. Download the latest UnioCustomCommands.jar file

  2. Place the jar file into your server’s mods folder

  3. Start or restart the server

Configuration files will be generated automatically on first launch.


💡 Tips

  • Use /commands to browse commands and click to paste them into chat

  • Use /ucc ui to manage aliases in real time

  • If you edit the config manually, always run /ucc reload


🧩 Dependencies