Configuration
The configuration file for Nexal Titles. Located at plugins/Nexal Titles/config.yml.
config.yml
# Nexal Titles Configuration
# Storage settings
storage:
type: json # json or sql
sql:
host: localhost
port: 3306
database: minecraft
username: root
password: ""
# Achievement tracking settings
achievements:
# Enable tracking of player statistics for unlocking achievement-based titles
enabled: true
# How often (in ticks) to save player statistics and add the current session to playtime,
# which also unlocks playtime titles such as Veteran (20 ticks = 1 second). Statistics are
# saved when a player leaves and when the server stops as well.
save-interval: 1200 # Every 60 seconds
# Title display settings
display:
# Show title prefix in chat messages
chat-prefix: true
# Show title above player's head using scoreboard teams
above-head: true
# Where the title goes around the name above heads: prefix, suffix or both
above-head-format: prefix
# Maximum visible characters of a title above heads. Colour codes do not count; 0 = no limit
max-length: 16
# Economy settings (requires Vault)
economy:
# Enable purchasing titles with economy
enabled: true
# How prices are shown, in the GUI, messages and placeholders. %amount% is the number
price-format: "$%amount%"
# The number, as a Java DecimalFormat pattern: , groups thousands, .00 gives two decimals
number-format: "#,##0.00"
# Leave out the decimals of whole amounts: $1,000 rather than $1,000.00 (but $1,000.50)
hide-zero-decimals: true
# Permission-based titles
permission-titles:
# Automatically grant permission-based titles when players join
auto-grant: true
# Check interval (in ticks) for permission changes
check-interval: 6000 # Every 5 minutes
# Title categories and their display order in GUI
categories:
- STARTER
- ACHIEVEMENT
- PURCHASE
- VIP
- EVENT
- SPECIAL
- ADMIN
# Define all available titles
#
# description: optional free text shown with the title in /titles (locked or not), in the chat
# hover on Paper and in %titles_description%. One line, or a list of lines; MiniMessage or &
# colour codes. Write what you like: lore, memes, who won it and when.
# requirement.display: optional, how the requirement reads to players ("Defeat the Ender
# Dragon"). Without it, advancement and rank titles show the first description line.
titles:
# Starter titles (free for everyone)
newbie:
display-name: "&7Newbie"
description:
- "<gray>Everyone starts somewhere.</gray>"
- "<gray>Some are still looking for their first tree.</gray>"
category: STARTER
rarity: COMMON
requirement:
type: NONE # No requirement, everyone has access
adventurer:
display-name: "&aAdventurer"
description: "&7A brave soul"
category: STARTER
rarity: COMMON
requirement:
type: NONE
# Achievement-based titles
warrior:
display-name: "&cWarrior"
description: "&7Kill 100 players"
category: ACHIEVEMENT
rarity: UNCOMMON
requirement:
type: ACHIEVEMENT
achievement: PLAYER_KILLS
amount: 100
slayer:
display-name: "&4&lSlayer"
description: "&7Kill 500 players"
category: ACHIEVEMENT
rarity: RARE
requirement:
type: ACHIEVEMENT
achievement: PLAYER_KILLS
amount: 500
veteran:
display-name: "&6Veteran"
description: "&7Play for 100 hours"
category: ACHIEVEMENT
rarity: UNCOMMON
requirement:
type: ACHIEVEMENT
achievement: PLAYTIME
amount: 360000 # 100 hours in seconds
miner:
display-name: "&7&lMiner"
description: "&7Mine 10,000 blocks"
category: ACHIEVEMENT
rarity: UNCOMMON
requirement:
type: ACHIEVEMENT
achievement: BLOCKS_MINED
amount: 10000
builder:
display-name: "&e&lBuilder"
description: "&7Place 10,000 blocks"
category: ACHIEVEMENT
rarity: UNCOMMON
requirement:
type: ACHIEVEMENT
achievement: BLOCKS_PLACED
amount: 10000
hunter:
display-name: "&2Hunter"
description: "&7Kill 1,000 mobs"
category: ACHIEVEMENT
rarity: UNCOMMON
requirement:
type: ACHIEVEMENT
achievement: MOBS_KILLED
amount: 1000
# Vanilla advancement-based titles
dragon_slayer:
display-name: "&5&lDragon Slayer"
description:
- "<dark_purple>Few who enter the End return.</dark_purple>"
- "<dark_purple>Fewer return with its breath in a bottle.</dark_purple>"
category: ACHIEVEMENT
rarity: EPIC
requirement:
type: ADVANCEMENT
advancement: minecraft:end/kill_dragon
display: "Defeat the Ender Dragon"
wither_killer:
display-name: "&8&lWither Killer"
description: "&7Summon and defeat the Wither"
category: ACHIEVEMENT
rarity: EPIC
requirement:
type: ADVANCEMENT
advancement: minecraft:nether/summon_wither
beacon_master:
display-name: "&b&lBeacon Master"
description: "&7Construct and place a beacon"
category: ACHIEVEMENT
rarity: RARE
requirement:
type: ADVANCEMENT
advancement: minecraft:nether/create_beacon
elytra_pilot:
display-name: "&f&lElytra Pilot"
description: "&7Find elytra in the End"
category: ACHIEVEMENT
rarity: RARE
requirement:
type: ADVANCEMENT
advancement: minecraft:end/elytra
# Purchasable titles
rich:
display-name: "&6&lRich"
description: "&7Show off your wealth"
category: PURCHASE
rarity: UNCOMMON
requirement:
type: PURCHASE
price: 10000
tycoon:
display-name: "&e&l&oTycoon"
description: "&7Rolling in money"
category: PURCHASE
rarity: RARE
requirement:
type: PURCHASE
price: 50000
millionaire:
display-name: "&6&l&oMillionaire"
description: "&7Money is no object"
category: PURCHASE
rarity: EPIC
requirement:
type: PURCHASE
price: 100000
# Permission-based titles (VIP)
vip:
display-name: "&a&lVIP"
description: "&7Very Important Player"
category: VIP
rarity: RARE
requirement:
type: PERMISSION
permission: nexaltitles.title.vip
mvp:
display-name: "&b&lMVP"
description: "&7Most Valuable Player"
category: VIP
rarity: EPIC
requirement:
type: PERMISSION
permission: nexaltitles.title.mvp
legend:
display-name: "&d&lLEGEND"
description: "&7A true legend"
category: VIP
rarity: LEGENDARY
requirement:
type: PERMISSION
permission: nexaltitles.title.legend
# Event titles: nobody has the node, so they are handed out with /titles admin grant
season3_champion:
display-name: "&6&lS3 Champion"
description:
- "<gold>Winner of Season 3</gold>"
- "<gray>Crowned on 30 June 2026</gray>"
category: EVENT
rarity: LEGENDARY
requirement:
type: PERMISSION
permission: nexaltitles.title.season3champion
display: "Win Season 3"
lag_survivor:
display-name: "&8Lag Survivor"
description:
- "<gray>Was online for the Great Lag Spike</gray>"
- "<gray>of 14 March 2026. We don't talk about it.</gray>"
category: SPECIAL
rarity: RARE
requirement:
type: PERMISSION
permission: nexaltitles.title.lagsurvivor
display: "Be online for the Great Lag Spike"
# Admin/Special titles
admin:
display-name: "&4&lADMIN"
description: "&7Server Administrator"
category: ADMIN
rarity: LEGENDARY
requirement:
type: PERMISSION
permission: nexaltitles.title.admin
developer:
display-name: "&3&lDEV"
description: "&7Plugin Developer"
category: ADMIN
rarity: LEGENDARY
requirement:
type: PERMISSION
permission: nexaltitles.title.developer
# Rarity colors (used in GUI)
rarity-colors:
COMMON: "&7"
UNCOMMON: "&a"
RARE: "&9"
EPIC: "&5"
LEGENDARY: "&6"
Configuration Options
Below is a reference of the main configuration sections:
storage
Nexal Titles Configuration
Storage settings
achievements
Achievement tracking settings
display
Title display settings
economy
Economy settings (requires Vault)
permission-titles
Permission-based titles
categories
Title categories and their display order in GUI
titles
Define all available titles
description: optional free text shown with the title in /titles (locked or not), in the chat hover on Paper and in %titles_description%. One line, or a list of lines; MiniMessage or & colour codes. Write what you like: lore, memes, who won it and when. requirement.display: optional, how the requirement reads to players ("Defeat the Ender Dragon"). Without it, advancement and rank titles show the first description line.
rarity-colors
Rarity colors (used in GUI)