/dynamic-vc-rename

動態語音頻道重命名 (dynamic-vc-rename)

指令概述

/dynamic-vc-rename 指令讓管理員能夠設置語音頻道的動態命名功能,使頻道名稱根據伺服器數據自動更新。這可以顯示各種實時統計資訊,如在線成員數、交易數量、營收等,為伺服器增添專業度和資訊透明度。

dynamic-vc-rename 指令介面

使用權限

  • 需要頻道管理權限:使用者必須擁有「管理頻道」(Manage Channels)權限才能使用此指令

指令參數

參數
說明
必填

channel

要設置動態命名的語音頻道

rename_name

動態命名模板(輸入 delete 停用)

使用步驟

1. 設置動態命名

選擇一個語音頻道並設定動態命名模板:

系統會立即更新頻道名稱,並設置為每 10 分鐘自動更新一次。

2. 停用動態命名

若要停用某個頻道的動態命名功能:

系統將停止自動更新該頻道名稱。

可用的佔位符

您可以在命名模板中使用以下佔位符,系統將自動替換為對應的數值:

伺服器統計

佔位符
說明

%server_members%

伺服器總成員數

%real_members%

真實用戶數(不含機器人)

%bots%

機器人數量

%online_members%

在線成員數

%total_channels%

總頻道數

%voice_channels%

語音頻道數

%text_channels%

文字頻道數

付款統計

佔位符
說明

%all_orders%

所有訂單數量

%completed_orders%

已完成訂單數量

%completed_amount%

已完成訂單總金額

%completed_pay_amount%

已完成訂單總付款金額(含手續費)

%completed_fee%

已收取手續費總額

待付款統計

佔位符
說明

%pending_orders%

待付款訂單數量

%pending_amount%

待付款訂單總金額

%pending_pay_amount%

待付款訂單總付款金額(含手續費)

%pending_fee%

待付款訂單手續費總額

已過期統計

佔位符
說明

%expired_orders%

已過期訂單數量

%expired_amount%

已過期訂單總金額

%expired_pay_amount%

已過期訂單總付款金額(含手續費)

%expired_fee%

已過期訂單手續費總額

月度統計

佔位符
說明

%monthly_orders%

本月所有訂單數量

%monthly_amount%

本月所有訂單總金額

%monthly_pay_amount%

本月所有訂單總付款金額(含手續費)

%monthly_fee%

本月手續費總額

%monthly_completed_orders%

本月已完成訂單數量

%monthly_completed_amount%

本月已完成訂單總金額

%monthly_completed_pay_amount%

本月已完成訂單總付款金額(含手續費)

%monthly_completed_fee%

本月已完成訂單手續費總額

命名模板範例

以下是一些實用的命名模板範例:

基本統計範例

顯示:【125人】總聊天室

顯示:🌐 在線:42/125

付款統計範例

顯示:💰 營收:25600 元

顯示:📊 本月訂單:78筆

複合統計範例

顯示:💼 營收:25600|待付:12筆

顯示:📈 月收:8500|訂單:32

系統運作機制

更新頻率

系統每 10 分鐘自動更新一次所有動態命名頻道。這個頻率平衡了即時性和 Discord API 的限制。

Discord 頻道命名限制

使用動態命名時請注意 Discord 的以下限制:

  • 頻道名稱最長 100 個字元

  • 每個頻道每 10 分鐘最多可更名 2 次

  • 一些特殊字元可能無法使用

更新優先級

當多個頻道同時需要更新時,系統按以下優先級處理:

  1. 顯示伺服器基本統計的頻道

  2. 顯示付款統計的頻道

  3. 顯示複合統計的頻道

常見問題解答

Q: 頻道名稱未按預期更新?

A: 可能原因:

  • Discord 限制每 10 分鐘最多更改 2 次頻道名稱

  • 機器人可能沒有足夠的權限修改頻道

  • 命名模板可能包含無效字元

Q: 統計數字與預期不符?

A: 系統資料有一定的緩存時間,最長可能需要 10 分鐘才會反映最新變化。

Q: 多個相似佔位符的區別?

A: 請注意區分以下區別:

  • amount 表示訂單原始金額

  • pay_amount 表示含手續費的實際付款金額

  • fee 單獨表示手續費金額

Q: 我的頻道突然不再自動更新?

A: 如果系統多次嘗試更新頻道名稱失敗(如權限不足),將自動移除該頻道的動態命名功能。請重新設置。

最佳實踐

使用建議

  1. 使用有意義的統計:選擇與頻道用途相關的統計數據

  2. 保持簡短清晰:避免使用過多佔位符,保持名稱易讀

  3. 使用表情符號:適當的表情符號可以提升視覺效果

  4. 避免過於頻繁變化:選擇相對穩定的數據,避免頻道名稱快速變化

常見用途

  • 伺服器成長追蹤🌱 成員:%server_members%

  • 收益透明度💰 總收入:%completed_amount%

  • 活動頻道🎮 遊戲室 [%online_members%人]

  • 業績指標📊 本月營收:%monthly_completed_amount%

相關指令

  • /payment create:建立新的付款訂單

  • /payment review:查詢訂單付款狀態

  • /payment history:查看歷史付款紀錄

  • /auto-publish:設定公告頻道自動發佈

支援與幫助

如使用過程中遇到任何問題,請聯繫伺服器管理員或移至指定的支援頻道尋求協助。

Last updated