PlayerDataSync Documentation

PlayerDataSync synchronisiert Inventar, Status, Statistiken und mehr zwischen deinen Servern – stabil, schnell und skalierbar.

Quick Start

Lade die JAR von der Download-Seite herunter.
Lege PlayerDataSync.jar in den Ordner plugins/.
Bearbeite config.yml (Datenbank & Module). Tipp: nutze den Config-Generator.
Starte den Server neu und prüfe die Logs auf Connected to database.

Du kannst jederzeit zwischen MySQL/MariaDB, SQLite oder (experimentell) PostgreSQL wechseln.

Requirements

Minecraft Server: Paper/Purpur 1.20.4 – 1.21.x
Java 17+
Datenbank: MySQL/MariaDB (empfohlen) oder SQLite, PostgreSQL (experimentell)
Optional: Vault (Economy), LuckPerms (Permissions), PlaceholderAPI

Installation

JAR in plugins/ kopieren und Server starten (Config wird generiert).
Config anpassen, erneut starten.
Mit /pds reload kannst du Änderungen laden, ohne neu zu starten.

Minimaler Auszug aus config.yml

server:
  id: default

database:
  type: mysql
  table_prefix: player_data
  mysql:
    host: localhost
    port: 3306
    database: minecraft
    user: root
    password: password

Database Setup

Empfohlen für Produktionsumgebungen: MySQL / MariaDB. SQLite eignet sich für Tests oder Single-Server.

database:
  type: mysql
  table_prefix: player_data
  mysql:
    host: localhost
    port: 3306
    database: minecraft
    user: root
    password: password
    ssl: false
    connection_timeout: 5000
    max_connections: 10

Nutze für jede Instanz ein eindeutiges server.id (z. B. hub-1, survival-2).

Synchronization Settings

Wähle, welche Daten synchronisiert werden:

inventory, armor, offhand, enderchest
xp, health, hunger, effects
statistics, achievements
economy (Vault), permissions (LuckPerms)

sync:
  inventory: true
  enderchest: true
  armor: true
  offhand: true
  health: true
  hunger: true
  statistics: true
  achievements: true
  economy: true
  permissions: false

Performance Tuning

PlayerDataSync arbeitet asynchron mit Batch-Schreibvorgängen und Cache-Layer.

performance:
  batch_size: 50
  cache_size: 100
  cache_ttl: 300000
  async_loading: true
  connection_pooling: true

Sehr hohe batch_size kann RAM-Verbrauch erhöhen. Steigere schrittweise und beobachte die TPS.

Commands

Command	Description	Permission
/pds reload	Reloads configuration and cache	`playerdatasync.admin`
/pds save <player>	Forces a manual save	`playerdatasync.admin`
/pds info <player>	Shows last sync time and server	`playerdatasync.admin`

Permissions

playerdatasync.admin – Zugriff auf Admin-Befehle

Config reference

server.id – eindeutige Instanz-ID
database.* – Datenbanktyp & Verbindungsdaten
sync.* – Module aktivieren/deaktivieren
performance.* – Batch, Cache, Async
integrations.* – Vault, LuckPerms, PAPI
logging.* – Log-Level & Debug
metrics.* – bStats & Custom Metrics

Eine editierbare Komplett-Config kannst du auf der Seite /config generieren.

Troubleshooting

Database connection failed: Host/Port/User/Pass prüfen.
Lag spikes: async_loading: true aktiv, batch_size moderat halten.
Data mismatch: Alle Server müssen dieselbe Datenbank nutzen.

FAQ

Snapshots & Releases?

Auf der Seite Download findest du stabile Versionen und Snapshots.

Wie oft Backups?

Täglich wird empfohlen. Nutze zusätzlich Backup/Rotation-Optionen.

Welche Versionen?

Paper/Purpur 1.20.4 – 1.21.x. Prüfe Kompatibilitätsflags in der Config.