MJ helper Wiki

WELCOME

開始使用 MJ helper

如果你是第一次使用，建議先看新手開始、指令總覽、伺服器管理設定與常見問題。

新手開始指令總覽伺服器管理設定常見問題

在 Discord 輸入 /help，也可以直接查看目前可用的功能。

ABOUT THE BOT

MJ helper 是什麼？

MJ helper 是 MJ Clan 的團長自己製作和維護的 Discord Bot。

它主要用來處理伺服器管理、日常互動和娛樂功能。每個伺服器可以依照自己的需求，開啟或調整不同功能。

音樂播放抽卡與卡片收藏限時活動與抽獎每日簽到與等級成員名單歡迎訊息與自動身分組防洗頻與防詐騙數數字遊戲真心話大冒險節日通知伺服器互動

GETTING STARTED

新手開始

01

把 MJ helper 加入伺服器

邀請 Bot 進入伺服器後，請確認它有正常顯示在線上。

02

確認必要權限

部分功能需要管理員權限或額外的 Discord 權限，例如管理身分組、管理頻道、管理訊息、禁言或停權成員、讀取訊息內容與讀取成員資料。

03

查看功能

在伺服器輸入 /help，Bot 會顯示功能分類和常用指令。

04

先設定伺服器功能

管理員可以依照需求設定 /歡迎面板、/防護功能、/防護診斷、/等級設定、/機器人更新、/音樂權限、/抽卡設定 與 /節日通知。

不同伺服器的設定和資料會分開保存，不會互相影響。

COMMAND REFERENCE

指令總覽

一般功能

/等級：查看自己或其他成員的等級
/排行榜：查看伺服器等級排行榜
/簽到日：查看本月簽到日期與連續簽到天數
/伺服器今日統計：查看伺服器今天的活動統計
/伺服器每日任務：查看每天的伺服器共同任務
/設定生日：設定自己的生日，節日通知由管理員設定
/help：查看目前可用指令分類與使用方式

音樂功能

/play：播放 YouTube、YouTube Music 或 Spotify 連結
/暫停、/繼續：控制播放狀態
/跳過、/停止：控制歌曲與播放佇列
/離開：讓 Bot 離開語音頻道
/佇列、/目前播放：查看播放資訊
/音量：設定播放音量
/音樂權限：設定 DJ 身分組或恢復所有人控制

娛樂功能

/抽卡：抽取收藏卡片
/抽卡圖鑑：查看卡片收藏進度
/抽卡背包：查看擁有的卡片與碎片
/抽卡排行：查看伺服器抽卡排行榜
/結婚請求：向其他成員發送娛樂用結婚請求
/gay指數：查看娛樂用測驗結果
/真心話大冒險：抽出真心話或大冒險題目
/數數字頻道、/數數字模式：設定數數字遊戲

管理功能

/考核紀錄、/懲罰紀錄：記錄考核與伺服器處分資料
/公告：發布伺服器公告
/建立抽獎、/結束抽獎、/取消抽獎：管理抽獎活動
/抽獎列表、/抽獎參加者：查看抽獎狀態
/建立活動、/結束活動、/取消活動、/活動加入成員：建立、結束或取消限時活動
/活動列表、/活動報名者：查看活動資訊和報名者
/設置名單、/新增成員、/編輯成員：管理成員名單
/編輯分組、/查詢成員、/名單統計、/名單紀錄：管理分組、搜尋及查看名單稽核
/匯入名單、/匯出名單、/名單權限：匯入預覽、備份及設定名單權限
/歡迎面板：管理歡迎／離開訊息與新成員自動身分組
/防護功能、/防護診斷：設定與檢查伺服器防護
/機器人更新、/節日通知、/抽卡設定：管理通知頻道和每日抽卡次數
/等級設定、/設定升等通知頻道、/等級獎勵：設定 XP 與升等獎勵
/設定領身分、/編輯領身分、/新增領取身分、/移除領取身分：管理自助領取身分組面板

Bot 擁有者功能

/更新發布：選擇發到已啟用更新頻道，或私訊已訂閱更新通知的伺服器擁有者
/文字狀態：管理 Bot 狀態文字、輪播與活動
/狀態燈號：設定 Bot 全域 Presence 燈號
/數數字恢復：恢復指定數數字頻道下一個要輸入的數字
/重啟：重新啟動 Bot

