Skip to content

Extroos/CraftCommand

Repository files navigation

CraftCommand

The Professional Hybrid Cloud Platform for Java & Bedrock Infrastructure

version platform license

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.

FeaturesArchitectureQuick StartSecurity ModelFull Docs


Why CraftCommand?

The "Goldilocks" Solution

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.

Honest Comparison Matrix

Feature Standard Launchers (Prism/Official) Enterprise Panels (Pterodactyl/AMP) CraftCommand (v1.12.5)
Ideal For Playing & Client Modding Reselling & Massive Clouds Home hosting & Network Ops
Setup Barrier Instant Native High (Linux, Docker, SQL, SSL req.) Zero-Config (Portable)
OS Flexibility Universal Native Linux-Only (Pterodactyl) Universal (Win Panel + Cross-Nodes)
Architecture Local Child Process Strict Docker Containerization Hybrid $O(N)$ Distributed
Resource Tracking None (Basic Log View) Detailed (Resource-Dense Panels) $O(N)$ Real-time Spatial Heatmap
Networking Manual Port Forwarding Port Mapping / Manual Proxies Velocity "Zero-Config" Automation
Version Selection Client-Side Only Manual (Require "Eggs") API-Driven Dynamic Manifest
Fault Tolerance None (Crashes) Basic (Auto-Restart On) Sentinel v3 (Heuristic Triage)
Diagnostic Fixes Manual Log Analysis Manual Troubleshooting req. Intelligent Heuristic Repair
Mod Management Excellent Client Manual / SFP Upload Triple-Layer IQ Mod Resolver
Security Model Basic (Local FS) Advanced (Docker Isolation) Enterprise (2FA + Cryptic Handshake)
UX Design Minimalist / Flat Functional / Busy Premium Glassmorphic IDE

Server Selection Manage multiple servers with a professional, data-dense interface.


The CraftCommand Advantage (v1.12.5)

Why choose CraftCommand instead of Pterodactyl, Crafty, or AMP?

While other platforms focus on being general-purpose containers, CraftCommand is built as a specialized orchestrator with vertical integration for game server lifecycles. We bridge the gap between "One-Click Simple" and "Enterprise Powerful."

1. Dynamic Versioning Manifest

Stop waiting for community "Eggs" or manual manifest updates. CraftCommand features a Self-Healing Version Manifest fetching directly from official Mojang and community Bedrock APIs.

  • 2026 Ready: Native, day-zero support for the 26.x year-based versioning standard.
  • Pre-flight Validation: Proactively catches "404 Not Found" or "403 Forbidden" errors on Paper/Purpur APIs before download, offering intelligent fallbacks to Vanilla or suggesting stable alternatives.
  • Software-Aware Logic: Automatically detects and recommends Java 21+ for the latest releases, ensuring 100% boot success.

2. $O(N)$ Distributed Architecture

Designed for massive scale without the Docker overhead or CPU spikes seen in legacy panels.

  • Linear Process Engine: Calculates CPU/RAM/IO metrics for 1,000+ servers in a single $O(N)$ pass, eliminating the $O(N^2)$ lag of nested scanning.
  • Reverse-Buffer Log Tailing: Predictable $O(1)$ memory usage. We read logs from the bottom-up using a 64KB reverse-buffer—10GB log files use the same RAM as 10KB files.
  • Single-Root File Watching: Massive reduction in OS file handle consumption by consolidating all server watchers into a single optimized root listener.

3. Triple-Layer Mod Stabilization

Stop fighting mod crashes. Our Mod Intelligence Engine ensures your modpacks boot correctly the first time.

  • Modrinth API Verifier: Automatically identifies and moves client-side mods to prevent server-side crashes.
  • Transitive Dependency Resolver: Scans fabric.mod.json/mods.toml and auto-installs missing dependencies from Modrinth.
  • JiJ (Jar-in-Jar) Intelligence: Detects embedded libraries to prevent duplicate mod conflicts at the binary level.

4. Industrial-Grade Security

Your infrastructure is only as safe as its weakest link. We provide mandatory protection for your cluster.

  • Native 2FA (TOTP): Full multi-factor authentication with AES-256-CBC encrypted secrets and Bcrypt-hashed recovery codes.
  • Session Revocation: View active sessions and perform a Global Logout to instantly invalidate all JWT tokens across the cluster.
  • Systems Integrity: Cryptographically signed updates (Ed25519) with SHA256 integrity verification, preventing supply-chain attacks.

5. Sentinel v3: Heuristic Auto-Healing

Scale horizontally without the complexity of deep Docker management or Kubernetes.

  • Heuristic Triage Engine: A proactive auto-healing system that performs multi-stage repair (Triage -> Scrap -> Start -> Verify) on failing instances.
  • Zombie Adoption: Node agents automatically re-acquire and adopt orphaned processes (Native & Docker) after a system reboot, ensuring 24/7 uptime.
  • Distributed Node Orchestration: Enroll remote hosts in seconds using Zero-Knowledge pair-bonding and unified resource telemetry.

