Custom Actions

Custom addon actions

Addons can register custom action types through the EventForge API.

Example action type from an addon:

RELIC_LOG

Then the event config can use it like a normal action:

triggers:
  event-start:
    actions:
      - type: RELIC_LOG
        message: "{event_display} started."

info

Custom action types depend on the addon that registered them. If the addon is missing, the action will not be available.

---

Action timing tips

Use actions carefully.

Good uses:

event-start broadcast/title
player-score actionbar/sound
event-finish broadcast/firework
milestone message/sound/title
objective discovery messages
webhook event summaries

Avoid:

heavy command spam
long chat spam on every score update
too many animated titles at once
webhooks on every small score change

---

Simple event-start example

triggers:
  event-start:
    actions:
      - type: BROADCAST
        message: "<gradient:#22d3ed:#ffffff>{event_display}</gradient> &7has started!"

      - type: ANIMATED_TITLE
        frames:
          - title: "<stack:rainbow,wobble>{event_display}</stack>"
            subtitle: "&7Good luck!"
            fade-in: 5
            stay: 40
            fade-out: 10
            interval: 5

      - type: SOUND
        sound: ENTITY_PLAYER_LEVELUP
        volume: 1.0
        pitch: 1.0

---

Simple player-score example

triggers:
  player-score:
    actions:
      - type: ANIMATED_ACTIONBAR
        frames:
          - message: "<pulse:#22d3ed:#ffffff>+{score_change} points</pulse> &8| &7Total: &f{new_score}"
            duration: 30
            interval: 5

      - type: SOUND
        sound: ENTITY_EXPERIENCE_ORB_PICKUP
        volume: 0.8
        pitch: 1.4

---