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 }