Key Differentiators

  1. Intelligent Diagnosis Engine v3.0: Our heuristic engine identifies over 40 common failure points and suppresses misleading secondary errors (Causality Suppression).
  2. Cryptographically Secure Updates: Industry-standard Ed25519 signatures and SHA256 integrity verification for every system update.
  3. Proxy Network Fabric (Velocity Automation): The industry's first "Zero-Config" proxy orchestrator. Native Velocity integration automatically manages internal secrets, forwarding protocols, and paper-global.yml synchronization.

Core Capabilities

1. Global Operations Center (GOC)

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).

2. World Intelligence & Telemetry

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, radius renders directly from the panel.
  • Health Handshake: Automated telemetry verification via internal service probes.

3. Proxy Orchestration

High-performance network management

  • Native Velocity Support: Full-stack integration with automated secret and velocity.toml 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.

4. Resilience & Auto-Healing v3 (Sentinel)

  • 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.
  • Graceful Shutdown Protocol: Countdown-based termination with automated in-game warnings and real-time cancellation support.

5. Systems Integrity & Security (v1.12.5)

Production-grade safety for your cluster

  • Two-Factor Authentication (2FA): Fully native TOTP support with AES-encrypted secrets and secure session revocation.
  • 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.
  • Protocol Guardians: Intelligent checks that ensure distributed nodes and proxies remain compatible during upgrades.

6. Cross-Play Ecosystem (v1.11.9)

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.

7. Global Access & Infrastructure (v1.11.9)

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.

8. Developer Experience (DevX)

  • Embedded Monaco IDE: Full syntax highlighting, bracket matching, and real-time co-presence for Minecraft configurations.
  • Plugin Marketplace: Integrated Modrinth/Spiget search with automated dependency resolution.
  • MC Identity Restoration: Professional 64x64 PNG branding system for server-icon.png and world_icon.png.
  • High-Performance Grep Search: Contextual snippets and optimized server-side scanning inside log files.
  • Chained Automation Engine: Build multi-action sequences with precise Cron-based offsets.
  • Immutable Audit Ledger: Cluster-wide audit trail for 100% accountability.

Operational Excellence (v1.12.5)

Built for stability. Optimized for performance.

  • Persistent Deployment Overlay: Professional global status tracker that remains visible during navigation.
  • Standardized API Request Layer: Enforced consistency across all cluster communications.
  • High-Efficiency Batch Storage: Atomic, high-performance updates using our new SQLite/JSON batch provider.
  • Proactive Pre-flight Diagnosis: Blocks startups if a critical environment failure (like a Java version mismatch) is predicted.
  • Surgical Mobile Responsiveness: A telemetry-grade mobile UI that preserves density on any device.

Dashboard Real-time monitoring with Auto-Healing v3, World Intelligence, and Systems Integrity controls.


Distributed Hosting (Worker Nodes)

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 and Jitter Middleware.
  • Mixed OS Clusters: Host your Panel on Windows and your Servers on a fleet of Linux VPS instances seamlessly.
  • Zombie Adoption: Self-healing agent logic that re-acquires orphaned server processes and containers after a hardware reboot.

Quick Start

Installation & Launch

Flow 1: Single PC (Hybrid Mode)

Best for: Users who want to play and host on the same computer.

  1. Download & Extract the latest release.
  2. Run Launcher: Execute run_CraftCommand.bat.
  3. Start: Choose [1] Start (Auto-Setup).
  4. Access: Open http://localhost:3000.

Flow 2: Distributed (Commander + Nodes)

Best for: Managing a fleet of servers (VPS, extra laptops, etc).

  1. Set up the Commander: Follow Flow 1.
  2. Add a Node: Go to Global Settings > Nodes and click "Add Node".
  3. Deploy Agent: Copy the ZIP to your second machine, extract and run bootstrap_agent.bat.
  4. Pairing: The node will automatically pair using Zero-Knowledge encryption.

Flow 3: Developer (Source)

Best for: Contributing to CraftCommand.

  1. Clone Repo: git clone https://github.com/Extroos/Craft-Commands.git
  2. Install: npm install (Root directory).
  3. Dev Mode: npm run dev.
  4. Access: Open http://localhost:3000.

Default Credentials

Caution

You will be required to change these credentials immediately after your first login.


Security Model

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.

Troubleshooting

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.
  • Velocity_Support: Our Diagnosis Brain identifies proxy forwarding mismatches (e.g., paper-global.yml) automatically.
  • Can't Connect: Ensure your DuckDNS synchronization is active in Global Settings.

Technical Architecture

  • Core: React 19, TypeScript, Node.js, Express, Socket.IO.
  • Styling: Framer Motion (60FPS), Vanilla CSS, Glassmorphism (Premium Aesthetic).
  • Orchestration: Modpack Intelligence Engine, Auto-Healing v3 (Sentinel) & Cross-Play Support.
  • Security: 2FA (TOTP), Ed25519 Software Signing, AES-256-CBC Encryption.
  • Storage: Hybrid Dual-Storage (SQLite for teams, JSON for solo portability).
  • License: GNU Affero General Public License v3.0

Developed by Extroos

About

Local-first Minecraft server management panel with team permissions, audit logging, HTTPS, and guided remote access. Built with React and Node.js.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors