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