Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
π Tachyon v2.0.0-beta.1 β Next-Gen Distributed Player Data Engine
We are thrilled to announce the first pre-release of Tachyon 2.0!
This major release is a complete re-architecture of Tachyon, moving away from legacy database models to a high-throughput, zero-loss reactive microservice powered by Quarkus 3.x, pure BSON gRPC streaming, Redis distributed locks, asynchronous DB batching, and MongoDB.
β οΈ Pre-Release Notice: This build is intended for testing and staging environments. Please report any issues or feedback on our GitHub Issues.
π Key Highlights & What's New
β‘ Pure BSON & High-Throughput DB Batching
- Dynamic BSON Components: Stored as schema-free BSON documents preserving 100% NBT, ItemMeta, and custom component fidelity without schema migrations.
- RawBsonDocument Streaming: Direct binary BSON streaming over gRPC eliminates conversion overhead.
- Asynchronous DB Batching: Database writes (MongoDB & Redis Streams) are now processed in bulk batches (
bulkWrite), drastically reducing I/O roundtrips and keeping DB latency minimal during traffic peaks.
π Distributed Session & Anti-Dupe Locking
- Redis-backed atomic profile locks guarantee that player data is safely saved and loaded before server switches.
- Completely eliminates race conditions and inventory dupe glitches during cross-server hops.
βͺ Granular Snapshots & S3 Cold Archival
- Zero-CPU Compression: Removed application-level zstd compression from Spigot and Quarkus, delegating compression natively to MongoDB (WiredTiger).
- Automated S3 Archiver: Old snapshots are automatically purged from MongoDB and archived into AWS S3 / MinIO.
π‘οΈ Resilient Local Recovery Queue
- The Spigot plugin safely rejects new player logins if the backend is unreachable to protect state, while active player mutations are buffered locally and replayed with zero data loss upon reconnection.
π Observability, FastStats & Diagnostics
- FastStats & Micrometer (Spigot): Integrated FastStats and Micrometer on the Minecraft plugin with dedicated scrapers (
TachyonMetrics,VanillaMetrics) to track TPS, JVM specs, memory pools, GC pauses, and internal queue sizes in real time with near-zero overhead. - Richer gRPC Health-Checks: Revamped the gRPC health-check service (
/ping) with detailed diagnostics, reporting live MongoDB/Redis connectivity, cached health states, and node status metrics. - Upgraded Grafana Dashboards: Refreshed ready-to-use Grafana dashboards to visualize player sync latencies, database bulk throughput, stream queues, and FastStats metrics live.
βοΈ DevOps & DX Improvements
- Automatic Config Export: Generates
config/application.yamlon first boot for seamless Docker and bare-metal editing. - Standalone Uber-JAR: Added a dedicated Maven profile (
-Puber-jar) to generate a single self-contained runnable JAR.
π¦ Artifacts in this Release
| File | Type | Description |
|---|---|---|
tachyon-service-2.0.0-SNAPSHOT-runner.jar |
Backend (Uber-JAR) | Standalone Quarkus backend (run with java -jar). |
tachyon-minecraft-plugin-2.0.0-SNAPSHOT.jar |
Spigot / Paper Plugin | Drop into your Minecraft server's plugins/ directory. |
tachyon-minecraft-example-2.0.0-SNAPSHOT.jar |
Example Plugin | Reference implementation (Tachyon-Cookies) demonstrating custom components. |
π οΈ Quick Start
1. Start the Backend
java -jar tachyon-service-2.0.0-SNAPSHOT-runner.jar
(On first startup, a default config/application.yaml file will be automatically generated in your working directory for easy editing).
2. Install the Spigot Plugin
- Drop
tachyon-minecraft-plugin-2.0.0-SNAPSHOT.jarinto your server'splugins/folder. - Configure
plugins/Tachyon/config.ymlto point to your backend gRPC host & port. - Restart your server.
π Documentation & Requirements
- Java Runtime: Java 25+ (Virtual Threads enabled)
- Datastores: Redis 6.x+, MongoDB 8.x+
- Platforms: Paper / Purpur / Spigot 1.8 β 1.21+
- Full Documentation: https://vskah.github.io/Tachyon/
β€οΈ Feedback & Support
Found a bug or have a suggestion? Open an issue on GitHub Tracker or join our community discussions!
Platforms
Paper
1.8β1.21.11
Dependencies
Paper