Claim Plugin Compatibility & Audit Reference¶
This document provides the canonical compatibility, API interaction model, and version matrix for all 18 third-party land-claim and territory protection systems supported by LeafRTP (16 Bukkit/Paper/Folia checkers in LeafRTPClaimAddon and 2 native mod checkers on Fabric/NeoForge).
Claim integrations are packaged in addons/LeafRTPClaimAddon (Bukkit/Paper/Folia) and native mod platforms (rtp-fabric, rtp-neoforge). Every integration blocks teleports into claimed land.
1. Supported Integration Matrix¶
| Protection Plugin / System | Platform | Integration Seam | Query Style | Boundary Provider | Tested Upstream Releases |
|---|---|---|---|---|---|
| Towny Advanced | Bukkit / Paper / Folia | TownyAdvancedChecker |
Native CompileOnly (TownyAPI.isWilderness) |
Yes (TownyBoundaryProvider) |
0.100.x, 0.99.x, 0.98.x |
| GriefPrevention | Bukkit / Paper / Folia | GriefPreventionChecker |
Native CompileOnly (DataStore.getClaimAt) |
Yes (GriefPreventionBoundaryProvider) |
16.18.x, 16.17.x |
| Lands | Bukkit / Paper / Folia | LandsChecker |
Native CompileOnly (LandsIntegration.isClaimed) |
Yes (LandsChecker.getBoundaryAt) |
7.x, 6.x |
SaberFactions / FactionsUUID (Factions) |
Bukkit / Paper / Folia | SaberFactionsChecker |
Direct API (Board.getInstance().getFactionAt(new FLocation(Location)), Faction.isWilderness) |
Yes (FactionsBoundaryProvider) |
Best effort: compiled and tested against the published SaberFactions 4.1.4-STABLE, not a live server |
| FactionsBridge | Bukkit / Paper / Folia | FactionsBridgeChecker |
Reflective (FactionsBridge.getFactionsAPI().getFactionAt(Location), Faction.isWilderness) |
No | Best effort: tested against stubs of the 1.4.2 source, not a live server |
| GriefDefender | Bukkit / Paper / Folia | GriefDefenderChecker |
Native CompileOnly (G griefDefender.getCore().getClaimAt) |
No | 2.1.x, 2.0.x |
| WorldGuard | Bukkit / Paper / Folia | WorldGuardChecker |
Native CompileOnly (RegionManager.getApplicableRegions) |
No | 7.0.x, 7.1.x |
| RedProtect | Bukkit / Paper / Folia | RedProtectChecker |
Native CompileOnly (RedProtect.get().getAPI().getRegion) |
No | 7.7.x |
| Residence | Bukkit / Paper / Folia | ResidenceChecker |
Direct API (Residence.getInstance().getResidenceManager().getByLoc(Location)) |
No | Best effort: compiled and tested against the published 6.0.2.3, not a live server |
| CrashClaim | Bukkit / Paper / Folia | CrashClaimChecker |
Reflective (CrashClaim.getPlugin().getApi().getClaim(Location)) |
No | Best effort: tested against stubs of the 1.0.42 source, not a live server |
| HuskClaims | Bukkit / Paper / Folia | HuskClaimsChecker |
Direct API (BukkitHuskClaimsAPI.getInstance().isClaimAt(Position)) |
No | Best effort: compiled and tested against the published huskclaims-bukkit 1.5.10, not a live server |
| HuskTowns | Bukkit / Paper / Folia | HuskTownsChecker |
Direct API (BukkitHuskTownsAPI.getInstance().getClaimAt(Location)) |
No | Best effort: compiled and tested against the published husktowns-bukkit 3.1.4, not a live server; 2.x unsupported |
| PlotSquared | Bukkit / Paper / Folia | PlotSquaredChecker |
Direct API (Location.at(String, int, int, int), isPlotRoad, getPlot().hasOwner(); owned plots and roads rejected) |
No | Best effort: compiled and tested against the published plotsquared-core 7.6.0, not a live server |
KingdomsX (Kingdoms) |
Bukkit / Paper / Folia | KingdomsXChecker |
Reflective (Land.getLand(Location).isClaimed()) |
No | Best effort: written from the KingdomsX API wiki (no public source); not tested on a live server |
| UltimateClaims | Bukkit / Paper / Folia | UltimateClaimsChecker |
Reflective (UltimateClaims.getInstance().getClaimManager().getClaim(String, int, int); com.craftaro or com.songoda) |
No | Best effort: tested against stubs of the 2.4.0 source, not a live server |
| minePlots (mineCodes) | Bukkit / Paper / Folia | MinePlotsChecker |
Direct API (PlotServiceApi.getPlot(Location) from the ServicesManager) |
No | Best effort: compiled and tested against the published plugin-api 4.6.2, not yet a live minePlots server |
| FTB Chunks | Fabric / NeoForge | FTBChunksChecker |
Mod SPI (FTBChunksAPI.isChunkClaimed) |
Planned | 2001.x (1.20.x), 2100.x (1.21.x) |
| OpenPartiesAndClaims | Fabric / NeoForge | OpenPartiesAndClaimsChecker |
Mod SPI (IOpenPartiesAndClaimsAPI.isClaimed) |
No | 0.21.x+ |
2. API Design & Safety Contracts¶
Fail-Closed Execution¶
All checkers implement a strict fail-closed on error policy (leafrtp-ADR-088):
- If the claim plugin is not installed or not enabled, the check reports "not claimed".
- If the claim plugin is enabled and throws during verification, the destination is rejected and a warning is logged (throttled to one per minute per integration).
- If the claim plugin is enabled but its API does not match what the addon expects (missing class or method), every destination is rejected and one error is logged per integration until /rtp reload. Update the claim plugin or the addon, or set the integration's integrations.yml flag to false, to resume teleports.
Direct API and Reflective Integrations¶
Integrations marked Direct API or Native CompileOnly are compiled against the claim plugin's published API, so an upstream rename fails the LeafRTP build. Their classes are not bundled; the installed plugin supplies them, and they are only touched while that plugin is enabled.
Integrations marked Reflective (CrashClaim, FactionsBridge, KingdomsX, UltimateClaims) have no usable published API artifact. They look up the plugin's public API singletons at runtime and are tested against stubs copied from the plugin's source or documentation: - Graceful no-op when the plugin is absent or not enabled. - An API that no longer matches is caught at runtime (fail closed, one error per integration), not at build time.
Folia Threading Caveats¶
LeafRTP checks destinations across async workers and regional threads:
- Synchronous claim verifiers perform fast in-memory spatial tree lookups (DataStore, spatial hash tables, or chunk maps) without initiating disk chunk I/O, so they never load chunks on the main thread.
- Where claim plugins mutate internal state or are not thread-safe, LeafRTP provides asynchronous verification APIs (RegionVerifierRegistry.registerAsync) to safely hop to the target region thread when required.
3. Configuration¶
Claim verifiers are enabled in plugins/RTP/addons/integrations.yml:
version: 1.0
# Set a key to true to prevent RTP destinations from landing in protected land
rerollTownyAdvanced: false
rerollGriefPrevention: false
rerollLands: false
rerollWorldGuard: false
rerollSaberFactions: false
rerollGriefDefender: false
rerollPlotSquared: false
rerollHuskClaims: false
rerollHuskTowns: false
rerollKingdomsX: false
rerollResidence: false
rerollRedProtect: false
rerollCrashClaim: false
rerollUltimateClaims: false
rerollMinePlots: false
rerollFactionsBridge: false
Reload configuration at runtime via /rtp reload without restarting the server.