Farbthema
العربية Беларуская Български Čeština Dansk Deutsch Ελληνικά English Español Suomi Français עברית Magyar Bahasa Indonesia Italiano 日本語 한국어 Lietuvių Nederlands Norsk ☠ Pirate Polski Português (BR) Português (PT) Română Русский Slovenčina Српски Svenska Türkçe Українська 简体中文 繁體中文

Abenteuer

Base: /api/adventure

Hytale 0.7: Welt-Ereignisse, Portale, Void-Invasionen, Instanzen und Spieler-Werkzeuge

Verarbeitung: AdventureHandler

Endpunkte

GET /api/adventure POST /api/adventure/world-events POST /api/adventure/portal/time POST /api/adventure/portal/timer POST /api/adventure/portal/void POST /api/adventure/debug-screens POST /api/adventure/teleport-player POST /api/adventure/spawn POST /api/adventure/send-to-spawn POST /api/adventure/scale POST /api/adventure/history POST /api/adventure/wilderness POST /api/adventure/instance/spawn POST /api/adventure/instance/exit POST /api/adventure/instance/close
GET /api/adventure

Abenteuer-Übersicht

Liefert jede geladene Welt (dauerhaft oder Instanz) mit Welt-Ereignissen, Spawn, Portal-Zustand, Stufen der Void-Invasion und Spielern mit Größe, Teleport-Verlauf, Wildnis-Karte und Debug-Sperre; dazu die Instanz-Vorlagen.

Antwort-Beispiel 

{
  "worlds": [
    {
      "name": "default",
      "available": true,
      "instance": false,
      "ticking": true,
      "world_events": true,
      "spawn": {
        "x": 0.0,
        "y": 64.0,
        "z": 0.0
      },
      "portal": null,
      "players": [
        {
          "name": "Steve",
          "debug_screens_blocked": false,
          "scale": 1.0,
          "history_back": 0,
          "history_forward": 0,
          "wilderness_debug": false,
          "x": 10.0,
          "y": 64.0,
          "z": -3.0
        }
      ]
    }
  ],
  "instance_templates": [
    "Dungeon_Small",
    "Dungeon_Large"
  ]
}

cURL 

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

Internes Verhalten

Führt je Welt eine Aufgabe auf ihrem Welt-Thread aus. Die Void-Stufen stammen aus der Konfiguration des jeweiligen Portals.
POST /api/adventure/world-events

Welt-Ereignisse an/aus

Schaltet Hytales Welt-Ereignisse (zum Beispiel Goblin-Einbrüche) für eine Welt an oder aus.

Anfragekörper

Feld Typ Pflicht Beschreibung
world string Nein Weltname, Standard erste geladene Welt
enabled boolean Ja Welt-Ereignisse an oder aus

Antwort-Beispiel 

{
  "success": true,
  "world": "default",
  "world_events": true
}

cURL 

curl -X POST 'http://localhost:5550/api/adventure/world-events' \
  -H 'X-Admin-Token: YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"world": "default", "enabled": false}'

Internes Verhalten

Ändert WorldEventsWorldConfig und startet oder stoppt laufende Ereignisse.
POST /api/adventure/portal/time

Portal-Zeit ändern

Ändert die Restzeit einer Portal-Welt, zwischen 10 Sekunden und 6 Stunden.

Anfragekörper

Feld Typ Pflicht Beschreibung
world string Nein Portal-Welt, Standard erste geladene Welt
seconds integer Ja Sekunden zum Hinzufügen (negativ zieht ab) oder zum Setzen
mode string Nein add (Standard) oder set

Antwort-Beispiel 

{
  "success": true,
  "world": "default",
  "remaining_seconds": 3600
}

cURL 

curl -X POST 'http://localhost:5550/api/adventure/portal/time' \
  -H 'X-Admin-Token: YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"world": "instance-portal_hedera-1", "seconds": 300}'

Internes Verhalten

Setzt die Restzeit von PortalWorld; baut eine fällige Void-Invasion sofort wieder auf oder lässt eine gestoppte gestoppt.
POST /api/adventure/portal/timer

Portal-Timer anhalten oder fortsetzen

Schaltet das Zeitlimit einer Portal-Welt um.

