mcserver/CONSOLE.md

Minecraft Server Console & Management

🎮 Server Console Zugriff

Option 1: RCON über Terminal (empfohlen)

Über SSH auf dem Coolify Server:

# Mit Container verbinden
docker exec -it minecraft-server rcon-cli

# Dann kannst du Commands ausführen:
> list
> op Spielername
> whitelist add Spielername
> say Hallo Server!
> stop

Vom eigenen PC aus (mit mcrcon):

# Windows (mit mcrcon.exe)
mcrcon -H deine-server-ip -P 25575 -p minecraft

# Linux/Mac
brew install mcrcon
mcrcon -H deine-server-ip -P 25575 -p minecraft

Option 2: Web-Interface (mcrcon-web)

Erstelle einen zusätzlichen Service in Coolify:

docker-compose-rcon.yml:

version: '3.8'

services:
  rcon-web:
    image: itzg/rcon
    container_name: minecraft-rcon-web
    restart: unless-stopped
    
    environment:
      - RWA_USERNAME=admin
      - RWA_PASSWORD=dein-passwort
      - RWA_RCON_HOST=minecraft-server
      - RWA_RCON_PORT=25575
      - RWA_RCON_PASSWORD=minecraft
    
    ports:
      - "4326:4326"
    
    networks:
      - minecraft-network

networks:
  minecraft-network:
    external: true
    name: wcs4cg8k8w4owss40sg4s0cg_minecraft-network

Dann öffne: http://deine-server-ip:4326

Option 3: Coolify Logs (Nur Lesen)

In Coolify:

1. Gehe zu deinem Service
2. Klicke auf "Logs" Tab
3. Siehst du alle Server-Ausgaben (aber keine Eingabe möglich)

🔄 Nur Minecraft Server neustarten

In Coolify:

1. Gehe zu deinem Service
2. Klicke auf "Containers" oder scrolle zu den Services
3. Finde minecraft-server
4. Klicke auf "Restart" nur für diesen Container

Via SSH auf Coolify Server:

# Nur Minecraft Server neustarten
docker restart minecraft-server

# Oder mit Container ID
docker ps  # Finde die Container ID
docker restart <container-id>

Via RCON:

# Verbinde via RCON
docker exec -it minecraft-server rcon-cli

# Stoppe Server gracefully
> stop

# Container startet automatisch neu (wegen restart: unless-stopped)

📝 Häufige RCON Commands

# Spieler-Management
> list                          # Zeige Online-Spieler
> op Spielername                # Mache zum Operator
> deop Spielername              # Entferne Operator
> kick Spielername Grund        # Kicke Spieler
> ban Spielername Grund         # Banne Spieler
> pardon Spielername            # Entbanne Spieler

# Whitelist
> whitelist on                  # Aktiviere Whitelist
> whitelist add Spielername     # Füge zur Whitelist hinzu
> whitelist remove Spielername  # Entferne von Whitelist
> whitelist reload              # Lade Whitelist neu

# Server-Management
> stop                          # Stoppe Server
> save-all                      # Speichere Welt
> say Nachricht                 # Sende Nachricht an alle
> tellraw @a {"text":"Test"}    # JSON Nachricht

# Welt-Management
> time set day                  # Setze auf Tag
> weather clear                 # Klares Wetter
> difficulty peaceful           # Ändere Schwierigkeit
> gamerule keepInventory true   # Behalte Inventar bei Tod

# Performance
> tps                          # Zeige TPS (Paper/Spigot)
> timings paste                # Performance Report (Paper)

🖥️ RCON Tools

Windows:

• mcrcon: https://github.com/Tiiffi/mcrcon/releases
• Minecraft RCON Console: https://github.com/iMasonite/Minecraft-RCON-Console

Linux/Mac:

# mcrcon
brew install mcrcon

# rcon-cli (bereits im Container)
docker exec -it minecraft-server rcon-cli

Web-basiert:

• RCON Web Admin: https://github.com/itzg/docker-rcon-web-admin
• Pterodactyl Panel: Vollständiges Server-Management Panel

🔐 RCON Sicherheit

⚠️ Wichtig:

1. Ändere RCON_PASSWORD in Coolify Environment Variables
2. Port 25575 sollte NICHT öffentlich erreichbar sein (nur intern)
3. Für externen Zugriff: VPN oder SSH Tunnel nutzen

SSH Tunnel für sicheren Remote-Zugriff:

# SSH Tunnel erstellen
ssh -L 25575:localhost:25575 user@coolify-server

# Dann lokal verbinden
mcrcon -H localhost -P 25575 -p minecraft

📊 Server Status überwachen

# Container Status
docker ps | grep minecraft

# Live Logs
docker logs -f minecraft-server

# Ressourcen-Nutzung
docker stats minecraft-server

# Health Check
docker inspect minecraft-server | grep Health

🎯 Schnell-Befehle

# Server neustarten (nur Minecraft)
docker restart minecraft-server

# Console öffnen
docker exec -it minecraft-server rcon-cli

# Backup erstellen
docker exec minecraft-server rcon-cli save-all
docker run --rm -v minecraft-server-data:/data -v $(pwd):/backup alpine tar czf /backup/backup-$(date +%Y%m%d-%H%M%S).tar.gz -C /data .

# Logs anzeigen (letzte 100 Zeilen)
docker logs --tail 100 minecraft-server

# Logs in Echtzeit
docker logs -f minecraft-server

🔧 Troubleshooting

RCON funktioniert nicht:

1. Prüfe ob ENABLE_RCON=true gesetzt ist
2. Prüfe RCON_PASSWORD in Environment Variables
3. Stelle sicher Port 25575 erreichbar ist
4. Check Logs: docker logs minecraft-server | grep -i rcon

Server reagiert nicht:

# Force Restart
docker restart -t 30 minecraft-server

# Komplett neu starten
docker stop minecraft-server
docker start minecraft-server

---

Tipp: Installiere mcrcon auf deinem PC für einfachen Console-Zugriff von überall! 🚀