🪄 Levels

Mitglied Aendern

Stufe und XP eines Mitglieds setzen, addieren oder abziehen.

─── Warum ueber die GESAMT-XP gerechnet wird ───────────────────────────

Weil eine Stufe kein Wert ist, den man setzt, sondern das Ergebnis einer Rechnung. Wer nur level = 30 schreibt, hinterlaesst ein Profil mit einem Schwellenwert, der nicht zu 30 gehoert - und beim naechsten XP springt es irgendwohin.

Der Weg ist deshalb immer derselbe:

1. aktuelle Gesamt-XP ermitteln
2. die Aenderung darauf anwenden
3. ueber `_neu_einordnen` wieder Stufe, Rest und Schwelle machen

Das gilt fuer alle vier Faelle - setzen, addieren, abziehen, beides zugleich - und deshalb gibt es nur diesen einen Weg.

─── Warum gesamt_xp_verdient nur STEIGT ──────────────────────────────

Es ist die Lebensleistung, nicht der Kontostand. Ein Admin, der XP hinzufuegt, erhoeht sie mit (die Person hat sie ja bekommen); ein Admin, der abzieht, senkt sie NICHT. Sonst waere die All-Time-Rangliste nach jedem Eingriff ein Stueck falscher, und niemand koennte hinterher sagen, wer wirklich am meisten gesammelt hat.

Die Ausnahme, die keine ist: das Zuruecksetzen auf Stufe 1 setzt sie ebenfalls nicht zurueck. Ein zurueckgesetztes Profil hat die XP trotzdem einmal verdient.

patch/api/v1/servers/{server_id}/level/mitglieder/{user_id}

Request

  • Base URL: https://api.notoq.xyz (the document declares no server; this is the origin it was published from)
  • URL: https://api.notoq.xyz/api/v1/servers/{server_id}/level/mitglieder/{user_id}
  • Auth: HTTP bearer

Path parameters

server_idstring required
user_idstring required

Request body

stufe_setzeninteger nullable
stufe_aenderninteger nullable

Positiv oder negativ

xp_setzeninteger nullable
xp_aenderninteger nullable

Positiv oder negativ

grundstring nullable

Response

Successful Response

successboolean required
dataobject required
messagestring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.