LightShowRegion
Displaying the region in the ActionBar
Автор: kainlight4731обновлён 26 апр. 2026 г.
Утилиты
Описание
DEPENDENCIES: PLACEHOLDERAPI
› Features
- Show or hide global region
- Shows if this is your region (owner or member)
- Shows whether this region is occupied (if you are not the owner or member)
- Blacklist of regions
- Renaming regions (for example the spawn region will be output as &6SPAWN)
- Full support for WorldGuard
› Review
› Commands and Permissions
| Command | Description | Permission |
|---|---|---|
| lightshowregion / lsr | Help by commands | lightshowregion.help |
| lightshowregion toggle (<actionbar>/<bossbar>) | Switch the region display | lightshowregion.toggle |
| lightshowregion add <region> <custom name> | Add a custom name to a region | lightshowregion.add |
| lightshowregion remove <region> | Remove custom name | lightshowregion.remove |
| lightshowregion blacklist add <region> | Add a region to the blacklist | lightshowregion.blacklist.add |
| lightshowregion blacklist remove <region> | Remove a region to the blacklist | lightshowregion.blacklist.remove |
| lightshowregion global | Switch the global region display | lightshowregion.global |
| lightshowregion reload actionbar | Reload actionbar for all online players | lightshowregion.reload.actionbar |
| lightshowregion reload bossbar | Reload bossbar for all online players | lightshowregion.reload.bossbar |
| lightshowregion reload bars | Reload actionbar and bossbar for all online players | lightshowregion.reload.bars |
| lightshowregion reload config | Reload all configurations | lightshowregion.reload.config |
| Permissions without commands | Description |
|---|---|
| lightshowregion.blacklist.* | All rights to manage the blacklist |
| lightshowregion.reload.* | Access for reload actionbar, bossbar and configs |
| lightshowregion.* | Full access to the plugin |
| Placeholder | Description |
|---|---|
| %lightshowregion_custom% | Displays information about free, occupied or your territory |
› API
Maven:
<dependency>
<groupId>ru.kainlight.lightshowregion</groupId>
<artifactId>api</artifactId>
<version>CURRENT_VERSION</version>
<scope>provided</scope>
</dependency>
Gradle — Groovy DSL:
repositories {
mavenCentral()
maven {
name = "GitHubPackages"
url = "https://maven.pkg.github.com/kainlighty/LightShowRegion"
}
}
dependencies {
compileOnly 'ru.kainlight.lightshowregion:api:CURRENT_VERSION'
}
Gradle — Kotlin DSL:
repositories {
mavenCentral()
maven {
name = "GitHubPackages"
url = uri("https://maven.pkg.github.com/kainlighty/LightShowRegion")
}
}
dependencies {
compileOnly("ru.kainlight.lightshowregion:api:CURRENT_VERSION")
}
Methods:
Get provider:
LightShowRegionAPI.getProvider()
| API | Description |
|---|---|
| createShowedPlayer(Player) | Create a player to display the region |
| getOrCreateShowedPlayer(Player) | Get or create a player to display the region |
| deleteShowedPlayer(Player/ShowedPlayer) | Delete a showed player |
| getShowedPlayer(Player) | Get the player to whom the region is displayed |
| getShowedPlayers() | Get list of the players |
| isShowedPlayer(Player) | Check if the player is a ShowedPlayer |
| reloadActionbar(Player) | Reload the actionbar to the player |
| reloadActionbars() | Reload the actionbar for all players |
| unloadActionbars() | Unload the actionbar for all players |
| reloadBossbar(Player) | Reload the bossbar to the player |
| reloadBossbars() | Reload the bossbar for all players |
| unloadBossbars() | Unload the bossbar for all players |
| addDisabledWorld(name) | Add a region to the blacklist |
| getDisabledWorlds() | Get a list of disabled worlds |
| removeDisabledWorld(name) | Remove a region to the blacklist |
| getRegionHandler() | Get players who are being checked |
| RegionHandler | Description |
|---|---|
| addCustomRegion(regionId, regionName) | Add a custom region |
| getCustomRegionName(Player) | Get a custom region where the player is located |
| removeCustomRegion(regionId) | Delete a custom region |
| getCustomRegionIds() | Get the custom region IDs |
| isCustomRegion(id) | Check if the region is custom |
| addBlacklist(regionId) | Add a region to the blacklist |
| getBlacklist() | Get the blacklist |
| removeBlacklist(regionId) | Remove a region to the blacklist |
| isGlobalRegion() | Check whether the global region display is enabled |
| setGlobalRegion () | Set the global region display |
| ShowedPlayer | Description |
|---|---|
| getPlayer() | Get a bukkit player |
| getActionbar() | Get the parameters for the actionbar |
| getBossbar() | Get the parameters for the bossbar |
| toggleAll() | Switch the region display in the actionbar and bossbar for all |
| showAll() | Show actionbar and bossbar |
| hideAll() | Hide actionbar and bossbar |
| Actionbar | Bossbar | Description |
|---|---|
| toggle() | Toggle the display |
| show() | Show the display |
| hide() | Hide the display |
| isActive() | Check if the display is active |
Последние версии
Все версии →beta
Folia support
1.4.426 апр. 2026 г.75Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2folia, paper, purpur
Что нового
The version will be redefined to the release version when it is better tested.
release
Support 1.21+
1.4.318 апр. 2026 г.67Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2paper, purpur
Что нового
- Removed Spigot support
- Updated dependencies
release
Fixes the region display
1.4.2.14 мар. 2025 г.80Minecraft: 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6paper, purpur, spigot
Что нового
Previously, there was an incorrect link to the player, because of this, his location was old, there could be a problem that the previous region is displayed.
release
Full support for WorldGuard
1.4.224 февр. 2025 г.65Minecraft: 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4paper, purpur, spigot
Что нового
### Added:
- [API](https://github.com/kainlighty/LightShowRegion#-api).
- [WorldGuard](https://dev.bukkit.org/projects/worldguard) Support.
_The [PlaceholderAPI](https://github.com/PlaceholderAPI/PlaceholderAPI) is no longer used to display the region._
- The `sorted-by` parameter. You can choose which region to display by priority:
```yaml
region-settings:
# HIGHEST, LOWEST, RANDOM.
# RANDOM — If there are several regions in a location, the label will switch between them.
sorted-by: RANDOM
```
- The `bossbar-settings` section:
```yaml
bossbar-settings:
# PINK, BLUE, GREEN, YELLOW, PURPLE, WHITE, RED.
color: RED
# SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20.
style: PROGRESS
```
- Simplified Chinese language [[#1](https://github.com/kainlighty/LightShowRegion/pull/1)].
- Toggle command: `/lightshowregion toggle`.
You can use it to switch the display of the region in actionbar or bossbar for yourself.
- More detailed description for the help command.
### Changed:
- The `reload bar` command to `reload actionbar`, `reload bossbar` or `reload bars`.
There are separate permissions for each of them.
release
Optimizations
1.4.1.215 февр. 2025 г.41Minecraft: 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4paper, purpur, spigot
Что нового
### Also:
- Added more comments in message configurations
- Added placeholder `%value%` for `region.global`
The message will now also indicate the set state
- Significantly reduced file weight.
_Basically, the update contains fixes in the library._
release
Switching to MiniMessage for messages
1.4.1.131 янв. 2025 г.74Minecraft: 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4paper, spigot
Что нового
- Versions below 1.17 will no longer be supported
- Placeholder symbols have been replaced with `%`
- Switching to [MiniMessage](https://docs.advntr.dev/minimessage/format.html#) for messages.
<details>
<summary>Colors</summary>
```
&0 -> <black>
&1 -> <dark_blue>
&2 -> <dark_green>
&3 -> <dark_aqua>
&4 -> <dark_red>
&5 -> <dark_purple>
&6 -> <gold>
&7 -> <gray>
&8 -> <dark_gray>
&9 -> <blue>
&a -> <green>
&b -> <aqua>
&c -> <red>
&d -> <light_purple>
&e -> <yellow>
&f -> <white>
&b -> <bold>
```
</details>
- Fixed a bug related to formatting messages on Spigot
- Added the `parse_mode` parameter for formatting in **MiniMessage** or **Legacy**.
release
1.3.2
1.3.219 янв. 2024 г.71Minecraft: 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2paper, purpur, spigot
Что нового
- Fixed Incorrect loading of the placeholder or its complete malfunction
- Added the value 'actionbar: true/false' to the configuration (the ability to use the plugin as a placeholder)