20TPS — Server Optimization & Security

20TPS is a lightweight, high-performance optimization framework engineered explicitly for modern Minecraft servers (1.20.5 - 1.21.x+). It monitors your server’s ticking engine and eliminates lag vectors before they impact your community's gameplay.

---

🛠️ Optimization Modules

Mob Stacking

• Organic Chunk Grouping: Automatically merges identical entities within the same chunk into a single mob to cut down rendering and CPU pathfinding loops.
• 8x Stack Capacity: Limits stacked groups to a maximum of 8 entities per stack to keep a balanced vanilla aesthetic.
• Exploit-Proof Combat: Intercepts lethal damage on stacked entities; the stack size drops by 1 and health refreshes. This completely eradicates infinite loot duplication glitches.
• Balanced Dynamics: Stacked hostile monsters attack with vanilla base values, preventing players from being one-shotted.

Explosion Control

• Per-Tick Quotas: Restricts global explosive detonations to a strict threshold per server tick (Default: 20). Any overflow is instantly cancelled.
• Chain-Reaction Breakage: Actively strips unignited TNT blocks out of active blast radiuses to break intentional lag machines.
• Wither Mitigation: Disables structural terrain damage caused by Withers and Wither Skulls, stopping automated wither-mining loops.

Redstone Limiter

• Chunk-Based Caps: Enforces strict execution limits on block updates for intensive blocks like Pistons, Observers, and Armor Stands.
• Auto-Freezing: Instantly locks down a chunk's redstone network for a designated cooldown period if it exceeds the allowed updates per second.
• Punitive Warning Signs: Places custom text signs over the culprit redstone wiring to alert players.
• Administrative Alarms: Pushes real-time coordinate alerts directly into staff chat, exposing the nearest player to the lag source.

---

🛡️ Anti-Exploit Suite

• Login Turnstile: Restricts brute-force bot connections by enforcing a mandatory millisecond cooldown between incoming IP connections.
• Anti-Container Macro: Monitors inventory clicks. Players utilizing cheat client macros to rapidly manipulate items are instantly rate-limited.
• Boat-Fly Interception: Instantly dismounts and ejects any player attempting to fly or glide using boats.
• Combat Reach Guard: Validates attack vectors using maximum reach boundaries (3.3 blocks) and forces client hitboxes to align with server positioning.
• Void & Roof Defenses: Teleports falling void victims safely back to spawn and restricts Nether building heights to prevent out-of-bounds exploits.

---

📊 Analytics & Crashes

• Performance Diagnostics: In-game status command displaying 1, 5, and 15-minute TPS trends alongside player network latency metrics.
• Crash Logging: Monitors server shutdowns. It cross-references clean reboots versus unexpected sudden crashes, providing system administrators with explicit feedback upon joining.

---

⚙️ Configuration

Every single feature, message, and option is localized into a single, clean config.yml. All structural options are grouped together at the top, while all player-facing text strings are compiled into a unified translation directory at the bottom:

# SYSTEM MODULES AND TECH SETTINGS
item-despawn-timer: { enabled: true, despawn-seconds: 120, show-countdown: true }
void-protection: { enabled: true, trigger-y: -64, destination: "CURRENT_WORLD" }
mob-stacker: { enabled: true }