Minecraft Server Management with Built-in Tunneling, Backups & Automation
ZeroBlockBridge is a desktop application that simplifies Minecraft server creation and management, designed with the intent to provide a user‑friendly interface that can safely turn any computer into a Minecraft server. With Zero Block Bridge, you can easily host a server to play with your friends and community — without the hassle of complex setup, port forwarding or unsafe configurations.
- Creation Wizard: 6-step guided setup with preview and validation.
- Multi-Version Support: Vanilla, Fabric, and Forge with dynamic version fetching (hundreds of versions).
- Custom RAM Allocation: Slider + manual entry with validation (512MB - system max).
- Server Properties Editor: Tabbed interface for all settings.
- Integrated Console: Send commands directly from the app.
- Live Monitoring: Real-time server and tunnel logs in separate tabs.
- One-Click Backups: Create and restore ZIP backups instantly.
- Scheduled Restarts:
- Interval mode (every X hours).
- Daily time mode (specific time like 03:00).
- Multi-stage warnings (1h, 30m, 15m, 1m, countdown).
- Automatic success/error notifications.
- Auto-Management: Set it and forget it with automated restarts + backups.
- Built-in Playit.gg Integration: No port forwarding needed.
- One-Click Tunnel Setup: Auto-opens claim link in browser.
- Public IP Display: Share the provided public address.
- Auto-Update: Agent stays up to date automatically.
Note: playit.gg is a global proxy that allows anyone to host a server without port forwarding by using tunneling.
- Modern GUI: Clean dark theme built with CustomTkinter.
- Cross-Platform Sound: Reliable notifications on Windows and Linux.
- Java 24 Support: Fully compatible with latest Java versions.
- Error Handling: Comprehensive validation and user feedback.
- Organized Structure: Dedicated folders for each server.
The application features:
- Sidebar: Server list with selection.
- Dashboard: Server/tunnel controls, auto-restart settings, quick backup.
- Tabbed Console: Separate logs for Server and Tunnel output.
- Console Input: Send server commands directly from the UI.
- Properties Editor: 6 tabs (General, World, Network, Advanced, Backups, Automation).
- Clone the repository
git clone https://github.com/DesvoSoft/ZeroBlockBridge.git- Navigate to the core app folder
cd ZeroBlockBridge/app- Install dependencies
Create a virtual environment (recommended):
py -m venv venv
.\venv\Scripts\activateInstall dependencies:
pip install -r requirements.txt- Run the application
py main.pyNote: Depending on your operating system and environment configuration, you might need to adjust the command used to run Python. For example, use
py,python, orpython3as appropriate.
- Click "Create Server" in the sidebar.
- Follow the 6-step wizard to configure your server.
- Select the server from the list.
- Click "Start". On the very first run, the server will start, create necessary files, and then you can stop it. On the second start, your settings from the wizard will be applied.
- Optional: Enable tunneling to play with friends online.
Note: The tunneling feature uses the free third party services from Playit.GG. The app will lead to their website and the respecitve dashboard to connect the agent, the tunnel, and to confirm your shearable IP (One time process).
- USAGE.md - Complete user guide with all features.
- TESTING.md - Test cases and verification steps.
The wizard guides you through:
- Type & Name: Choose Vanilla/Fabric/Forge and select Minecraft version, then name your server.
- RAM: Use slider or type exact MB value (with validation).
- World Settings: Seed, game mode, difficulty, view distance, simulation distance.
- Server Icon: Upload custom PNG/JPG icon (optional, resized to 64x64).
- Location: View save location (custom paths coming soon).
- Review: Confirm all settings before creation.
Configure from the dashboard or properties editor:
- Interval Mode: Restart every X hours.
- Daily Time Mode: Restart at a specific time (e.g., 03:00 for 3AM).
- Warnings: Players get in-game notifications starting 1 hour before restart.
- Final Countdown: A 5-second countdown is announced in-game before shutdown.
- Create: Dashboard button or Properties → Backups tab.
- Format: ZIP archives with timestamp (
backup_YYYYMMDD_HHMMSS.zip). - Restore: Select backup in properties editor (wipes current server!).
- Storage:
servers/<server-name>/backups/.
Send any Minecraft command:
say Hello everyone!
op PlayerName
gamemode creative PlayerName
Commands appear in the log with > prefix and execute immediately.
ZeroBlockBridge is designed with simplicity and transparency in mind:
- No External Connections: The software does not connect to any external services other than the free tunneling services provided by Playit.gg.
- No Data Collection: ZeroBlockBridge is not intended to collect, store, or transmit any personal information or usage data.
- User Control: All server management, backups, and tunneling operations remain fully under the user’s control.
This ensures that your Minecraft server management experience is secure, private, and limited strictly to the features described.
The project follows a clean architecture, separating UI, business logic, and services.
ZeroBlockBridge/
├── app/
│ ├── main.py # Main application, UI layout, and coordination
│ ├── logic.py # Core business logic & Sound Utility
│ ├── constants.py # File paths, URLs, and configuration constants
│ ├── app_config.py # UI configuration (colors, fonts, window settings)
│ ├── version_manager.py # Dynamic version fetching, caching, and URL resolution
│ ├── server_events.py # Event system for server state notifications
│ ├── scheduler_service.py # Handles the logic for automated restarts
│ ├── playit_manager.py # Manages the playit.gg tunneling agent
│ ├── server_wizard.py # UI and logic for the 6-step creation wizard
│ ├── server_properties_editor.py # UI for the server properties editor
│ ├── ui_components.py # Reusable UI widgets (console, list items)
| └── requirements.txt # Project dependencies for pip
│
├── assets/ # Other misc files
│ ├── notification.wav # Notification sound effect
| ├── icon.ico # App icon
| └── logo.png # Project logo
|
├── docs/
│ ├── USAGE.md # User guide
| └── TESTING.md # Test documentation<server-name>/
|
├── servers/ # (Generated) Created servers are stored here
│ └── <server-name>/
│ ├── server.jar
│ ├── server.properties
│ ├── metadata.json # Stores RAM allocation, scheduler config, etc.
│ └── backups/ # Server backups stored here
│ └── YYYY-MM-DD_HH-MM-SS.zip
│
├── bin/ # (Generated) Binaries like the playit agent
│
├── config/ # (Generated) Playit.gg agent configuration
│ └── config.json # (Generated) App-level configuration
│
└── README.md # This file c:
Zero Block Bridge uses dynamic version fetching to automatically support hundreds of Minecraft versions:
- Vanilla: Fetches top 20 latest releases from Mojang API (e.g., 1.21.1, 1.20.1, 1.19.4) + popular versions (1.18.2, 1.16.5, 1.12.2, 1.8.9, etc.)
- Fabric: Fetches top 20 stable game versions from Fabric Meta API with latest installer
- Forge: Fetches top 50 versions from Forge Promotions API with recommended/latest builds
- Auto-Update: Version cache refreshes every 24 hours automatically
- Cache Location: Stored in
config/versions_cache.jsonfor offline access
- OS: Windows/Linux
- Python: 3.10 or higher
- Java: 17 minimum, 24 supported (This might also depend on your desired Minecraft server version)
- RAM: 2GB minimum (4GB+ recommended for modded servers)
- Disk: 37 MB for core app and dependencies + ~107MB per server (vanilla, it might vary for modded servers) + world size
All required Python packages are listed in requirements.txt. The dependencies are:
- customtkinter – Modern graphical user interface framework for Python.
- requests – Handles HTTP requests for downloading server files and updates.
- psutil – Provides system information (CPU, RAM, processes) for resource management.
- packaging – Utilities for version parsing and dependency handling.
- playsound==1.2.2 – Lightweight library for playing notification sounds.
- Pillow – Image processing library, used for server icon feature.
Contributing, issues and pull requests are welcome! Feedback is always appreciated ❤️
ZeroBlockBridge © 2025 by DesvoSoft.
This project is licensed under the PolyForm Noncommercial License 1.0.0.
- No Commercial Use — You may not use this software for any commercial purpose. This includes:
- Selling the software or any modified version of it.
- Using the software as part of a paid hosting service.
- Using the software to support the operations of a for-profit business.
- CustomTkinter: Modern UI Python framework by Tom Schimansky.
- Playit.gg: Free tunneling service for easy multiplayer.
- Minecraft/Mojang: For creating an amazing game.
- Documentation: See docs/USAGE.md for detailed instructions.
- Issues: Report bugs or request features via GitHub Issues.
- Discussions: Share your server setups and get help from the community.
