Ranky

Ranky - Minecraft Title Management Mod

Effortlessly manage server titles with Ranky, a server-side Fabric mod introducing a GUI-based system for unlocking and managing titles via advancements!

# Features: - Chest-Based GUI: Intuitive title selection. - Advancement Unlocks: Earn titles through achievements. - Configurable: Customize titles via JSON. - Pagination Support: Handle large title lists easily. - Server-Side Security: Safe and reliable. - Reload Config: Update titles without restarting. - Aliases: Use `/titles` or `/ranks` to open the GUI.

## Commands: - `/titles` or `/ranks`: Opens the title selection GUI (all players). - `/ranky reload`: Reloads configuration (op level 4).

### Config Example: Located in `config/ranky_titles.json`: ```json [ { "name": "Noob", "command": "say %player% is now a Noob", "item": "minecraft:name_tag", "requirements": [] }, { "name": "Veteran", "command": "say %player% is now a Veteran", "item": "minecraft:diamond", "requirements": ["minecraft:story/mine_diamond"] } ] ```

Fields: - `name`: Title display name. - `command`: Runs when selected (`%player%` = player name). - `item`: GUI button (Minecraft item ID). - `requirements`: List of required advancement IDs.

Common Advancements: - `minecraft:story/mine_diamond`: Acquire diamonds. - `minecraft:nether/find_fortress`: Discover a Nether Fortress. - `minecraft:end/kill_dragon`: Defeat the Ender Dragon.

Adding Titles: 1. Stop the server. 2. Edit `config/ranky_titles.json`. 3. Add new entries. 4. Save and restart or use `/ranky reload`.

Permissions: - `/titles` or `/ranks`: Accessible to all players. - `/ranky reload`: Operator-only.

Make titles an exciting, customizable feature with Ranky!

Here’s an example test configuration for Ranky with LuckPerms support to create a cosmetic rank:

```json [ { "name": "Overlord", "setCommand": "lp user {player} parent add Overlord", "removeCommand": "lp user {player} parent remove Overlord", "item": "minecraft:name_tag", "requirements": [ "dystorian-adventures:cosmeticranks/overlord" ] } ] ```