The Professional Hybrid Cloud Platform for Java & Bedrock Infrastructure
CraftCommand is a professional-grade orchestrator that bridges the gap between simple local launchers and complex enterprise infrastructure. It provides monolithic management with a distributed data plane, designed to prevent mistakes, explain problems, and scale safely from solo use to massive networks.
Features • Architecture • Quick Start • Security Model • Full Docs
Most hosting solutions are either too fragile (Basic .bat files) or too complex (Enterprise panels requiring Linux degrees and hours of setup). CraftCommand offers a third way: Hybrid Orchestration.
- Easier than a Batch File: One click to start. No editing text files to fix RAM or Java versions.
- Unified Engine: Native support for Java (Paper, Spigot, Vanilla) and Bedrock Edition (Dedicated Server) with software-aware configurations.
- Simpler than Enterprise: Runs on Windows, installs in seconds, and scales with Zero-Knowledge worker nodes.
| Feature | Standard Launchers | Enterprise Panels | CraftCommand (v1.11.8) |
|---|---|---|---|
| Ideal For | Testing | Reselling & Large Networks | Home Hosting & Private Use |
| Setup Time | Instant | Hours (Linux req.) | Instant (Zero-Config) |
| Architecture | Local Child | Distributed Docker | Hybrid (Local + Agents) |
| OS Synergy | All | Linux First | Universal (Win Panel + Lin Nodes) |
| Resilience | Crash = Dead | Auto-Restart | Auto-Healing v3 (Sentinel) |
| Networking | Manual Port Fwd | Reverse Proxy | Proxy Orchestration (Velocity) |
| World Data | Level Fold | Manual Database | World Intelligence (Dynmap) |
| Environment Fix | Manual Install | Error & Exit | Integrated Auto-Fix (Heuristic) |
| File Transfer | Local Only | SFTP Client Req. | Secure Chunked Sync (Built-in) |
| UX Design | Industrial/Flat | Functional/Busy | Premium Glassmorphic IDE |
| Audit Logging | ❌ | Per-Instance | Immutable Cluster-Wide Ledger |
| Software Support | Java Only (typ.) | Universal | Java & Bedrock (Optimized) |
Manage multiple servers with a professional, data-dense interface.
The cluster-wide "God View"
- Resource Heatmap: Real-time spatial visualization of CPU/RAM density across the entire cluster with load-aware color coding.
- Environment Health: Integrated prerequisite detection and normalization (Java 8-21, Docker, Git, Permissions).
- One-Click Heuristic Fix: Automatically repair remote node environments directly from the UI using targeted diagnosis.
- Node Capabilities: Instant advertising of host capabilities (OS, Core Count, Virtualization Status).
Deep spatial visibility into your worlds
- Dynmap Integration: Professional one-click installation and verification suite for real-time world maps.
- Viewport Control: Native embedded map viewports with secure proxy-forwarding.
- Remote Render Triggers: Trigger update, full, or radius renders directly from the panel without console access.
- Health Handshake: Automated telemetry verification via internal service probes.
High-performance network management
- Native Velocity Support: Full-stack integration for high-performance proxies with automated lifecycle management.
- Via Suite Automation: One-click deployment of the ViaVersion suite (Backwards, Rewind) for multi-version compatibility.
- Forwarding Synchronization: Automated management of modern/legacy forwarding secrets and backend server links.
- Connectivity Mapping: Visual management of server aliases and priority join lists.
- Sentinel Throttling: Proactive system sentinel that protects the host by throttling recoveries during CPU/RAM/IO overload.
- Drift Detection: Automatic repair of "Zombie" instances (Status ONLINE but PID missing) and orphaned processes.
- Stateful Recovery Pipeline: Multi-stage repair logic (Triage -> Scrap -> Start -> Verify) with stability scoring.
- Safe Mode Protection: Panic control system that isolates failing instances to prevent host exhaustion.
Production-grade safety for your cluster
- Industry-Standard Security: Integrated Ed25519 signature verification and SHA256 hashing for all system updates.
- Atomic State Transitions: Safe file swapping with automated backup and rollback pathways to prevent data corruption.
- Maintenance Dashboard: Professional embedded update interface with real-time progress and diagnostic feedback.
- Protocol Guardians: Intelligent checks that ensure distributed nodes and proxies remain compatible during upgrades.
Unified Java & Bedrock gameplay
- One-Click Integration: Native Geyser and Floodgate orchestration for seamless Bedrock client connections.
- Automated Networking: Intelligent UDP port management and real-time connectivity diagnostics.
- Floodgate Optimization: Zero-config authentication mapping for unified player identities across platforms.
Zero-config remote connectivity
- Cloudflare Tunnels: Integrated one-click provisioning for secure global access without manual port forwarding.
- Dynamic DNS (DDNS): Native DuckDNS synchronization and real-time propagation monitoring.
- Hosting OS Mode: Specialized service layer for bare-metal resource isolation and disk quota enforcement.
- Embedded Monaco IDE: The power of VS Code in your browser with full syntax highlighting for Minecraft configurations.
- Plugin Marketplace: Integrated Modrinth/Spiget search with automated dependency resolution.
- MC Identity Restoration: Professional 64x64 PNG branding system for in-game server-icon and world-icon.
- Immutable Audit Ledger: Cluster-wide audit trail for Every command, import, and configuration change.
Real-time monitoring with Auto-Healing v3, World Intelligence, and Systems Integrity controls.
Scale safely without touching the command line.
CraftCommand utilizes a specialized Node Agent to manage remote resources (Other PCs, VPS, or Old Laptops).
- One-Click Enrollment: Use the Wizard to generate a secure Bootstrap ZIP.
- Zero-Knowledge Pairing: Automated cryptographic handshake using rotating secrets.
- Mixed OS Clusters: Host your Panel on Windows and your Servers on a fleet of Linux VPS instances seamlessly.
Best for: Users who want to play and host on the same computer.
- Download & Extract the latest release.
- Run Launcher: Execute
run_CraftCommand.bat. - Start: Choose [1] Start (Auto-Setup).
- Access: Open
http://localhost:3000.
Best for: Managing a fleet of servers (VPS, extra laptops, etc).
- Set up the Commander: Follow Flow 1 to install the panel on your main PC.
- Add a Node:
- Go to Global Settings > Nodes.
- Click "Add Node".
- Follow the Wizard to generate a Bootstrap Bundle (ZIP).
- Deploy Agent:
- Copy the ZIP to your second machine.
- Extract and run
bootstrap_agent.bat. - The node will automatically pair with your Commander panel using Zero-Knowledge encryption.
Best for: Contributing to CraftCommand.
- Clone Repo:
git clone https://github.com/Extroos/Craft-Commands.git - Install:
npm install(Root directory). - Dev Mode:
npm run dev. - Access: Open
http://localhost:3000.
- Email:
admin@craftcommand.io - Password:
admin
Caution
You will be required to change these credentials immediately after your first login.
Secure by Default, Explicit by Choice.
- Systems Integrity: Cryptographically signed updates (Ed25519) with SHA256 integrity verification.
- RBAC (Hierarchy Guard): Strict role isolation (Owner > Admin > Manager).
- Network Isolation: Local-only binding by default; remote exposure requires owner-level approval.
- Token Hardening: JWT-based sessions with industry-standard bcrypt hashing.
- Capability Advertising: Nodes advertise their limits; the Panel never sends a task a node cannot sustain.
Common issues and error codes are documented in the dedicated guide.
View the Troubleshooting Guide (Error Codes & Fixes)
Some common quick fixes:
- E_JAVA_MISSING: Use the Heuristic Fix (Wand Icon) in the GOC to auto-install the correct Java version.
- E_PORT_IN_USE: Port conflict detected. Use the Environment Doctor to identify the conflicting process.
- Can't Connect: Ensure your DuckDNS synchronization is active in Global Settings.
- Access Denied: If seen during Caddy setup, this is a benign launcher error and has been suppressed in v1.11.8.
- Core: React 19, TypeScript, Node.js, Express, Socket.IO.
- Styling: Framer Motion (60FPS), Vanilla CSS, Glassmorphism (Premium Aesthetic).
- Orchestration: Systems Integrity Engine with Auto-Healing v3 (Sentinel) & Cross-Play Support.
- Storage: Hybrid Dual-Storage (SQLite for teams, JSON for solo portability).
- License: GNU Affero General Public License v3.0
Developed by Extroos