Leiv’s Network Lib

🌐 Leiv’s Network Lib

Leiv’s Network Lib is the synchronization backbone of the Leiv Ecosystem Suite.

While my other libraries handle math and logic, this library ensures that the server and client talk to each other flawlessly. It is an ultra-performant networking framework built to synchronize feature flags, settings, and timers across the network instantly—without ever causing server lag. It ensures that mods like ItemCuller and others behave exactly as the server dictates, providing a seamless multiplayer experience.

⚠️ PLAYER NOTE: This is a required core dependency for mods within the Leiv Ecosystem. It does not add content or items on its own, but must be installed to ensure my utility mods sync correctly on multiplayer servers!

✨ Key Features

• ⚡ Ultra-Fast Synchronization: Designed for high-speed, synchronous client-server data exchange that guarantees players instantly receive the correct mod settings when joining a server.
• 🛡️ Zero Server Lag: Highly optimized payload handling ensures that network traffic is kept to an absolute minimum, protecting server TPS (Ticks Per Second).
• 🧩 Seamless Ecosystem Integration: Works hand-in-hand with Leiv’s API. Network flags pushed by the server are automatically and seamlessly injected into the client’s RuleEngine.
• 🔄 Instant Async Mirroring: The client efficiently mirrors received data in the background, updating active states without stalling the main game thread.

🛠️ Technical Highlights (For Developers & Modpack Creators)

Leiv’s Network Lib abstracts complex networking pipelines into a developer-friendly, highly robust system:

• 📡 LeivSyncServer: A powerful server-side manager that allows developers to push essential key-value pairs, timers, and feature flags to connected clients effortlessly.
• 🪞 LeivSyncState: An asynchronous, highly optimized client-side state holder. It instantly merges received payload values with a minimal memory footprint.
• ⚙️ Auto-Flag Injection: Network flags (using the flag: prefix) are automatically intercepted and injected into the client’s local configuration engine without requiring messy manual packet handling.
• 🔌 Version-Agnostic Design: The underlying CustomPayload system is heavily abstracted to allow for rapid porting across different loaders and game versions.

🔗 Dependencies

This library bridges the gap between the foundational code and the logic engine:

• Requires: Leiv’s Lib & Leiv’s API (Make sure both are installed!)
• Used By: ItemCuller and all other Leiv Ecosystem end-mods that require multiplayer sync.

💬 Community & Support

Got questions, feedback, or need to report a bug? Join the community!

• 👥 Discord: Join Leiv’s Community
• 🐛 Issue Tracker: Report bugs via the official Discord ticket system.