<div align="center">

![PalworldSaveTools Logo](../assets/branding/PalworldSaveTools_Blue.png)

# PalworldSaveTools

**Ein umfassendes Toolkit zur Bearbeitung gespeicherter Dateien für Palworld**

[![Downloads](https://img.shields.io/github/downloads/deafdudecomputers/PalworldSaveTools/total)](https://github.com/deafdudecomputers/PalworldTools/releases/latest)
[![License](https://img.shields.io/github/license/deafdudecomputers/PalworldSaveTools)](LICENSE)
[![Discord](https://img.shields.io/badge/Discord-Join_for_support-blue)](https://discord.gg/sYcZwcT4cT)
[![NexusMods](https://img.shields.io/badge/NexusMods-Download-orange)](https://www.nexusmods.com/palworld/mods/3190)

[English](../../README.md) | [简体中文](README.zh_CN.md) | [Deutsch](README.de_DE.md) | [Español](README.es_ES.md) | [Français](README.fr_FR.md) | [Русский](README.ru_RU.md) | [日本語](README.ja_JP.md) | [한국어](README.ko_KR.md) | [Português (Brasil)](README.pt_BR.md) | [Português (Portugal)](README.pt_PT.md)

---

### **Laden Sie die Standalone-Version von [GitHub Releases](https://github.com/deafdudecomputers/PalworldSaveTools/releases/latest)** herunter

---

</div>
<div align="center">

## Übersicht

<img src="https://readme-typing-svg.demolab.com?lines=Was+genau+ist+das+f%C3%BCr+ein+Ding%3F;Dein+Save%2C+dein+Weg;Ein+Werkzeug%2C+um+sie+alle+zu+beherrschen&center=true&width=490&height=28&font=monospace&size=22&color=7DD3FC&vCenter=true" alt="" />

</div>

Palworld Save Tools (PST) ist eine schnelle All-in-One-Desktopanwendung zum Überprüfen und Bearbeiten von Palworld-Sicherungsdateien. Es wurde mit Python und PySide6 erstellt und liest und schreibt das komprimierte Speicherformat des Spiels direkt – keine Spielmodifikationen erforderlich.

Ganz gleich, ob Sie einen dedizierten Server verwalten, zwischen Co-op- und dedizierten Servern migrieren, aufgegebene Daten bereinigen oder einzelne Pals optimieren müssen, PST bietet für alles eine einzige einheitliche Schnittstelle.

### Highlights

- **Plattformübergreifend** – Vorgefertigte Binärdateien für **Windows**, **Linux** und **macOS**.
- **Schnelles natives Parsen** – Einer der schnellsten verfügbaren Lesegeräte für gespeicherte Dateien, angetrieben durch die [`palsav`](src/palsav)-Engine.
- **Visuelle Karte** – Interaktive Weltkarte mit Basis-/Spielermarkierungen, Sperrzonen und Koordinatenkalibrierung.
- **Umfassende Pal-Bearbeitung** – Volle Kontrolle über Statistiken, IVs, Seelen, Fähigkeiten, passives, Arbeitseignungen, Rang und Aussehensflaggen.
- **Tools auf Serverniveau** – Massenlöschung, Bereinigung, Konvertierung und Zeichenübertragung für Administratoren.
- **Automatische Backups** – Bei jedem Speichervorgang wird vor dem Schreiben ein Backup erstellt.
- **9 Sprachen** – Lokalisierte Benutzeroberfläche, In-App-Anleitungen und Dokumentation.





---





## Inhaltsverzeichnis

- [Übersicht](#übersicht)
- [Funktionen](#funktionen)
- [Installation](#installation)
- [Schnellstart](#schnellstart)
- [Anleitungen](#anleitungen)
- [Fehlerbehebung](#fehlerbehebung)
- [Aufbau aus der Quelle](#aufbau-aus-der-quelle)
- [Mitwirken](#mitwirken)
- [Lizenz](#lizenz)
- [Das Palworld-Team](#das-palworld-team)

- [Unterstützung](#support)
- [Lizenz](#license)
- [Danksagungen](#acknowledgments)





---




<div align="center">

## Funktionen

<img src="https://readme-typing-svg.demolab.com?lines=Die+guten+Sachen;Schauen+Sie+es+sich+an;Vollgepackt+mit+Werkzeugen&center=true&width=290&height=28&font=monospace&size=22&color=7DD3FC&vCenter=true" alt="" />

</div>

### Spielerverwaltung

- Alle Spieler nach Name, Level, pal Anzahl, UID, Gilde und zuletzt gesehener Zeit anzeigen und durchsuchen.
- Bearbeiten Sie Spielernamen, Level, Statistiken und Technologiepunkte.
- **Registerkarte „Statistik“** – Heldenstatistiken (Gesundheit, Ausdauer, Angriff, Verteidigung, Arbeitsgeschwindigkeit, Gewicht) mit korrekten, im Spiel berechneten Werten; Reliktfähigkeiten mit Schaltern und Spinnern.
- **Alle Statistiken maximieren** – Begrenzen Sie alle Statistiken sofort auf das Maximum (50 Punkte).
- **Massenoperationen** für mehrere Spieler: Gegenstandsverwaltung, pal-Verwaltung und Technologie-Freischaltungen.
- Inaktive Spieler nach Zeitschwelle löschen; Duplikate entfernen.

### Pal Editor

Eine umfassende Bearbeitungsoberfläche für jedes Pal, das einem beliebigen Spieler gehört. Pals werden von **Party** (aktive Truppe) und **Palbox** (Lagerung) organisiert.

- **Statistiken & IVs** – HP, Angriff, Verteidigung (IV 0–100), Level (1–80), Vertrauensrang (0–10).
- **Seelen** – HP, Angriff, Verteidigung, Handwerksgeschwindigkeit (0–20).
- **Fertigkeiten** – Aktive Fertigkeitsauswahl; lerne alle Bewegungen; Fähigkeiten zur Massensynchronisierung in Pals.
- **Passive Eigenschaften** – Passiver Picker mit vollständigen Spieldaten.
- **Arbeitseignung** – Legen Sie individuelle Arbeitseignungsstufen fest (0–10).
- **Aussehensflaggen** – Boss/Alpha, Lucky/Shiny, Predator, Awakened und Imported/DNA umschalten.
- **Rang & Sperre** – Rang und bevorzugte Sperrstufe festlegen (0–3).
- **Cheat-Modus** – Umschalten, um alle Obergrenzen zu erweitern: Level, IVs, Seelen, Kondensatorrang auf 255; Schalten Sie unbegrenzte Aktiv-/Passivfähigkeiten frei, wobei Duplikate zulässig sind.
- **Exportieren/Importieren** – Klicken Sie mit der rechten Maustaste auf ein beliebiges pal, um es als `.pstpal` (komprimiert) oder `.json` zu exportieren. Importieren Sie in leere Slots über Gruppen-, Palbox-, DPS- oder Basisarbeiter hinweg. Funktioniert für alle Spielstände und Spieler.
- **Max. Alle Pals** – Max. aller Statistiken (IVs, Seelen, Rang, Level) für alle pals in der Gruppe, alle Palbox-Seiten oder alle Basisarbeiter – berücksichtigt die Obergrenzen des Cheat-Modus.
- **Illegales Pals beheben** – pals mit illegalen Statistiken, Fertigkeiten oder Eigenschaften pro Spieler erkennen und begrenzen.
- **Massenklonen/Löschen** – Artenauswahldialog mit Mengensteuerung und Quellenumschaltung (Party/Palbox/DPS) für Stapelvorgänge.
- Neuen Pals hinzufügen oder per Doppelklick schnell löschen.

### Gildenverwaltung

Zweiteilige Ansicht: Gildenliste oben, Mitgliederliste unten.

- Gilden umbenennen, Anführer wechseln, Gildenstufe festlegen, maximale Gildenstufe festlegen.
- Schalten Sie alle Laborforschungen frei; Alle Gilden neu aufbauen.
- Spieler zwischen Gilden verschieben; Leere oder inaktive Gilden löschen.

### Basislager-Werkzeuge

- Alle Basislager mit Gildenzugehörigkeit anzeigen.
- Basis-Blaupausen **Exportieren** nach `.json`; **Importieren** (einzelne oder mehrere Dateien) in jede Gilde.
- **Klonen** Basen für andere Gilden mit versetzter Positionierung.
- **Koordinaten ändern** – Klicken Sie mit der rechten Maustaste auf eine Basismarkierung auf der Karte, wählen Sie „Koordinaten ändern“ und klicken Sie dann auf eine beliebige Stelle, um die Basis zu teleportieren.
- **Base Nudge** – Verschieben Sie eine Basis um exakte X/Y/Z-Versatze, um Bodenbeschneidungen oder -schweben zu beheben.
- **Basisradius anpassen** (50 %–1000 %).
- Löschen Sie inaktive Basen und Nicht-Basiskartenobjekte.
### Kartenbetrachter

Interaktive Visualisierung Ihrer gesamten Welt.

- Basismarker (Haussymbol) und Spielermarker (Personensymbol) mit Detailfeldern.
- Überlagerungen umschalten: Basen, Spieler, Radiusringe, Sperrzonen.
- **Zonenzeichnung** – Zeichnen Sie rechteckige oder polygonale Sperrzonen direkt auf der Karte.
- **Kalibrierungsmodus** – Richten Sie die Karte genau an den Spielkoordinaten aus.
- Weltkarten- und Baumkartenansichten; Filtern Sie nach Gilde oder Spielername.
- Zoomen (1,0x–30,0x), Schwenken, Doppelklick, um zu einer Markierung zu fliegen.
- Rechtsklick-Markierungen und leerer Bereich für Verwaltungsaktionen.

### Bestandsverwaltung

**Spielerinventar** – Drei Unterregisterkarten:
- *Inventar* – Alle Gegenstände und Ausrüstung in der Haupttasche; Menge bearbeiten, hinzufügen, entfernen.
- *Schlüsselgegenstände* – Questgegenstände, Bildnisse und Technologie; Fügen Sie alle Bildnisse/Schlüsselelemente in großen Mengen hinzu.
- *Statistiken* – Level, HP, Ausdauer, Angriff, Verteidigung, Arbeitsgeschwindigkeit, Gewicht.
- Ausrüstungstafel für Waffen, Zubehör, Nahrung, Rüstung, Schild, Gleiter und Modulplätze.
- Schalten Sie alle Karten- und Schnellreisepunkte mit einem Klick frei.

**Basisinventar** – Durchsuchen und verwalten Sie Artikel und arbeiten Sie Pals über alle Basen hinweg:
- Elemente in Containern anzeigen/bearbeiten; durchsichtige Behälter; Containerplätze ändern.
- Gildenübergreifende Gegenstandsoperationen (Gegenstände in allen Gilden finden/entfernen).
- Gildenübergreifende Strukturlöschung.
- Unterregisterkarte **Basis Pals** – Verwalten Sie die jeder Basis zugewiesenen Arbeits-Pals mit vollständigen pal-Editor-Kontextmenüs.

### Ausschlüsse

Schutzlisten, die Spieler, Gilden und Stützpunkte vor Aufräumarbeiten schützen.

- Drei nebeneinander liegende Felder: ausgeschlossene Spieler-UIDs, Gilden-IDs und Basis-IDs.
- Fügen Sie Einträge über Rechtsklick-Kontextmenüs in den Registerkarten „Spieler“, „Gilden“ oder „Basen“ hinzu.
- Ausschlusslisten dauerhaft speichern und laden.
- Erstellen Sie Ihre Liste **bevor** Sie die Massenbereinigung durchführen.

### Werkzeuge speichern

Über die Registerkarte **Tools** als anklickbare Karten zugänglich:

| Werkzeug | Beschreibung |
|------|-------------|
| **Gespeicherte Dateien konvertieren** | Konvertieren zwischen SAV- und JSON-Format |
| **Konvertieren Sie GamePass → Steam** | Konvertieren Sie Xbox/GamePass-Speicherungen in das Steam-Format |
| **Konvertieren SteamID** | Konvertieren Sie Steam-IDs in Palworld-UIDs |
| **Karte wiederherstellen** | Vollständig freigeschalteten Kartenfortschritt auf alle Welten/Server anwenden |
| **Schlitzinjektor** | Palbox-Slots pro Spieler erhöhen |
| **Ändern Speichern** | Rohspeicherdaten öffnen und ändern |
| **Charakterübertragung** | Charaktere zwischen verschiedenen Welten/Servern übertragen (Cross-Save) |
| **Host-Speicherung beheben** | UIDs zwischen zwei Spielern austauschen (Host-Swap, Plattformmigration) |

### Bereinigungs- und Hilfsfunktionen

Diese Server-Vorgänge sind über **Menü → Funktionen** zugänglich und umfassen:

- **Löschen** – Leere Gilden, inaktive Basen/Spieler, doppelte Spieler und nicht referenzierte Daten löschen.
- **Bereinigung** – Entfernen Sie ungültige/modifizierte Elemente, ungültige pals und passives, ungültige Strukturen; illegales pals beheben (Grenze auf zulässiges Maximum); Luftabwehrtürme zurücksetzen; entsperren private chests; alle Strukturen reparieren.
- **Zurücksetzen** – Missionen, Dungeons, Bohrinsel, Eindringling, Versorgungslieferungen zurücksetzen.
- **Zeitstempel** – Negative Zeitstempel korrigieren; Spielerzeiten zurücksetzen.
- **PalDefender** – `killnearestbase`-Befehle generieren.





---




<div align="center">

## Installation

<img src="https://readme-typing-svg.demolab.com?lines=Bringen+Sie+es+in+wenigen+Minuten+zum+Laufen;Herunterladen+und+loslegen;Keine+Einrichtung+erforderlich&center=true&width=420&height=28&font=monospace&size=22&color=7DD3FC&vCenter=true" alt="" />

</div>

### Eigenständige Builds (empfohlen)

Vorgefertigte Binärdateien sind für alle drei Hauptplattformen ab [GitHub Releases](https://github.com/deafdudecomputers/PalworldSaveTools/releases/latest) verfügbar:

| Plattform | Herunterladen | Anforderungen |
|----------|----------|--------------|
| **Windows** | `PalworldSaveTools-*.exe` | Windows 10/11, [VC++ Redistributable](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170) (2015–2022) |
| **Linux** | `PalworldSaveTools-*-linux` | Jede moderne Distribution |
| **macOS** | `PalworldSaveTools-*-macos.dmg` | macOS 12+ (Monterey oder höher) |

Auch verfügbar unter [Nexus Mods](https://www.nexusmods.com/palworld/mods/3190).

1. Laden Sie den passenden Build für Ihre Plattform herunter.
2. Extrahieren Sie die ausführbare Datei (falls archiviert) und führen Sie sie aus.
3. Das war's – kein Python oder Abhängigkeiten erforderlich.

> **Windows:** Wenn die Meldung „VCRUNTIME140.dll wurde nicht gefunden“ angezeigt wird, installieren Sie [Microsoft Visual C++ Redistributable](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170).

> **Linux:** Möglicherweise müssen Sie die Datei als ausführbar markieren: `chmod +x PalworldSaveTools-*-linux`

> **macOS:** Wenn Gatekeeper die App blockiert, klicken Sie beim ersten Mal mit der rechten Maustaste → **Öffnen** oder führen Sie `xattr -d com.apple.quarantine /path/to/app` aus.

### Aus der Quelle (Alle Plattformen)

PST verwendet [`uv`](https://docs.astral.sh/uv/) für die Abhängigkeitsverwaltung. Das Startskript erstellt automatisch eine virtuelle Umgebung und installiert alles.

**Voraussetzungen:** [Python 3.11+](https://www.python.org/) und [uv](https://docs.astral.sh/uv/getting-started/installation/).

```bash
git clone https://github.com/deafdudecomputers/PalworldSaveTools.git
cd PalworldSaveTools
uv run start.py
```

**Windows** (Doppelklick-Launcher):
```
start.cmd
```

Der Launcher erstellt einen `.venv`, installiert Abhängigkeiten über `uv sync` und startet die App. Es bereinigt die Sperrdatei beim Beenden, sodass jeder Lauf reproduzierbar ist.





---




<div align="center">

## Schnellstart

<img src="https://readme-typing-svg.demolab.com?lines=Laden.+Bearbeiten.+Speichern.+So+einfach.;Drei+Schritte+zum+Ruhm;So+einfach+ist+das&center=true&width=450&height=28&font=monospace&size=22&color=7DD3FC&vCenter=true" alt="" />

</div>

1. **Laden Sie Ihren Speicherstand**
   - Klicken Sie auf **Menü → Laden und Speichern** oder ziehen Sie eine `.sav`-Datei per Drag-and-Drop in das Fenster.
- Navigieren Sie zu Ihrem Palworld-Speicherordner und wählen Sie `Level.sav`.

2. **Erkunden Sie Ihre Daten**
   - Verwenden Sie die Registerkarten – **Karte**, **Tools**, **Spieler**, **Gilden**, **Basen**, **Spielerinventar**, **Basisinventar**, **Pal Editor**, **Ausschlüsse** – um Ihren Speicherstand zu erkunden.
   - Die Statistikleiste zeigt Live-Zählungen; Schnellnavigationssymbole springen zu den einzelnen Abschnitten.

3. **Änderungen vornehmen**
   - Zum Auswählen mit der linken Maustaste klicken; Klicken Sie mit der rechten Maustaste auf fast alles, um kontextbezogene Aktionen auszuführen.
   - Doppelklicken Sie, um schnell zu bearbeiten oder schnell zu löschen (weitere Informationen finden Sie in den In-App-Anleitungen).

4. **Speichern Sie Ihre Änderungen**
   - Klicken Sie auf **Menü → Änderungen speichern**. Backups werden automatisch erstellt.

> **Tipp:** Jede Registerkarte verfügt über eine integrierte Anleitung – klicken Sie auf das Hilfesymbol in einer beliebigen Registerkarte, um genau zu sehen, was sie tun kann. Um tiefere Informationen zu erhalten, **bewegen Sie den Mauszeiger über eine beliebige Schaltfläche, ein Feld oder ein Steuerelement**, um detaillierte Tooltips in der Kopfzeile anzuzeigen. Das In-App-Tooltip-Hilfesystem ist Ihre beste Referenz, um genau zu verstehen, was die einzelnen Funktionen bewirken und wie sie verwendet werden.





---




<div align="center">

## Anleitungen

<img src="https://readme-typing-svg.demolab.com?lines=Schritt-f%C3%BCr-Schritt-Anleitungen;Folgen+Sie+der+Anleitung;Wir+zeigen+Ihnen+wie&center=true&width=390&height=28&font=monospace&size=22&color=7DD3FC&vCenter=true" alt="" />

</div>

### Dateispeicherorte speichern

**Host / Koop (Windows):**
```
%localappdata%\Pal\Saved\SaveGames\YOURID\RANDOMID\
```

**Dedizierter Server:**
```
steamapps\common\Palworld\Pal\Saved\SaveGames\0\RANDOMSERVERID\
```

### Kartenfreischaltung

PST kann die vollständige Karte (alle Schnellreisepunkte) für Ihren Speicherstand freischalten:

1. Laden Sie Ihren Speicherstand im PST-Format.
2. Öffnen Sie die Registerkarte **Spielerinventar** und klicken Sie auf **Alle Karten + Schnellreisen freischalten** für einen einzelnen Spieler, **oder**
3. Verwenden Sie das Tool **Karte wiederherstellen** auf der Registerkarte „Extras“, um den freigeschalteten Kartenfortschritt auf **allen** Ihren Welten/Servern gleichzeitig anzuwenden.
4. Änderungen speichern. Es werden automatische Backups erstellt.

### Host → Serverübertragung

<details>
<summary>Zum Erweitern klicken</summary>

1. Kopieren Sie `Level.sav` und den Ordner `Players` von Ihrem Hostspeicher.
2. Fügen Sie sie in den Speicherordner des dedizierten Servers ein.
3. Starten Sie den Server, erstellen Sie einen neuen Charakter und warten Sie auf die automatische Speicherung.
4. Schließen Sie den Server.
5. Verwenden Sie **Fix Host Save** in PST, um die GUID des alten Charakters auf die neue zu migrieren.
6. Kopieren Sie die Dateien zurück und starten Sie den Server.

</details>

### Host Swap (Host wechseln)

<details>
<summary>Klicken Sie hier, um den Host-Swap-Leitfaden zu erweitern</summary>

**Hintergrund:**

– Der Host verwendet `0001.sav`.
- Jeder Client verwendet einen eindeutigen regulären UID-Speicher, z. B. `1234.sav`, `9876.sav` usw.
- Spieler A ist der alte Host mit Fortschritten in `0001.sav`.
- Spieler B ist ein bestehender Kunde, der zum neuen Host wird.

**Ausgangszustand:**
```
0001.sav = Player A, old host
1234.sav = Player B, future host
```

**Voraussetzungen:**
- Spieler B muss zuvor der Welt von Spieler A beigetreten sein und einen Charakter erstellt haben.
- Der reguläre Spielerspeicher von Spieler B muss im Ordner `Players` vorhanden sein.
- Spieler A und Spieler B müssen beide mindestens Level 2 sein.
- Sichern Sie den gesamten World-Save-Ordner, bevor Sie Änderungen vornehmen.
- Fahren Sie den Server herunter oder schließen Sie Palworld, bevor Sie den Speicher ändern.

---

### 1. Tauschen Sie Spieler B in den Host-Slot aus

Öffnen Sie **Fix Host Save** und wählen Sie:
```
Source Player: Player A, 0001.sav
Target Player: Player B, 1234.sav
```
Führen Sie die Migration aus.

Ergebnis:
```
0001.sav = Player B's original progress
1234.sav = Player A's original progress
```
Spieler B belegt nun den Host-Slot. Der ursprüngliche Host-Fortschritt von Spieler A bleibt in der früheren regulären UID von Spieler B erhalten.

---

### 2. Starten Sie die Welt mit Spieler B als neuem Gastgeber

Starten Sie Palworld mit Spieler B, der die Welt hostet. Bestätigen Sie, dass Spieler B den richtigen Charakter, das richtige Level, das richtige Inventar, pals, die richtige Gilde, die richtigen Basen und den richtigen Besitz hat.

Status speichern:
```
0001.sav = Player B, new host
1234.sav = Player A's original progress
```

---

### 3. Lassen Sie Spieler A der Welt von Spieler B beitreten

Spieler A tritt der Welt bei, die jetzt von Spieler B gehostet wird. Palworld kann Spieler A eine neue reguläre UID zuweisen, da er nicht mehr der Host ist.

Beispiel:
```
3456.sav = Player A's new client UID
```

Palworld kann Spieler A bitten, einen neuen Charakter zu erstellen (erwartet). Der ursprüngliche Fortschritt von Spieler A liegt immer noch bei `1234.sav`.

Nachdem Spieler A den temporären Charakter erstellt hat:
```
0001.sav = Player B's correct progress
1234.sav = Player A's original progress
3456.sav = Player A's new temporary character
```

---

### 4. Den temporären Charakter von Spieler A aufleveln

1. Lassen Sie Spieler A mit dem temporären Charakter mindestens **Level 2** erreichen.
2. Lassen Sie Spieler A den Server verlassen.
3. Fahren Sie den Server vollständig herunter.
4. Sichern Sie den World-Save-Ordner erneut.

Level 2 ist erforderlich, da **Fix Host Save** erfordert, dass beide ausgewählten Charaktere mindestens Level 2 haben.

---

### 5. Stellen Sie den ursprünglichen Fortschritt von Spieler A wieder her

Öffnen Sie **Fix Host Save** erneut und wählen Sie:
```
Source Player: Player A's original progress, 1234.sav
Target Player: Player A's new client UID, 3456.sav
```
Führen Sie die Migration aus. Denn dies ist ein weiterer wechselseitiger Tausch:

```
0001.sav = Player B's correct host progress
3456.sav = Player A's restored original progress
1234.sav = Player A's temporary character
```
Die neue Client-UID von Spieler A verweist jetzt auf den ursprünglichen Charakter und Fortschritt von Spieler A.

---

### Endergebnis:
```
0001.sav = Player B, new host with original progress
3456.sav = Player A, client with restored original progress
1234.sav = Temporary leftover character
```
- Spieler B moderiert den Originalcharakter von Spieler B.
- Spieler A tritt mit dem wiederhergestellten Originalcharakter von Spieler A bei.

</details>

### Charakterübertragung (Cross-Save)

<details>
<summary>Zum Erweitern klicken</summary>

Übertragen Sie Charaktere zwischen verschiedenen Welten oder Servern und bewahren Sie dabei Charaktere, Pals, Inventar und Technologie:

1. Öffnen Sie das Tool **Charakterübertragung** auf der Registerkarte Extras.
2. Wählen Sie den Quellspeicher und den Zielspeicher aus.
3. Transferieren Sie einen einzelnen Spieler oder alle Spieler.
4. Nützlich für die Migration zwischen Koop- und dedizierten Servern.

</details>

### Basisexport / Import / Klonen

<details>
<summary>Zum Erweitern klicken</summary>

**Eine Basis exportieren:**
1. Gehen Sie zur Registerkarte **Stützpunkte** (oder verwenden Sie den Map Viewer).
2. Klicken Sie mit der rechten Maustaste auf eine Basis → **Basis exportieren**.
3. Als `.json`-Blueprint-Datei speichern.

**Eine Basis importieren:**
1. Klicken Sie mit der rechten Maustaste auf die Zielgilde (in der Registerkarte „Basen“, „Map Viewer“ oder „Gilden“).
2. Wählen Sie **Basis importieren** (einzelne Datei) oder **Basen importieren (mehrere Dateien)**.
3. Wählen Sie Ihre exportierte(n) `.json`-Datei(en) aus.

**Klonen einer Basis:**
1. Klicken Sie mit der rechten Maustaste auf eine Basis → **Basis klonen**.
2. Wählen Sie die Zielgilde aus.
3. Die Basis wird mit versetzter Positionierung geklont.

**Anpassen des Basisradius:**
1. Klicken Sie mit der rechten Maustaste auf eine Basis → **Radius anpassen**.
2. Geben Sie einen neuen Radius ein (50 %–1000 %).
3. Speichern Sie den Speicherstand im Spiel und laden Sie ihn erneut, damit die Strukturen neu zugewiesen werden können.

</details>





---




<div align="center">

## Fehlerbehebung

<img src="https://readme-typing-svg.demolab.com?lines=Wenn+die+Dinge+schiefgehen;Keine+Panik;Wir+haben+alles+gesehen&center=true&width=390&height=28&font=monospace&size=22&color=7DD3FC&vCenter=true" alt="" />

</div>

### „VCRUNTIME140.dll wurde nicht gefunden“ (Windows)

Installieren Sie den [Microsoft Visual C++ Redistributable](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170) (2015–2022).

### `struct.error` beim Parsen eines Speicherstands

Das Speicherdateiformat ist veraltet. Laden Sie den Speicherstand im Spiel (Solo, Koop oder Dedizierter Server) einmal, um eine automatische Strukturaktualisierung auszulösen, und versuchen Sie es dann erneut. Stellen Sie sicher, dass der Speicherstand mit oder nach dem neuesten Spiel-Patch aktualisiert wurde.

### GamePass Konverter funktioniert nicht

1. Schließen Sie die GamePass-Version von Palworld vollständig.
2. Warten Sie einige Minuten, bis die Dateihandles freigegeben werden.
3. Führen Sie den Konverter GamePass → Steam aus.
4. Starten Sie Palworld zur Überprüfung auf GamePass.

### Linux/MacOS-Binärdatei wird nicht gestartet

- **Linux:** `chmod +x PalworldSaveTools-*-linux`, um es als ausführbar zu markieren.
- **macOS:** Wenn vom Gatekeeper blockiert, klicken Sie mit der rechten Maustaste → **Öffnen** oder führen Sie `xattr -d com.apple.quarantine /path/to/app` aus.





---




<div align="center">

## Aufbau aus der Quelle

<img src="https://readme-typing-svg.demolab.com?lines=Stellen+Sie+es+selbst+zusammen;Bauen+Sie+Ihr+eigenes;Von+der+Quelle+zur+Bin%C3%A4rdatei&center=true&width=340&height=28&font=monospace&size=22&color=7DD3FC&vCenter=true" alt="" />

</div>

PST unterstützt zwei Build-Pfade. Die CI/CD-Pipeline verwendet Nuitka für plattformübergreifende Release-Binärdateien; cx_Freeze wird für das lokale Windows-Installationsprogramm verwendet.

### Nuitka (Plattformübergreifend – Wird von CI/Releases verwendet)

Erfordert Python 3.11+ und `uv`. Nuitka wird automatisch installiert.

```bash
# One-file build (Windows / Linux)
uv run python build/nuitka/build_nuitka.py --onefile

# One-directory build (macOS .app)
uv run python build/nuitka/build_nuitka.py --onedir
```

Ausgaben gehen an `dist/`:
- Windows → `dist/PalworldSaveTools-*.exe`
- Linux → `dist/PalworldSaveTools-*-linux`
- macOS → `dist/PalworldSaveTools.app` → verpackt als `.dmg`

### cx_Freeze (Windows Installer)

Für ein lokales Windows `.7z`-Paket:

```
scripts\build_cx.cmd
```

Dadurch wird `PST_standalone_v{version}.7z` im Projektstamm erstellt.

### Interaktiver Builder

Ein interaktives Menü zur Auswahl eines Build-Modus:

```bash
uv run python build/build_interactively.py
```





---




<div align="center">

## Mitwirken

<img src="https://readme-typing-svg.demolab.com?lines=M%C3%B6chten+Sie+helfen%3F+Hier+erfahren+Sie%2C+wie;Treten+Sie+dem+Team+bei;Jeder+Beitrag+z%C3%A4hlt&center=true&width=440&height=28&font=monospace&size=22&color=7DD3FC&vCenter=true" alt="" />

</div>

Beiträge sind willkommen! Bitte senden Sie gerne einen Pull Request.

1. Forken Sie das Repository.
2. Erstellen Sie Ihren Feature-Zweig (`git checkout -b feature/AmazingFeature`).
3. Übernehmen Sie Ihre Änderungen (`git commit -m 'Add some AmazingFeature'`).
4. Drücken Sie auf den Zweig (`git push origin feature/AmazingFeature`).
5. Öffnen Sie eine Pull-Anfrage.





---




<div align="center">

## Haftungsausschluss

<img src="https://readme-typing-svg.demolab.com?lines=Lesen+Sie+dies%2C+bevor+Sie+etwas+kaputt+machen;Sie+wurden+gewarnt;Zuerst+sichern%21;Mit+gro%C3%9Fer+Kraft...&center=true&width=520&height=28&font=monospace&size=22&color=7DD3FC&vCenter=true" alt="" />

</div>

**Die Verwendung dieses Tools erfolgt auf eigene Gefahr. Sichern Sie immer Ihre Sicherungsdateien, bevor Sie Änderungen vornehmen.**

Die Entwickler sind nicht verantwortlich für den Verlust gespeicherter Daten oder Probleme, die durch die Verwendung dieses Tools entstehen können.





---




<div align="center">

## Unterstützung

<img src="https://readme-typing-svg.demolab.com?lines=Wir+stehen+Ihnen+zur+Seite;Brauchen+Sie+Hilfe%3F;Wir+sind+f%C3%BCr+Sie+da&center=true&width=340&height=28&font=monospace&size=22&color=7DD3FC&vCenter=true" alt="" />

</div>

- **Discord:** [Join us for support, base builds, and more!](https://discord.gg/sYcZwcT4cT)
- **GitHub Probleme:** [Report a bug](https://github.com/deafdudecomputers/PalworldSaveTools/issues)
- **Nexus-Mods:** [Download & discuss](https://www.nexusmods.com/palworld/mods/3190)





---




<div align="center">

## Lizenz

<img src="https://readme-typing-svg.demolab.com?lines=MIT+%E2%80%93+machen+Sie%2C+was+Sie+wollen;Kostenlos+wie+beim+Bier;Open+Source%2C+offener+Geist&center=true&width=430&height=28&font=monospace&size=22&color=7DD3FC&vCenter=true" alt="" />

</div>

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei [license](license).





---




<div align="center">

## Das Palworld-Team

<img src="https://readme-typing-svg.demolab.com?lines=Die+Menschen+hinter+der+Magie;Lernen+Sie+das+Team+kennen;Mit+Leidenschaft+gebaut&center=true&width=420&height=28&font=monospace&size=22&color=7DD3FC&vCenter=true" alt="" />

</div>

Ohne die Menschen dahinter gäbe es dieses Projekt nicht.

### Aktive Betreuer

**[Pylar](https://github.com/deafdudecomputers)** – Der Mann, mit dem alles begann. Jede Zeile dieses Tools geht auf seine Vision und seine unermüdliche Arbeit an der Speicher-Engine, der GUI und den Funktionen zurück, die Sie täglich verwenden.

**[cyrix](https://github.com/CyrixJD115)** – Refactorer und Sub-Maintainer. Konzentriert sich auf Codequalität, Vereinfachung und strukturelle Verbesserungen – so bleibt die Codebasis sauber, kleiner und einfacher zu warten, wenn das Projekt wächst.

### Mitwirkende

**[dkoz](https://github.com/dkoz)** – Der Mann hinter den Ausweisen. Bietet Spieldaten-IDs, strukturelle Einblicke in die ID-Codes und umfassende Kenntnisse darüber, wie die Daten von Palworld miteinander verknüpft sind, sodass das Tool bei jedem Spielupdate korrekt bleibt.

**[oMaN-Rod](https://github.com/oMaN-Rod)** – Stellte den ursprünglichen Speicherparser bereit, von dem dieses Projekt geforkt wurde. Ohne seine grundlegende Arbeit zum Knacken des Palworld-Speicherformats gäbe es das alles nicht. Der Fork hat seinen Parser zu dem optimiert und vereinfacht, was PST heute ist.

**[Okaetsu](https://github.com/Okaetsu)** – Modding-Erkenntnisse, die den Basisimport/-export ermöglichten. Sein Verständnis dafür, wie Palworld Basisdaten von der Modding-Seite aus strukturiert, überbrückte die Lücke zwischen Modding und Save Editing und machte dieses Feature Wirklichkeit.





---




<div align="center">

## Danksagungen

<img src="https://readme-typing-svg.demolab.com?lines=Wo+Kredit+f%C3%A4llig+ist;Vielen+Dank+euch+allen;Wir+stehen+auf+Schultern&center=true&width=390&height=28&font=monospace&size=22&color=7DD3FC&vCenter=true" alt="" />

</div>
Ein großes Dankeschön an:

- **Palworld**, entwickelt von Pocketpair, Inc. – für das Spiel, das uns alle zusammengebracht hat.
- **Die Fehlerreporter** – jedes eingereichte Problem, jeder gefundene Randfall, jedes in Discord eingefügte Protokoll. Mit jedem Bericht machen Sie dieses Tool robuster.
- **Die Palworld-Modding-Community** – andere Modder, Tool-Entwickler und Tüftler, die Wissen teilen, Formate zurückentwickeln und das Ökosystem vorantreiben. Dieses Projekt steht auf den Schultern dieser gemeinsamen Anstrengung.
- **Alle Mitwirkenden und Community-Mitglieder** – egal, ob Sie eine PR eingereicht, eine Frage in Discord beantwortet oder einfach einem Freund von PST erzählt haben – vielen Dank.

---

<div align="center">

![Divider](../assets/branding/PalworldSaveTools_readme_divider.png)

**Hergestellt mit ❤️ für die Palworld-Community**

[⬆ Back to Top](#palworld-save-tools)

</div>