Actieparameters

Elke actie ondersteunt een set gedeelde parameters. Hiermee kun je acties beperken tot bepaalde rechten, vertragingen toevoegen en bepalen op wie de actie van toepassing is. Je kunt ze naar wens combineren op dezelfde actie.

Parameters

permission

Als dit is ingesteld, wordt de actie alleen uitgevoerd als de speler deze permissienode heeft. Spelers zonder dit recht worden stilzwijgend genegeerd.

actionbar:
  text: "<green>Hallo!"
  permission: "my_pack.greet"

delay

Wacht dit aantal ticks voordat de actie wordt uitgevoerd. 20 ticks = 1 seconde. Standaard: 0 (direct).

message:
  text: "<gold>Laden..."
  delay: 40 # 2 seconden na de trigger

target

Bepaalt op wie de actie van toepassing is. Standaard: self.

message:
  text: "<red>Je hebt iemand geraakt!"
  target: other

target_radius

Alleen gebruikt bij target: radius. Bepaalt de X/Y/Z-radius in blokken rond het eventdoel, eventblok of de activerende speler.

actionbar:
  text: "<yellow>Gebiedseffect!"
  target: radius
  target_radius: 10

target_in_sight_distance

Alleen gebruikt bij target: in_sight. Het maximale aantal blokken dat vanuit de oogpositie van de speler wordt gescand bij het zoeken naar een entiteit. Als er geen entiteit wordt gevonden binnen dat bereik, wordt de actie volledig overgeslagen.

ignite:
  duration: 100
  target: in_sight
  target_in_sight_distance: 10

Triggerplaatsing

Acties worden gedeclareerd binnen events secties van ItemsAdder-items, -blokken, furniture of complex furniture.

info:
  namespace: my_pack

items:
  ruby_staff:
    events:
      interact:
        right:
          message:
            text: "<green>Right-clicked"

  ruby_lamp:
    events:
      placed_furniture:
        interact:
          message:
            text: "<yellow>Furniture clicked"

placed_block acties kunnen worden genest onder events.placed_block. Furniture- en complex furniture-acties worden geladen uit events.placed_furniture.

Ondersteunde triggernamen

Veelgebruikte itemtriggers zijn:

interact, interact_mainhand, interact_offhand, block_break, attack, kill,
drop, pickup, held, held_offhand, unheld, unheld_offhand, item_break,
eat, drink, bow_shot, gun_shot, gun_no_ammo, gun_reload, item_throw,
item_hit_ground, item_hit_entity, book_write, book_read, fishing_start,
fishing_caught, fishing_failed, fishing_cancel, fishing_bite,
fishing_in_ground, bucket_empty, bucket_fill

Bloktriggers zijn onder andere interact, break en geneste placed_block triggers. Furniture-triggers gebruiken dezelfde item-style triggernamen onder placed_furniture. Complex furniture ondersteunt momenteel placed_furniture.interact.

interact, interact_mainhand en interact_offhand kunnen argumentsecties gebruiken zoals right, left, right_shift en left_shift. Wildcardacties onder de trigger worden ook uitgevoerd na de exacte argumentmatch.

Cooldowns en stat requirements

Wanneer een actie wordt geactiveerd vanuit een vastgehouden ItemsAdder-item, controleert ItemsAdderAdditions de door ItemsAdder geconfigureerde cooldowns en stat requirements voor dat item voordat de actie wordt uitgevoerd. Als de speler niet aan die eisen voldoet, wordt de actie overgeslagen.

Volledig voorbeeld

my_item:
  events:
    interact:
      right:
        actionbar:
          text: "<aqua>Rechtsgeklikt!"
          permission: "some.permission" # Alleen spelers met dit recht activeren dit
          delay: 10 # Een halve seconde vertraging
          target: self # Alleen van toepassing op de klikker