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 "