ModiQDocs

ActiveBox

Zufällige Belohnungs-Boxen im Kanal, Box-Token-Shop und Wallets.

ActiveBox lässt in einem gewählten Kanal in zufälligen Abständen Belohnungs-Boxen erscheinen. Wer eine Box öffnet, erhält Box-Token und sammelt sie in seiner Wallet. Im Shop lösen Mitglieder die Token gegen Belohnungen ein — vier Standard-Artikel sind vorgegeben und lassen sich anpassen, eigene Artikel kommen dazu. Hinweis: Dieser Tab hat keine Option in `config.ts`; die Aktivierung läuft über den Schalter im Kopf des Tabs und wird mit der Modul-Konfiguration gespeichert. (activebox)

Bild folgt

Das Dashboard mit geöffnetem Tab „ActiveBox“: links die Modulliste, rechts die Einstellungen mit Speichern-Knopf.

Nur die Seite selbst zeigen – ohne Browserleiste, ohne persönliche Daten.

public/docs-assets/modules/activebox.png · 1600x900 · dunkles Design

Box-Token-Shop

Vier Standard-Artikel sind vorgegeben; Name, Beschreibung und Preis lassen sich überschreiben, und jeder Artikel kann einzeln abgeschaltet werden. Eigene Artikel fügst du über Artikel anlegen hinzu (Name, Effekt-Typ, Preis in Token und je nach Typ eine Menge). Der Preis beträgt mindestens 1 Token.

cash_small — Bargeld-Bonus (Klein)
Standard-Artikel, vergibt Bargeld.
cash_large — Bargeld-Bonus (Groß)
Standard-Artikel, vergibt mehr Bargeld.
xp_booster — XP-Booster (1h, x2)
Standard-Artikel, verdoppelt XP im aktuellen Kanal für eine Stunde.
voicecoins — Voicecoins-Bonus
Standard-Artikel, vergibt Voicecoins.

Als Effekt-Typen stehen cash (Bargeld), voicecoins, xp_booster und none (kein Effekt, manuell) zur Verfügung. Eingelöst wird der Shop über /activebox redeem.

Wallets & Statistiken

Wallets entstehen automatisch, sobald jemand eine Box öffnet. Im Tab Wallets siehst du das Guthaben pro Mitglied und kannst es manuell anpassen oder zurücksetzen. Die Statistik zeigt gespawnte und geöffnete Boxen, Einlösungen sowie ausgegebene Token.

  • Boxen gespawnt
  • Boxen geöffnet
  • Einlösungen
  • Ausgegebene Token

Befehle

/activeboxsetup? toggle? status? summon? wallet? shop? redeem?

Zufällige Belohnungs-Boxen, die im Kanal auftauchen (Setup, Wallet, Shop, Redeem)

Einstellungen im Dashboard

EinstellungTypBedeutung
ActiveBoxenabledSchalterSchaltet das Box-Spawn-System ein oder aus. Standard: aus.Standard: Aus
KanalchannelIdKanalKanal, in dem die Boxen erscheinen. Zur Auswahl stehen Textkanäle.
Min-Intervall (s)minIntervalSecondsZahlKleinster Abstand in Sekunden zwischen zwei Boxen. Mindestens 30. Standard: 600.Standard: 600
Max-Intervall (s)maxIntervalSecondsZahlGrößter Abstand in Sekunden zwischen zwei Boxen. Mindestens 30. Standard: 1800.Standard: 1800
Aktiv-Dauer (s)activeSecondsZahlWie lange eine Box offen bzw. klickbar bleibt, bevor sie abläuft. Mindestens 5. Standard: 60.Standard: 60
Min-BelohnungminRewardZahlKleinste Box-Token-Belohnung beim Öffnen einer Box. Mindestens 1. Standard: 50.Standard: 50
Max-BelohnungmaxRewardZahlGrößte Box-Token-Belohnung beim Öffnen einer Box. Mindestens 1 und mindestens so groß wie die Min-Belohnung. Standard: 250.Standard: 250

Stolperfallen

  • Es gibt keinen Options-Schalter in config.ts für ActiveBox — die Aktivierung läuft über den Schalter im Kopf des Tabs.
  • Die Max-Belohnung muss mindestens so groß wie die Min-Belohnung sein, sonst ist die Konfiguration nicht sinnvoll.

Siehe auch