region_audience) is a specialized entry that allows you to broadcast persistent content (like Boss Bars, Action Bars, or Particle effects) to every player currently inside a specific region.
How it works
Unlike a one-time “Enter Event”, the Region Audience maintains the content as long as the player remains inside the zone. When they leave, the content is automatically hidden.Configuration
| Parameter | Type | Description |
|---|---|---|
region | Ref<RegionDefinition> | The region to target. |
contents | List<Ref<Content>> | Content to display (ActionBars, BossBars, etc). |
Uses
- Zone Labeling: Continuously show “Zone: Industrial Sector” in the Action Bar.
- Atmosphere: Display a purple Dragon boss bar when inside a “Cursed Forest” region.
- Tutorials: Show help text on screen while players are in a starting area.
[!NOTE] This uses Paper/Folia’s audience system to ensure high performance even with many players moving between zones.