  🔵 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 — displayed in chat, above their name, or wherever your chat formatter pulls from — and can browse and equip them through a native in-game UI.

No other plugins are required. QuestLines Titles runs independently out of the box. If you also run the QuestLines quest plugin, it hooks in automatically to give you 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 file
Organize titles into categories (e.g. pvp, builder, misc) for clean grouping in the UI
Titles support rich inline formatting: hex colors ({#RRGGBB}), bold ({b}), italic ({i}), and more
Player title data is stored per-player in individual JSON files — no database required

Player experience
/title — opens an in-game title selection UI where players can browse all their unlocked titles and set one as active
Titles are previewed with full formatting before equipping
Players can clear their active title at any time

Admin tools
/titleadmin grant — unlock a title for a player
/titleadmin remove — revoke a title from a player
/titleadmin list — see all titles a player has unlocked
/titleadmin available — list every title defined on the server
/titleadmin ui — open the admin title management UI

PlaceholderAPI Integration

QuestLines Titles registers a PlaceholderAPI expansion automatically when PAPI is installed. This exposes the player's currently active title as a placeholder that any PAPI-compatible chat formatter (e.g. EliteEssentials, EssentialsChat, DeluxeChat) can use.

Placeholder: %title%

Use it 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. The value is returned with &-codes intact so your chat formatter applies color as normal.

Optional: VaultUnlocked Integration

If VaultUnlocked is installed, QuestLines Titles registers itself as a ChatUnlocked chat prefix provider. This lets VaultUnlocked-compatible chat plugins read the player's active title directly without needing PlaceholderAPI at all.

Optional: QuestLines Integration

When the QuestLines quest plugin is also installed, Titles registers the following extras automatically:

Actions (trigger from any quest response or dialogue page):

giveTitle: — unlock a title for the player
removeTitle: — revoke a title from the player

Requirements (gate responses or pages behind title ownership):
hasTitle: — passes if the player owns the title
titleActive: — passes if the player currently has the title equipped

Text variable (use in dialogue or quest text):
{title} — replaced with the player's active title (plain text), or empty if none set

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.