premium banner

Data's Ranks

custom ranks for Hytale, with a user interface, and configuration

Description

✨ Overview

Data’s Ranks is a fully-featured rank management plugin built for modern Hytale servers.
It includes a clean in-game UI, flexible configuration, live editing, and a developer API for integration with other plugins.

Whether you're running a small community server or a large network, Data’s Ranks gives you full control over your server hierarchy.

⭐ Features

In-Game Rank Manager

  • Create, edit, and delete ranks directly in-game
  • Assign ranks to players instantly
  • No restarts required
  • Live preview system

Custom Rank Colours

  • Supports full hex colour codes and gradients
  • Chat
  • Player list
  • Character name
  • Name coloring

Permission System

  • Assign permissions per rank
  • Simple comma-separated format
  • Supports staff, donors, and progression ranks

Visibility Controls

Each rank can control where it appears:

  • Chat
  • Player list
  • Character
  • Name coloring

Config-Based Backend

  • JSON-based config files
  • Easy backups and migration
  • Safe live-reload support

Event & Notification System

  • Optional rank change event titles
  • Optional notification panel
  • Placeholder support (%rank%, %player%)

🖥 In-Game UI

The Rank Manager UI includes:

  • Player selector with pagination
  • Rank editor panel
  • Rank preview system
  • Multi-select rank assignment
  • Confirmation overlay

🚀 Getting Started

  1. Drop the plugin into your server

  2. Start the server

  3. Run **/rank** (requires OP or **rank-admin** permission)

Create your ranks, assign permissions, and you're ready to go.

⚙ Configuration

Placeholders:

  • %rank% — Player’s rank
  • %player% — Player’s name

Config options:

  • ShowEventTitle
  • EventTitleTextFirstLine
  • EventTitleTextSecondLine
  • ShowNotificationPanel
  • NotificationPanelTextFirstLine
  • NotificationPanelTextSecondLine

🔌 Developer API

 I've included an informal integration API for other plugins.

  • Add the plugin JAR as a dependency
  • Access ranks via com.ranks.Main.rankConfig.get()
  • Listen for PlayerRankUpdateEvent

Perfect for:

  • Chat plugins
  • Economy plugins
  • Factions plugins
  • Minigame plugins

🛠 Planned Features

  • Rank icons & badges
  • In-world rank display

📌 Beta Release

This is currently a beta version.
Core systems are stable and production-ready, but new features are actively being added.

Feedback and bug reports are welcome.