LeafRTP Architecture Decision Records¶
This directory contains Architecture Decision Records (ADRs) scoped to the LeafRTP plugin (../..). Repo-wide workflow and directory-structure ADRs live in docs/adr/, and standalone library/platform module ADRs live under their respective api/*/docs/adr/ and platforms/*/docs/adr/ directories.
Index¶
| # | Title | Status |
|---|---|---|
| leafrtp-ADR-001 | Archimedean Spiral 1D Mapping for Location Selection | Accepted |
| leafrtp-ADR-002 | H2/SQLite for Spatial Memory Persistence Over Flat-File Cache | Accepted |
| leafrtp-ADR-003 | rtp-plugin as a Separate Bridge Module from rtp-core |
Accepted |
| leafrtp-ADR-004 | Async Queue Pre-Generation Over On-Demand Async Selection | Accepted |
| leafrtp-ADR-005 | Per-User Isolated Queues Alongside the Global Queue | Accepted (operational details superseded by leafrtp-ADR-028) |
| leafrtp-ADR-006 | MemoryTracker as Active Task GC with WeakReference Deallocation |
Accepted |
| leafrtp-ADR-007 | Configurable Spatial Distributions: Flat, Normal, Exponential | Accepted |
| leafrtp-ADR-008 | rtp-api as a Separately Published Addon Interface |
Accepted |
| leafrtp-ADR-009 | ChunkReservation as an Internal Chunk Ticket Abstraction |
Accepted |
| leafrtp-ADR-010 | Addons as External Gradle Projects Rather Than Built-In Optional Modules | Accepted (partially superseded by leafrtp-ADR-012) |
| leafrtp-ADR-011 | Stale-Chunk Guard for Count-Bound Pipes | Accepted |
| leafrtp-ADR-012 | Claim-Plugin Integrations Folded Into rtp-plugin; Example Addon Retained |
Superseded by leafrtp-ADR-051 |
| leafrtp-ADR-013 | Language Bootstrap and Locale-Aware ConfigParser |
Accepted |
| leafrtp-ADR-014 | Region Shape Cache Key: Seed + Canonical Config Hash | Accepted |
| leafrtp-ADR-015 | Login Reserve Cache for Join-Time RTP | Accepted |
| leafrtp-ADR-016 | RTP Lite Assembly Variant | Superseded by leafrtp-ADR-078 |
| leafrtp-ADR-017 | External Hook API Surface | Accepted |
| leafrtp-ADR-018 | L3 Backlog Cache (backlogLocations) |
Accepted |
| leafrtp-ADR-019 | Teleport Pipeline Latency Histogram: 256-Sample Wait-Free Ring, Never Reset | Accepted (extended by leafrtp-ADR-036) |
| leafrtp-ADR-020 | Memory Shape Catalog and Polygon Shape | Accepted |
| leafrtp-ADR-021 | Interactive Menus via Written Book (Book-First, Chat Fallback; Optional User GUI via Addon) | Accepted (token-registry sections superseded by leafrtp-ADR-033) |
| leafrtp-ADR-022 | Network Mode: Multi-Server, Multi-Proxy RTP | Accepted |
| leafrtp-ADR-023 | Harden RTP Config Commands (Prerequisite for /rtpadmin Setup Wizards) |
Accepted |
| leafrtp-ADR-024 | /rtpadmin Setup Wizards (Book-Menu Driven, Config-Transaction Backed) |
Accepted |
| leafrtp-ADR-025 | /rtpadmin Diagnostic Surfaces (Biome Map, Bad-Selection Heatmap, Metrics Readouts) |
Accepted |
| leafrtp-ADR-026 | Cross-Backend Metric Time-Series Publication via MemoryTracker Tier Promotion |
Accepted |
| leafrtp-ADR-027 | /rtp config Command and Save Mechanics: Implementation Strategy (companion to leafrtp-ADR-023) |
Accepted |
| leafrtp-ADR-028 | rtp.personalqueue Permission Semantics: Bucket-Only Opt-In (supersedes operational details of leafrtp-ADR-005) |
Accepted |
| leafrtp-ADR-029 | /rtp docs Menu Consumer (Markdown -> MenuModel, converted at config load) |
Withdrawn (superseded by leafrtp-ADR-080) |
| leafrtp-ADR-030 | Declarative Chart Composition Bridge (ChartSpec + ChartSpecResolver + MapDispatch) |
Accepted |
| leafrtp-ADR-031 | Move menu page builders into rtp-api behind RTPServerAccessor |
Accepted |
| leafrtp-ADR-032 | Lift network-mode plumbing (NetworkModeBootstrap + 12 helpers) from rtp-plugin/bukkit/network/ to rtp-core |
Accepted |
| leafrtp-ADR-033 | Concrete Menu Commands Supersede Token Registries | Accepted |
| leafrtp-ADR-034 | Two-Tier API Extension Model | Accepted |
| leafrtp-ADR-035 | Outcome Metrics and Cause-Tagged Bad Locations | Accepted |
| leafrtp-ADR-036 | Pipeline Latency Percentiles and Slow-Teleport Audit (extends leafrtp-ADR-019; /rtp info readout) |
Accepted |
| leafrtp-ADR-037 | RTPRunnable Self-Scheduling Thread Routing (target/location + schedule() entity/region/async dispatch) |
Accepted |
| leafrtp-ADR-038 | PvP Combat Gate | Accepted |
| leafrtp-ADR-039 | Pluggable bare-/rtp root action (enables optional user GUI via example addon) |
Accepted |
| leafrtp-ADR-040 | Platform-agnostic addon SPI (RTPAddon + AddonRegistry ServiceLoader discovery) |
Accepted |
| leafrtp-ADR-041 | Region-Specific Schematic (.schem) Paste at the Arrival Location (SchematicPaster SPI) |
Accepted |
| leafrtp-ADR-042 | Relative Ground-Distance Safety Predicate (_groundDistance) |
Accepted |
| leafrtp-ADR-043 | Emergency-Platform Block-Restoration Timeout (safety.yml platformRestoreSeconds) |
Accepted |
| leafrtp-ADR-044 | Open-Core Dual Licensing | Superseded by ADR-108 |
| leafrtp-ADR-045 | Biome-Probability Weighting for Location Selection | Accepted |
| leafrtp-ADR-046 | Biome-First Menu with Auto-Region Selection by Biome Availability | Accepted |
| leafrtp-ADR-047 | World-Override Regions and the /rtp World Menu |
Accepted |
| leafrtp-ADR-048 | Foreign Config Importer (rtp config import <plugin>) |
Accepted |
| leafrtp-ADR-049 | Automatic PRESCAN, Adaptive Scan Rate Control, and .mca-Header Generation Check |
Accepted |
| leafrtp-ADR-050 | Cross-Server Persisted Teleport Limits | Accepted |
| leafrtp-ADR-051 | Claim Integrations Extracted to Bundled Addon (LeafRTPClaimAddon) |
Accepted (supersedes leafrtp-ADR-012) |
| leafrtp-ADR-052 | Platform-neutral /rtp command root (CoreRtpRoot) for Brigadier-bridged platforms |
Accepted |
| leafrtp-ADR-053 | Config Organization and Discoverability | Accepted (top-level layout superseded by leafrtp-ADR-058) |
| leafrtp-ADR-054 | Teleport View-Distance Clamp and Steady Restore | Accepted |
| leafrtp-ADR-055 | Config Default Inheritance via @<file> References |
Accepted |
| leafrtp-ADR-056 | Operator-Facing RTP Throughput and Cost Metrics | Accepted |
| leafrtp-ADR-057 | Platform-Neutral Player-Move Event SPI | Accepted |
| leafrtp-ADR-058 | Config Folder Consolidation | Accepted |
| leafrtp-ADR-059 | Composable Cache Pipeline Stages, Domain Stage Nomenclature, and Dynamic Hot Quota Allocation | Accepted |
| leafrtp-ADR-060 | Cause-Based TTL and Staged Expiration on Spatial Memory Segments | Accepted |
| leafrtp-ADR-061 | Opt-In Simulation Benchmark Tier | Accepted |
| leafrtp-ADR-062 | Unified Blocked Biome Run Table in MemoryShape |
Accepted |
| leafrtp-ADR-063 | Cache-Conscious B+ Tree of Primitive Array Pages for Spatial Run Memory | Not adopted - alternative considered |
| leafrtp-ADR-064 | Two-Tier Hierarchical Cell Routing | Superseded by leafrtp-ADR-065, declined by leafrtp-ADR-066 |
| leafrtp-ADR-065 | Layered Learned-State Index: Coarse Spiral Directory over Per-Cell Hilbert RLE Blobs | Rejected - superseded by leafrtp-ADR-066 |
| leafrtp-ADR-066 | Spiral-Addressed Hilbert Key Space for Learned State | Accepted |
| leafrtp-ADR-067 | External Web Map Integration via anvil-api, maps-api, and Spatial Memory |
Accepted |
| leafrtp-ADR-068 | Adaptive Compute Governor: Demand-Driven Backoff, Memory Backpressure, and Multi-Region Concurrency | Accepted |
| leafrtp-ADR-069 | Configurable Downsampling Stride Filter for Spatial Candidate Selection | Accepted |
| leafrtp-ADR-070 | Universal MapCanvas Bridge, Biome-Hazard Composite Overlays, and Visual Pipeline Gauges |
Accepted |
| leafrtp-ADR-071 | Test-Driver, Synthetic MCA Generator, and Dimension Benchmark Dataset | Accepted |
| leafrtp-ADR-072 | Hybrid Bit-Packed and 16-Bit Run Container Hazard Table | Accepted |
| leafrtp-ADR-073 | Declarative Scripted Actions via Core Confinement, Subspace Placement, and Minecraft Command Lifecycle | Accepted |
| leafrtp-ADR-074 | Subspace Anchor Providers, Near-Teleport Primitives, and External Verifier Perimeter Extraction | Accepted |
| leafrtp-ADR-075 | Per-Action Pre-Validated Caches and Bounded Subspace Placement Retries | Accepted |
| leafrtp-ADR-076 | Declarative Command Parameters, Per-Parameter Permissions, and Authoritative Defaults | Accepted |
| leafrtp-ADR-077 | Zero-Overhead Visual Region Creation via Ecosystem Selection Bridges and Cartography Models | Accepted |
| leafrtp-ADR-078 | Superseding leafrtp-ADR-016: Technical Parity and Pro as SLA & Support Tier | Accepted |
| leafrtp-ADR-079 | In-House SQL Connection Pool and Retirement of HikariCP | Accepted |
| leafrtp-ADR-080 | Ephemeral Web Editor and In-Game Packed Docs Integration | Accepted |
| leafrtp-ADR-081 | Intent-Based Documentation Architecture, Operator-Centric Routing, and Documentation Lifecycle Refinement | Accepted |
| leafrtp-ADR-082 | Shape Curve Helpers, Curve-Space Run Layers, and the Signed Two-Way Editor Channel | Accepted |
| leafrtp-ADR-083 | Addon Editor Extensions: Shared Data, Addon Tabs and Protocol Negotiation | Accepted |
| leafrtp-ADR-084 | Measured-Cost Probe-First Gate | Accepted |
| leafrtp-ADR-085 | Purpose-Gated Live Loads | Accepted |
| leafrtp-ADR-086 | Cost-Governed On-Demand Chunk Reads and Native Fallback Admission | Accepted |
| leafrtp-ADR-087 | Release Cadence: Contractual Pro Patches, Discretionary Lite Releases, One Version Line | Accepted |
| leafrtp-ADR-088 | Claim Checkers Compile Against Published Plugin APIs; Reflection Only Where None Exists | Accepted |
| leafrtp-ADR-089 | Slope Detection at the Landing Spot; Elevation and Slope Memory Recorded as Alternatives | Accepted |
| leafrtp-ADR-090 | Mountainside and Cliff-Edge Check over the Resident 3x3 Square | Accepted |
| leafrtp-ADR-091 | Built-In Test for Configuration and the Action Engine | Accepted |
| leafrtp-ADR-092 | Folia Tick-Region Allocation: Work Placement, Probed Shares, Steering and Lending | Accepted |
| leafrtp-ADR-093 | Consumer Attribution for Constrained Background Refill | Accepted |
Template¶
Use ADR-TEMPLATE.md when recording a new LeafRTP decision.