Item Limiter

# ============================================================
#   NotDqshers item limiter — config.yml
# ============================================================
#
# COMMANDS
# --------
#   /itemlimit set        Hold an item, opens the deposit GUI.
#                          Place however many you want allowed —
#                          that count becomes the limit.
#
#   /itemlimit limits      Opens a GUI showing all active limits
#                          and banned items.
#
#   /itemlimit ban         Hold an item, then confirm within 10s
#                          to ban it. Banned items are DELETED
#                          from player inventories, not dropped.
#
#   /itemlimit unban        Opens a GUI listing all banned items —
#                          click one to unban it.
#
#   /itemlimit removelimit  Opens a GUI listing all limited items —
#                          click one to remove its limit.
#
#   /itemlimit reload       Reload this config from disk.
#
#   Aliases: /il, /ilimit
#
# PERMISSIONS
# -----------
#   itemlimit.use       Required to run /itemlimit
#   itemlimit.admin     Access to /itemlimit reload
#   itemlimit.bypass    Exempt from all limits and bans
#
# HOW LIMITS WORK
# ---------------
#   -1  = No limit (completely unrestricted)
#   0   = BANNED (item is deleted from player inventories)
#   1+  = Maximum number of this item a player can carry
#
# ITEM KEY FORMAT
# ---------------
#   Regular items  ->  MATERIAL_NAME
#                      e.g.  GOLDEN_APPLE
#
#   Potions        ->  POTION_<EFFECT>
#                      e.g.  POTION_SPEED
#                      Automatically applies to normal, extended,
#                      strong, splash, lingering, and tipped arrow
#                      variants.
#
# VALID POTION EFFECTS
# --------------------
#   SPEED, SLOWNESS, HASTE, MINING_FATIGUE, STRENGTH,
#   INSTANT_HEAL, INSTANT_DAMAGE, JUMP_BOOST, NAUSEA,
#   REGENERATION, RESISTANCE, FIRE_RESISTANCE,
#   WATER_BREATHING, INVISIBILITY, BLINDNESS, NIGHT_VISION,
#   HUNGER, WEAKNESS, POISON, WITHER, HEALTH_BOOST,
#   ABSORPTION, SATURATION, GLOWING, LEVITATION,
#   LUCK, UNLUCK, SLOW_FALLING, CONDUIT_POWER,
#   DOLPHINS_GRACE, BAD_OMEN, HERO_OF_THE_VILLAGE, DARKNESS
#
# ============================================================

settings:
  notify-player: true
  # {limit} = the cap, {item} = item name
  notify-message: "&9&lMax limit for &b&l{item} &9&lis &b&l{limit}&9&l."
  # Shown when a banned item is removed
  banned-message:
  drop-excess: true
  # How often (in ticks, 20 ticks = 1 second) EVERY online player gets fully
  # re-scanned for banned or over-limit items. This is a safety-net sweep —
  # most enforcement already happens instantly via pickup/click/craft/join
  # events, so raising this mostly just widens the window for edge cases
  # like /give or other plugins adding items directly.
  #
  # This does NOT mean all players are scanned in one go every X ticks —
  # the plugin automatically spreads the work into small batches (every
  # 5 ticks) so the number below only controls how often the FULL cycle
  # completes, not the cost of any single tick. This keeps large player
  # counts from causing a scan-everyone-at-once lag spike.
  #   Small servers (<50 players):    10-20  (0.5s-1s)
  #   Medium servers (50-100):        40-60  (2s-3s)
  #   Large servers (100-200+):       100+   (5s+)
  # Reload with /itemlimit reload to apply changes without restarting.
  sweep-interval-ticks: 20

limits:
  # --- Regular Items (-1 = no limit, 0 = banned, 1+ = limit) ---
  GOLDEN_APPLE: -1
  ENCHANTED_GOLDEN_APPLE: -1
  TOTEM_OF_UNDYING: -1
  ENDER_PEARL: -1
  SHIELD: -1

  # --- Potions ---
  POTION_HEALING: -1
  POTION_REGENERATION: -1
  POTION_STRENGTH: -1
  POTION_SPEED: -1
  POTION_FIRE_RESISTANCE: -1
  POTION_INVISIBILITY: -1
  POTION_SLOWNESS: -1
  POTION_WEAKNESS: -1
  POTION_POISON: -1
  POTION_INSTANT_DAMAGE: -1