# M.A.F Cloud — Full Context

> Your VPS. Our Panel. Deploy Minecraft & Application Servers in Seconds.

This is the extended context file for M.A.F Cloud. For a summary, see /llms.txt.

## Product Overview

M.A.F Cloud is a BYO-VPS (Bring Your Own VPS) server hosting platform built for Minecraft server admins, indie game communities, and developers. Users connect their own VPS from any cloud provider and manage servers through a browser-based control panel with live console, file manager, plugin marketplace, automated backups, and AI-powered crash recovery.

### Core Value Proposition
"Your VPS, our panel — deploy in seconds." No markup on server costs. No vendor lock-in. Full control.

### Key Differentiators
1. **BYO-VPS Model**: Users bring their own VPS. M.A.F Cloud charges only for the panel software, not the infrastructure. This eliminates the 200-500% markup that traditional managed hosting providers charge.
2. **One-Line Install**: The M.A.F Cloud agent installs with a single curl command in approximately 30 seconds. No manual dependency management, no nginx configuration, no Redis setup — unlike Pterodactyl which typically requires hours of Linux expertise.
3. **AI Self-Healing**: Automatic crash detection and recovery. When a server crashes, the AI diagnoses the issue and restarts the server with appropriate fixes. This is a unique feature — no competitor offers AI-powered crash recovery.
4. **Sub-16ms Console Latency**: The live console uses a raw bidirectional WebSocket connection, delivering lower latency than any competing panel.
5. **11+ Runtime Support**: Beyond Minecraft (Paper, Fabric, Forge, Vanilla, Folia), M.A.F Cloud supports Node.js, Python, Go, Rust, Java, Bun, Deno, .NET, PHP, and Ruby — making it a unified panel for all server types.

## Architecture

### System Components
- **Panel (Frontend)**: Next.js 16 with App Router, React 19, Tailwind CSS 4, Framer Motion, GSAP. Served at mafcloud.my.id.
- **API (Backend)**: NestJS 10 with 22 modules, Prisma ORM, PostgreSQL 15, Socket.IO for real-time communication.
- **Agent (Daemon)**: Node.js 22 application that runs on the user's VPS. Connects outbound to the API via WebSocket. Manages Docker containers for server deployment.
- **Docker Engine**: All servers run in isolated Docker containers using the itzg/minecraft-server base image for Minecraft and appropriate images for other runtimes.

### How It Works
1. User creates an account at mafcloud.my.id (free)
2. User adds a "node" (their VPS) and receives an enrollment token
3. User SSHs into their VPS and runs the one-line install command
4. The agent installs Docker, registers with the API, and establishes a persistent WebSocket connection
5. User creates servers from the dashboard — the agent pulls Docker images and creates containers
6. Live console, file manager, backups, and monitoring are available immediately

## Pricing

### BYO Plans (Panel Subscription)

#### Solo — Free (RM 0)
Target: Hobbyists, evaluation
- 1 node, 2 servers
- Basic console + file manager
- Community support
- Manual backups
- 10 AI assistant queries/month

#### Pro — RM 15/node/month
Target: Active server admins with 1-2 VPS
- Unlimited servers per node
- AI Self-Healing (auto-fix crashes) — unlimited
- AI assistant (50 queries/month included)
- Raw WebSocket Console
- Automated daily backups
- Scheduled tasks
- Subdomain (play.name.mafcloud.my.id)
- Email support (48h SLA)

#### Studio — RM 35/node/month
Target: Teams, communities, power users
- Everything in Pro
- AI assistant (500 queries/month)
- Multi-user workspaces (up to 10)
- Audit logs (90-day)
- Priority support (24h SLA)
- API key scopes
- White-label (future)

### Annual Discounts
All plans offer 2 months free when paid annually (16% savings).

