Minecraft Server Hosting

This guide covers setting up and managing Minecraft Java hosting products in Mamba Panel for your customers.

Overview

Minecraft Java is one of the most popular game server hosting products. Mamba Panel integrates with Pterodactyl to provide:

• One-click deployment for Vanilla, Paper, Purpur, Forge, and Fabric
• Automatic version management
• Plugin and mod support
• Customer self-service through the portal

Creating Minecraft Products

Plan Configuration

Navigate to Products → Game Servers → Create Plan and configure:

Setting	Starter	Pro	Premium
RAM	1 GB	3 GB	6 GB
CPU	0.5 vCPU	1 vCPU	2 vCPU
Storage	10 GB	25 GB	50 GB
Player Estimate	5-8	10-20	25-35
Suggested Price	$2.99/mo	$7.99/mo	$14.99/mo

Pterodactyl Egg Selection

Map plans to appropriate Pterodactyl eggs:

Server Type	Egg	Use Case
Vanilla	Minecraft Java	Pure survival, minimal plugins
Paper/Purpur	Paper	Performance + plugins
Forge	Forge	Modded gameplay
Fabric	Fabric	Lightweight modding

Configure egg mappings in Settings → Integrations → Pterodactyl → Eggs.

Plan Sizing Guidelines

Recommend to customers based on their needs:

Vanilla/Paper:

• 1 GB RAM per 5-8 players
• Add 1 GB for each 10 plugins
• Add 2 GB for heavy plugins (Dynmap, WorldEdit)

Modded (Forge/Fabric):

• Minimum 3 GB for light modpacks
• 4-6 GB for medium modpacks (50-100 mods)
• 8+ GB for heavy modpacks (100+ mods)

Customer Onboarding

Provisioning Flow

1. Customer purchases Minecraft hosting plan
2. Mamba Panel creates order and provisions via Pterodactyl
3. Customer receives:
   • Portal access with server management
   • SFTP credentials
   • Server IP and port
4. Server starts with default world generation

First-Time Setup Guide

Share with customers:

1. Access the panel — Log in to view server controls
2. Choose server type — Select Vanilla, Paper, Forge, or Fabric
3. Configure settings — Server name, gamemode, difficulty
4. Upload existing world (optional) — Via SFTP before first start
5. Start the server — Click Start and monitor console
6. Connect and play — Use the provided IP:port

Server Management

Version Management

Customers can change Minecraft versions through the panel:

1. Stop the server
2. Go to Startup → Minecraft Version
3. Select desired version
4. Start the server

Note: Downgrading versions may corrupt worlds. Always backup first.

Plugin Installation (Paper/Purpur)

1. Download plugin .jar files
2. Upload to /plugins via SFTP or file manager
3. Restart the server
4. Configure plugin in /plugins/[plugin]/config.yml

Mod Installation (Forge/Fabric)

1. Ensure server and client use same Forge/Fabric version
2. Upload mods to /mods folder
3. Upload any required configs to /config
4. Restart and verify in console

World Management

Uploading existing worlds:

1. Stop the server
2. Upload world folders via SFTP:
   • world (overworld)
   • world_nether
   • world_the_end
3. Update level-name in server.properties if needed
4. Start the server

Resetting worlds:

1. Stop the server
2. Delete world folders
3. Change level-seed for new seed (optional)
4. Start to generate new world

Performance Optimization

Server.properties Recommendations

view-distance=10
simulation-distance=8
max-players=[based on plan]
network-compression-threshold=256

Paper/Purpur Optimizations

For paper-global.yml:

chunk-system:
  gen-parallelism: default
  io-threads: default

For paper-world-defaults.yml:

chunks:
  max-auto-save-chunks-per-tick: 8
environment:
  treasure-maps:
    enabled: false

Java Arguments

Configure in Pterodactyl startup:

-Xms[RAM]M -Xmx[RAM]M -XX:+UseG1GC -XX:+ParallelRefProcEnabled -XX:MaxGCPauseMillis=200

Performance Monitoring

Recommend customers use:

• /tps — Check server tick rate (should be ~20)
• /spark profiler — Detailed performance analysis (with Spark plugin)
• /timings on → /timings paste — Paper timing reports

Warning signs:

• TPS below 19 consistently
• Memory above 80% sustained
• Long garbage collection pauses

Backups & Recovery

Automated Backups

Configure in Schedules:

• Daily world backups
• Pre-update snapshots
• 7-day retention minimum

Manual Backup Triggers

Customers should backup before:

• Major plugin updates
• Minecraft version changes
• Large world changes

Restore Process

1. Stop the server
2. Navigate to Backups
3. Select backup to restore
4. Confirm and restart

Common Customer Issues

Issue	Cause	Resolution
Can’t connect	Server not started, wrong IP	Verify server running, check IP:port
Lag/Low TPS	Insufficient resources, heavy plugins	Upgrade plan, optimize plugins
Mods not working	Version mismatch	Verify client/server mod versions match
World corruption	Improper shutdown	Restore from backup
Out of memory	Insufficient RAM	Upgrade plan or reduce view distance

Scaling Guidance

When to Upgrade

Recommend upgrades when customers report:

• Consistent TPS below 18
• Memory usage above 80%
• Player count approaching limit
• Adding heavy plugins/mods

Network Servers (BungeeCord/Velocity)

For customers wanting multiple connected servers:

1. Create separate Minecraft server for each instance
2. Create BungeeCord/Velocity proxy server
3. Configure port allocations
4. Set up shared database for cross-server features

Support Resources

For Your Staff

• Familiarize with common Minecraft hosting issues
• Know when to recommend upgrades vs optimization
• Understand plugin compatibility basics

For Customers

Provide:

• General Troubleshooting Guide
• Links to Paper/Purpur/Forge documentation
• Plugin compatibility resources (SpigotMC, Modrinth)

Related Documentation

• Getting Started with Mamba Panel
• Game Server Troubleshooting
• FiveM Setup Guide