QuestLines Titles

🔵 Discord ☕ Ko-fi ⭐ Patreon 📖 Wiki

QuestLines Titles

QuestLines Titles is a fully standalone player title system for Hytale servers. Players earn and collect cosmetic titles — shown in chat, above their name, on the world map, or wherever your chat formatter pulls from — and browse and equip them through a native in-game UI.

No other plugins are required. If you also run the QuestLines quest plugin, Titles hooks in automatically for quest-driven title rewards and requirements — but that integration is entirely optional.

Features

Title system

• Define as many titles as you want in a simple titles.json config
• Organize titles into categories (pvp, builder, misc) for clean grouping in the UI
• Rich inline formatting: hex colors ({#RRGGBB}), bold ({b}), italic ({i}) and more
• A configurable default title for players who have none, and an option to require a title always be worn

Rank titles

A second, separate slot for staff and donor badges. Ranks are worn automatically and exposed as their own {rank} placeholder, so a player's chosen title keeps showing in chat while their rank badge sits alongside it. Players holding more than one rank pick which shows with /title rank.

Nameplates and map markers

The nameplate layout is configurable — the divider and what sits in front of a player's name — including which wins when a player has both a rank and a title. Active titles can also be shown on the player's world-map marker.

Player experience

• /title — in-game selection UI to browse unlocked titles and set one active
• Titles are previewed with full formatting before equipping
• Players can clear their active title at any time
• Optional confirmation click and an optional cooldown between changes, to stop spam-switching

Admin tools

• /titleadmin grant — unlock a title for a player
• /titleadmin remove — revoke a title
• /titleadmin list — titles a player has unlocked
• /titleadmin available — every title defined on the server
• /titleadmin ui — admin management UI

Granting a title to a player who has never joined is held as a pending record and applied on their first connect.

Storage

Player title data is keyed by UUID, so it survives renames. Choose your backend in config.json:

• file (default) — per-player JSON, no database needed
• SQLite
• MySQL / MariaDB — share one database with the rest of the QuestLines suite

Switching from the file backend to a database imports each player's existing data on their next join. There is no manual migration step.

PlaceholderAPI Integration

Titles registers a PlaceholderAPI expansion automatically when PAPI is installed, exposing the player's active title to any PAPI-compatible chat formatter.

Placeholders: %title% and %rank%. Use them in your chat format like this:

[%title%] %player_name%: %message%

If a player has no active title the placeholder returns an empty string — no bracket clutter, no broken format. Values keep their &-codes intact so your chat formatter applies color as normal.

Optional: VaultUnlocked Integration

If VaultUnlocked is installed, Titles registers itself as a ChatUnlocked chat prefix provider, letting compatible chat plugins read the active title directly without PlaceholderAPI.

Optional: QuestLines Integration

With QuestLines installed, Titles registers these automatically:

• Actions — giveTitle: unlocks a title, removeTitle: revokes one
• Requirements — hasTitle: passes if the player owns it, titleActive: if it is equipped
• Text variable — {title} resolves to the player's active title

Configuration

Titles are defined in QuestLinesTitles/titles.json. A default set is generated on first run:

{
  "pvp:warrior":   { "category": "pvp",  "value": "{#FF4444}{b}Warrior{/}{/}" },
  "misc:newcomer": { "category": "misc", "value": "{#55FFFF}Newcomer{/}" }
}

The key is the title ID used in commands and quest actions, category is the grouping shown in the UI, and value is the formatted display text.

The QuestLines Suite

Every plugin works standalone; together they share one ecosystem.

• QuestLines Core — dialogue, quests, requirements, actions
• Icons — floating quest-state icons above NPCs
• Dialog — in-game linear dialogue builder
• Titles — player title and rank rewards (this plugin)
• GUI — custom in-game interfaces, no code required
• Claims — land protection, regions, rent and buy plots
• Denizens — native NPC manager
• Arcade — arcade, board and puzzle games
• Hooks — early plugin unlocking extra quest tracking
• MMO — parties, guilds, dungeons, duels and item sets
• Mimics — chests that stand up and fight
• Nations — cities and nations built on Claims (via Discord)