LatTrickOrTreat

# Trick-or-treat: hold a candy bag and right-click a player to knock on their door.
# They hand out a treat, or play a harmless trick on you. Give bags with /trickortreat bag.

# Generated from TrickOrTreatSettings. Keys you delete return to their default;
# keys that are not in the schema are ignored and reported on load.

command:
  # Command for knocks left today, and for staff to give bags. Takes effect on restart.
  name: "trickortreat"
  aliases:
    - "tot"
  permission: "trickortreat.use"
  # Permission for /trickortreat bag.
  admin-permission: "trickortreat.admin"
# Timezone for start, end and the daily reset of knocks, e.g. Europe/London.
timezone: "UTC"
# First day, as MM-DD, repeating every year. Leave start and end empty to run all year.
# An end before the start runs over the new year.
start: "10-01"
# Last day, inclusive, as MM-DD.
end: "11-01"
# Knocks each player gets per day. Only the first knock on a door each day can be a treat,
# so two friends cannot farm each other.
knocks-per-day: 10
# Knock on a door already knocked on today, and it always answers with a trick.
# The repeat still spends one of the day's knocks. False refuses repeat knocks.
trick-on-same-door: false
# Chance, from 0 to 1, that a knock gets a trick instead of a treat.
trick-chance: 0.3
# How the candy bag looks. It is never placed or eaten, whatever its model.
bag:
  name: "<gradient:#ff7a00:#b14cff><bold>Candy Bag</bold></gradient>"
  lore:
    - "<gray>Right-click a player to knock"
    - "<gray>on their door."
    - ""
    - "<gold>Trick or treat!"
  # Item model, as namespace:key. A resource pack can supply its own.
  model: "minecraft:orange_bundle"
# Treats, picked by weight. The icon is what flies out of the pumpkin; the reward is what is given.
treats:
  - # Relative chance against the other treats.
    weight: 45
    # Item that flies out of the pumpkin to the player. Only for show.
    icon: "COOKIE"
    reward:
      # Console commands. {player} is the player's name.
      commands:
        - "minecraft:give {player} cookie 4"
      # Sent to the player as a success line in the server theme. Empty for none.
      message: "<body>A handful of cookies!"
      # Sound key, e.g. entity.player.levelup. Empty for none.
      sound: null
  - # Relative chance against the other treats.
    weight: 30
    # Item that flies out of the pumpkin to the player. Only for show.
    icon: "PUMPKIN_PIE"
    reward:
      # Console commands. {player} is the player's name.
      commands:
        - "minecraft:give {player} pumpkin_pie 2"
      # Sent to the player as a success line in the server theme. Empty for none.
      message: "<body>Fresh pumpkin pie!"
      # Sound key, e.g. entity.player.levelup. Empty for none.
      sound: null
  - # Relative chance against the other treats.
    weight: 20
    # Item that flies out of the pumpkin to the player. Only for show.
    icon: "CAKE"
    reward:
      # Console commands. {player} is the player's name.
      commands:
        - "minecraft:give {player} cake 1"
      # Sent to the player as a success line in the server theme. Empty for none.
      message: "<body>A whole cake. Generous!"
      # Sound key, e.g. entity.player.levelup. Empty for none.
      sound: null
  - # Relative chance against the other treats.
    weight: 5
    # Item that flies out of the pumpkin to the player. Only for show.
    icon: "GOLDEN_APPLE"
    reward:
      # Console commands. {player} is the player's name.
      commands:
        - "minecraft:give {player} golden_apple 1"
      # Sent to the player as a success line in the server theme. Empty for none.
      message: "<accent>The full-size candy bar of treats!"
      # Sound key, e.g. entity.player.levelup. Empty for none.
      sound: "ui.toast.challenge_complete"
# Tricks, picked by weight. None of them touch the inventory, blocks or health.
# Types: PUMPKIN_HEAD (a pumpkin on your head, as everyone sees you), BATS (a swarm of bats),
# SCARE (a jump scare only you see), DARKNESS (the darkness effect).
tricks:
  - type: PUMPKIN_HEAD
    # Relative chance against the other tricks.
    weight: 30
    # How long it lasts, 1 to 60. SCARE is instant and ignores it.
    seconds: 20
  - type: BATS
    # Relative chance against the other tricks.
    weight: 30
    # How long it lasts, 1 to 60. SCARE is instant and ignores it.
    seconds: 5
  - type: SCARE
    # Relative chance against the other tricks.
    weight: 20
    # How long it lasts, 1 to 60. SCARE is instant and ignores it.
    seconds: 5
  - type: DARKNESS
    # Relative chance against the other tricks.
    weight: 20
    # How long it lasts, 1 to 60. SCARE is instant and ignores it.
    seconds: 6
# The doorstep animation. Times are in ticks, twenty to a second.
animation:
  # Item that rises above the door's head, and turns into the trick.
  pumpkin: "CARVED_PUMPKIN"
  # What the pumpkin turns into on a trick.
  trick-face: "JACK_O_LANTERN"
  pumpkin-size: 0.9
  # Size of each piece of candy.
  candy-size: 0.45
  # Pieces of candy that burst out on a treat, 1 to 16. Only for show.
  candies: 7
  # Ticks the pumpkin takes to rise.
  appear-ticks: 12
  # Ticks it shakes while the door decides.
  suspense-ticks: 30
  # Ticks the candy, or the trick face, hangs in the air after the reveal.
  hang-ticks: 16
  # Ticks each piece takes to fly to the player.
  fly-ticks: 10
  # Ticks between one piece leaving and the next.
  fly-stagger: 2
  sounds:
    # Played twice at the door, as the knock. Empty for none, here and below.
    knock: "entity.zombie.attack_wooden_door"
    # Played every few ticks while the pumpkin shakes, rising in pitch.
    shake: "block.note_block.bit"
    treat: "entity.firework_rocket.twinkle"
    trick: "entity.witch.celebrate"
    # Played as each piece of candy reaches the player.
    collect: "entity.item.pickup"
    # Played when the trick pumpkin hits the player.
    hit: "entity.slime.squish"