Tachyon

🌌 Tachyon — Next-Gen Distributed Player Data Engine

Tachyon is a high-performance player data management and cross-server synchronization system built for modern Minecraft networks (Paper, Purpur, Spigot).

By offloading all data persistence, locking, and serialization to a dedicated Quarkus 3.x microservice, Tachyon eliminates database overhead, race conditions, and inventory duplication glitches across your network.

✨ Features

• ⚡ Pure BSON & gRPC Streaming: High-throughput binary streaming using RawBsonDocument. Zero SQL queries and zero database lag on your Minecraft servers.
• 🔒 Distributed Session & Anti-Dupe Locking: Atomic Redis locks guarantee that player data is safely flushed and verified before cross-server hops.
• 📦 Dynamic Component Storage: Store player data as schema-free BSON documents in MongoDB with 100% NBT and ItemMeta fidelity. No database migrations required.
• ⏪ Granular Snapshots & Point-In-Time Rollbacks: Roll back a single component (e.g. only inventory or money) to any point in time without touching other data or restoring the whole database.
• 🧹 Automated S3 Archiving: Background archiver purges expired snapshots from MongoDB and pushes them into AWS S3 / MinIO for cost-effective cold storage.
• 🛡️ Resilient Local Recovery Queue: Spigot blocks new joins to protect state during network cuts, while active player mutations are queued locally and replayed upon reconnection.
• 📊 Full Observability: Integrated FastStats, Micrometer (:9100/metrics), native Quarkus metrics (:8080/q/metrics), and OpenTelemetry traces for Prometheus and Grafana.

🛠️ Requirements & Compatibility

• Runtime: Java 25+ (Virtual Threads enabled)
• Backend: Quarkus 3.x
• Datastores: Redis 6.x+, MongoDB 8.x+, (Optional) AWS S3 / MinIO
• Platforms: Paper / Purpur / Spigot 1.8 – 1.21+

🚀 Installation & Setup

1. Start the Quarkus Backend

Download tachyon-service-2.0.0-SNAPSHOT-runner.jar from our GitHub Releases and run:

java -jar tachyon-service-2.0.0-SNAPSHOT-runner.jar

(On first startup, a default config/application.yaml file is automatically created in your working directory for easy editing).

2. Install the Spigot Plugin

1. Drop tachyon-minecraft-plugin-2.0.0-SNAPSHOT.jar into your server's plugins/ directory.
2. Edit plugins/Tachyon/config.yml to point to your backend gRPC host & port (9000).
3. Restart your server!

📚 Links & Resources

• 💻 GitHub Repository: https://github.com/vSKAH/Tachyon
• 📦 Maven Repository (Reposilite): https://reposilite.skworks.tech/#/releases/tech/sk-works/minecraft
• 🐛 Issue Tracker: https://github.com/vSKAH/Tachyon/issues