Spielerwelten

Base: /api/playerworlds

Welten, die Spieler im Spiel mit /meinewelt anlegen

Verarbeitung: PlayerWorldsHandler

GET /api/playerworlds

Spielerwelten-Übersicht

Liefert die Einstellungen und jede Spielerwelt mit Anzeigename, Besitzer, Mitgliedern, Gästen, Lade- und Freischalt-Zustand.

Antwort-Beispiel

{
  "max_per_player": 1,
  "idle_park_minutes": 5,
  "creation_enabled": true,
  "worlds": [
    {
      "name": "pw-1234abcd-1",
      "display_name": "Steve's World",
      "owner": "Steve",
      "owner_uuid": "1234...",
      "members": [
        "Alex"
      ],
      "guests": [
        "Bob"
      ],
      "loaded": true,
      "unlocked": false,
      "created": 1737000000000
    }
  ]
}

cURL

curl -X GET 'http://localhost:5550/api/playerworlds' \
  -H 'X-Admin-Token: YOUR_TOKEN'

Internes Verhalten

Liest player-worlds.json und den aktuellen Zustand (Freischaltung steht nur im Speicher bis zum nächsten Neustart).

POST /api/playerworlds/config

Einstellungen Spielerwelten

Ändert die globalen Einstellungen der Spielerwelten.

Anfragekörper

Feld	Typ	Pflicht	Beschreibung
`creation_enabled`	boolean	Nein	Spieler dürfen Welten anlegen
`max_per_player`	integer	Nein	Welten je Spieler, 0 bis 50 (0 schaltet ab)
`idle_park_minutes`	integer	Nein	Leere Welten nach 1 bis 1440 Minuten auslagern

Antwort-Beispiel

{
  "max_per_player": 2,
  "idle_park_minutes": 10,
  "creation_enabled": true,
  "success": true
}

cURL

curl -X POST 'http://localhost:5550/api/playerworlds/config' \
  -H 'X-Admin-Token: YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"creation_enabled": true, "max_per_player": 2, "idle_park_minutes": 10}'

Internes Verhalten

Schreibt player-worlds.json; Werte werden auf den erlaubten Bereich begrenzt.