MUSIC SYSTEM

音樂系統

使用 /play 播放 YouTube、YouTube Music 或 Spotify 連結。

支援內容

YouTube 單曲與公開播放清單
YouTube Music 專輯
Spotify 歌曲、專輯與歌單 metadata 對應
每個伺服器獨立播放佇列
播放面板：暫停、繼續、跳過、停止與離開
0–150% 自訂音量
播放失敗自動重試

Spotify 連結說明

Spotify 連結會先讀取歌曲名稱和藝人，再尋找公開的 YouTube 對應歌曲播放。實際播放的是 YouTube 音訊，不是直接播放 Spotify 音訊；相似度不足時會略過，不會把同名歌曲當成可靠對應。

公開 YouTube 播放清單／專輯最多加入 50 首；YouTube 自動 Mix（list=RD...）不能像一般公開清單載入。音樂控制預設所有人可用，管理者可用 /音樂權限 設定 DJ 身分組。

CARD COLLECTION

抽卡系統

使用 /抽卡 抽取收藏卡片。目前共有 60 張卡片，分成普通、稀有、超稀有、傳說和神話等級。

/抽卡圖鑑：查看收藏進度
/抽卡背包：查看擁有的卡片和碎片
/抽卡排行：查看伺服器排行榜
/抽卡設定：由管理員設定每天免費抽卡次數

抽到重複卡片時，會自動轉換成卡片碎片。預設每位成員每天可以抽 1 次，管理員可以使用 /抽卡設定 調整為每天 1～10 次。

/抽卡設定 每日次數:5

設定後，每位成員每天可以免費抽 5 次。這項設定只影響目前伺服器，不會重置既有卡片、碎片或保底進度。

EVENTS & GIVEAWAYS

活動與抽獎

管理員可以建立限時活動，設定活動名稱、活動說明、活動時間，以及可以參加的身分組。

限時活動

管理員可建立活動、設定結束時間及最多五種參加身分組
成員可從活動面板報名、退出或查看狀態
管理員可手動加入符合資格的成員
時間到會公告並通知已報名成員
Bot 重啟後會恢復尚未結束的活動

/建立活動、/結束活動、/取消活動、/活動列表、/活動報名者 可管理活動。

按鈕抽獎

使用 /建立抽獎 設定獎品、時間、中獎人數及選填的提供者；成員可按鈕參加或退出。時間到會自動抽獎，中獎者收到領獎私訊，提供者也會收到發獎提醒。管理者可使用 /抽獎列表、/抽獎參加者、/結束抽獎、/取消抽獎 和 /重抽 管理。

CHECK-IN & LEVELS

簽到與等級

MJ helper 會記錄成員的每日簽到、連續簽到、聊天 XP 和語音 XP。

每日首次發言簽到，基本 +10 XP
連續簽到與週期獎勵
本月簽到日曆
聊天 XP、冷卻及每日上限
語音 XP（需至少兩位真人）
等級與排行榜
升等通知頻道與等級獎勵身分組
伺服器每日共同任務

管理員可使用 /等級設定 面板，分別調整聊天、語音 XP 或關閉等級系統。關閉會停止等級 XP 並保留既有等級與 XP；簽到 XP 不受聊天冷卻影響。

語音 XP 不錄音、不讀取語音內容；Bot 離線期間不會把離線日期誤算成新的簽到。預設聊天 XP 為每 30 秒冷卻、每日最多 +600 XP；語音 XP 為每分鐘 +4 XP，且需至少兩位真人同處語音頻道。

MEMBER DIRECTORY

成員名單

MJ MEMBER 名單功能可以用來管理伺服器成員資料。

設定名單頻道和標題
新增、編輯或移除成員
設定 Roblox ID 必填或選填
建立和管理分組
設定查看者和編輯者身分組
查詢成員
查看名單統計
匯入或匯出資料
查看名單操作紀錄

名單可依伺服器規則要求 Roblox ID 或允許選填；CSV／JSON 匯入會先預覽再確認。匯出檔可能含 Discord 名稱、Roblox ID 與備註，請只提供給有權限的人。

