Anleitung zum Server-Shop von Levlix

Mit dem Shop-Modul von Levlix bieten Server-Admins Artikel an, die sich mit der virtuellen Punktewährung des Servers kaufen lassen. Mitglieder stöbern in den verfügbaren Artikeln, kaufen sie mit ihrem Punktestand und sehen ihren vollständigen Kaufverlauf, entweder über die Slash-Befehle in Discord oder direkt im Web-Dashboard.

Wo Mitglieder einkaufen können

Es gibt zwei gleichwertige Wege zum Stöbern und Kaufen:

1. In Discord, über die unten beschriebenen /shop-Slash-Befehle.
2. Im Web-Dashboard, unter Server → Shop. Mitglieder sehen denselben Katalog, den die Server-Admins eingerichtet haben, dazu ihren aktuellen Punktestand, Abzeichen zur Verfügbarkeit und den vollständigen Kaufverlauf.

Ein Kauf im Dashboard durchläuft genau dieselben Sicherheitsprüfungen wie der Slash-Befehl: Startdatum, Ablauf, Kauflimits, Bestand und Bezahlung werden alle serverseitig durchgesetzt. Der Abzug der Punkte und die Zuteilung des Codes passieren in einer einzigen Datenbanktransaktion. Ein Kauf, der auf halbem Weg scheitert (zum Beispiel weil der Vorrat an Codes genau in diesem Moment leer war), kostet deshalb nie Punkte: Niemand zahlt für einen Code, den er nicht bekommen hat.

Befehle für Mitglieder

Es gibt einen Befehl für Mitglieder:

/shop

Er öffnet das Shop-Dashboard mit zwei Tabs:

Mit der Option tab öffnest du das Dashboard direkt auf einem Tab. Artikel, die du bereits bis zum Limit gekauft hast, und ausverkaufte Artikel werden nicht angeboten.

Nach einem bestätigten Kauf:

1. Levlix prüft deinen aktuellen Punktestand und den Bestand des Artikels.
2. Der Code zum Artikel kommt per Direktnachricht zu dir.
3. Sind deine DMs geschlossen, siehst du den Code stattdessen in einer ephemeren Nachricht (nur für dich sichtbar).
4. Dein Punktestand sinkt um den Preis des Artikels.

Hast du nicht genug Punkte, sagt dir Levlix, wie viele Punkte du brauchst und wie viele du gerade hast.

Einkaufen im Dashboard

Öffne Server → Shop im Levlix Web Dashboard. Mitglieder landen direkt in der Ladenansicht. Wer den Server verwaltet, sieht standardmäßig die Verwaltungsansicht und öffnet den Laden für Mitglieder, indem er ?view=store an die Shop-URL hängt.

Die Ladenseite zeigt:

Einen gekauften Code aufdecken

Damit gekaufte Codes sicher bleiben, falls jemand auf deinen Bildschirm schaut, zeigt der Kaufverlauf standardmäßig nur die letzten vier Zeichen eines Codes. Klicke in einer Zeile auf Reveal code, um den vollständigen Wert bei Bedarf zu laden. Jedes Aufdecken wird festgehalten, du hast also immer einen Nachweis darüber, was du wann eingelöst hast.

Ausverkaufte und geplante Artikel

• Ausverkaufte Artikel erscheinen ausgegraut und lassen sich nicht kaufen. Sie bleiben auf der Seite, damit Mitglieder sehen, was früher angeboten wurde.
• Geplante Artikel nennen das Datum ihrer Freischaltung. Die Kauf-Schaltfläche bleibt deaktiviert, bis available_from erreicht ist.
• Abgelaufene Artikel bleiben mit dem Abzeichen Expired gelistet und lassen sich nicht kaufen.

Admin: Den Shop verwalten

Admins legen Shop-Artikel im Levlix Web Dashboard an, bearbeiten sie und entfernen sie wieder. Jeder Artikel hat die folgenden Einstellungen:

Sind alle Codes eines Artikels verkauft, wird der Artikel automatisch als ausverkauft markiert und aus der Shop-Liste ausgeblendet.

Für die schnelle Verwaltung direkt in Discord gibt es außerdem die Admin-Slash-Befehle der Gruppe /shop-admin (create, show, admin-list, showcase, expire-check). Mit mehreren Artikeln auf einmal arbeitest du im Dashboard aber am bequemsten.

Shop-Artikel nach Status filtern

Die Verwaltungsseite hat einen Statusfilter (Active, Scheduled, Sold Out, Expired), mit dem du direkt zu den Artikeln springst, die Aufmerksamkeit brauchen. Der Status folgt denselben Regeln, die der Laden auch bei den Mitgliedern anwendet. Die beiden Ansichten können sich also nie widersprechen.

Rolle für die Shop-Verwaltung

Standardmäßig können nur Server-Admins den Shop verwalten. Soll eine andere Rolle (zum Beispiel ein Community Manager oder ein eigenes Shop Team) Artikel anlegen und bearbeiten, setze im Dashboard Shop Manager Role auf moderator oder admin. Die Rollenhierarchie (user → moderator → admin → owner) entscheidet, wer die Verwaltungsansicht sieht und wer den Laden.

Mitglieder unterhalb der eingestellten Rolle landen immer in der Ladenansicht, selbst wenn sie die Verwaltungs-URL direkt aufrufen. Wer sich den Laden als Verwalter ansieht, behält den Link Back to management und findet so immer zurück.

Punktestände verwalten

Server-Admins können den Punktestand eines Mitglieds im Levlix Web Dashboard von Hand erhöhen, verringern oder anpassen. Jede Änderung wird im Audit-Verlauf protokolliert, damit alles nachvollziehbar bleibt.

Sonderfälle und Sicherheitshinweise

• Prüfung der Mitgliedschaft bei jedem Kauf im Dashboard. Die Laden-URL ist für alle mit einem Levlix-Konto erreichbar, kaufen können aber nur Mitglieder des Servers: Die Kaufabwicklung prüft die Mitgliedschaft noch einmal, bevor sie den Vorrat an Codes anfasst.
• Immer nur ein Code pro Käufer. Während ein Kauf läuft, wird die Zeile des Käufers in der Datenbank kurz gesperrt. Ein Doppelklick auf die Kauf-Schaltfläche (oder dieselbe Person mit zwei offenen Tabs) kann also nie zwei Codes für eine Zahlung abgreifen.
• Bot offline? Käufe funktionieren trotzdem. Käufe im Dashboard werden über Redis veröffentlicht, damit der Bot dem Gewinner eine DM schicken kann. Der Code wird aber ohnehin sofort im Dashboard ausgeliefert. Ist der Bot offline, gelingt der Kauf trotzdem und der Code wartet nach dem Neuladen in deinem Kaufverlauf.
• Der Wechsel auf ausverkauft passiert sofort. Wird der letzte Code eines Artikels im Dashboard eingelöst, gilt der Artikel schon in derselben Anfrage als ausverkauft. Dem nächsten Besucher wird kein veraltetes "1 übrig" mehr angezeigt.