Befehlsreferenz

Jede Tabelle, die du erstellst, bekommt einen eigenen Slash-Befehl mit dem Namen der Tabelle und diesen Unterbefehlen. Ersetze <table> durch den Befehlsnamen deiner Tabelle, zum Beispiel /inventory.

Kurzübersicht

/<table> addSchreiben
/<table> queryLesen
/<table> updateSchreiben
/<table> deleteAdmin
/<table> viewLesen
/<table> leaderboardLesen
/<table> saved-viewLesen
/<table> bulk-updateAdmin
/<table> bulk-deleteAdmin

/<table> add

Schreiben

Fügt eine neue Zeile hinzu. Jede Tabelle bekommt einen eigenen Befehl mit ihrem Namen, und jede Spalte wird zu einer Option. Pflichtspalten stehen vorne und müssen ausgefüllt werden; optionale Spalten kannst du weglassen.

Syntax

/<table> add <column>:<value> <column>:<value> ...

Beispiel

/inventory add item:Diamond Sword quantity:3 rarity:Epic
  • •Der Discord-Nutzer, der den Befehl ausgeführt hat, wird mit der Zeile gespeichert.
  • •Der Bot antwortet mit einer Bestätigung und den gespeicherten Werten.
  • •Jeder Plan hat ein Zeilenlimit pro Tabelle (100 in Free). Der Bot sagt dir, wenn eine Tabelle voll ist.

/<table> query

Lesen

Durchsucht eine Tabelle. Jede Spalte ist ein optionaler Filter; lässt du alle weg, werden Zeilen aufgelistet.

Syntax

/<table> query [<column>:<value> ...] [limit:<1-25>]

Beispiel

/inventory query rarity:Epic limit:10
  • •Textspalten passen, wenn der Wert das Eingegebene enthält. Andere Spaltentypen müssen exakt übereinstimmen.
  • •Zeigt standardmäßig 10 Ergebnisse, höchstens 25.

/<table> update

Schreiben

Ändert eine vorhandene Zeile. Wähl die Zeile aus der Autovervollständigung und gib nur die Spalten an, die du ändern willst.

Syntax

/<table> update row:<row> <column>:<new_value> ...

Beispiel

/inventory update row:Health Potion quantity:9
  • •Spalten, die du weglässt, behalten ihren aktuellen Wert.
  • •Bei Tabellen mit Zahlenspalten legt die Option _mode fest, ob Zahlen gesetzt, erhöht oder verringert werden.

/<table> delete

Admin

Löscht eine einzelne Zeile. Der Bot lässt dich das vorher per Button bestätigen.

Syntax

/<table> delete row:<row>

Beispiel

/inventory delete row:Rope
  • •Gelöschte Zeilen verschwinden sofort aus der Tabelle und werden nach 30 Tagen endgültig entfernt.

/<table> view

Lesen

Zeigt alle Spalten einer einzelnen Zeile in einem Embed.

Syntax

/<table> view row:<row>

Beispiel

/inventory view row:Diamond Sword
  • •Zeigt auch, wer die Zeile erstellt hat und wann sie erstellt und zuletzt aktualisiert wurde.

/<table> leaderboard

Lesen

Sortiert Zeilen nach einer Zahlenspalte, höchster Wert zuerst. Die ersten drei bekommen Medaillen.

Syntax

/<table> leaderboard column:<number_column> [limit:<1-25>]

Beispiel

/xp leaderboard column:XP limit:10
  • •Gibt es nur bei Tabellen mit mindestens einer Zahlenspalte.
  • •Zeigt standardmäßig 10 Plätze, höchstens 25.
  • •Jede Punktzahl steht neben der ersten Text- oder Mitgliedsspalte der Zeile.

/<table> saved-view

Lesen

Führt eine gespeicherte Ansicht aus, die du im Dashboard für die Tabelle eingerichtet hast.

Syntax

/<table> saved-view name:<view> [limit:<1-25>]

Beispiel

/inventory saved-view name:Epic items
  • •Gibt es nur bei Tabellen mit mindestens einer gespeicherten Ansicht.

/<table> bulk-update

Admin

Ändert eine Spalte in allen Zeilen, in denen eine andere Spalte einem Wert entspricht. Nur in den Plänen Pro und Max.

Syntax

/<table> bulk-update filter:<column> value:<match> set-column:<column> set-value:<new_value>

Beispiel

/inventory bulk-update filter:item value:Rope set-column:rarity set-value:Common
  • •Der Bot zeigt, wie viele Zeilen passen, und lässt dich bestätigen, bevor er etwas ändert.

/<table> bulk-delete

Admin

Löscht alle Zeilen, in denen eine Spalte einem Wert entspricht. Nur in den Plänen Pro und Max.

Syntax

/<table> bulk-delete filter:<column> value:<match>

Beispiel

/inventory bulk-delete filter:rarity value:Common
  • •Der Bot zeigt, wie viele Zeilen passen, und lässt dich vor dem Löschen bestätigen.

Allgemeines Verhalten der Befehle

  • Private Fehlermeldungen — Fehlende Berechtigungen und ungültige Eingaben sieht nur die Person, die den Befehl ausgeführt hat (ephemere Nachrichten). So bleiben die Kanäle sauber.
  • Autovervollständigung — Auswahlspalten zeigen ihre Optionen als Liste. Die Optionen für Zeile und gespeicherte Ansicht schlagen beim Tippen passende Treffer vor.
  • Rate-Limits — Um Missbrauch zu verhindern, sind Befehle auf 5 pro Nutzer in 10 Sekunden begrenzt. Das liegt weit über normaler Nutzung.
  • Embeds — Alle Antworten sind sauber formatierte Discord-Embeds. Je nach Befehl werden die Daten als Tabelle oder als Schlüssel-Wert-Paare angezeigt.
  • Berechtigungen — Solange du einer Tabelle keine Rollen zuweist, kann jedes Mitglied alle ihre Befehle ausführen. Sobald Rollen gesetzt sind, können nur Mitglieder mit einer der aufgeführten Rollen die Tabelle nutzen: Lesen umfasst query, view, leaderboard und saved-view; Schreiben ergänzt add und update; Admin ergänzt delete und die Massenbefehle. Discord-Administratoren können immer alles ausführen.
  • Globale Befehle — /help listet die Tabellen deines Servers auf, /ping prüft, ob der Bot online ist, und /delete-my-data löscht die Zeilen, die du auf allen Servern erstellt hast.