指令參考
你建立的每張資料表都會有一個以資料表命名的斜線指令，並包含下列子指令。把 <table> 換成你資料表的指令名稱，例如 /inventory。
快速參考
/<table> add寫入/<table> query讀取/<table> update寫入/<table> delete管理/<table> view讀取/<table> leaderboard讀取/<table> saved-view讀取/<table> bulk-update管理/<table> bulk-delete管理/<table> add
寫入新增一列。每張資料表都有一個以它命名的指令，每個欄位都會成為一個選項。必填欄位會排在前面且一定要填；選填欄位可以略過。
語法
/<table> add <column>:<value> <column>:<value> ...
範例
/inventory add item:Diamond Sword quantity:3 rarity:Epic
- •執行指令的 Discord 使用者會和這一列一起儲存。
- •機器人會回覆確認訊息和已儲存的值。
- •每個方案都有每張資料表的資料列上限（Free 為 100 列）。資料表滿了時，機器人會告訴你。
/<table> query
讀取搜尋資料表。每個欄位都是選填的篩選條件；全部不填就會列出資料列。
語法
/<table> query [<column>:<value> ...] [limit:<1-25>]
範例
/inventory query rarity:Epic limit:10
- •文字欄位只要包含你輸入的內容就算符合。其他欄位類型必須完全相符。
- •預設顯示 10 筆結果，最多 25 筆。
/<table> update
寫入修改現有的一列。從自動完成清單選出資料列，然後只填你想修改的欄位。
語法
/<table> update row:<row> <column>:<new_value> ...
範例
/inventory update row:Health Potion quantity:9
- •沒填的欄位會保留目前的值。
- •在有數字欄位的資料表上，_mode 選項決定數字是直接設定、增加還是減少。
/<table> delete
管理刪除單一資料列。機器人會先請你按按鈕確認。
語法
/<table> delete row:<row>
範例
/inventory delete row:Rope
- •刪除的資料列會立即從資料表消失，並在 30 天後永久清除。
/<table> view
讀取在一則 Embed 中顯示單一資料列的所有欄位。
語法
/<table> view row:<row>
範例
/inventory view row:Diamond Sword
- •也會顯示這一列是誰建立的，以及建立和最後更新的時間。
/<table> leaderboard
讀取依數字欄位由高到低排名資料列。前三名會得到獎牌。
語法
/<table> leaderboard column:<number_column> [limit:<1-25>]
範例
/xp leaderboard column:XP limit:10
- •只有至少有一個數字欄位的資料表才會有這個指令。
- •預設顯示 10 名，最多 25 名。
- •每個分數會顯示在該列第一個文字或成員欄位旁邊。
/<table> saved-view
讀取執行你在控制台為這張資料表設定的已儲存檢視。
語法
/<table> saved-view name:<view> [limit:<1-25>]
範例
/inventory saved-view name:Epic items
- •只有至少有一個已儲存檢視的資料表才會有這個指令。
/<table> bulk-update
管理在另一個欄位符合某個值的所有資料列上，修改同一個欄位。僅限 Pro 和 Max 方案。
語法
/<table> bulk-update filter:<column> value:<match> set-column:<column> set-value:<new_value>
範例
/inventory bulk-update filter:item value:Rope set-column:rarity set-value:Common
- •機器人會先顯示符合的資料列數量，並在修改前請你確認。
/<table> bulk-delete
管理刪除某個欄位符合某個值的所有資料列。僅限 Pro 和 Max 方案。
語法
/<table> bulk-delete filter:<column> value:<match>
範例
/inventory bulk-delete filter:rarity value:Common
- •機器人會先顯示符合的資料列數量，並在刪除前請你確認。
指令的共通行為
- 僅自己可見的錯誤 — 權限錯誤和驗證失敗只會顯示給執行指令的人（僅自己可見的訊息），讓頻道保持乾淨。
- 自動完成 — 選項欄位會把它的選項顯示成選擇清單。資料列和已儲存檢視的選項會在你輸入時建議符合的項目。
- 速率限制 — 為了防止濫用，每位使用者每 10 秒最多可以執行 5 個指令。這遠高於一般使用量。
- Embed — 所有回覆都使用格式整齊的 Discord Embed（嵌入訊息）。依指令不同，資料會以表格或「鍵：值」的形式顯示。
- 權限 — 在你為資料表指定身分組之前，每位成員都能執行它的所有指令。設定身分組之後，只有擁有列出身分組的成員可以使用這張資料表：讀取包含 query、view、leaderboard 和 saved-view；寫入再加上 add 和 update；管理再加上 delete 和批次指令。Discord 管理員永遠可以執行所有指令。
- 全域指令 —
/help會列出你伺服器的資料表，/ping檢查機器人是否在線上，/delete-my-data會刪除你在所有伺服器建立的資料列。