OnArea

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.

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.