每個伺服器的名單資料分開保存，不會與其他伺服器混用。

WELCOME & ROLES

歡迎與自動身分組

管理員可以使用 /歡迎面板 設定新成員加入訊息、成員離開訊息、通知頻道、Embed 顏色、歡迎圖片與新成員私訊。

自動身分組已整合在 /歡迎面板：使用「加入伺服器自動身分組」選單選擇角色，或按「清除自動身分組」取消。沒有獨立的自動身分組指令。

Bot 需要「管理身分組」權限，且自己的身分組必須高於目標角色；不能指定 @everyone 或由其他機器人／整合管理的身分組。加入與離開通知頻道可分開設定；預設歡迎私訊卡會顯示加入序號和成員頭像。

SERVER PROTECTION

防護功能

管理員可以使用 /防護功能 設定防護項目：

防洗頻
重複訊息偵測
@everyone 和 @here 偵測
邀請連結偵測
詐騙訊息偵測
詐騙隔離頻道
自動刪除訊息
禁言或停權處分

如果防護沒有正常運作，先使用 /防護診斷 查看 Bot 是否缺少權限或 Discord Intent。

管理員可在面板調整防護項目、處置方式及紀錄／隔離頻道。Bot 缺少 Discord 權限，或目標成員的角色高於 Bot 時，部分處置可能無法執行；可先使用 /防護診斷 檢查。

詐騙隔離功能可通知伺服器擁有者。防護偵測不保證百分之百準確，管理員仍應檢查紀錄並處理申訴。

OTHER INTERACTIONS

其他功能

社交互動

抽真心話／大冒險題目或指定挑戰對象
對方可用按鈕接受或拒絕挑戰
結婚請求是純娛樂，不代表法律關係
Gay 指數是每日娛樂測驗，不是身分判斷

/真心話大冒險、/結婚請求、/gay指數 可由成員使用。

數數字與生日

共同模式按順序接龍，答錯會提示正確數字並重置
個人模式建立私人頻道，僅建立者可用
管理員用 /數數字頻道 設定頻道，/數數字模式 切換模式
/設定生日 可填自己的 MM-DD，提醒會在設定時的文字頻道發送

節日通知

管理員使用 /節日通知 設定頻道；Bot 依台灣節日資料通知，並標示當日是否放假。

FAQ

常見問題

為什麼新指令看不到？

修改功能後，需要由 Bot 擁有者自行執行 /重啟。重新啟動後，新的指令才會載入。

為什麼自動身分組沒有發出去？

請確認 Bot 有「管理身分組」權限、Bot 的身分組位於目標身分組上方、目標身分組不是 @everyone，也不是其他機器人或整合管理的身分組，並確認 Discord Developer Portal 已開啟 Server Members Intent。

為什麼 Spotify 不能直接播放？

Spotify 連結不是直接轉送 Spotify 音訊。MJ helper 會讀取 Spotify 的歌曲資料，再找公開的 YouTube 對應歌曲播放，避免下載、轉發或繞過 Spotify 的音訊限制。

怎麼設定新成員自動身分組？

在 /歡迎面板 中使用加入身分組選單設定，或按「清除自動身分組」取消。請確認 Bot 有管理身分組權限，且 Bot 的角色高於目標身分組。

Bot 會保存所有聊天內容或錄音嗎？

不會建立所有聊天內容的完整永久存檔，也不錄音。問候、數數字、防護和 XP 等功能會在需要時處理訊息事件；功能資料與必要操作摘要依隱私權政策保存。

每個伺服器的設定會不會互相影響？

不會。名單、活動、防護、抽卡、音樂權限、歡迎設定和其他伺服器資料都會依伺服器分開保存。

Bot 沒有反應怎麼辦？

請先確認 Bot 是否在線、Bot 是否有目前頻道的查看／讀取／發送訊息權限、指令是否輸入正確、該功能是否需要管理員權限，以及防護、歡迎或音樂功能是否缺少額外 Discord 權限。

如何查詢、更正或刪除資料？

到 MJ Clan Discord 聯絡維護者，提供要處理的功能、伺服器與帳號資訊以便核實；詳細方式請閱讀隱私權政策。