This project is in an early stage of development and is constantly being refined. For the latest information, please check our Discord regularly! To test the cloud, you can create a ticket on our Discord.
Important
The system is not yet suitable for productive use and should only be used for testing purposes!
ByteStorm is a modular, high-performance cloud system for Minecraft server networks.
It was developed from scratch in Java to ensure scalability, extensibility, and maintainability.
It follows the principle: “One module, one task – maximum impact!” 🧠💻
The cool thing about the project? It is completely open source! Anyone can join in and expand the system.
Everyone is welcome to participate in the development and customize the system according to their own needs.
To get involved, check out the Contributing Guidelines.
- 🚀 Information
- 📖 Table of Contents
- 📦 Module Overview
- common/ – Utilities & shared logic for all modules
- core/ – Central control unit & main server logic
- api/ – Public API for external plugins & tools
- bridge/common/ – Common logic for all bridge modules
- bridge/velocity/ – Proxy connection for Velocity
- bridge/proxy-legacy/ – Legacy proxy connection (BungeeCord & Waterfall)
- bridge/paper/ – Paper server connection
- controller/ – CLI & web controller for administration
- agent/ – Remote agent on target servers
- dashboard/ – Optional web dashboard for administration
- 🔧 Technical overview
- 📁 Module structure
- 🚀 Target audience
- ✨ Still in planning
- 📖 License
- 📞 Contact
Here you will find an overview of all modules and their respective responsibilities in the ByteStorm ecosystem:
This module contains general classes and tools that are shared by all other modules:
- Configuration handling
- Logging system
- Utility classes (e.g., for files, time, threads)
- Shared interfaces & enums
The heart of ByteStorm – executes the server logic:
- Starts and manages internal services
- Lifecycle management (start, stop, reload)
- Event system & command handling
- Coordination of all subsystems
External plugins or tools can use this module to interact with ByteStorm:
- Server groups and templates
- Player information
- Interfaces for third-party developers
- Status and query APIs
Contains common logic for all bridge modules:
- Common interfaces and classes
- Utility functions for communication
- Event handling for all Minecraft server instances
- Synchronization tools
- Configuration management for bridge modules
Ensures communication between ByteStorm and Minecraft instances:
- Forwards player events
- Synchronizes data via proxies
- Enables central control via proxy
For older BungeeCord installations that have not yet switched to Velocity:
- Offers similar functionality to
bridge/proxy/ - Compatibility with existing BungeeCord setups
- Enables migration to Velocity in the future
Caution
This module is included for compatibility purposes only and will not be further developed once it is stable.
Connects ByteStorm directly to Paper servers:
- Does the same as
bridge/spigot/, but optimized for Paper server features - Use of Paper-specific APIs
- Extensible for future Paper versions
Control ByteStorm conveniently via a command line or web UI:
- CLI input & parsing
- Web server with REST API
- Authentication & access control
- Management of server groups and templates
- Real-time status queries
- Webhooks for external integrations
Runs directly on Minecraft servers for remote control:
- Starts/stops Minecraft instances
- Sends status data back to Core
- Updater & heartbeat system
Attractive, modern UI for managing your server structure:
- Displays player & server status
- Start/stop servers via the web
- Manage templates & groups
- User management with tokens
- Language: Java 21
- Build system: Gradle (Groovy DSL, multi-module)
- Design principles: OOP, single responsibility, dependency injection, modularity
- Goal: High-performance, expandable Minecraft cloud system with professional infrastructure
ByteStorm/
├── common/ → Shared code
├── core/ → Central control
├── api/ → Public API
├── bridge/ → Connection to proxies
│ ├── common/ → Shared logic for all bridge modules
│ ├── velocity/ → Velocity proxy
│ ├── proxy-legacy/ → BungeeCord proxy
│ ├── spigot/ → Spigot connection
│ ├── paper/ → Paper connection
│ ├── aspaper/ → Advanced Slime Paper connection
│ ├── purpur/ → Purpur connection
│ ├── folia/ → Folia connection
│ └── minestom/ → Minestom connection
├── controller/ → CLI & Web server
├── agent/ → Remote agent
├── dashboard/ → external admin interface
└── README.md → Documentation
- Developers of Minecraft server networks
- Plugin developers who need server-side control
- Server administrators who want an easy-to-control but powerful system
- Database modules (Redis/MySQL)
- Plugin marketplace
- Extension API
- Discord bot for control via chat
ByteStorm is licensed under the MIT License.
Do you have questions, ideas, or just want to get involved? Check out our Discord or open an issue on GitHub!
Ready to take your network to the next level? Welcome to ByteStorm! 🫡⚔️
This project was created by whynotmax and the nextforge.gg team.
©️ 2025 ByteStorm Team. All rights reserved.