Enhance your Minecraft experience with a powerful RPG-style title system that allows players to earn, manage, and display custom titles both above their heads and in chat — now with automatic title rewards based on in‑game actions and preset export/import for easy setup transfer.
Perfect for RPG servers, roleplay, factions, progression-based gameplay, or any server that wants more identity and immersion.

---

✨ Features

• Fully custom player titles – titles are not hardcoded and can be any text
• Players can own multiple titles and choose one active title
• Titles support spaces and Minecraft color codes (§ or &)
• Titles are displayed above player names in-game
• Titles can optionally appear as chat prefixes
• Each title can have a custom description (shown on hover in chat)
• Titles and selections are saved persistently (survive relogs and restarts)
• Fully customizable chat format with placeholders
• Automatic title rewards based on actions (kills, blocks, exploration, level, deaths, fishing)
• Unique "first player only" titles
• Personal sound feedback when a title is unlocked
• Export/Import presets – save and share title collections and auto-rules
• Works in singleplayer and multiplayer (server-friendly)

---

⚡ Automatic Title Rules

Admins can create auto‑title rules either in‑game via commands or directly in the server config:
mmorpgtitles_auto_titles.json

Each rule tracks per‑player progress and rewards a title once.
Unique rules can be set so only the first player on the server can claim the title.

Supported conditions:

• Kill players (optional weapon filter)
• Kill mobs (by entity id, optional weapon filter)
• Break blocks
• Visit dimension / biome / structure
• Reach XP level
• Death count
• Fishing count

Chat notification on auto‑grant can be toggled in the config.

---

📝 Title Descriptions

Each title can have an optional description, for example:

"Granted for killing a legendary boss"
"Reward for completing a dungeon"

When chat prefixes are enabled, hovering over a title in chat will display its description.
Perfect for achievements, lore, or progression systems.

---

💬 Chat Integration

• Titles can be displayed as chat prefixes
• Chat prefix system can be enabled or disabled globally by admins
• Chat formatting is fully server-controlled when enabled
• Hovering over titles in chat shows their description
• Clean rendering without duplicated player names

---

🧩 Custom Chat Format

The chat format is fully configurable using placeholders:

• {title} – player's active title (with hover description)
• {player} – player name
• {message} – chat message content

Default format:
[{title}] <{player}>: {message}

Admins can view or change the format directly in-game.
If chat prefixes are disabled, the server automatically falls back to vanilla chat formatting.

---

💾 Preset Export/Import

New feature! Players and admins can now save and share complete title setups:

Export a preset:
/rtitle export

Saves all your granted titles and all server auto-title rules to a JSON file in the mmorpgtitles_data/ folder.
A clickable link in chat takes you directly to the export folder.

Import a preset:
/rtitle import

Loads all titles and rules from a saved preset.
Auto-completion suggests available preset files.

Perfect for: • Setting up titles in singleplayer and transferring them to a multiplayer server • Backing up custom title collections • Sharing preset configs with other server admins • Quick server setup and migration

---

🎮 Commands

Admin Commands

/rtitle grant ""<br>Grants a custom title to a player.</p> <p>/rtitle grant <player> "<title>" desc <description><br>Grants a custom title with an optional description (shown on hover in chat).</p> <p>/rtitle revoke <player> "<title>"<br>Removes a title from a player</p> <p>/rtitle set <player> <title><br>Sets one of the player's owned titles as their active title.<br>Tab-completion suggests only titles that the target player actually owns.</p> <p><strong>Auto‑title rules:</strong></p> <p>/rtitle add "<title>" desc "<description>" kill 5<br>/rtitle add "<title>" desc "<description>" kill_mob minecraft:slime 5<br>/rtitle add "<title>" desc "<description>" break_block minecraft:diamond_ore 10<br>/rtitle add "<title>" desc "<description>" visit_biome minecraft:plains<br>/rtitle add "<title>" desc "<description>" visit_structure minecraft:village<br>/rtitle add "<title>" desc "<description>" reach_level 30<br>/rtitle add "<title>" desc "<description>" deaths 10<br>/rtitle add "<title>" desc "<description>" fish 20<br>(Add unique at the end to make it first‑player only.)</p> <p>/rtitle rules list<br>Lists all auto‑rules</p> <p>/rtitle rules remove <id><br>Removes a rule</p> <p>/rtitle rules reload<br>Reloads rules from config</p> <p>/rtitle chatprefix on<br>Enables title prefixes in chat</p> <p>/rtitle chatprefix off<br>Disables title prefixes in chat</p> <p>/rtitle chatformat<br>Shows the current chat format and available placeholders</p> <p>/rtitle chatformat <format><br>Sets a new chat format.<br>Available placeholders: {title}, {player}, {message}.<br>If a player has no active title, the title part is automatically hidden.</p> <p>/rtitle export <name><br>Saves all player titles and server rules to a preset file in the <code>mmorpgtitles_data/</code> folder.<br>A clickable link in chat takes you directly to the export folder.</p> <p>/rtitle import <name><br>Loads all titles and rules from a saved preset.<br>Auto-completion suggests available preset files.</p> <h3><strong>Player Commands</strong></h3> <p>/rtitle display <title><br>Sets one of your owned titles as active</p> <p>/rtitle hide<br>Hides your active title</p> <p>/rtitle list<br>Shows all titles you own</p> <hr> <h1><strong>🎨 Color & Formatting</strong></h1> <p>Titles support Minecraft formatting codes using & or §:</p> <p>• &1 Dark Blue<br>• &4 Dark Red<br>• &e Yellow<br>• &l Bold<br>• &o Italic<br>• &n Underline</p> <p>Examples:</p> <p>&6[&eKing&6] → [King] (gold/yellow)<br>&cHero &7of &aNature → Hero of Nature<br>&9★ &bMage &9★ → ★ Mage ★</p> <hr> <h1><strong>🔧 Compatibility</strong></h1> <p>• Minecraft 1.21.1 (NeoForge)<br>• Client & Server compatible<br>• Works in singleplayer and multiplayer<br>• Designed to work alongside other mods</p>