資料表與結構
資料表是 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 管理員永遠可以執行所有指令。