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

指令總覽

一般功能

/等級：查看自己或其他成員的等級
/排行榜：查看伺服器等級排行榜
/簽到日：查看本月簽到日期與連續簽到天數
/伺服器今日統計：查看伺服器今天的活動統計
/伺服器每日任務：查看每天的伺服器共同任務
/設定生日：設定自己的生日
/節日通知：管理節日與放假提醒

音樂功能

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

娛樂功能

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

管理功能

/考核紀錄、/懲罰紀錄：記錄考核與伺服器處分資料
/公告：發布伺服器公告
/建立抽獎、/結束抽獎、/取消抽獎：管理抽獎活動
/抽獎列表、/抽獎參加者：查看抽獎狀態
/建立活動、/活動加入成員：建立與管理限時活動
/活動列表、/活動報名者：查看活動資訊
/設置名單、/新增成員、/編輯成員：管理成員名單
/查詢成員、/名單統計、/名單權限：查詢與設定名單
/歡迎面板、/加入自動身分組：管理歡迎與身分組
/防護功能、/防護診斷：設定與檢查伺服器防護
/機器人更新、/抽卡設定：管理更新頻道與抽卡次數

Bot 擁有者功能

/更新發布：將更新公告發布到所有已開啟的更新頻道
/狀態：管理 Bot 狀態文字
/重啟：重新啟動 Bot

MUSIC SYSTEM

音樂系統

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

支援內容

YouTube 單曲與播放清單
YouTube Music 專輯
Spotify 歌曲、專輯與歌單
播放佇列
暫停、繼續、跳過和停止
自訂音量
播放失敗自動重試

Spotify 連結說明

Spotify 連結會先讀取歌曲名稱和藝人，再尋找公開的 YouTube 對應歌曲播放。實際播放的是 YouTube 音訊，不是直接播放 Spotify 音訊。

CARD COLLECTION

抽卡系統

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

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

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

/抽卡設定 每日次數:5

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

EVENTS & GIVEAWAYS

活動與抽獎

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

成員可以

報名活動
退出活動
查看自己的報名狀態

活動結束後

Bot 會在原本的頻道公告結果，並私訊已報名的成員。管理員也可以使用 /活動加入成員，手動加入符合身分組資格的成員。

CHECK-IN & LEVELS

簽到與等級

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

每日簽到
連續簽到
離線期間連勝保護
聊天 XP
語音 XP
等級排行榜
升等通知
等級獎勵身分組
伺服器每日任務

Bot 離線期間不會把離線日期誤算成新的簽到，但會依照既有規則保留符合條件的連勝。

MEMBER DIRECTORY

成員名單

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

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

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

WELCOME & ROLES

歡迎與自動身分組

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

如果希望新成員加入後自動取得身分組，可以使用：

/加入自動身分組

設定時需要指定身分組。Bot 的身分組必須高於要給予的新成員身分組，並且需要「管理身分組」權限。不能指定 @everyone，也不能指定由其他機器人或整合管理的身分組。

SERVER PROTECTION

防護功能

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

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

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

詐騙隔離頻道偵測到可疑成員時，可以通知伺服器擁有者。通知不會包含完整的可疑訊息內容，避免把可疑內容再次散播出去。

OTHER INTERACTIONS

其他功能

真心話大冒險

可以自己抽出真心話或大冒險題目
可以指定其他成員接受挑戰
對方可以接受或拒絕

數數字

成員依序輸入正確數字
輸入錯誤時會提示正確數字並重置
可以使用共用頻道或私人數數字頻道

節日通知

管理員可以設定通知頻道，Bot 會檢查台灣節日，通知會標示依政府行事曆是否放假。

FAQ

常見問題

為什麼新指令看不到？

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

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

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

為什麼 Spotify 不能直接播放？

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

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

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

Bot 沒有反應怎麼辦？

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