PluggLAB | PulseEvents Docs

Getting Started

PulseEvents loads every file in plugins/PulseEvents/events/ as an independent event definition. Each file defines a trigger, one or more actions, and optional conditions.

events:
  double-drops:
    trigger:
      type: schedule
      cron: "0 20 * * FRI"
    actions:
      - broadcast: "&6Double drops are now active!"
      - effect: drop-multiplier
        value: 2.0
        duration: 3600

Triggers

Type	Description
`schedule`	Cron-style recurring trigger.
`interval`	Repeats every N seconds while the server is online.
`playerCount`	Fires once a player count threshold is crossed.
`command`	Fires when an operator runs `/pulse trigger <id>`.

Actions

Action	Description
`broadcast`	Sends a formatted message to every online player.
`command`	Runs a console or player command.
`effect`	Applies a temporary server-wide effect (drop multiplier, spawn rate, etc.).
`spawn`	Spawns a mob or boss at a configured location.

Conditions

Conditions are optional and stack with AND logic. An event only fires when every listed condition passes.

conditions:
  - minPlayers: 5
  - world: "survival"
  - timeOfDay: "night"

Commands

Command	Description
`/pulse reload`	Reloads every event config without a restart.
`/pulse list`	Lists all loaded events and their next run time.
`/pulse trigger <id>`	Manually fires an event immediately.
`/pulse info <id>`	Shows the parsed trigger, actions, and conditions for one event.

Full Example

events:
  night-raid:
    trigger:
      type: schedule
      cron: "0 22 * * *"
    conditions:
      - minPlayers: 3
      - world: "survival"
    actions:
      - broadcast: "&cSomething stirs in the dark..."
      - spawn:
          mob: WITHER_SKELETON
          count: 4
          location: "raid-arena"
      - effect: mob-spawn-boost
        value: 1.5
        duration: 900