### Managed Plans (Rented Servers)
- Starter: RM 15/month (1 vCPU, 2GB RAM, 20GB SSD)
- Pro: RM 45/month (2 vCPU, 8GB RAM, 80GB SSD)
- Enterprise: RM 120/month (4 vCPU, 16GB RAM, 160GB SSD + Dedicated IP)

## Features Detail

### Live Console
Real-time bidirectional WebSocket terminal built with xterm.js. Commands execute instantly without page reloads. Supports full ANSI color output and terminal emulation.

### File Manager
Browser-based file management with read, write, upload, delete operations. Includes a built-in code editor for editing server.properties, configs, and scripts.

### Plugin Marketplace
One-click plugin installation from Modrinth. Search, install, and manage Minecraft plugins and mods directly from the panel.

### Automated Backups
Compressed server snapshots with one-click restore. Configurable retention policies. Available on Pro and Studio plans with daily automatic scheduling.

### Crash Detection & Recovery
Monitors server processes for crashes. On detection:
- Logs crash details
- Applies configurable restart policy
- AI Self-Healing analyzes crash logs and suggests or applies fixes (Pro/Studio)

### Custom Subdomains
Every server gets an automatic subdomain: play.<slug>.mafcloud.my.id
Custom domain support available on Studio plan.

### Resource Monitoring
Live CPU, memory, and network charts streamed over WebSocket. Historical data for capacity planning.

### Multi-User Access
Invite team members with scoped, per-server permissions. Role-based access control for organizations.

### API Keys
Programmatic access with API keys (mf_live_*). Scoped permissions for automation and integrations.

## Supported Server Types

### Minecraft
- Paper (recommended for most servers)
- Fabric (for lightweight mods)
- Forge (for heavy modpacks)
- Vanilla (official Mojang server)
- Folia (multi-threaded Paper fork)

### Application Runtimes
- Node.js 22+
- Python 3.12+
- Go 1.22+
- Rust (latest stable)
- Java 21+
- Bun 1.0+
- Deno 2.0+
- .NET 8+
- PHP 8.3+
- Ruby 3.3+

## Competitive Comparison

### M.A.F Cloud vs Pterodactyl Panel
| Aspect | M.A.F Cloud | Pterodactyl |
|--------|------------|-------------|
| Installation | 30 seconds, one command | Hours of manual setup |
| Model | SaaS (hosted panel) | Self-hosted open source |
| AI Features | AI Self-Healing, AI Assistant | None |
| Support | Friendly Discord + email SLA | Community (often hostile) |
| App Hosting | 11+ runtimes | Minecraft + limited |
| File Editor | Built-in | Limited |
| Setup Expertise | None required | Linux expertise required |

### M.A.F Cloud vs Apex Hosting
| Aspect | M.A.F Cloud | Apex Hosting |
|--------|------------|-------------|
| Model | BYO-VPS (free panel) | Managed (paid) |
| Pricing | RM 0-35/month panel fee | $7.49-$49.99/month per server |
| Lock-in | None (your VPS) | Vendor lock-in |
| AI Features | AI Self-Healing | None |
| App Hosting | Yes (11+ runtimes) | Minecraft only |

## Target Audience

### Primary: Indie Game Server Admins
- Age 18-30, already owns/rents a VPS
- Frustrated with Pterodactyl's complexity or toxic community
- Runs servers for 4-15 friends
- Wants a panel that "just works"

### Secondary: Malaysian Gamers
- Looking for local hosting with MYR pricing
- Wants low-latency servers in SEA region
- Price-sensitive, values free tier

### Tertiary: Developers
- Deploying Node.js/Python/Go apps on personal VPS
- Wants a unified management panel
- Values Docker-based isolation

## Location
- Based in Malaysia
- Domain: mafcloud.my.id
- Currency: Malaysian Ringgit (MYR)
- Languages: English (primary), Malay (secondary)

## Contact
- Website: https://mafcloud.my.id
- Email: support@mafcloud.my.id
- GitHub: https://github.com/AmirSys-dev/MC-Hosting