TickGrid

TickGrid: The Enterprise Server Core

TickGrid is an enterprise-grade, performance-obsessed monolithic core designed exclusively for modern PaperMC servers (Java 25 / Paper 26+).

Stop managing dozens of outdated, overlapping, and unoptimized plugins. TickGrid provides a unified, highly optimized ecosystem that handles everything from secure trading and team identity to asynchronous world generation and combat logging.

Engineered from the ground up for maximum TPS protection, every system within TickGrid is designed to keep the main thread clean. Heavy calculations are pushed off-thread, SQLite database queries are transaction-batched and asynchronous, and vanilla edge-case exploits are mathematically blocked.

---

Core Architectural Advantages

• The Module Engine: Total control. Don't want the Teleport Engine? Disable it in the config.yml. TickGrid strictly isolates modules—disabled features are never registered to the event bus, utilizing zero memory or CPU.
• Bulletproof Persistence: Powered by a HikariCP connection pool with SQLite Write-Ahead Logging (WAL) and JVM shutdown hooks. Your player data is immune to corruption, even during force-kills or server crashes.
• Memory Optimized: High-frequency events (like hotbar scrolling and combat) utilize millisecond-precise Caffeine caches and Garbage Collection optimizations to prevent RAM degradation.
• 100% Translatable: Every player-facing string, error, and hover-text is routed through messages.yml using modern MiniMessage formatting.

---

The Unified Ecosystem (Modules)

Combat & Progression

• Combat Logger: Prevents combat logging with offline marker entities, environmental kill attribution (void/fall damage credits the attacker), and deterministic penalties.
• Lifesteal Engine (Premium Parity): Eliminate players at zero hearts. Features a dynamic economy where admins can configure custom craftable Heart items, withdrawal commands, and offline-compatible Revive Beacons directly via JSON/YAML.
• Grace Period: Persistent early-game protection with BossBar countdowns, PvP/explosion cancellation, and a cinematic audio/visual finale.
• Strength & Bliss Cores: Craftable progression items granting transient, perfectly capped attribute modifiers (Attack Damage, Regeneration) that bypass vanilla exploit limits.

Community & Identity

• Teams System: Advanced team grouping with custom MiniMessage RGB logos via GUI. Includes proximity-based combat heuristics and formal war declarations.
• Stats & Leaderboards: Asynchronous, multi-metric tracking (Kills, Playtime, Animals Bred, etc.). Features an off-thread leaderboard compiler and automatic Discord webhook broadcasting.
• HybridAuth: Secure offline-account protection utilizing state-masking and safe-room mechanics that perfectly restore inventory and location upon authentication.

Server Utility & World Management

• Explosion Recovery: Automatically and deterministically regenerates terrain damaged by TNT or Creepers over time.
• Chunk Pre-Generator: Asynchronous world generation to eliminate exploration lag.
• Secure GUI Trading: Bulletproof, visual trading interfaces for safe player-to-player commerce.

---

Comprehensive Command Reference

Authentication

• /login <password> - Authenticate to your account this session. Used by cracked players and by premium players who could not be auto-verified.
• /register <password> <confirmPassword> - Create your auth account on first join[cite: 5].

Teleportation

• /tpa <player> - Request to teleport to a player.
• /tpaccept [player] - Accept a pending teleport request.
• /tpdeny [player] - Deny a pending teleport request.
• /rtp - Randomly teleport into the wild (async, lag-free).

Secure Trading

• /trade <player> - Request a secure, double-blind GUI trade with a player.
• /tradeaccept [player] - Accept a pending trade request.

Teams System

• /team <subcommand> - Team management with subcommands including create, invite, join, leave, kick, transfer, disband, pvp, info, list, setbanner, logo, setlogo, setcolor, and war.
• /teamadmin <subcommand> - Administrative team management (requires tickgrid.admin.teams) including forcejoin, forcekick, transfer, and disband.

Waypoints

• /waypoint set|remove|list|team <name> - Manage location beacons (client-side particle beams) that can be shared with your team.

Statistics & Leaderboards

• /stats [player] - View player statistics like kills, deaths, K/D, playtime, sleeps, and animals bred[cite: 5]. Online players read live, while offline players read persisted totals.
• /leaderboard <metric> [discord] - View the top-10 leaderboard for a specific metric. The optional discord arg posts the board to a webhook (requires tickgrid.admin.stats).

Lifesteal Engine

• /withdraw <amount> - Convert your own maximum hearts into physical Heart items[cite: 5]. Refuses if it would leave you at one heart or less.

Grace Period

• /grace <start|stop|add> [duration] - Manage the global persistent early-game grace period[cite: 5]. Requires tickgrid.admin.grace permission.

Combat Logger

• /screcover <player> - Recover the latest stored combat-log snapshot for a player (requires tickgrid.admin.recover).

World Management & Pre-Generation

• /pregen start|stop|status - TPS-aware background world pre-generation (requires tickgrid.admin.pregen).

Performance & Administration

• /tickgrid <status|reload|gc|pregen> - Admin dashboard and control.
• /tickgrid reload - Reparses config.yml and messages.yml and live-reloads modules without touching the DB pool (requires tickgrid.admin.reload).
• /tickgrid status, /tickgrid gc, /tickgrid pregen - Require tickgrid.admin.status permission.

Proximity Voice

• /voice - Get your proximity voice session token for the companion client.

---

Built for the Future

TickGrid is not just a plugin; it is the server-side foundation for ClientGrid, an upcoming companion Fabric mod that will natively render team nametags, combat HUDs, and waypoint particle beams using custom plugin-message channels.

Take control of your server. Drop the clutter. Install TickGrid.