
ProtectorAPI
An API aims to provide a standard protection API.
Автор: lijinhong117490обновлён 25 окт. 2026 г.
БиблиотекиУтилиты
Описание
ProtectorAPI
An API try to provide a standard protection API.
What can it do?
- Get the protection range that protected by protection plugin
- Check player can place/break/interact the block
- Register flags easily
- You don't need to worry about multiple protection plugins in the server, ProtectorAPI handles it perfectly.
Supported Plugins
- Residence
- Dominion
- HuskClaims (since v1.0.3)
- IridiumSkyblock (since v2.0.0)
- PlotSquared
- WorldGuard
- RedProtect
- BentoBox
- GriefDefender (since v2.2.1)
- BlockLocker
- Bolt
- ChestProtection
- ChestShop (since v1.0.2)
- ExcellentClaims (since v1.1.0)
- FactionsUUID (since v1.0.3)
- FunnyGuilds (since v1.0.3)
- GriefPrevention (since v1.0.6)
- HuskTowns (since v1.0.6)
- Lands
- LockettePro (since v1.0.1)
- LWC (LWCX)
- NoBuildPlus (since v1.0.7)
- QuickShop-Reremake
- QuickShop-Hikari
- ShopChest
- Towny
Usage
See https://lijinhong11.gitbook.io/protectorapi/start/readme
Develop
See https://lijinhong11.gitbook.io/protectorapi/develop/setup
Javadocs: https://javadoc.io/doc/io.github.lijinhong11/protectorapi-api/latest
Develop Examples
Check whether a player can place
Player player = ...;
boolean allow = ProtectorAPI.allowPlace(player);
If you need to check wehether a player can place a block at a location (safer than previous method):
Player player = ...;
Block block = ...;
boolean allow = ProtectorAPI.allowPlace(player, block);
Check whether a player can break
Player player = ...;
boolean allow = ProtectorAPI.allowBreak(player);
If you need to check whether a player can break a block at a location (safer than previous method):
Player player = ...;
Block block = ...;
boolean allow = ProtectorAPI.allowBreak(player, block);
Check whether a player can interact
NOTE: RedProtect didn't have a more general interaction flag, so we uses "redstone" flag to check instead.
Player player = ...;
boolean allow = ProtectorAPI.allowInteract(player);
If you need to whether a player can interact block at a location (safer than previous method):
Player player = ...;
Block block = ...;
boolean allow = ProtectorAPI.allowInteract(player, block);
Последние версии
Все версии →release
2.5.1
2.5.125 окт. 2026 г.15Minecraft: 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.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.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.2, 26.2, 26.3bukkit, folia, paper, purpur, spigot
Что нового
## Fixes
1. Flags values now get correctly in claim context (GriefDefender)
2. Block checks get corrected result (Bolt)
## Addition
1. Chunk checks
* Run checks through `ProtectorAPI.isChunkProtected(Chunk)`
2. Async
* Add async support for some adapters
* ProtectorAPI added the corresponding methods to check asynchronously
3. GriefDefender now supports registering flags
## Edits
1. `CustomFlag` now requires a Material for icon
## Removes
1. ASkyBlock module
2. QuickShop-Reremake module
release
2.4.1
2.4.17 окт. 2026 г.30Minecraft: 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.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.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.2, 26.2, 26.3bukkit, folia, paper, purpur, spigot
Что нового
1. `isProtected(Player, Location)` is now changed to `isProtected(Location)`
the method is used to check the block is protected by the plugin, the player is not neccesary
release
2.4.0
2.4.04 окт. 2026 г.18Minecraft: 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.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.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.2, 26.2, 26.3bukkit, folia, paper, purpur, spigot
Что нового
Support LandClaimPlugin
release
2.3.0
2.3.029 июл. 2026 г.36Minecraft: 26.1, 26.1.1, 26.1.2, 26.2bukkit, folia, paper, purpur, spigot
Что нового
1. ASkyBlock (kinda weird)
2. Only support 26.1+
release
2.2.1
2.2.116 мая 2026 г.95Minecraft: 1.7.2, 1.7.3, 1.7.4, 1.7.5, 1.7.6, 1.7.7, 1.7.8, 1.7.9, 1.7.10, 1.8, 1.8.1, 1.8.2, 1.8.3, 1.8.4, 1.8.5, 1.8.6, 1.8.7, 1.8.8, 1.8.9, 1.9, 1.9.1, 1.9.2, 1.9.3, 1.9.4, 1.10, 1.10.1, 1.10.2, 1.11, 1.11.1, 1.11.2, 1.12, 1.12.1, 1.12.2, 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.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.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.2bukkit, folia, paper, purpur, spigot
Что нового
Support GriefDefender
Add four common flags
release
2.2.0
2.2.011 апр. 2026 г.119Minecraft: 1.7.2, 1.7.3, 1.7.4, 1.7.5, 1.7.6, 1.7.7, 1.7.8, 1.7.9, 1.7.10, 1.8, 1.8.1, 1.8.2, 1.8.3, 1.8.4, 1.8.5, 1.8.6, 1.8.7, 1.8.8, 1.8.9, 1.9, 1.9.1, 1.9.2, 1.9.3, 1.9.4, 1.10, 1.10.1, 1.10.2, 1.11, 1.11.1, 1.11.2, 1.12, 1.12.1, 1.12.2, 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.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.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.2bukkit, folia, paper, purpur, spigot
Что нового
Event handlers implementation
Allows to get world by protection range
Move IBlockProtectionModule
release
2.0.2
2.0.214 мар. 2026 г.40Minecraft: 1.7.2, 1.7.3, 1.7.4, 1.7.5, 1.7.6, 1.7.7, 1.7.8, 1.7.9, 1.7.10, 1.8, 1.8.1, 1.8.2, 1.8.3, 1.8.4, 1.8.5, 1.8.6, 1.8.7, 1.8.8, 1.8.9, 1.9, 1.9.1, 1.9.2, 1.9.3, 1.9.4, 1.10, 1.10.1, 1.10.2, 1.11, 1.11.1, 1.11.2, 1.12, 1.12.1, 1.12.2, 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.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.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, folia, paper, purpur, spigot
Что нового
Rename `IProtectionRangeInfo` to `IProtectionRange`
release
2.0.1
2.0.17 мар. 2026 г.26Minecraft: 1.8, 1.8.1, 1.8.2, 1.8.3, 1.8.4, 1.8.5, 1.8.6, 1.8.7, 1.8.8, 1.8.9, 1.9, 1.9.1, 1.9.2, 1.9.3, 1.9.4, 1.10, 1.10.1, 1.10.2, 1.11, 1.11.1, 1.11.2, 1.12, 1.12.1, 1.12.2, 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.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.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, folia, paper, purpur, spigot
Что нового
Support low versions
release
2.0.0
2.0.025 февр. 2026 г.28Minecraft: 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.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.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, folia, paper, purpur, spigot
Что нового
1. Breaking changes:
* IFlagState -> FlagState
* FakeEventMaker deleted
* and more...
2. Support IridiumSkyblock
3. Update debug command
release
1.1.1
1.1.112 февр. 2026 г.29Minecraft: 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.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.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, folia, paper, purpur, spigot
Что нового
Add debug command
Fix plugin.yml