資料表與結構

資料表是 CordBase 的核心。每張資料表都定義了一個結構,並自動為你的伺服器成員產生斜線指令。

欄位類型

每個欄位都有一個類型,決定資料在 Discord 中如何驗證、儲存和顯示。

文字

任意文字。適合名稱、說明、備註或任何字串資料。

在 Discord 中:斜線指令中的一般文字輸入框。
範例:鑽石劍、任務說明、玩家備註

數字

整數或小數。數字欄位是排行榜指令的基礎,也可以用 update 來增加。適合分數、價格、數量和 XP。

在 Discord 中:會驗證內容的數字輸入框。非數字的值會被拒絕。
範例:100, 3.5, -20

日期

以 YYYY-MM-DD 格式輸入的日期。適合截止日期和活動日期。

在 Discord 中:標示 YYYY-MM-DD 格式的文字輸入框。
範例:2026-03-27, 2026-12-31

布林值

true/false 開關。很適合標示狀態,例如已完成、啟用中、已驗證或已付款。

在 Discord 中:在 True 和 False 之間選擇。
範例:true, false

選項

建立欄位時自己定義的一組選項。很適合分類、稀有度、狀態值和隊伍職責。

在 Discord 中:由你定義的選項組成的固定選擇清單(Discord 最多顯示 25 個)。
範例:普通 / 稀有 / 史詩 / 傳說

使用者

指向一位 Discord 使用者。以使用者 ID 儲存,並顯示使用者名稱。適合用來標示擁有者和分派對象。

在 Discord 中:Discord 內建的成員選擇器,支援自動完成。
範例:@Neo, @Player1

欄位設定

  • 必填 — 開啟時,斜線指令一定要填這個欄位。關閉時,這個欄位為選填,可以留空。

編輯資料表結構

資料表建立後,你可以在控制台編輯它。前往你的資料表,點選 編輯資料表。

  • 新增欄位 — 新欄位會加在結構的最後面。現有的資料列在更新前,新欄位的值都是空值(null)。
  • 重新命名欄位 — 修改控制台和機器人回覆中顯示的名稱。成員輸入的選項名稱不變。
  • 移除欄位 — 從資料表和它的斜線指令中移除這個欄位。

資料表建立後,現有欄位的鍵和類型就會鎖定。想變更欄位類型,請新增一個欄位,再移除舊的欄位。

儲存變更後,CordBase 會向 Discord 重新註冊斜線指令,需要幾秒鐘才會生效。

身分組權限

每張資料表都有三種權限等級,可以指定給 Discord 身分組:

  • 讀取 — 可以使用 query、view、saved-view 和 leaderboard 檢視資料。
  • 寫入 — 包含讀取權限,並可對任何資料列使用 add 和 update。
  • 管理 — 完整權限,包括 delete、bulk-update 和 bulk-delete。批次指令需要 Pro 或 Max 方案。

在你為資料表指定身分組之前,每位成員都能執行它的所有指令,包括刪除。只要指定了任何身分組,沒有列出身分組的成員就完全無法使用這張資料表,所以如果資料表要維持公開,請把讀取權限給一個所有成員都有的身分組。Discord 管理員永遠可以執行所有指令。