ZeroBlockBridge

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. Host a server to play with friends and community — without complex setup, port forwarding or unsafe configurations.

---

Features

• Server Management: 3-step wizard, multi-version (Vanilla/Fabric/Forge/Paper/Purpur), smart caching, RAM allocation, properties editor, integrated console.
• Automation & Backups: One-click ZIP backups, scheduled restarts (interval or daily time), multi-stage warnings with countdown.
• Modrinth Mod Browser: Search, filter, one-click install, manage installed mods, check updates against Modrinth API.
• Tunneling: Built-in Playit.gg integration, persistent sessions, soft/full reset, DNS recovery chain, agent heartbeat.
• Auto-Healing: Watchdog (crash detection), heartbeat (zombie detection), lag monitor, command sanitizer — see ARCHITECTURE.md.
• Developer Experience: JDK auto-installer (Adoptium 17-21), event-driven architecture, thread safety, zero bare except: blocks.

---

Quick Start

Prerequisites

• Python 3.10+ (Download)
• Java: Not required manually. The app automatically detects, downloads, and caches the correct JDK (Adoptium, range 17-21) based on the selected Minecraft version.

Installation

1. Clone the repository

   git clone https://github.com/DesvoSoft/ZeroBlockBridge.git

2. Navigate to the project folder

   cd ZeroBlockBridge

3. Install dependencies

   Create a virtual environment (recommended):

   Windows:

   py -m venv venv
   .\venv\Scripts\activate

   Linux/macOS:

   python3 -m venv venv
   source venv/bin/activate

   Install dependencies:

   pip install -r requirements.txt

4. Run the application

   py app/launcher.py

   Depending on your OS, you might need python or python3 instead of py.

First Server

1. Click "Create Server" in the sidebar.
2. Follow the 3-step wizard (identity, engine/resources, rules/world).
3. The wizard shows detailed progress (download, verify, scaffold, bytecode analysis, tunnel setup).
4. After creation, click "Start Now" to launch your server.
5. Optional: Click "⚡ Link" to enable Playit tunneling and play with friends online.

---

Project Structure

ZeroBlockBridge/
├── app/
│   ├── ui/              # Presentation layer (main window, wizard, editors, browser)
│   ├── core/             # Orchestration & business logic (ZBBManager, EventBus, logic)
│   └── services/         # Specialized services (watchdog, heartbeat, backups, API clients)
├── docs/                 # Documentation
├── assets/               # App icon and logo
├── servers/              # (Generated) per-server directories
├── backups/              # (Generated) ZIP archives
├── bin/                  # (Generated) playit agent binary
├── .zbb_cache/           # (Generated) JDK cache
└── config/               # (Generated) app configuration

---

Documentation

• ARCHITECTURE.md — Auto-healing system, technical details, architecture overview.
• SKILL.md — AI assistant guidelines for development.
• STANDARDS.md — Master technical standards and architecture guide.
• ROADMAP.md — Development roadmap and phase tracking (local-only, untracked from repo).

---

Contributing

Contributions, issues, and pull requests are welcome!

---

License

ZeroBlockBridge © 2025-2026 by DesvoSoft.

Licensed under the PolyForm Noncommercial License 1.0.0 — no commercial use.

View Full License Text

---

Support

• Issues: Report bugs or request features via GitHub Issues.
• Discussions: Share setups and get help from the community.

---

Built by a player, for players, Minecraft creators & friends