Sapling Optimizer Documentation Overview Sapling Optimizer is a lightweight Paper 1.21+ performance plugin designed to automatically reduce server lag by dynamically optimizing entities, chunks, and visual effects based on real-time TPS. It runs silently in the background and only activates when your server begins to experience performance drops, ensuring smooth gameplay without permanent changes to vanilla mechanics. ⚙️ How It Works Sapling Optimizer continuously monitors server TPS (ticks per second). Based on performance, it switches between two modes: Normal Mode (TPS ≥ 18) Vanilla Minecraft behavior is fully preserved No optimizations are applied No gameplay interference Optimization Mode (TPS < 18) Automatically activates performance improvements: Reduces entity processing load Optimizes mob AI in distant chunks Enables entity stacking system Reduces particle overload Improves chunk handling efficiency Features TPS Monitoring System Real-time server performance tracking Automatic switching between normal and optimized modes Entity Optimization Disables AI for mobs far from players Reduces unnecessary entity ticking Groups large amounts of identical entities into stacks Example: Bamboo [x300] Chunk Optimization Prevents unnecessary chunk processing Reduces load from inactive areas Improves overall server stability during high load ✨ Particle Optimization Limits excessive particle effects during lag Prevents visual overload from explosions and effects Safety Design Sapling Optimizer is built to ensure: No impact on nearby players No removal of important entities (bosses, NPCs) No permanent gameplay changes Fully safe for survival SMP servers Commands /sapling status Displays current TPS and optimization state. /sapling reload Reloads the configuration file. Requirements Minecraft: 1.21+ Server: Paper or Paper fork Java: 17+ Installation Download the plugin .jar Place it in your /plugins folder Restart your server Configure config.yml if needed ⚙️ Configuration YAML optimization: tps-threshold: 18
entity-stacking: enabled: true
particles: reduce-on-lag: true Performance Philosophy Sapling Optimizer does NOT try to permanently change Minecraft. Instead, it: “only intervenes when the server actually needs help” This ensures: Stable gameplay Minimal interference Maximum performance during stress Author Credit Developed by Syd Professional Minecraft Developer creating free and optimized server tools.