Inhalt
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:
- In Discord, über die unten beschriebenen
/shop-Slash-Befehle. - Im Web-Dashboard, unter Wirtschaft → 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:
| Tab | Was du dort tun kannst |
|---|---|
| Shop | Alle gerade verfügbaren Artikel durchsehen, mit Preis, Restbestand und wie oft du sie noch kaufen darfst. Artikel im Menü auswählen, bestätigen, und der Kauf läuft. |
| Meine Käufe | Sehen, was du im Shop dieses Servers gekauft hast, mit Datum, Preis und dem gelieferten Code. |
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:
- Levlix prüft deinen aktuellen Punktestand und den Bestand des Artikels.
- Der Code zum Artikel kommt per Direktnachricht zu dir.
- Sind deine DMs geschlossen, siehst du den Code stattdessen in einer ephemeren Nachricht (nur für dich sichtbar).
- Dein Punktestand sinkt um den Preis des Artikels.
Bei vom Bot gelieferten Artikeln gibt es keinen Code: Der Artikel wird direkt bei dir angewendet, und die Bestätigung sagt das auch so. Der Tab Meine Käufe listet deine aktiven Effekte zuerst.
Hast du nicht genug Punkte, sagt dir Levlix, wie viele Punkte du brauchst und wie viele du gerade hast.
Einkaufen im Dashboard
Öffne Wirtschaft → 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:
| Element | Bedeutung |
|---|---|
| Punktestand | Deine aktuellen Server-Punkte, nach jedem Kauf aktualisiert. |
| Status-Abzeichen | Verfügbar, Geplant (wird an einem späteren Datum freigeschaltet), Ausverkauft oder Abgelaufen. |
| Schaltfläche Kaufen | Deaktiviert, wenn der Artikel nicht aktiv ist, du sein Kauflimit erreicht hast oder dein Punktestand zu niedrig ist. |
| Meine Käufe | Jeder Code, den du auf diesem Server je gekauft hast, der neueste zuerst. |
| Aktive Effekte | Rollen, Boosts, Schilde und Nicknames, die du gerade hältst, mit ihrem Enddatum. |
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 Anzeigen, 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.
Käufe von vom Bot gelieferten Artikeln zeigen, was du gekauft hast und in welchem Status es ist (aktiv bis, geplant, verbraucht, abgelaufen, widerrufen, erstattet), statt eines Codes.
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_fromerreicht ist. - Abgelaufene Artikel bleiben mit dem Abzeichen Abgelaufen 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:
| Einstellung | Beschreibung |
|---|---|
| Artikeltitel | Name, der den Mitgliedern angezeigt wird |
| Preis (Punkte) | Preis in Server-Punkten |
| Artikelart | Was der Käufer bekommt: einen Code aus einem Vorrat oder etwas, das der Bot selbst liefert (siehe unten) |
| Bestand | Optionale Anzahl Einheiten für vom Bot gelieferte Artikel; leer bedeutet unbegrenzt |
| Kauflimit | Wie oft ein Mitglied diesen Artikel höchstens kaufen darf; 0 bedeutet unbegrenzt |
| Käufe ankündigen | Optionaler Kanal, in dem der Bot postet, wenn jemand den Artikel kauft |
| Startdatum | Optionales Datum, ab dem der Artikel gekauft werden kann; bis dahin erscheint er als Geplant |
| Enddatum | Optionales Datum, nach dem der Artikel aus dem Shop verschwindet |
Sind alle Codes eines Artikels verkauft, wird der Artikel automatisch als ausverkauft markiert: /shop in Discord bietet ihn nicht mehr an, der Web-Shop zeigt ihn ausgegraut weiter.
Einen Artikel, den noch niemand gekauft hat, kannst du löschen. Sobald ihn jemand gekauft hat, zeigt seine Karte Jetzt beenden statt Löschen: Die Käufe und laufende Rollen, Boosts oder Nicknames bleiben an den Artikel gebunden, deshalb wird er beendet statt entfernt. Jetzt beenden setzt sein Enddatum auf die aktuelle Uhrzeit, der Artikel verschwindet sofort aus dem Shop und bleibt in der Verwaltungsliste unter Abgelaufen. Um ihn wieder zu verkaufen, gib ihm unter Bearbeiten ein neues Enddatum.
Für die schnelle Verwaltung direkt in Discord öffnest du /setup und wählst Engagement und dann Shop. Das Shop-Panel listet deine Artikel auf und hat die Schaltflächen Artikel erstellen, Übersicht posten und Ablauf jetzt prüfen, dazu ein Menü, das einen einzelnen Artikel in einem Kanal postet. Shop-Verwalter ohne die Berechtigung Server verwalten erreichen dasselbe Panel über die Schaltfläche Shop verwalten in /shop. Mit mehreren Artikeln auf einmal arbeitest du im Dashboard trotzdem am bequemsten.
Mit einer Vorlage starten
Ein Shop ohne aktive Artikel zeigt oben auf der Shop-Seite drei Vorlagen; ein Shop, der schon etwas verkauft, hat stattdessen den Knopf Vorlage hinzufügen.
| Vorlage | Artikel |
|---|---|
| Einsteiger | Streak-Schutz, eigener Nickname für 7 Tage, 2x XP-Boost für 24 Stunden |
| Community | Einsteiger plus wöchentliches Lotterie-Los und eine VIP-Rolle für 30 Tage |
| Aktiv | Community mit einem Streak-Schutz, von dem man drei halten kann, plus 3x XP-Boost für 48 Stunden |
Die Preise richten sich danach, was ein typisches Mitglied auf deinem Server pro Woche verdient: Ruhige Server bekommen niedrige Preise, aktive höhere. Ein Server mit noch wenig Punkte-Verlauf rechnet mit 100 Punkten pro Woche. Angelegt wird erst, wenn du bestätigst: In der Vorschau kannst du Artikel abwählen und jeden Preis ändern. Für die VIP-Rolle legt Levlix eine neue Rolle an, oder du wählst eine vorhandene. Die Lotterie braucht einen Kanal für ihre Ergebnisse, entweder in der Vorschau gewählt oder den Standardkanal des Shops. Artikel, die dein Shop schon verkauft, sind abgewählt.
Shop-Artikel nach Status filtern
Die Verwaltungsseite hat einen Statusfilter (Alle, Aktiv, Geplant, Abgelaufen, Ausverkauft), 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.
Vom Bot gelieferte Artikel
Neben Codes kann der Shop Dinge verkaufen, die der Bot selbst anwendet. Die Art wählst du beim Anlegen des Artikels; sie lässt sich danach nicht mehr ändern, ihre Einstellungen schon.
| Art | Was das Mitglied bekommt | Einstellungen | Bot-Berechtigung |
|---|---|---|---|
| Temporäre Rolle | Eine Rolle für eine Anzahl Tage (1 bis 365) | Rolle, Dauer | Rollen verwalten, und die Rolle muss unter der höchsten Rolle des Bots liegen |
| Persönlicher XP-Boost | Einen Multiplikator auf die eigenen XP für eine Anzahl Stunden (1 bis 168) | Multiplikator (1,5x bis 5x in Schritten von 0,5), Dauer | keine |
| Serienschutz | Schutz für die Daily-Serie: ein Schild deckt einen verpassten Tag ab | Wie viele ein Mitglied höchstens halten darf (1 bis 10) | keine |
| Spitzname | Einen Wunsch-Nickname innerhalb einer Vorlage, die du festlegst, für eine Anzahl Tage (1 bis 90) | Vorlage mit {text}, Dauer |
Nicknames verwalten |
| Lotterielos | Ein Los für die laufende Runde des Artikels; ein Los ist eine Chance | Wochentag und Stunde der Ziehung (UTC), Hausanteil (0 bis 50 Prozent), Lose pro Mitglied und Runde, Ergebniskanal | Nachrichten senden im Ergebniskanal |
Jeder vom Bot gelieferte Artikel kann einen Bestand haben (wie viele Einheiten es insgesamt gibt), ein Kauflimit pro Mitglied, beides oder keines von beiden. Code-Artikel leiten ihren Vorrat weiterhin aus der Zahl der unbenutzten Codes ab.
So läuft die Lieferung
- Ein Kauf in Discord wendet den Artikel sofort an. Ein Kauf im Dashboard übergibt die Aufgabe an den Bot, der sie spätestens nach wenigen Minuten erledigt, auch wenn er beim Kauf offline war.
- Wer einen zeitlich begrenzten Artikel erneut kauft, verlängert ihn: Das neue Zeitfenster beginnt, wenn das laufende endet.
- Ein persönlicher XP-Boost addiert sich nie mit einem serverweiten Boost oder einem Rollen-Boost. Der höchste Multiplikator gilt.
- Streak-Schilde werden automatisch eingesetzt: Verpasst ein Mitglied Tage, wird pro verpasstem Tag ein Schild verbraucht und die Serie läuft weiter. Ohne genug Schilde wird die Serie zurückgesetzt und die Schilde bleiben erhalten.
- Bei einem Nickname-Artikel tippt das Mitglied den Text ein; der Bot setzt ihn in deine Vorlage ein (zum Beispiel
VIP {text}). Der Text läuft durch die Wortfilter der Moderation, wenn das Moderationsmodul aktiv ist. - Endet ein Artikel, entfernt der Bot die Rolle oder stellt den vorherigen Nickname wieder her. Eine Rolle, die das Mitglied schon vor dem Kauf hatte, wird nie entfernt, und ein zwischenzeitlich selbst geänderter Nickname bleibt unangetastet.
Erstattungen
Kann der Bot einen Artikel nicht anwenden (die Rolle wurde gelöscht, dem Bot fehlt die Berechtigung, das Mitglied hat den Server verlassen oder der Serverinhaber hat einen Nickname gekauft), wird der Kauf automatisch erstattet: Die Punkte kehren auf den Punktestand zurück, die Vorratseinheit wird freigegeben und der Käufer bekommt eine Direktnachricht mit dem Grund. Im Kaufverlauf erscheint der Kauf als Erstattet.
Eine Zuteilung widerrufen
Manager sehen über Vergaben auf der Artikelkarte, wer einen vom Bot gelieferten Artikel gerade hält, und können eine Zuteilung dort widerrufen. Der Bot macht sie innerhalb weniger Minuten rückgängig. Ein Widerruf erstattet nichts.
Kauf-Ankündigungen
Schalte Käufe ankündigen ein und wähle einen Kanal, damit der Bot bei jedem Kauf des Artikels eine kurze Nachricht postet. Die Mitglieder werden darin erwähnt.
Die Shop-Einstellungen oben auf der Verwaltungsseite enthalten die Vorgaben, die jeder Artikel erbt: einen Standard-Ankündigungskanal und ob neue Artikel mit eingeschalteter Ankündigung starten. Ein Artikel ohne eigenen Kanal postet in den Standardkanal; Lotterie-Ergebnisse nutzen denselben Rückfall. Ohne Standardkanal muss jeder ankündigende Artikel seinen eigenen wählen. Die Stufe für Shopverwaltung bleibt in den Servereinstellungen.
Lotterie
Ein Lotterie-Artikel läuft in Runden. Jedes gekaufte Los zahlt seinen Preis abzüglich des Hausanteils in den Topf der Runde; der Hausanteil verschwindet einfach aus dem Umlauf. Zum Ziehungszeitpunkt zieht der Bot ein Los per Zufall (jedes Los zählt einmal, mehr Lose bedeuten also mehr Chancen), zahlt den ganzen Topf als Punkte an dieses Mitglied aus, postet das Ergebnis im Ergebniskanal und eröffnet die nächste Runde. Eine Runde ohne Lose wird still geschlossen.
Manager können Jetzt ziehen (die Ziehung läuft innerhalb einer Minute) und Runde annullieren (alle Lose werden erstattet und die nächste Runde beginnt; der Bot postet einen kurzen Hinweis). Ein Lotterie-Artikel lässt sich nicht löschen, solange in der offenen Runde Lose liegen: erst ziehen oder abbrechen. Läuft der Artikel ab, endet der Losverkauf, die offene Runde wird aber noch gezogen.
Die Karte im Store zeigt den aktuellen Topf, die Zahl der Lose darin, deine eigenen Lose und den nächsten Ziehungszeitpunkt. Die /shop-Ansicht in Discord zeigt dieselbe Zeile.
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 unter Servereinstellungen die Stufe für Shopverwaltung auf Moderatoren+ oder Admins & Eigentümer. Die Rollenhierarchie (user → moderator → admin → owner) entscheidet, wer die Verwaltungsansicht sieht und wer den Laden.
| Einstellung | Ergebnis |
|---|---|
| Admins & Eigentümer (Standard) | Nur Admins und der Server-Besitzer können den Shop verwalten. |
| Moderatoren+ | Moderatoren, Admins und der Besitzer können den Shop verwalten. |
| Nur Eigentümer | Nur der Server-Besitzer kann den Shop verwalten. |
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 Zurück zur Verwaltung 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.