Runtime Notifications

Runtime Notifications

Runtime notifications are an opt-in EasyLibrary layer for server-side control-plane events.

They are different from Repository Notifications:

• repository notifications are GitHub Actions messages for pushes/releases;
• runtime notifications happen inside the PocketMine server when EasyLibrary installs, updates, removes, repairs or rolls back packages.

Config

Runtime notifications are disabled by default.

runtime-events:
  enabled: false
  local-jsonl: true
  timeout-seconds: 3

  discord:
    enabled: false
    webhook-url: ""

  generic-http:
    enabled: false
    url: ""

The config file is:

plugin_data/EasyLibrary/config/notifications.yml

Legacy fallback still comes from config.yml when the split file does not exist.

Commands

/easylibrary notifications
/easylibrary notifications test

notifications prints the active policy without exposing webhook URLs. notifications test emits a sanitized test event.

Local JSONL

When enabled, EasyLibrary writes sanitized JSON lines to:

plugin_data/EasyLibrary/notifications/events-YYYYmmdd.jsonl

Payloads use schema:

easylibrary.notification.v1

Safety Rules

• disabled by default;
• no package operation should fail because a webhook failed;
• webhook URLs are not printed in command output;
• obvious secrets are redacted before local or remote dispatch;
• package operations still use the normal dry-run, confirm and restart rules.