AdvancedRegionDisplay | WorldGuard Territory HUD ✦ BossBar & ActionBar [1.16.5]

✦ What is AdvancedRegionDisplay?
AdvancedRegionDisplay is a lightweight WorldGuard extension that gives players clear visual feedback about the territory they are currently standing in.

Instead of filling the chat with region notifications, AdvancedRegionDisplay keeps everything inside a clean BossBar or ActionBar.

Create unique messages for important regions such as your spawn, market, mines or PvP arena, while global territory messages automatically handle free land, your territory and another player's territory.

Whether you are running a survival server, RPG world, town server, PvP network or lobby, AdvancedRegionDisplay provides a simple way to make different areas of your world instantly recognizable.


✦ Main Features
• WorldGuard Integration
Detect the WorldGuard regions surrounding each player.
• Custom Messages for Individual Regions
Give regions such as spawn or mine their own display text.
• Ownership-Aware Territory Messages
Automatically display different messages for free territory, regions where the player is an owner or member, and regions belonging to somebody else.
• BossBar & ActionBar
Choose the display style that best matches your server interface.
• WorldGuard Priority Support
When multiple regions apply to the same location, higher-priority WorldGuard regions are checked first.
• PlaceholderAPI Support
Use PlaceholderAPI placeholders directly inside your region messages when PlaceholderAPI is installed.
• Resource Pack Aware Display
Optionally change the display mode depending on the player's reported resource-pack status.
• Configurable Refresh & Caching
Fine-tune how often displays are refreshed and how long region lookups are cached.
• Instant Configuration Reload
Apply configuration changes using /ard reload without restarting the server.
• No Database Required
Everything is configured through a simple config.yml file.


✦ Perfect For
• Survival & SMP servers
• Town and territory-based servers
• RPG worlds
• PvP arenas
• Mines
• Spawn areas
• Markets and districts
• Network lobbies
• Roleplay servers


✦ Custom Region Messages
Assign completely different messages to individual WorldGuard regions.
The configuration key is the WorldGuard region ID.
For example, when a player enters the spawn region, the plugin can display: Spawn


✦ Smart Territory Messages
You do not have to configure every WorldGuard region individually.

AdvancedRegionDisplay can automatically choose a global message based on the player's current territory.
Free Territory
Displayed when the player is not inside a WorldGuard region.

Your Territory
Displayed when the player is an owner or member of the current region.

Alien Territory
Displayed when the player is inside a region where they are neither an owner nor a member.


✦ Display It Your Way
AdvancedRegionDisplay supports three display modes.

BOSS_BAR
Shows the current region as a persistent BossBar at the top of the screen.

ACTION_BAR
Shows the current region above the player's hotbar.

NONE
Disables the visual display without disabling the plugin itself.

Example:

✦ Customizable BossBar
When using BOSS_BAR, you can customize its appearance.

Available colors:
PINK • BLUE • RED • GREEN • YELLOW • PURPLE • WHITE

Available styles:
SOLID • SEGMENTED_6 • SEGMENTED_10 • SEGMENTED_12 • SEGMENTED_20


✦ PlaceholderAPI Support
PlaceholderAPI integration is completely optional.

When PlaceholderAPI is installed and enabled, placeholders inside region messages are expanded automatically.
If PlaceholderAPI is not installed, AdvancedRegionDisplay will continue working normally without placeholder expansion.


✦ Resource Pack Aware Display
AdvancedRegionDisplay can react to the resource-pack status reported by Minecraft and use a different display mode for each status.

Important: AdvancedRegionDisplay does not send a resource pack to players.

It only reacts to the resource-pack status reported by the server.
Each status can use:
BOSS_BAR • ACTION_BAR • NONE


✦ Requirements
Required:
• Java 8 or newer
• Spigot-compatible server
• WorldGuard 7
• WorldEdit 7

Optional:
• PlaceholderAPI

Native Minecraft version: 1.16
Built against: Spigot API 1.16.5
API version: 1.16


✦ Quick Installation
1. Download AdvancedRegionDisplay.
2. Place the plugin JAR inside your server's /plugins folder.
3. Make sure WorldGuard and WorldEdit are installed.
4. Restart the server.
5. Open plugins/AdvancedRegionDisplay/config.yml.
6. Configure your region messages and preferred display mode.
7. Run /ard reload.
That's it.


✦ Commands & Permissions
Reload the configuration:
Permission:
advancedregiondisplay.reload
Default: OP


✦ Performance
AdvancedRegionDisplay checks online players on a configurable interval.
refresh-ticks
Controls how often player displays are refreshed.

A value of 20 corresponds to approximately one second under normal server conditions.

region-cache-ticks
Controls how long the previous region lookup may be reused while the player remains in the same block.

Set it to 0 to disable region lookup caching.


✦ Focused by Design
AdvancedRegionDisplay is designed to complement WorldGuard, not replace it.

It does not:
• Create WorldGuard regions
• Edit WorldGuard regions
• Delete WorldGuard regions
• Claim land
• Replace WorldGuard protection or permissions
• Require a database
• Send resource packs


✦ Support
Found a problem or need help with your configuration?

When contacting support, please provide:
• Server version
• AdvancedRegionDisplay version
• WorldGuard version
• WorldEdit version
• PlaceholderAPI version, if applicable
• Your config.yml
• Relevant console errors
• A short description of the problem

Contact:
Telegram — @feelingadeath