config.yml
Default config.yml
#
# xBattlepass Configuration
# by Exanthiax, _OfTeN_, Auxilor
#
# The amount of time (in milliseconds) that the GUI icons should be cached for
# Prevents spamming the GUI to cause lag
gui-cache-ttl: 1000
# GUI Configuration for the Battlepass GUI (/battlepass)
battlepass-gui:
title: "xBattlepass"
mask:
# The way the mask works is by having a list of materials
# And then a pattern to use those materials.
# The pattern is the rows in the GUI
# Each line must be 9 long, and the amount of rows should be the amount of rows in the GUI
# A zero represents nothing
# A 1 represents the first material
# A 2 represents the second material
# And so on, you can add up to 9.
materials:
- black_stained_glass_pane
pattern:
- "111111111"
- "111010111"
- "111111111"
buttons:
tiers:
item: lime_stained_glass_pane
name: "&aTiers"
lore:
- ""
- "&aLeft click &7to see"
- "&7your battlepass progression"
- "&7and claim rewards"
- ""
location:
row: 2
column: 4
quests:
item: orange_stained_glass_pane
name: "&6Quests"
lore:
- ""
- "&6Left click &7to see"
- "&7all available quests"
- "&7and your progression"
- ""
location:
row: 2
column: 6
# Custom GUI slots; see here for a how-to: https://plugins.auxilor.io/all-plugins/custom-gui-slots
custom-slots: [ ]
# GUI Configuration for the Tiers GUI (/battlepass tiers)
tiers-gui:
title: "xBattlepass: Tiers"
mask:
# The way the mask works is by having a list of materials
# And then a pattern to use those materials.
# The pattern is the rows in the GUI
# Each line must be 9 long, and the amount of rows should be the amount of rows in the GUI
# A zero represents nothing
# A 1 represents the first material
# A 2 represents the second material
# And so on, you can add up to 9.
materials:
- black_stained_glass_pane
pattern:
- "111111111"
- "111111111"
- "111111111"
- "111111111"
- "111111111"
- "111111111"
progression-pattern:
# To set the order of the pattern,
# Use 1-9 and then a-z: a goes after 9.
- "109ab0jkl"
- "2080c0i0m"
- "3070d0h0n"
- "4560efg0o"
- "00000000p"
- "00000000q"
buttons:
# The amount of the item as a function of the level
item-amount: "%level%"
# For example, increasing every 10 levels would be "ceil((%level% + 1) / 10)"
# The value is always rounded down.
prev-page:
material: arrow
name: "&fPrevious Page"
location:
row: 6
column: 4
next-page:
material: arrow
name: "&fNext Page"
location:
row: 6
column: 6
close:
material: barrier
name: "&cClose"
location:
row: 6
column: 5
free-rewards-format: "&8»&r &9%reward%"
premium-rewards-format: "&8»&r &6%reward%"
empty-rewards-format: ""
unlocked:
item: lime_stained_glass_pane
name: "&aTier %tier_numeral%"
lore:
- "&7Rewards:"
- "%free-rewards%"
- "%premium-rewards%"
- ""
- "&aCLAIM"
in-progress:
item: yellow_stained_glass_pane
name: "&eTier %tier_numeral%"
lore:
- "&7Rewards:"
- "%free-rewards%"
- "%premium-rewards%"
- ""
- "&fProgress:"
- "&8» &e%percentage_progress%%"
- "&8» &e%current_bp_xp%&8/&7%required_bp_xp% &fXP"
locked:
item: red_stained_glass_pane
name: "&cTier %tier_numeral%"
lore:
- "&7Rewards:"
- "%free-rewards%"
- "%premium-rewards%"
- ""
- "&cLOCKED"
claimed:
item: green_stained_glass_pane glint
name: "&aTier %tier_numeral%"
lore:
- "&7Rewards:"
- "%free-rewards%"
- "%premium-rewards%"
- ""
- "&aCLAIMED"
# Custom GUI slots; see here for a how-to: https://plugins.auxilor.io/all-plugins/custom-gui-slots
custom-slots: [ ]
# GUI Configuration for the Categories GUI (/battlepass quests)
categories-gui:
title: "&8Categories: %page%"
mask:
# The way the mask works is by having a list of materials
# And then a pattern to use those materials.
# The pattern is the rows in the GUI
# Each line must be 9 long, and the amount of rows should be the amount of rows in the GUI
# A zero represents nothing
# A 1 represents the first material
# A 2 represents the second material
# And so on, you can add up to 9.
materials:
- black_stained_glass_pane
pattern:
# For this GUI, "c" represents a slot for a category.
# Categories are sorted in the order they are in the categories.yml file.
- "111111111"
- "1c1c1c1c1"
- "1111c1111"
- "111111111"
- "111111111"
next-page:
item:
active: orange_stained_glass_pane name:"&aNext page"
inactive: gray_stained_glass_pane
lore:
active: [ ]
inactive: [ ]
row: 5
column: 6
prev-page:
item:
active: orange_stained_glass_pane name:"&aPrevious page"
inactive: gray_stained_glass_pane
lore:
active: [ ]
inactive: [ ]
row: 5
column: 4
# Custom GUI slots; see here for a how-to: https://plugins.auxilor.io/all-plugins/custom-gui-slots
custom-slots: [ ]
# GUI Configuration for the Quests GUI
quests-gui:
title: "%category%: %page%"
mask:
# The way the mask works is by having a list of materials
# And then a pattern to use those materials.
# The pattern is the rows in the GUI
# Each line must be 9 long, and the amount of rows should be the amount of rows in the GUI
# A zero represents nothing
# A 1 represents the first material
# A 2 represents the second material
# And so on, you can add up to 9.
materials:
- black_stained_glass_pane name:" "
pattern:
# For this GUI, "q" represents a slot for a quest.
# Quests are sorted in the order they are in the categories.yml file.
- "111111111"
- "1q1q1q1q1"
- "11q1q1q11"
- "111111111"
- "111111111"
next-page:
item:
active: orange_stained_glass_pane name:"&aNext page"
inactive: black_stained_glass_pane name:" "
lore:
active: [ ]
inactive: [ ]
row: 5
column: 6
prev-page:
item:
active: orange_stained_glass_pane name:"&aPrevious page"
inactive: black_stained_glass_pane name:" "
lore:
active: [ ]
inactive: [ ]
row: 5
column: 4
# Custom GUI slots; see here for a how-to: https://plugins.auxilor.io/all-plugins/custom-gui-slots
custom-slots: [ ]
# GUI Configuration for the Quest Icon
quests-icon:
timer-format:
start: "Starts in %time%"
end: "Ends in %time%"
reset: "Resets in %time%"
none: "One-Time quest (does not end or reset)"
tasks-format:
- "&a%task_name%"
- " %task_lore%"
tasks-separator: []
name: "&6%quest_name%" # The name of the quest
lore:
- "&7%quest_description%" # This shows the description of the quest
- ""
- "&a%quest_tasks%" # This shows the tasks and their progress
- ""
- "&7%quest_tier%" # Premium or Both
- "&7%quest_timer%" # This shows either: When it unlocks, when it started, or the time until it resets.
time-format:
split: " "
days: "&6%value%&fd"
hours: "&6%value%&fh"
minutes: "&6%value%&fm"
seconds: "&6%value%&fs"
# Date format patterns (case-sensitive):
# d = day, M = month, y = year, H = hour (0-23), m = minute, s = second
# Example: "dd/MM/yyyy HH:mm:ss" → 31/05/2025 14:07:30
date-format: "yyyy-MM-dd HH:mm"
sound:
tier-up:
enabled: true # Whether the sound is enabled
sound: block.anvil.use # The sound to play
volume: 1 # The volume of the sound
pitch: 1 # The pitch of the sound
reward-claim:
enabled: true
sound: block.anvil.use
volume: 1
pitch: 1
quest-complete:
enabled: true
sound: block.anvil.use
volume: 1
pitch: 1
gui-click-sound:
enabled: true
sound: ui_button_click
volume: 1
pitch: 1
Last updated