Anfragekörper

Feld Typ Pflicht Beschreibung
world string Nein Portal-Welt

Antwort-Beispiel 

{
  "success": true,
  "world": "default",
  "timer_active": false
}

cURL 

curl -X POST 'http://localhost:5550/api/adventure/portal/timer' \
  -H 'X-Admin-Token: YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"world": "instance-portal_hedera-1"}'

Internes Verhalten

Ruft PortalWorld.toggleTimeLimit auf dem Welt-Thread auf.
POST /api/adventure/portal/void

Void-Invasion stoppen oder zulassen

stop entfernt die Invasion und hält ihren Zähler an, die Portalzeit läuft weiter; allow setzt den Plan zurück.

Anfragekörper

Feld Typ Pflicht Beschreibung
world string Nein Portal-Welt
action string Ja stop oder allow

Antwort-Beispiel 

{
  "success": true,
  "world": "default",
  "action": "stop"
}

cURL 

curl -X POST 'http://localhost:5550/api/adventure/portal/void' \
  -H 'X-Admin-Token: YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"world": "instance-portal_hedera-1", "action": "stop"}'

Internes Verhalten

Entfernt das VoidEvent-Objekt und pausiert dessen Zähler, oder hebt die Sperre auf und startet den Stufenplan neu, wenn fällig.
POST /api/adventure/debug-screens

Debug-Anzeige sperren

Sperrt oder erlaubt die Debug-Anzeige (F3) für einen Spieler.

Anfragekörper

Feld Typ Pflicht Beschreibung
player string Ja Online-Spieler
blocked boolean Ja Debug-Anzeige (F3) sperren

Antwort-Beispiel 

{
  "success": true,
  "player": "Steve",
  "debug_screens_blocked": true
}

cURL 

curl -X POST 'http://localhost:5550/api/adventure/debug-screens' \
  -H 'X-Admin-Token: YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"player": "Eranio", "blocked": true}'

Internes Verhalten

Fügt die Komponente PreventDebugScreens hinzu oder entfernt sie.
POST /api/adventure/teleport-player

Zu Spieler teleportieren

Teleportiert einen Spieler zu einem anderen, auch weltübergreifend.

Anfragekörper

Feld Typ Pflicht Beschreibung
player string Ja Zu bewegender Spieler
target string Ja Spieler, zu dem teleportiert wird

Antwort-Beispiel 

{
  "success": true,
  "player": "Steve",
  "target": "Alex",
  "world": "default"
}

cURL 

curl -X POST 'http://localhost:5550/api/adventure/teleport-player' \
  -H 'X-Admin-Token: YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"player": "Eranio", "target": "Kim"}'

Internes Verhalten

Liest die Zielposition auf dessen Welt-Thread und schreibt einen Eintrag in den Teleport-Verlauf.
POST /api/adventure/spawn

Spawn setzen

Setzt den Spawnpunkt einer Welt an der Position eines Spielers oder an Koordinaten.

Anfragekörper

Feld Typ Pflicht Beschreibung
player string Nein Position dieses Spielers als Spawn verwenden
world string Nein Welt für Koordinaten
x number Nein Pflicht ohne player
y number Nein Pflicht ohne player
z number Nein Pflicht ohne player

Antwort-Beispiel 

{
  "success": true,
  "world": "default",
  "x": 10.0,
  "y": 64.0,
  "z": -3.0
}

cURL 

curl -X POST 'http://localhost:5550/api/adventure/spawn' \
  -H 'X-Admin-Token: YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"world": "default", "x": -398.5, "y": 115, "z": -98.5}'

Internes Verhalten

Setzt einen GlobalSpawnProvider in der Weltkonfiguration.
POST /api/adventure/send-to-spawn

Zum Spawn schicken

Schickt einen Spieler zum Spawn einer Welt.

Anfragekörper

Feld Typ Pflicht Beschreibung
player string Ja Online-Spieler
world string Nein Zielwelt, Standard die Welt des Spielers

Antwort-Beispiel 

{
  "success": true,
  "player": "Steve",
  "world": "default"
}

cURL 

curl -X POST 'http://localhost:5550/api/adventure/send-to-spawn' \
  -H 'X-Admin-Token: YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"player": "Eranio"}'

