Web-Interface (/cweb)

Eingebautes Web-Panel ohne externe Abhängigkeiten: /cweb erzeugt einen persönlichen Einmal-Link, im Browser verwaltet der Spieler Homes, Claims, Jobs, Teams, Warps und Economy. Kein Login, kein Passwort; der Spieler muss während der Session online bleiben.

Commands & Permissions #

Aufbau #

Links steht die Kategorie-Leiste (auf dem Handy unten als Leiste mit Symbolen), rechts die gewählte Seite. Die Kategorien sind in dieselben Gruppen gegliedert wie diese Wiki: Teleportation (Homes, Warps), Wirtschaft & Jobs (Konto, Shops, Jobs), Claims, Teams & Chat (Teams, Profil), Welt & Utility (Inventar) und der Team-Bereich (Moderation, Admin, nur mit Rechten sichtbar). Jede Gruppe hat ihre Wiki-Farbe, die das ganze Panel einfärbt, damit auf einen Blick klar ist, wo man gerade ist. Umfangreiche Kategorien sind in Abschnitte geteilt, die als Reiter über dem Inhalt sitzen; auf dem Handy stehen sie als Raster untereinander. Die gewählte Seite steht in der Adresse (#teams/members), also führen Zurück-Taste und Neuladen an dieselbe Stelle. Das Panel folgt der Browsersprache: Englisch und Deutsch sind eingebaut, andere Sprachen fallen auf Englisch zurück.

Teams ist in vier Abschnitte geteilt, statt alles in eine lange Liste zu packen:

Über dem Ganzen steht eine Team-Karte mit Name, Tag, Level, deinem Rang und den wichtigsten Zahlen, eingefärbt in der Team-Farbe.

So funktioniert es #

Der Link ist einmalig und läuft nach link-expiry-seconds ab; eine neue /cweb-Nutzung beendet die alte Session. Alles im Browser ist nur Anzeige: Erst beim Klick auf Apply prüft der Server jede Änderung live gegen Permissions, Team-Ränge, Kontostand und Cooldowns und speichert nur bei Erfolg (mehrere Änderungen werden einzeln geprüft, ein Fehlschlag verwirft die anderen nicht). Die Session endet nach session-timeout-minutes Inaktivität oder beim Verlassen des Servers. Der Webserver ist mit Rate-Limiting gegen Anfrage-Fluten abgesichert.

Kategorien: Homes (ansehen, umbenennen, löschen, gesperrte Welten sehen; setzen nur ingame), Claims (ansehen, aufgeben, Vertrauen verwalten für Spieler, public oder [Gruppe], Claim-Blöcke kaufen und verkaufen, Claim-Flags wie Explosionen oder öffentlichen Zugang schalten, Subclaims ansehen und einschränken, eigene Claims dem Team übergeben, Admin-Plots für das Team kaufen oder mieten, Rückgabe-Anfragen des Team-Inhabers annehmen oder ablehnen; Haustiere übergeben bleibt ingame (/givepet), weil das Tier dafür angeklickt werden muss; braucht das eingeschaltete Claim-Modul), Jobs (Level, Verdienst, Quests, Toplisten mit Job-Filter, aktive Boosts, Punkteshop: Käufe landen beim Anwenden im Inventar), Teams (siehe Aufbau oben; Team-Warps lassen sich umbenennen, mit Icon per Item-ID und Beschreibung versehen, in der Sichtbarkeit umschalten und löschen, alles nach Team-Rang, inklusive Team-Erstellung zu denselben Regeln wie ingame; ohne Team lassen sich Einladungen annehmen oder ablehnen und offene Teams beitreten, mit Team Allianzen anfragen, annehmen und auflösen, das Team-Home entfernen und als Inhaber das Team nach Eintippen des Teamnamens auflösen), Warps (öffentliche Liste verwalten: umbenennen, Icon per Item-ID wie cobblestone, Beschreibung, Kategorie, löschen, Sponsor-Slots für die eigenen Warps kaufen; anlegen und verschieben passiert bewusst nur ingame, weil die Position vom Spieler kommt), Economy (Kontostand, Kontostand anderer Spieler nachschlagen, Topliste mit Seiten, /pay), Inventar (Cosmetics anwenden und entfernen, Übersicht der noch gesperrten Cosmetics), Profil (Nickname setzen und entfernen, eigene Join- und Leave-Nachricht, Teleport-Anfragen und Mobs-mitnehmen an- oder ausschalten, ignorierte Spieler verwalten), Shops (eigene Kistenshops und die Shops des Teams: Preis ändern, zwischen Verkauf und Ankauf wechseln, Shop entfernen; anlegen nur ingame per Schild an der Kiste).

Team-Bereich: Mit der Berechtigung core.web.category.moderation (Standard: nur OP, bewusst nicht Teil von core.web.*) erscheint die Kategorie Moderation: Online-Liste mit Serverlast, Spieler-Details und Verwarnungshistorie, aktive Bans, IP-Bans, Mutes und Jail-Einträge mit Formularen zum Setzen und Aufheben. Jede Aktion braucht zusätzlich den passenden mod.*-Knoten und greift erst beim Anwenden; Online-Spieler werden wie beim Befehl gekickt oder teleportiert. Jail-Positionen und Vanish bleiben ingame. Mit core.web.category.admin (ebenfalls Standard OP) kommt die Kategorie Admin dazu: Serverstatus mit Modulübersicht und Reload, Broadcast, Kontostände anderer Spieler nachschlagen und ändern (economy.admin), Nicknames setzen und zurücksetzen (nick.admin), Gruppenspawns entfernen (spawn.admin) sowie Zeit, Wetter und Gamerules je Welt (world.time, world.weather, world.gamerules), Team-Verwaltung wie /teama (Mitglieder, Ränge, Inhaber, Name, Beschreibung, Tag, Farbe, Score, Kasse, Auflösen nach Eintippen des Namens; team.admin.*) und Jobs-Verwaltung wie /jobsa (Beitritt, Level, XP, Punkte, Verdienstlimit, Quests, Admin-Boosts; jobs.admin.*), Claim-Verwaltung (globale Claim-Liste mit Besitzer-Filter, Löschen, Übertragen, Blockkonten anpassen; coreengineclaim.deleteclaims, coreengineclaim.transferclaim, coreengineclaim.adjustclaimblocks) und Hologramme (Zeilen bearbeiten, hinzufügen und entfernen, Hologramm löschen; holo.edit, holo.delete; anlegen und verschieben nur ingame).

Einrichtung auf öffentlichen Servern #

Lokal funktioniert /cweb sofort auf http://localhost:8196. Öffentlich muss einmalig die public-url gesetzt werden:

1. plugins/CoreEngine/modules/websession.yml öffnen und public-url auf deine IP/Domain setzen (ohne http://).
2. Port 8196 (TCP) in Firewall/Hoster-Panel freigeben.
3. Neustarten oder /ce reload; im Log muss [WebSession] /cweb links will use: http://... deine Adresse zeigen.

Für HTTPS: Reverse Proxy (nginx/Caddy) auf 443, bind-address: "127.0.0.1", public-url: "https://panel.deinserver.de", behind-proxy: true. Erlaubt dein Hoster keine Zusatzports, setze websession.enabled: false, damit Spieler keine toten Links bekommen.

Konfiguration (modules/websession.yml) #

# Schaltet das Web-Interface-Modul ein oder aus.
enabled: true

websession:
  # Web-Interface einzeln abschaltbar.
  enabled: true
  # Port des eingebauten HTTP-Servers.
  port: 8196
  # Bind-Adresse. 127.0.0.1 für Reverse-Proxy-Setups.
  bind-address: "0.0.0.0"
  # Adresse in den Links. IP/Domain reicht (http:// und Port werden
  # ergänzt), volle URLs wie https://... werden unverändert benutzt.
  # Auf öffentlichen Servern Pflicht, sonst zeigen Links auf localhost.
  public-url: ""
  # X-Forwarded-Header vertrauen (NUR hinter einem Reverse Proxy).
  behind-proxy: false
  # Sekunden, die ein unbenutzter Link gültig bleibt.
  link-expiry-seconds: 300
  # Cooldown für NEUE Links; ein noch gültiger Link wird wiederverwendet.
  # Bypass: core.web.cooldown.bypass.
  command-cooldown-seconds: 10
  # Session endet nach N Minuten Inaktivität im Browser.
  session-timeout-minutes: 20
  # Optionaler Website-Link im Footer des Panels.
  website-url: ""

Troubleshooting #

Komplette Beispiel-Config #

enabled: true

websession:
  enabled: true
  port: 8196
  bind-address: "127.0.0.1"
  public-url: "https://panel.meinserver.de"
  behind-proxy: true
  link-expiry-seconds: 180
  command-cooldown-seconds: 30
  session-timeout-minutes: 15
  website-url: "https://meinserver.de"