Discord 機器人
First Ledger 機器人會依成員持有的 NFT 和代幣給予 Discord 身分組,即時發布你的收藏系列銷售動態,並提供白名單、投票與抽獎功能,適用於 XRP Ledger 上的任何收藏系列。
功能介紹
持有者身分組:成員只需連結錢包一次,機器人就會隨著買賣自動給予或移除身分組,通常在成交後幾秒內完成。
動態:將你收藏系列的銷售、上架、鑄造與出價發布到你選擇的頻道。
伺服器工具:在頻道名稱中即時顯示地板價和持有者數量、持有者快照、稽核紀錄,以及管理員專用的網頁控制台。
社群:白名單、持有者投票、抽獎、活動與個人通知。
完全免費:所有功能,適用於每個伺服器和每個收藏系列。
將機器人加入伺服器
在 First Ledger 開啟機器人頁面,選擇「加入 Discord」。你需要在目標伺服器擁有「管理伺服器」權限。
接著 Discord 會顯示機器人要求的六項權限。請全部保持勾選:每一項都會用到。
- 管理身分組用於給予和移除持有者身分組。沒有此權限就無法發放身分組。
- 管理頻道讓
/setup能建立 #verify 頻道,並持續更新頻道名稱中的地板價和持有者數量。 - 檢視頻道讓機器人能看到要發文的頻道。
- 傳送訊息用於發布動態、驗證面板、投票、抽獎與活動。
- 嵌入連結讓每筆銷售和上架以卡片形式顯示 NFT 圖片與價格。
- 附加檔案讓
/admin snapshot take能以 CSV 檔傳送持有者清單。
機器人絕不會要求管理員、管理伺服器,或踢出、封鎖成員的權限。機器人自身的身分組只需這六項權限,其他請保持關閉。
在「伺服器設定 → 身分組」中,將機器人的身分組拖曳到所有要發放的身分組之上。Discord 只允許機器人給予比自身低的身分組。
執行 /check-permissions。每一行都應該是綠色勾勾;紅色的會告訴你需要修正什麼。
使用 /admin collection add 新增你的收藏系列。輸入名稱後從清單中選取。
使用 /admin role set 建立持有者身分組:選擇身分組、收藏系列,若要分級可設定最小與最大數量。也可以要求特定特徵,或 NFT 需持有一定天數。
使用 /setup 發布驗證面板。它會建立 #verify 頻道,或使用你指定的頻道,並附上讓成員點擊的「驗證」按鈕。
以上所有操作也都能在控制台完成,只要用 Discord 登入,就會列出你管理的伺服器。
持有者身分組
依數量:持有某系列至少一定數量的 NFT,也可設定上限,藉此分出 Holder、Collector 與 Whale 等級。
依特徵:持有具特定特徵的 NFT,例如 Background: Gold。
依稀有度或排名:持有在系列中排名前 N 的 NFT,或名列前 N 大持有者。
創作者:系列的創作者或發行者錢包。
依餘額:持有一定數量的 XRP、在 XRP Ledger 上發行的代幣(包括在 First Ledger 推出的代幣)或多用途代幣。用 /admin role token 設定:選擇身分組、檢查項目與最低數量,機器人會加總成員所有已連結錢包的餘額。
依錢包:貼上一份地址清單。
組合條件:在後台的進階編輯器中,以 AND、OR 和 NOT 組合上述任一條件,例如持有三個以上 AND 持有一百 XRP。
成員 First Ledger 帳戶中的所有錢包會合併計算,因此在自己的錢包之間轉移 NFT 不會失去身分組。
以 NFT 為條件的身分組會在成交後數秒內更新。以餘額為條件的身分組會在每小時重新檢查時更新,成員執行 /refresh 時則立即更新。
只有 XRP Ledger 才能實現的身分組
已上架的 NFT 仍會計算。在 XRP Ledger 上,上架出售的 NFT 在售出前都會留在你的錢包中,因此上架不會讓成員失去身分組。若想獎勵不上架的持有者,可設定已上架 NFT 比例的規則。
持有天數:持有 NFT 達一定天數。效果類似質押,但不需鎖倉。
會員通行證:鑄造時未設定可轉移標記的 NFT 只能退回創作者,因此無法出售。這類通行證可打造無法用錢買到的會員身分組。
流動性提供者:持有 AMM 池的流動性代幣,例如你專案代幣的池子。同樣用 /admin role token 設定。
支付版稅的持有者:系列中每個 NFT 都是透過鑄造或支付創作者版稅的交易取得,而非免費轉讓。
動態通知與伺服器工具
用 /admin feed add 建立動態通知:選擇頻道、要發布的活動類型(成交、上架、鑄造、轉移、銷毀、出價)、最低價格,以及完整或精簡版面。同一買家在同一 ledger 中的多筆購買會合併為一則掃貨通知。
價格以成交時使用的幣別顯示,若有 XRP 價值也會一併列出。
用 /admin stat add 建立統計頻道:頻道名稱會顯示地板價、持有者數、上架數、當日交易量或擁有某身分組的成員數,每十分鐘更新。
用 /admin snapshot take 建立快照:將系列所有持有者匯出成試算表。開啟 Discord ID 時,只會列出你伺服器內成員的名稱。
用 /admin audit 查看機器人給予或移除的所有身分組及原因。
白名單、投票、抽獎與活動
/allowlist create 會發布「加入」按鈕。符合條件的成員可用已連結的錢包加入;結束後可將名單匯出為試算表。
/poll create 會發布投票。可設定每位成員一票,或每持有一個 NFT 一票。
/raffle create 會發布「參加」按鈕。得獎者依報名截止後關閉的 XRP Ledger 帳本雜湊抽出,公告中會顯示該雜湊,任何人都能驗證抽獎是否公平。
/event create 會發布可讓成員報名的活動,可選擇僅限持有者參加並設定人數上限。
成員可用 /alerts 開啟私訊通知:自己 NFT 收到的出價、疑似詐騙出價的警示、收藏系列的成交,或低於指定價格的上架。
成員:驗證方式
在伺服器中點選「驗證」,或執行 /verify。機器人會回覆一個只有你看得到的連結。
連結會開啟 First Ledger。照常用錢包登入,然後選擇「繼續」。
Discord 會請你確認帳號。確認後,身分組會在幾秒內出現。
之後又在 First Ledger 帳號新增了錢包?請再次執行 /verify,然後執行 /refresh。
切勿完成別人傳給你的驗證。每個連結只屬於執行指令的人,也只對他有效。
所有指令
管理指令需要「管理伺服器」權限,Discord 只會對有此權限的人顯示。多數回覆只有你看得到;/floor、/collection 和 /nft 會在頻道中公開發布。在任何收藏系列選項中輸入名稱,再從清單中選取即可:先列出你伺服器的收藏系列,再列出市集的。
所有人可用
/verify
任何人傳送一個僅你可見的連結,用來連結你 First Ledger 帳戶中的錢包。連結僅供你使用,有效十分鐘。你不需要簽署任何交易。
/wallets
任何人列出你連結的錢包,每個都連到它在 First Ledger 的頁面。
/refresh
任何人立即從 First Ledger 重新載入你的錢包並重新檢查身分組。新增錢包後,或餘額身分組尚未更新時使用。
/roles
任何人列出此伺服器的持有者身分組及各自的條件,並勾選你已擁有的。
/floor
任何人發布地板價、過去一天的變化與上架數量,可查詢單一收藏,或最多 15 個伺服器的收藏。
collection- 單一系列。留空則包含伺服器的所有系列。
/collection
任何人發布收藏的統計:地板價、最高出價、上架數、持有者、交易量、銷售數、版稅及是否已驗證。
collection必填- 系列。
/nft
任何人發布 NFT 卡片:圖片、擁有者、稀有度排名、上架價格、版稅、旗標與特徵。
id必填- NFT 的
NFTokenID,長度為 64 個字元。
/portfolio
任何人依收藏分組顯示你所有已連結錢包中的 NFT。
/alerts add
任何人開啟私訊提醒。對同一收藏再次新增同類提醒會取代原本的價格。請保持接收伺服器成員的私訊,否則機器人無法通知你。
kind必填offer_received為你的 NFT 收到的出價,suspicious_offer在出價疑似詐騙時發出警告,collection_sale為系列中的成交,listing_below為低於某價格的上架。collection- 成交與上架通知必填。
price- 以 XRP 計:通知的最低成交價;上架通知則為最高價格。
/alerts remove
任何人關閉提醒。
kind必填offer_received為你的 NFT 收到的出價,suspicious_offer在出價疑似詐騙時發出警告,collection_sale為系列中的成交,listing_below為低於某價格的上架。collection- 成交與上架通知必填。
/alerts list
任何人列出你的提醒。
/privacy allow
任何人允許合作夥伴應用程式查詢你連結的錢包。
partner必填- 合作夥伴應用程式的名稱。
/privacy revoke
任何人停止與合作夥伴應用程式共享。
partner必填- 合作夥伴應用程式的名稱。
/privacy status
任何人列出你共享資料的合作夥伴應用程式。
/unlink
任何人在你與機器人共同所在的所有伺服器中,移除你的連結及機器人給你的身分組。
/help
任何人顯示你是否已連結,以及這些指令的簡短說明。
設定
/setup
管理伺服器發布驗證面板,成員點擊即可連結錢包,並記住其頻道。未指定頻道時,會建立 #verify。
channel- 面板的發布位置。留空則 bot 會建立 #verify,需要「管理頻道」權限。
/check-permissions
管理伺服器檢查機器人所需的每項權限、每條身分組規則(身分組仍存在,且位於機器人的身分組之下)及每個動態頻道,以勾或叉標示,並說明如何修正。若機器人被授予不需要的「管理員」權限,會發出警告。
/admin collection add
管理伺服器追蹤收藏系列,讓其動態傳到你的動態頻道,持有者取得你的身分組。若市集已標記該收藏系列,會發出警告。
collection必填- 系列。
/admin collection remove
管理伺服器停止追蹤收藏系列。
collection必填- 系列。
/admin collection list
管理伺服器列出此伺服器追蹤的收藏系列。
持有者身分組
/admin role set
管理伺服器將身分組給予持有足夠數量收藏系列的成員。對同一身分組再次設定會取代原規則。已連結的成員會立即重新檢查。
role必填- 低於 bot 自身角色的一般角色。bot 不接受 @everyone、由其他應用程式管理的角色,以及具有管理員或管理權限的角色。
collection必填- 系列。
min- 最少需持有的 NFT 數量,1 到 100,000。預設為 1。
max- 最多數量,用於 Holder、Collector、Whale 等等級。
traitType:Value,例如Background:Gold。多個值以|分隔,符合任一即可。held-days- 另須有一個 NFT 持有至少這麼多天,1 到 3,650。
/admin role token
管理伺服器依餘額給予身分組,餘額為成員所有已連結錢包的加總:XRP、在 XRP Ledger 上發行的代幣、多用途代幣,或 AMM 池的流動性代幣。餘額每小時重新檢查一次,或在成員執行 /refresh 時檢查。
role必填- 低於 bot 自身角色的一般角色。bot 不接受 @everyone、由其他應用程式管理的角色,以及具有管理員或管理權限的角色。
kind必填xrp、token為 XRP Ledger 上發行的代幣、mpt為多用途代幣,或lp為 AMM 池的流動性代幣。min必填- 最低餘額,須大於零。
issuer- 適用
token:發行者地址。 currency- 適用
token:代幣代碼,例如RLUSD。 issuance-id- 用於
mpt:48 個字元的發行 ID。 pool- 用於
lp:AMM 池的帳戶地址。
/admin role set-json
管理伺服器依 JSON 撰寫的規則給予身分組,可組合下列任何條件。
role必填- 低於 bot 自身角色的一般角色。bot 不接受 @everyone、由其他應用程式管理的角色,以及具有管理員或管理權限的角色。
rule必填- 規則,最多 6,000 個字元。
/admin role remove
管理伺服器刪除身分組的規則,並從機器人給予該身分組的成員身上移除它。
role必填- 低於 bot 自身角色的一般角色。bot 不接受 @everyone、由其他應用程式管理的角色,以及具有管理員或管理權限的角色。
/admin role list
管理伺服器以文字列出每條身分組規則,以及是否啟用。
動態與伺服器工具
/admin feed add
管理伺服器將動態發布到頻道。機器人會先傳送測試訊息,確認可在該頻道發文。在已有動態的頻道新增動態會更新原有設定。
channel必填- 文字或公告頻道。
kinds- 以逗號分隔,可選
sale、list、delist、mint、transfer、burn、buy_offer_created、buy_offer_cancelled、offer_expired和uri_modified。預設為sale。 collection- 單一系列。留空則包含伺服器的所有系列。
min-price- 略過低於此 XRP 數量的動態。沒有價格的動態(例如轉移)也會略過。
layoutfull或compact。
/admin feed layout
管理伺服器切換動態的完整或精簡版面。
channel必填- 頻道。
layout必填full或compact。
/admin feed remove
管理伺服器刪除頻道的動態。
channel必填- 頻道。
/admin feed list
管理伺服器列出你的動態、各自發布的內容,以及是否啟用。
/admin stat add
管理伺服器建立一個鎖定的語音頻道,名稱會顯示即時數字,例如地板價。數字變動時更新,最多每 10 分鐘一次。
kind必填floor、holders、volume(當日交易量)、listed,或role(擁有某身分組的成員數)。collection- 除
role外的所有類型皆須填寫。 rolerole須填寫。template- 頻道名稱,3 到 90 個字元,至少包含一個
{floor} {holders} {listed} {supply} {volume24h} {sales24h} {bid} {count}。
/admin stat remove
管理伺服器停止更新統計頻道。頻道本身會保留。
channel必填- 頻道。
/admin snapshot take
管理伺服器以 CSV 檔傳送收藏系列的所有持有者給你:地址、使用者名稱、持有數量及佔比。
collection必填- 系列。
min- 僅限持有至少此數量的持有者。
with-discord- 新增 Discord ID 欄位。只會顯示此伺服器中已連結的成員。
/admin snapshot list
管理伺服器列出最近的快照。
/admin audit
管理伺服器顯示最近 25 筆身分組與規則變更,以及各自的原因。
user- 僅顯示此成員的變更。
/admin reconcile
管理伺服器立即重新檢查所有已連結成員。變更會顯示在 /admin audit。
白名單、投票、抽獎與活動
/allowlist create
管理伺服器發布附有「加入」按鈕的白名單。符合資格的成員會以其第一個連結的錢包加入。
name必填- 名稱,最多 60 個字元,不可與伺服器其他白名單重複。
max-entries- 參加人數上限。
closes-in-hours- 在此時數後關閉,最多 2,160 小時(90 天)。
eligibility-collection- 僅限此系列的持有者參加。留空則任何已連結錢包的人都可參加。
eligibility-min- 須持有的數量。預設為 1。
rule-json- 或使用 JSON 格式的任意規則,同
/admin role set-json。
/allowlist close
管理伺服器立即關閉白名單。
name必填- 名稱,最多 60 個字元,不可與伺服器其他白名單重複。
/allowlist export
管理伺服器以 CSV 檔傳送白名單的登記名單給你。
name必填- 名稱,最多 60 個字元,不可與伺服器其他白名單重複。
/allowlist list
管理伺服器列出伺服器的白名單,包含名單成員與截止時間。
/poll create
管理伺服器發布投票,每個選項各有一個按鈕。投票截止前,成員可以更改選擇。
question必填- 最多 200 個字元。
options必填- 2 到 10 個選項,以
|分隔,每個最多 80 個字元。 duration-hours必填- 持續時間(小時),最多 2,160 小時(90 天)。
weightingmember每人一票或一次參加,或nft每持有一個 NFT 計一次。weight-collection- 要為
nft計算哪個收藏系列。 eligibility-collection- 僅限此系列的持有者參加。留空則任何已連結錢包的人都可參加。
eligibility-min- 須持有的數量。預設為 1。
/poll close
管理伺服器立即結束投票並公布結果。
id必填- 貼文底部的 ID。
/raffle create
管理伺服器發布抽獎,附上「參加」按鈕。
prize必填- 最多 200 個字元。
winners必填- 1 到 100。
duration-hours必填- 持續時間(小時),最多 2,160 小時(90 天)。
weightingmember每人一票或一次參加,或nft每持有一個 NFT 計一次。weight-collection- 要為
nft計算哪個收藏系列。 eligibility-collection- 僅限此系列的持有者參加。留空則任何已連結錢包的人都可參加。
eligibility-min- 須持有的數量。預設為 1。
/raffle draw
管理伺服器立即截止報名並抽出得獎者。抽獎以已驗證 ledger 的雜湊值作為種子,公告中會顯示,任何人都能重新驗算。
id必填- 貼文底部的 ID。
/event create
管理伺服器發布活動供成員報名,直到活動開始或額滿為止。
title必填- 最多 100 個字元。
starts必填- 從現在起的小時數,例如
48,或含時區的日期與時間,例如2026-12-01T18:00Z。須在 90 天內。 description- 最多 1,000 個字元。
location- 最多 200 個字元。
capacity- 可回覆出席的人數上限。
eligibility-collection- 僅限此系列的持有者參加。留空則任何已連結錢包的人都可參加。
eligibility-min- 須持有的數量。預設為 1。
/event cancel
管理伺服器取消活動並更新活動貼文。
id必填- 貼文底部的 ID。
/event attendees
管理伺服器列出參加者。
id必填- 貼文底部的 ID。
進階:以 JSON 撰寫規則
/admin role set-json 接受以 JSON 撰寫的規則,可建立 /admin role set 和 /admin role token 無法設定的條件。控制台的進階編輯器也能幫你產生相同的規則。
用 and 或 or 組合條件,每個可包含 1 到 20 條規則,並用 not 反轉條件。規則最多可巢狀 6 層,最多包含 30 個條件。
每個條件都會合併檢查成員所有已連結的錢包;沒有連結錢包的人一律視為不符合。若機器人無法檢查條件(例如無法連上帳本時),成員會保留現有的身分組。
以下依 JSON 類型列出條件。收藏系列以其市集 slug 指定。
holds,搭配collection、min及選填的max:持有該系列此數量的 NFT。holds_trait,搭配collection、traits(1 至 12 個,格式為Type:Value)及min:持有此數量具任一特徵的 NFT。holds_any_verified,搭配min:持有此數量來自已驗證系列的 NFT,不限系列。holds_non_transferable,搭配collection及min:持有此數量該系列的靈魂綁定 NFT(無法出售的 NFT)。held_for,搭配collection、days(1 至 3,650)及min:持有此數量至少達該天數。rarity_rank,搭配collection及max_rank:持有稀有度排名達此名次或更稀有的 NFT。listed_ratio,搭配collection及max(0 到 1 的比例):已上架的 NFT 不超過此比例。未持有任何 NFT 者視為不符合。top_holders,搭配collection及n(1 至 1,000):為該系列的前幾大持有者之一。is_creator,搭配collection:其中一個錢包建立或發行了該系列。royalty_compliant,搭配collection:所持有該系列的每個 NFT 都是鑄造取得,或在有支付版稅的交易中購得。xrp_balance,搭配min:持有至少此數量的 XRP。token_balance,搭配issuer、currency(如RLUSD的代碼,或其 40 字元的十六進位格式)及min:持有至少此數量的該代幣。mpt_balance,搭配issuance_id(48 個十六進位字元)及min:持有至少此數量的多用途代幣。amm_lp_balance,搭配amm_account及min:持有至少此數量的該池流動性代幣。wallet_in,搭配addresses(1 至 10,000 個):其中一個錢包在名單上。
限制
- 每個伺服器可追蹤 25 個系列。
- 每個伺服器 50 條身分組規則,每個身分組一條。
- 每個伺服器 20 個動態,每個頻道一個。
- 每個伺服器 10 個統計頻道,最多每 10 分鐘重新命名一次。
- 每個伺服器每 10 分鐘一次持有者快照,最多約 100,000 位持有者。
- 每位成員 25 個提醒,每小時最多傳送 30 則提醒訊息。
- 投票可設 2 至 10 個選項;抽獎可抽出 1 至 100 位得主;白名單、投票、抽獎和活動最長可進行 90 天。
- 每位成員每分鐘可使用機器人 20 次,超過時會請對方放慢速度。
隱私與安全
驗證時,機器人會取得你 First Ledger 帳戶中錢包的地址。它不會看到任何私鑰,也不會要求你簽署交易。要求你簽署的都不是這個機器人。
機器人只會要求它實際用到的權限,絕不要求管理員權限。它也會拒絕發放帶有管理或審核權限的身分組。
它只會移除自己發放的身分組。管理員手動給你的身分組會保留。
只有在你用 /privacy allow 指名允許後,其他應用程式才能看到你連結的錢包,而且你隨時可以撤回。
/unlink 會刪除你的連結,並移除機器人在所有伺服器中給你的身分組。
疑難排解
驗證後沒有身分組:執行 /refresh。如果仍未出現,請管理員執行 /check-permissions;可能是機器人的身分組排在持有者身分組之下。
連結顯示已過期:每個連結有效十分鐘,且只能使用一次。請重新執行 /verify。
「不同的 Discord 帳戶」:你確認時使用的 Discord 帳戶與執行指令的帳戶不同。請在 Discord 切換帳戶後重新執行 /verify。
動態沒有更新:執行 /admin feed list。機器人無法再發文的動態會被關閉,原因可在 /admin audit 查看。
餘額身分組沒有變更:這類身分組會在每小時重新檢查時更新。執行 /refresh 可立即檢查。