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:

[  
  {  
    "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:

[
    {
        "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"
        ]
    }
]