Internes Verhalten

Teleportiert zum Spawnpunkt und schreibt den Teleport-Verlauf.
POST /api/adventure/scale

Spielergröße setzen

Skaliert einen Spieler zwischen 25 und 400 %.

Anfragekörper

Feld Typ Pflicht Beschreibung
player string Ja Online-Spieler
scale number Ja Größenfaktor 0,25 bis 4,0

Antwort-Beispiel 

{
  "success": true,
  "player": "Steve",
  "scale": 1.5
}

cURL 

curl -X POST 'http://localhost:5550/api/adventure/scale' \
  -H 'X-Admin-Token: YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"player": "Eranio", "scale": 2.0}'

Internes Verhalten

Setzt die EntityScaleComponent.
POST /api/adventure/history

Teleport-Verlauf

Bewegt einen Spieler im Teleport-Verlauf einen Schritt zurück oder vor (wie /back).

Anfragekörper

Feld Typ Pflicht Beschreibung
player string Ja Online-Spieler
direction string Nein back (Standard) oder forward

Antwort-Beispiel 

{
  "player": "Steve",
  "direction": "back",
  "success": true
}

cURL 

curl -X POST 'http://localhost:5550/api/adventure/history' \
  -H 'X-Admin-Token: YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"player": "Eranio", "direction": "back"}'

Internes Verhalten

Ruft TeleportHistory.back oder forward auf.
POST /api/adventure/wilderness

Wildnis-Karte

Zeigt oder versteckt die Wildnis-Debug-Karte für einen Spieler.

Anfragekörper

Feld Typ Pflicht Beschreibung
player string Ja Online-Spieler
enabled boolean Ja Wildnis-Karte an oder aus

Antwort-Beispiel 

{
  "success": true,
  "player": "Steve",
  "wilderness_debug": true
}

cURL 

curl -X POST 'http://localhost:5550/api/adventure/wilderness' \
  -H 'X-Admin-Token: YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"player": "Eranio", "enabled": true}'

Internes Verhalten

Fügt WildernessDebug hinzu oder entfernt es und leert beim Ausschalten die eingefärbten Kartenteile.
POST /api/adventure/instance/spawn

Instanz öffnen

Öffnet eine neue Instanz aus einer Vorlage und schickt den Spieler hinein. Beim Verlassen kehrt er an die alte Position zurück.

Anfragekörper

Feld Typ Pflicht Beschreibung
template string Ja Instanz-Vorlage (siehe instance_templates in der Übersicht)
player string Ja Online-Spieler

Antwort-Beispiel 

{
  "success": true,
  "player": "Steve",
  "template": "Dungeon_Small"
}

cURL 

curl -X POST 'http://localhost:5550/api/adventure/instance/spawn' \
  -H 'X-Admin-Token: YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"template": "Portals/Portals_Hedera", "player": "Eranio"}'

Internes Verhalten

Ruft InstancesPlugin.spawnInstance auf.
POST /api/adventure/instance/exit

Instanz verlassen

Holt einen Spieler aus einer Instanz zurück in die vorherige Welt.

Anfragekörper

Feld Typ Pflicht Beschreibung
player string Ja Spieler in einer Instanz

Antwort-Beispiel 

{
  "success": true,
  "player": "Steve",
  "world": "instance_abc123"
}

cURL 

curl -X POST 'http://localhost:5550/api/adventure/instance/exit' \
  -H 'X-Admin-Token: YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"player": "Eranio"}'

Internes Verhalten

Ruft InstancesPlugin.exitInstance auf.
POST /api/adventure/instance/close

Instanz schließen

Schließt eine leere Instanz.

Anfragekörper

Feld Typ Pflicht Beschreibung
world string Ja Instanz-Welt

Antwort-Beispiel 

{
  "success": true,
  "world": "instance_abc123"
}

cURL 

curl -X POST 'http://localhost:5550/api/adventure/instance/close' \
  -H 'X-Admin-Token: YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"world": "instance-portal_hedera-1"}'

Internes Verhalten

Prüft, dass niemand drin ist, und ruft InstancesPlugin.safeRemoveInstance auf.