QuestLines Titles

How It Works

QuestLineTitles maintains two stores: a server-wide title catalogue (titles.json) that defines every available title, and per-player title data that records which titles each player has unlocked and which one is currently active.

Titles are awarded through QuestLines actions (giveTitle:), admin commands (/titleadmin grant), or directly via the developer API. Once a player owns at least one title they can open /title to browse their collection and set an active title. The active title is then exposed to chat plugins and PlaceholderAPI.

titles.json

All available titles are defined in mods/QuestLineTitles/titles.json. The file is created with a set of defaults on first start and can be edited directly or updated via /titleadmin. Reload with /titleadmin reload to pick up file changes without restarting.

Each entry is keyed by a unique title ID (convention: category:name) and carries a category string and a value display string. The display string supports rich formatting — see Title Formatting below.

{
  "misc:newcomer": {
    "category": "misc",
    "value":    "&3Newcomer"
  },
  "misc:king": {
    "category": "misc",
    "value":    "{#FFAA00}{b}King{/}{/}"
  },
  "pvp:champion": {
    "category": "pvp",
    "value":    "<gradient:#FF4444:#FFAA00>Champion</gradient>"
  },
  "builder:artisan": {
    "category": "builder",
    "value":    "<rainbow>Artisan</rainbow>"
  }
}

Title Formatting

Title values support three overlapping formatting syntaxes. All three are parsed by the same formatter and can be mixed freely in a single value string.

Brace Tags

XML-style Tags

&-Codes

Standard Minecraft &X codes are supported. A color code resets all active formatting before applying the new color.

// &-code color + bold
"&6&lLegend"

// Brace-tag hex color with bold
"{#FFAA00}{b}King{/}{/}"

// XML gradient
"<gradient:#FF4444:#FFAA00>Champion</gradient>"

// Tags can nest freely
"{b}{#FF55FF}Grand{/} Explorer{/}"

Commands

Player Commands

Admin Commands

All /titleadmin subcommands require the questlinetitles.titleadmin permission.

QuestLines Integration

When QuestLines Core is installed alongside QuestLineTitles, the following actions, requirements, and text variables are automatically registered with the QuestLines engine.

Actions

Requirements

Text Variable

// Quest response action: award a title on quest completion
"Actions": [
  "questCompleted:dragon_slayer",
  "giveTitle:pvp:dragonslayer",
  "message:You earned the title: {title}!"
]

// Requirement: only show page if player has the title
"Requirements": [ "hasTitle:pvp:dragonslayer" ]

Integrations

VaultUnlocked

When VaultUnlocked is installed, QuestLineTitles registers as a ChatUnlocked provider. Chat plugins that consume VaultUnlocked’s chat API will automatically receive the player’s active title as a chat prefix. No additional configuration is required.

PlaceholderAPI

When PlaceholderAPI is installed, QuestLineTitles registers the title expansion. Use %title% in any PlaceholderAPI-aware plugin (e.g. a chat formatter) to insert the player’s active title. The returned value has {…} formatting tags stripped but retains &-codes and §-codes for downstream color-code processing.

File Layout

Permissions