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-barsection inconfig.yml. - Persistent Display: When
keep-aliveis set totrue(default), the action bar message is refreshed continuously while the player remains inside the area. - Single Display: When
keep-aliveis set tofalse, 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-exittotrueclears 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.ymlunder the language setting (setting it toautowill automatically detect the language based on the server's OS). - Players can also manually set their language using the
/onarea langcommand. 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.
