LightShowRegion

Displaying the region in the ActionBar

Загрузки: 333
Подписчики: 1
Обновлён: 26 апреля 2026 г.
Лицензия: MIT

Опубликован 19 января 2024 г.

Исходный код Сообщить об ошибке

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

Ченджлог

1.4.4Бета26.1, 26.1.1, 26.1.2 · 26 апреля 2026 г.

The version will be redefined to the release version when it is better tested.

1.4.3Релиз26.1, 26.1.1, 26.1.2 · 18 апреля 2026 г.

Removed Spigot support
Updated dependencies

1.4.2.1Релиз1.20.4, 1.20.5, 1.20.6 · 4 марта 2025 г.

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.

1.4.2Релиз1.21.2, 1.21.3, 1.21.4 · 24 февраля 2025 г.

Added:

API.
WorldGuard Support. The PlaceholderAPI is no longer used to display the region.

The sorted-by parameter. You can choose which region to display by priority:

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:

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].
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.

1.4.1.2Релиз1.21.2, 1.21.3, 1.21.4 · 15 февраля 2025 г.

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.

1.4.1.1Релиз1.21.2, 1.21.3, 1.21.4 · 31 января 2025 г.

Versions below 1.17 will no longer be supported
Placeholder symbols have been replaced with %

Switching to MiniMessage for messages.

Colors

&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>

Fixed a bug related to formatting messages on Spigot
Added the parse_mode parameter for formatting in MiniMessage or Legacy.

1.3.2Релиз1.20, 1.20.1, 1.20.2 · 19 января 2024 г.

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)