Temp4Boost ⚖️ | Advanced Boost Shop GUI [1.18 - 1.21+]

# ======================================================================
# Temp4Boost Configuration
# ======================================================================
# Current release: 1.9.3
# Runtime target: Paper/Spigot 1.18 through 1.21.x on Java 17.
# The bundled defaults only use IDs that already exist in 1.18.2 so a fresh
# install stays portable across the full supported version range.
# ======================================================================

# Current configuration contract. Keep this value as provided.
# Temp4Boost may restore missing safe system keys when needed, but category and
# product data should always be edited intentionally by the developer.
config-version : 193

# Extra command aliases. /t4b and /temp4boost always work.
# Set to [] if you do not want extra aliases.
command-aliases :
 - boostshop

# Optional Spigot update checker.
update-checker:
  enabled : true

# Reference links for copy-paste-safe IDs used by this file:
# Materials / item icons (1.18.2-safe list):
# https://jd.papermc.io/paper/1.18.2/org/bukkit/Material.html#enum-constant-summary
# Potion effects (1.18.2-safe list):
# https://jd.papermc.io/paper/1.18.2/org/bukkit/potion/PotionEffectType.html#field-summary
# Sounds (1.18.2-safe list):
# https://jd.papermc.io/paper/1.18.2/org/bukkit/Sound.html#enum-constant-summary

# Text colors work in GUI titles, item names, lore, messages and ActionBar.
# Standard color codes: &a &b &c &l &o &n &m &r
# RGB/Hex formats: &#55FFFF, #55FFFF, <#55FFFF>, {#55FFFF}
# Always quote text that starts with # or &, because YAML treats them specially.

cooldown-seconds : 8
max-simultaneous : 4

persistence:
  save-on-change : true

same-effect:
  block-different-boosts : true
  block-existing-potion-effects : true

allow-illegal-levels : false

debug:
  enabled : false
  topics:
    general : true
    config : true
    economy : true
    purchases : false
    gui : false
    persistence : true
    resync : false

diagnostics:
  startup-summary : true

restrictions:
  disabled-worlds : [ ]
  disable-in-creative : true

death:
  keep-boosts : true

milk:
  behavior : MATCH_DEATH

self-heal:
  rescan-interval-seconds : 60

particles : true
icons : true

actionbar:
  enabled : true
  interval-ticks : 40
  format : "&b{boost} &8| &f{time}"

stacking-mode : DENY

permissions:
  categories:
    hide-without-permission : false
  products:
    hide-without-permission : false

# Categories/products can stay visible but locked by default, with fully
# configurable lore, click denial messages and permission-denied sounds.

messages:
  prefix : "&9&lTemp4Boost &7> "

  active:
    header :
     - "&8&m------------------------------------------------"
      - "&b&lYour Active Boosts &7({count})"
    entry : "&8- &f{boost} &8| &b{time}"
    empty :
     - "&8&m------------------------------------------------"
      - "&7You do not have any active boosts."
      - "&8&m------------------------------------------------"
    footer :
     - "&8&m------------------------------------------------"

  errors:
    usage:
      active : "&7Usage: /t4b active"

sounds:
  permission-denied : "ENTITY_VILLAGER_NO:0.8:0.9"

placeholderapi:
  outputs:
    empty : ""
    no-active : "&7No active boosts"
    boolean-true : "true"
    boolean-false : "false"
    list-separator : " &8| "
  formats:
    time : "{time}"
    boost-display : "&b{boost} &8- &f{time}"
    next-display : "&bNext &8| &f{boost} &8- &f{time}"
    list-entry : "&b{boost} &8- &f{time}"
    status-single : "&b1 active &8| &f{boost} &8- &f{time}"
    status-multiple : "&b{count} active &8| &fNext: &b{boost} &8- &f{time}"
 

# ----------------------------------------------------------------------
# [CATEGORIES AND PRODUCTS]
#
# Recommended layout:
#
# categories:
#   category_id:
#     enabled: true
#     name: "&bDisplay Name"
#     icon: MATERIAL
#     # Custom heads are optional and work in categories and products.
#     # Use either head-owner OR head-texture. If both are set, head-texture wins.
#     # Recommended:
#     #   icon: PLAYER_HEAD
#     #   head-owner: "Notch"
#     # Or:
#     #   icon: PLAYER_HEAD
#     #   head-texture: "base64:..."
#     # head-texture also accepts a direct http(s) Minecraft skin texture URL.
#     head-texture: ""
#     head-owner: ""
#     slot: 10
#     lore: ["Short description shown in the main menu."]
#     permission-required: false # true requires: temp4boost.category.<category_id>.
#     limits:
#       max-active: 0
#       max-products: 14
#     products:
#       product_id:
#         name: "Swiftness I"
#         effect: SPEED
#         level: 0
#         duration-seconds: 120
#         price: 150.0
#         icon: SUGAR
#         head-texture: ""
#         head-owner: ""
#         slot: 10
#         permission-required: false # true requires: temp4boost.product.<category_id>.<product_id>.
#         lore: ["Shown on the product item."]
#
# Internal product IDs are "<category_id>.<product_id>", for example:
# movement.speed_i
#
# You may add any category ID. Use lower_snake_case, numbers or hyphens.
# Reserved IDs: main, confirm.
#
# Product effect, duration-seconds and price are required catalog fields. If one
# is missing or has the wrong type, only that product is ignored; Temp4Boost will
# not invent effects, durations or economy values from defaults.
#
# Copy item icons from:
# https://jd.papermc.io/paper/1.18.2/org/bukkit/Material.html#enum-constant-summary
#
# Copy potion effect IDs from:
# https://jd.papermc.io/paper/1.18.2/org/bukkit/potion/PotionEffectType.html#field-summary
#
# Preferred effect keys use the current Bukkit names, for example:
# SPEED, STRENGTH, HASTE, RESISTANCE, JUMP_BOOST, NIGHT_VISION.
#
# Default icons, sounds and effects only use IDs available in Minecraft 1.18,
# so a fresh install works across the full supported range. Developers may use
# newer valid IDs on newer servers. If an icon material is missing on the current
# server version, Temp4Boost warns in console and uses an internal safe item for
# that GUI entry; no fallback list is needed in config.yml.
#
# Valid materials are always respected, even if they are subtle visually. Only
# empty values, AIR, non-item materials, or IDs unavailable on the current server
# are replaced internally.
#
# Category and product permission entries can stay visible but locked by default,
# or be hidden completely through the permissions section in config.yml.
#
# Balance model used by the default shop:
# - 100-300: utility/basic boosts
# - 300-650: stronger or longer boosts
# - 650-950: high-impact combat/defense boosts
# - 900+: permission-gated elite boosts
# ----------------------------------------------------------------------