# BuildersWand Configuration File

# this is the prefix for all messages sent by the plugin.
# this is an optional setting, if you remove it the default prefix will be used
# supports minimessage formatting (along with the display name and lore of wands)
prefix : "&7[&bBuildersWand&7] &r"

# this isn't required for the build wand to work, but it does reduce the amount of fired events when placing blocks through the wand
# set to false if you want to handle block place event cancellations yourself and don't want extra events fired
# set to true if you want to allow other plugins to handle block place event cancellations (like WorldGuard or SuperiorSkyblock)
fireWandBlockPlaceEvent : true

# this isn't required for the build wand to work, but it does reduce the amount of fired events when using the wand
# set to false if you don't want to add extra logic to wand usage, ideal for servers with a lot of players
fireWandPreviewEvent : true

# This can be disabled if you want blocks to be placed instantly.
# If you notice a performance impact definitely enable this and adjust the maxBlocksPerTick value.
placementQueue:
  enabled : true
  maxBlocksPerTick : 20 # max blocks to place per tick

# Whether to automatically remove invalid wands from players' inventories
# An invalid wand is one that has been removed from the config or has otherwise become invalid
# this should be kept disabled until you are sure your wands are configured correctly
destroyInvalidWands:
  enabled : false
  message : "&4The wand you had was misconfigured and has been removed. Please contact an administrator immediately."

updater:
  enabled : true
  checkIntervalMinutes : 60
  notifyMessage : "&aAn update for BuildersWand is available! Check console for more info." # this message is sent in chat to those who have the permission node listed below
  notifyPermission : "builderswand.notify.update"
  notify:
    console : true
    ingame : true

# Only recommended when troubleshooting issues since it can generate a lot of log spam. defaults to false
debug : false

wands:
  my_special_wand:
    name : "&3Builders Wand"
    material : "BLAZE_ROD"
    lore :
     - "&7A powerful wand for <blue>building!"
      - "&7Use it <green>wisely."
    wandType : STANDARD # defaults to STANDARD. valid types: STANDARD & STATIC
    staticLength : 5 # only used if wandType is STATIC, otherwise ignored
    staticWidth : 5 # only used if wandType is STATIC, otherwise ignored
    maxSize : 8 # max block search & placement size
    maxSizeText : "&3Max Size: {maxSize}"
    maxRayTraceDistance : 16 # max distance that the plugin will search for a block in a given direction
    consumeItems : true # whether the wand should consume items from the player's inventory when placing blocks
    generatePreviewOnMove : false # whether to generate a preview (small white particles) of where blocks will be placed when the player moves
    undoHistorySize : 10 # number of undoes to store per player for this wand, defaults to 10. shift left click to undo a placement, input - 1 for unlimited and 0 to disable undoing.
    durability:
      amount : 100
      enabled : true
      text : "&3Durability: {durability}"
      breakSound : # whether to play a sound when the wand breaks
        enabled : false
        sound : ENTITY_ITEM_BREAK # valid sounds can be found here: https://jd.papermc.io/paper/1.21.11/org/bukkit/Sound.html
        message : "&4Your wand broke!"
    previewParticle : # paper-only
      particle : "DUST" # valid particle names can be found here: https://jd.papermc.io/paper/1.21.11/org/bukkit/Particle.html
      options : # only required for certain particles
        color:
          red : 0
          green : 0
          blue : 0
        size : 1.0
      count : 1 # number of particles to spawn per block in the preview
      offset:
        x : 0
        y : 0
        z : 0
      speed : 0 # speed of the particles
    cooldown : 2 # in seconds
    craftable : false # whether this wand can be used in crafting recipes as an ingredient
    blockedMaterials :
     - BEDROCK
      - BARRIER
    craftingRecipe:
      enabled : false
      shape : # if this is larger than 3x3, an error will be thrown
        - " E "
        - " S "
        - " S "
      ingredients : # ensure the ingredients listed here are valid materials
        E : EMERALD
        S : STICK