RTP Addons Requirements¶
This document details the requirements and constraints for any external addons integrating with the RTP plugin.
1. Strict Architectural Requirements¶
1.1 Fault Encapsulation and Isolation¶
- Strict Isolation: External addons (e.g.,
LeafRTPCountdownAddon) must execute within strict isolation. Listeners and validation checks must wrap their logic intry-finallyblocks to guarantee that third-party database timeouts or API errors do not fail the parent RTP queue pipelines. The claim-plugin integrations formerly shipped asRTP_ClaimPluginIntegrationsnow ship as the bundledLeafRTPClaimAddon(see ADR-069, superseding ADR-019); the standaloneRTP_Glideaddon was folded intoeffects-apias theGLIDEeffect (effects-api-ADR-001); the experimentalRTP_Iris_integrationaddon has been removed (the Iris world generator works against the standardorg.bukkit.WorldAPI without dedicated integration); third-party addons should consultLeafRTPCountdownAddonas the canonical template.
1.2 Non-Blocking Operations¶
- Strict Adherence to Non-Blocking IO: Addons interacting with land-protection or biome APIs must perform verifications asynchronously. Pausing the main thread or halting a teleport queue while waiting on a synchronous third-party claim check is strictly prohibited.
1.3 Memory Management¶
- Scoped Memory Bounding: Addons must not maintain unbounded collections of active teleport states. They must limit their footprint by dynamically querying the core
MemoryTrackeror leveraging scoped, lock-free caches to maintain performance consistency.
1.4 Bundled Addons¶
- Removable and Replaceable: An addon bundled inside the RTP distribution jar (e.g.,
LeafRTPGuiAddon,LeafRTPClaimAddon,LeafRTPCountdownAddon,LeafRTPActionAddon) shall depend only onrtp-api, shall not be required for core teleportation to function, and shall be removable by deleting its extracted jar fromplugins/RTP/addons/. A third-party addon implementing the same SPI (e.g., the ADR-056 bare-/rtproot action for GUIs) shall be able to replace it without core changes. Operator-facing behaviour is documented indocs/admin/ADDONS.md.