Skip to content

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.