<div align="center">

CraftCommand

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

</div>

---

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 |

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 fo