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

* Data Persistence: Create areas by selecting two points (Data Persistence: and Data Persistence:) to form a rectangular boundary. * Data Persistence: 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

* Priority System: The plugin checks whether a player is within a registered area whenever they move between blocks. * Priority System: The area's display name appears at the bottom-center of the screen (Action Bar) upon entry. * Priority System: Several action bar behaviors can be customized via the `action-bar` section in `config.yml`. * Priority System: When `keep-alive` is set to `true` (default), the action bar message is refreshed continuously while the player remains inside the area. * Priority System: When `keep-alive` is set to `false`, the message is shown only once on entry and fades out naturally after approximately 3 seconds. * Priority System: When a player exits an area, the action bar stops being sent and fades out on the client side. * Priority System: 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.