Skip to main content

Notifications Configuration

Configure notifications, messages, and announcements.

Notification Settings​

notifications:
  enabled: true
  methods:
    - CHAT
    - ACTION_BAR
  sound-on-delivery: true
  sound-name: ENTITY_EXPERIENCE_ORB_PICKUP
  sound-volume: 0.5
  sound-pitch: 1.0
  order-announcements:
    enabled: true
    broadcast-to-all: true
    permission: "sigmaorders.announcement"

Basic Notifications​

enabled​

Type: Boolean
Default: true
Description: Enable/disable all notifications

methods​

Type: List of Strings
Default: [CHAT, ACTION_BAR]
Options: CHAT, TITLE, ACTION_BAR, SOUND
Description: Notification delivery methods

Examples:

methods:
  - CHAT           # Chat messages
  - ACTION_BAR     # Action bar messages
  - TITLE          # Title messages
  - SOUND          # Sound notifications

Sound Settings​

sound-on-delivery​

Type: Boolean
Default: true
Description: Play sound when items are delivered

sound-name​

Type: String
Default: ENTITY_EXPERIENCE_ORB_PICKUP
Description: Sound to play (Minecraft sound name)

Common Sounds:

  • ENTITY_EXPERIENCE_ORB_PICKUP - Default
  • ENTITY_PLAYER_LEVELUP - Level up sound
  • BLOCK_NOTE_BLOCK_PLING - Ping sound
  • ENTITY_VILLAGER_YES - Villager yes

sound-volume​

Type: Double (0.0 - 1.0)
Default: 0.5
Description: Sound volume

sound-pitch​

Type: Double (0.0 - 2.0)
Default: 1.0
Description: Sound pitch

Order Announcements​

order-announcements.enabled​

Type: Boolean
Default: true
Description: Enable order placement announcements

order-announcements.broadcast-to-all​

Type: Boolean
Default: true
Description: Broadcast to all players or only those with permission

order-announcements.permission​

Type: String
Default: sigmaorders.announcement
Description: Permission required if broadcast-to-all is false

Message Customization​

Messages are configured in messages.yml:

# Order creation
order:
  created: "{prefix}✓ Order created successfully. Order ID: #{id}"

# Delivery notifications
delivery:
  completed-item: "{prefix}✓ Delivered {amount} {item} for order #{id}"

# Collection notifications
collection:
  collected: "{prefix}✓ Collected {amount} {item} from order #{id}"

Configuration Examples​

Minimal Notifications​

notifications:
  enabled: true
  methods:
    - CHAT
  sound-on-delivery: false
  order-announcements:
    enabled: false

Full Notifications​

notifications:
  enabled: true
  methods:
    - CHAT
    - ACTION_BAR
    - TITLE
    - SOUND
  sound-on-delivery: true
  sound-name: ENTITY_PLAYER_LEVELUP
  sound-volume: 0.7
  sound-pitch: 1.2
  order-announcements:
    enabled: true
    broadcast-to-all: true

Permission-Based Announcements​

notifications:
  order-announcements:
    enabled: true
    broadcast-to-all: false
    permission: "sigmaorders.announcement"