VeraTotems

# ============================================================
# VeraTotems - Example Totem
# ============================================================
#
# VeraTotems recursively loads every .yml file located inside
# the plugins/VeraTotems/totems directory.
#
# You can copy this file, rename it or place it inside any
# subdirectory within the totems directory.
#
# Every totem must have a unique ID.
# Changes require /veratotems reload or a server restart.
# ============================================================

# Determines whether this totem should be loaded.
enabled: true

# Unique internal identifier.
# Use lowercase letters, numbers, hyphens and underscores.
id: example

# Display name shown on the item.
# MiniMessage formatting is supported.
display-name: "<gradient:#60A5FA:#8B5CF6><bold>Verakai Totem</bold></gradient>"

item:
  # Minecraft material used by the custom totem.
  #
  # Any valid material can be used, including blocks and
  # regular items such as DIAMOND, BONE_MEAL or EMERALD_BLOCK.
  material: TOTEM_OF_UNDYING

  # Custom model number provided by a resource pack.
  # Set to 0 when no custom model is being used.
  custom-model-data: 0

  # Adds an enchantment glow without displaying an enchantment.
  glow: true

  # Prevents the item from losing durability.
  unbreakable: true

  # Prevents the custom totem from being placed when its
  # material is a placeable block.
  prevent-placement: true

  # Lore displayed below the item name.
  # MiniMessage formatting is supported.
  lore:
    - ""
    - "<gray>An example custom totem.</gray>"
    - "<gray>Created with VeraTotems.</gray>"
    - ""
    - "<aqua>Regeneration III</aqua>"
    - "<yellow>Absorption II</yellow>"
    - "<gold>Fire Resistance</gold>"
    - ""
    - "<dark_gray>ID: example</dark_gray>"

activation:
  # Determines how death protection is activated.
  #
  # AUTO:
  # Uses native Minecraft death protection when supported.
  # Otherwise, VeraTotems uses its compatible fallback system.
  #
  # VANILLA:
  # Uses EntityResurrectEvent and requires TOTEM_OF_UNDYING.
  #
  # FATAL_DAMAGE:
  # VeraTotems detects fatal damage and performs the
  # resurrection itself. This supports any material.
  trigger: AUTO

  # Hands from which this totem can activate.
  #
  # Available values:
  # - MAIN_HAND
  # - OFF_HAND
  hands:
    - MAIN_HAND
    - OFF_HAND

  # Determines whether one item is consumed after activation.
  consume: true

  # Cooldown duration in seconds.
  # Set to 0 to disable the cooldown.
  cooldown: 30

  # Removes fire from the player after activation.
  extinguish: true

  health:
    # Restores the configured amount of health.
    # Two health points are equal to one heart.
    enabled: true
    amount: 8.0

  food:
    # Restores the configured number of food points.
    # The maximum normal food level is 20.
    enabled: true
    amount: 6

  effects:
    regeneration:
      # Bukkit potion effect name.
      type: REGENERATION

      # Effect duration in seconds.
      duration: 10

      # Amplifiers begin at 0.
      # 0 = level I, 1 = level II, 2 = level III.
      amplifier: 2

    absorption:
      type: ABSORPTION
      duration: 20
      amplifier: 1

    fire_resistance:
      type: FIRE_RESISTANCE
      duration: 30
      amplifier: 0

  sound:
    # Sound played at the player's location.
    #
    # Native death protection already produces its own sound.
    # VeraTotems avoids playing this sound twice when the
    # native Minecraft activation system is used.
    enabled: true
    type: ITEM_TOTEM_USE
    volume: 1.0
    pitch: 1.0

  particle:
    # Particle effect displayed around the player.
    enabled: true
    type: TOTEM_OF_UNDYING

    # Number of particles produced.
    amount: 50

    # Particle distribution around the player.
    offset-x: 0.5
    offset-y: 1.0
    offset-z: 0.5

    # Particle movement speed.
    speed: 0.1

  # Commands executed sequentially after the totem activates.
  #
  # CONSOLE:
  # Executes the command through the server console.
  #
  # PLAYER:
  # Executes the command as the player who used the totem.
  #
  # WAIT:
  # Pauses the sequence for the specified number of ticks.
  # 20 ticks = 1 second.
  #
  # A command without a prefix is executed as the console.
  #
  # Available placeholders:
  # {player} = player name
  # {uuid}   = player UUID
  # {totem}  = custom totem ID
  # {world}  = current world
  # {x}      = player X coordinate
  # {y}      = player Y coordinate
  # {z}      = player Z coordinate
  #
  # Use single quotes around commands containing JSON.
  commands:
    - 'CONSOLE: title {player} title {"text":"VeraTotems","color":"light_purple"}'
    - "WAIT: 20"
    - 'CONSOLE: tellraw @a [{"text":"["},{"text":"{player}","color":"aqua"},{"text":"] activated the Verakai Totem."}]'
    - "WAIT: 20"
    - "PLAYER: me survived using a custom totem"