🔍 PalworldDocker

# Palworld Proton Docker Server

Docker-Container für Palworld **Windows Dedicated Server** unter Linux via **Proton-GE** (GloriousEggroll).

[![Docker](https://img.shields.io/badge/docker-ready-blue.svg)](https://www.docker.com/)
[![License](https://img.shields.io/github/license/yourusername/palworld-proton-server)](LICENSE)

## Warum Proton?

| Feature | Native Linux | Proton (Windows-Server) |
|---------|-------------|-------------------------|
| 🎮 UE4SS/Mods | ❌ Nein | ✅ **Ja** |
| 🔧 Server-Injectoren | ❌ Nein | ✅ **Ja** |
| 🐧 Offizieller Support | ✅ Ja | ⚠️ Indirekt |
| ⚡ Performance | ✅ Optimal | ⚠️ Leicht reduziert |

> **Wichtig:** Die meisten Palworld-Mods (insbesondere [UE4SS](https://github.com/UE4SS-RE/RE-UE4SS)) funktionieren nur auf Windows. Dieser Container ermöglicht Mod-Unterstützung auf Linux-Servern!

---

## 📋 Schnellstart

### 1. Repository klonen

```bash
git clone https://github.com/deinusername/palworld-proton-server.git
cd palworld-proton-server
```

### 2. Konfiguration anpassen

```bash
# Kopiere Beispiel-Config
cp config/default.env .env

# Bearbeite .env mit deinen Einstellungen
nano .env
```

**Wichtige Änderungen:**
- `SERVER_NAME` - Dein Server-Name
- `ADMIN_PASSWORD` - Admin-Passwort ändern!
- `SERVER_PASSWORD` - Server-Passwort (optional)

### 3. Server starten

```bash
docker-compose up -d

# Logs anzeigen
docker-compose logs -f
```

Der Server ist beim **ersten Start** ca. 5-10 Minuten beschäftigt (Steam-Download + Proton-Initialisierung).

---

## 🏗️ Architektur

```
┌─────────────────────────────────────────┐
│         Docker Container                │
│  ┌─────────────────────────────────┐    │
│  │   Ubuntu 22.04 LTS              │    │
│  │   ┌─────────────────────────┐     │    │
│  │   │  Proton-GE            │     │    │
│  │   │  (Wine + Patches)     │     │    │
│  │   └─────────────────────────┘     │    │
│  │   ┌─────────────────────────┐     │    │
│  │   │  Xvfb (Virtual Display)│     │    │
│  │   └─────────────────────────┘     │    │
│  │   ┌─────────────────────────┐     │    │
│  │   │  PalServer.exe        │     │    │
│  │   │  (Windows-Server)     │     │    │
│  │   └─────────────────────────┘     │    │
│  └─────────────────────────────────┘    │
└─────────────────────────────────────────┘
```

---

## 🔧 Umgebungsvariablen

### Server-Grundkonfiguration

| Variable | Standard | Beschreibung |
|----------|----------|--------------|
| `SERVER_NAME` | `Palworld Proton Docker Server` | Server-Name in der Liste |
| `SERVER_DESCRIPTION` | `...` | Beschreibung |
| `SERVER_PASSWORD` | *(leer)* | Server-Passwort |
| `ADMIN_PASSWORD` | `changeThisPassword123` | **ÄNDERN!** Admin/RCON |
| `MAX_PLAYERS` | `32` | Maximale Spieler |
| `SERVER_PORT` | `8211` | Game-Port |
| `QUERY_PORT` | `27015` | Steam Query |
| `RCON_PORT` | `25575` | RCON-Port |
| `RCON_ENABLED` | `true` | RCON aktivieren |

### Proton-Konfiguration

| Variable | Standard | Beschreibung |
|----------|----------|--------------|
| `PROTON_VERSION` | `GE-Proton9-20` | [Proton-GE Version](https://github.com/GloriousEggroll/proton-ge-custom/releases) |
| `UPDATE_ON_START` | `true` | Update beim Start |
| `VALIDATE_FILES` | `true` | Steam-Validierung |

### Spiel-Konfiguration (Auswahl)

| Variable | Standard | Beschreibung |
|----------|----------|--------------|
| `DIFFICULTY` | `None` | Schwierigkeit: None/Easy/Normal/Hard |
| `DAYTIME_SPEEDRATE` | `1.0` | Tagesgeschwindigkeit |
| `EXP_RATE` | `1.0` | XP-Multiplikator |
| `PAL_CAPTURE_RATE` | `1.0` | Pal-Fangrate |
| `DEATH_PENALTY` | `All` | Todes-Strafe: None/Item/ItemAndEquipment/All |
| `ENABLE_PVP` | `false` | PvP aktivieren |
| `ENABLE_MULTIPLAY` | `true` | Multiplayer |

### Backup & Wartung

| Variable | Standard | Beschreibung |
|----------|----------|--------------|
| `BACKUP_ENABLED` | `true` | Auto-Backups |
| `BACKUP_INTERVAL` | `3600` | Sekunden zwischen Backups |
| `BACKUP_RETENTION` | `7` | Backup-Aufbewahrung (Tage) |

> **Alle Variablen** siehe `config/default.env`

---

## 🎮 Ports

| Port | Protokoll | Zweck | Exponiert |
|------|-----------|-------|-----------|
| `8211` | TCP/UDP | Haupt-Game-Port | ✅ |
| `27015` | UDP | Steam Query | ✅ |
| `25575` | TCP | RCON | ✅ |
| `8212` | TCP | REST API | ✅ |

### Port-Forwarding (Router)

Falls der Server nicht in der Liste erscheint:

```
8211 TCP/UDP → Docker-Host IP
27015 UDP → Docker-Host IP
```

---

## 💾 Backups

### Automatische Backups

```bash
# Backup-Intervall in .env setzen
BACKUP_INTERVAL=3600  # 1 Stunde
BACKUP_RETENTION=7    # 7 Tage aufbewahren
```

### Manuelle Backups

```bash
# Backup jetzt erstellen
docker exec palworld-proton-server /opt/palworld/scripts/backup-manager.sh --create

# Backups auflisten
docker exec palworld-proton-server /opt/palworld/scripts/backup-manager.sh --list

# Wiederherstellen (ACHTUNG: Überschreibt aktuelle Saves!)
docker exec palworld-proton-server /opt/palworld/scripts/backup-manager.sh --restore backup_20240115_143022.tar.gz
```

### Backup-Speicherort

```
./data/backups/
├── backup_20240115_143022.tar.gz
├── backup_20240115_153022.tar.gz
└── ...
```

---

## 🐛 Fehlersuche

### Server startet nicht

```bash
# Logs prüfen
docker-compose logs -f

# Container-Status
docker ps -a

# In Container shelln
docker exec -it palworld-proton-server bash
```

### Deadlock/Freeze-Probleme

Bekanntes Problem mit Proton. Lösungen:

```env
# In .env:
WINE_ESYNC=1
WINE_FSYNC=1
MALLOC_CHECK=0
```

### Server nicht in Liste sichtbar

1. **Ports prüfen:** `sudo netstat -tulnp | grep 8211`
2. **Router:** Port-Forwarding für 8211 TCP/UDP
3. **Firewall:** `sudo ufw allow 8211/tcp && sudo ufw allow 8211/udp`
4. **PUBLIC_IP:** In `.env` festlegen wenn nötig

### Performance-Probleme

```bash
# Docker-Stats anzeigen
docker stats palworld-proton-server

# Ressourcen in docker-compose.yml erhöhen:
deploy:
  resources:
    limits:
      cpus: '6'      # CPU-Kerne
      memory: 24G    # RAM
```

---

## 🧩 Mod-Support (Experimentell)

### UE4SS (Unreal Engine 4 Scripting System)

```bash
# In .env:
INSTALL_UE4SS=true        # Auto-Install von GitHub (experimental-latest)
ENABLE_MODS=true          # Mod-Unterstützung aktivieren
FORCE_REINSTALL_UE4SS=true # Für Updates auf neueste Version
```

#### Automatische Installation

Bei `INSTALL_UE4SS=true` wird automatisch vom GitHub Release `experimental-latest` installiert:
- **Quelle:** https://github.com/UE4SS-RE/RE-UE4SS/releases/tag/experimental-latest
- **Installiert nach:** `Pal/Binaries/Win64/`
- **Mods-Verzeichnis:** `./data/mods/`

#### Manuelle Mod-Installation

```bash
# 1. Mods nach local/mods/custom/ kopieren
mkdir -p ./data/mods/custom
cp ~/Downloads/MeinMod.zip ./data/mods/custom/

# 2. Container neu starten
docker-compose restart
```

#### Verfügbare Mods (Beispiele)

| Mod | Beschreibung | Quelle |
|-----|--------------|--------|
| **PalInfo** | Zeigt detaillierte Pal-Informationen | NexusMods |
| **MapUnlocker** | Entsperrt komplette Karte | NexusMods |
| **DropMultiplier** | Erhöhte Drop-Raten | GitHub |

> **⚠️ Warnung:** Experimental-Builds können instabil sein. Bei Problemen ohne UE4SS starten (`INSTALL_UE4SS=false`).

---

## 🏗️ Selbst bauen

```bash
# Image bauen
docker-compose build

# Oder direkt:
docker build \
  --build-arg PROTON_VERSION=GE-Proton9-20 \
  -t mein-palworld-server \
  ./docker
```

---

## 📚 Ressourcen

- [Palworld Tech Docs](https://tech.palworldgame.com/)
- [Proton-GE Releases](https://github.com/GloriousEggroll/proton-ge-custom/releases)
- [SteamCMD Dokumentation](https://developer.valvesoftware.com/wiki/SteamCMD)
- [UE4SS GitHub](https://github.com/UE4SS-RE/RE-UE4SS)

---

## 🤝 Vergleich: Native vs Proton

| Lösung | Mods | Einfachheit | Performance |
|--------|------|-------------|-------------|
| [thijsvanloef/palworld-server-docker](https://github.com/thijsvanloef/palworld-server-docker) | ❌ | ✅ Sehr einfach | ✅ Optimal |
| **Dieser Container (Proton)** | ✅ | ⚠️ Mittel | ⚠️ Gut |
| [jammsen/docker-palworld-dedicated-server](https://github.com/jammsen/docker-palworld-dedicated-server) | ❌ | ✅ Einfach | ✅ Optimal |

---

## 📝 Lizenz

MIT License - Siehe [LICENSE](LICENSE)

---

## ⚠️ Disclaimer

Dies ist ein **inoffizielles** Community-Projekt. Nicht verbunden mit Pocketpair Inc. oder Palworld.

"Palworld" ist ein eingetragenes Markenzeichen von Pocketpair Inc.

---

## 🙏 Credits

- [GloriousEggroll](https://github.com/GloriousEggroll) für Proton-GE
- [thijsvanloef](https://github.com/thijsvanloef/palworld-server-docker) für Inspiration
- Palworld Community

---

**Happy Gaming! 🎮🦖**