HorizonSync
HorizonSync is a high-performance Fabric 1.21.1 mod designed to keep player data synchronized and secure using MongoDB. Whether you are running a single server looking for data redundancy or a network where player progress must be universal, HorizonSync ensures a seamless experience.
Features
Inventory & Equipment Sync: Full synchronization of the main inventory, armor, offhand items, and Ender Chest.
Experience & Stats: Your XP level, bar progress, health, food, and saturation stay exactly as you left them.
Potion Effects: Active status effects are automatically restored when a player joins the server.
High-Performance Persistence: Features a 3-minute asynchronous auto-save system and a synchronous "force-save" on server shutdown to prevent any data loss.
Mod Support
HorizonSync is built with deep integration for the most essential Fabric 1.21.1 APIs and mods:
Accessories API: Full synchronization of accessory slots and cosmetics.
Trinkets API: Complete support for all Trinkets slots.
Sophisticated Backpacks (Unofficial Fabric Port): All backpack contents are serialized and kept in sync.
How It Works
Unlike traditional methods, HorizonSync leverages MongoDB (NoSQL), allowing for extremely fast and flexible data writing:
On Join: Data is retrieved from the cloud and injected into the player via synchronized network packets.
During Gameplay: An asynchronous timer saves changes every 3 minutes without affecting the server's TPS (Ticks Per Second).
On Leave/Shutdown: A final save is performed to ensure every last movement and item is recorded.
Getting Started Installation: Place the HorizonSync .jar file into the mods folder of your Fabric 1.21.1 server.
MongoDB Configuration: Upon the first launch, a config file will be generated in the /config folder. Edit your MongoDB connection string (Local or Atlas) there.
Connection: Ensure your server's IP is whitelisted in your database firewall.
Ready to Go: HorizonSync will automatically create the necessary collections and begin protecting your data.
Configuration Options All settings are managed via the configuration file in the /config directory.
Database Settings uri: Your MongoDB connection string (e.g., mongodb+srv://user:pass@cluster.mongodb.net/).
database: The name of the database (Default: horizonsync).
collection: The specific collection for player data (Default: playerdata).
FAQ
Q: Why use MongoDB instead of MySQL? A: MongoDB allows for saving complex objects (like Item NBTs) much more efficiently, reducing lag when processing large or modded inventories.
Q: What happens if the server crashes? A: Thanks to the 3-minute auto-save system, data loss is minimized. Players will only lose, at most, their last few minutes of progress.
Q: Is it compatible with Singleplayer? A: HorizonSync is optimized for Dedicated Server environments. It is not recommended for local singleplayer worlds.
Q: Does it support items from other mods? A: Yes. As long as a mod stores its data within the standard Minecraft NBT, HorizonSync will serialize and sync it correctly.
HorizonSync – Your data, always on the horizon, always secure.
