A lightweight SpigotMC plugin that allows you to define specific areas within your server. When a player enters a designated area, its name is automatically displayed on their action bar.

Area Creation & Management

• Defining Areas: Create areas by selecting two points (pos0 and pos1) to form a rectangular boundary.
• IDs & Display Names: Each area uses an internal ID for management and a customizable display name for players.
• Data Persistence: All area data is saved in areas.yml, ensuring settings are preserved even after a server restart.

Entry & Exit Detection

• Real-time Detection: The plugin checks whether a player is within a registered area whenever they move between blocks.
• Action Bar Notifications: The area's display name appears at the bottom-center of the screen (Action Bar) upon entry.
• Configurable Behavior: Several action bar behaviors can be customized via the action-bar section in config.yml.
• Persistent Display: When keep-alive is set to true (default), the action bar message is refreshed continuously while the player remains inside the area.
• Single Display: When keep-alive is set to false, the message is shown only once on entry and fades out naturally after approximately 3 seconds.
• Automatic Clearing: When a player exits an area, the action bar stops being sent and fades out on the client side.
• Instant Clearing: Setting force-clear-on-exit to true clears the action bar immediately upon exit instead of waiting for the natural fade.
• Priority System: If multiple areas overlap, the first area detected will take priority for the display.

Action Bar Compatibility

The action bar has only one slot, so when other plugins also send messages to it, the messages overwrite each other and the text flickers. If ProtocolLib or PacketEvents (2.x) is installed, OnArea avoids this by adding the area name to the other plugin's message instead of competing with it.

• Message Merging: The other plugin's action bar message is shown together with the area name, with the text set in merge.separator placed between them. By default the area name comes after the other message.
• Optional Dependency: Only one of ProtocolLib or PacketEvents is needed. If both are installed, only one is used. If neither is installed, the plugin works as before and sends the area name on its own.
• Note: The action bar is centered on screen, so the other plugin's message shifts slightly when the area name is added.

The following settings are available in the action-bar section of config.yml:

• mode: auto (default; merges if ProtocolLib or PacketEvents is installed, otherwise works as before), merge (same as auto, but logs a warning to the console if neither is installed), standalone (never merges; resends the area name every second).
• merge.provider: Which library to use. auto (ProtocolLib first), protocollib, or packetevents.
• merge.position: Where to put the area name. suffix (after the other plugin's message, default) or prefix (before it).
• merge.separator: Text placed between the two messages (default: two spaces).

Multilingual Support

• Supports 9 languages: 日本語, English, 简体中文, 한국어, Español, Português, Русский, Deutsch, Français
• The system automatically detects the player's Minecraft client language and displays messages in the corresponding language.
• For unsupported languages, the server's default language will be used. You can configure this in config.yml under the language setting (setting it to auto will automatically detect the language based on the server's OS).
• Players can also manually set their language using the /onarea lang command. These individual settings will persist even after a server restart.

Commands

All commands require the onarea.admin permission.

• /onarea pos0 [x y z] – Sets the starting point. Uses your current location if coordinates are omitted.
• /onarea pos1 [x y z] – Sets the end point. Uses your current location if coordinates are omitted.
• /onarea create <ID> <DisplayName> – Registers a new area between the two specified points.
• /onarea edit <ID> <DisplayName> – Updates the display name of an existing area.
• /onarea delete <ID> – Deletes the specified area.
• /onarea list – Displays a list of all registered areas.
• /onarea lang – Displays the current language setting and its source (manual/automatic).
• /onarea lang <code> – Changes the language (ja, en, zh, ko, es, pt, ru, de, fr)
• /onarea lang reset – Clears the manual language setting and reverts to automatic detection.
• /onarea debug – Displays registered areas with borders. Running it again will hide them.