Discord 機器人

Bot 使用指南

Primostar Calculator 讓《杖劍傳說》玩家在 Discord 規劃角色養成、估算資源需求,並查詢遊戲機制。

快速入門

在可使用 Bot 的 Discord 頻道輸入 /,再選 Primostar Calculator 的指令。下方範例顯示參數名稱與示範值,請在 Discord 的對應欄位填值,角色、賽季、碎片及副本則從自動完成選取。

執行 /profile create,指定角色名稱和賽季。在編輯介面填寫所需功能的資料,每次提交表單即保存,再執行計算指令。日後用 /profile edit 更新資料,或用 /profile use 切換預設角色。

同一 Discord 帳號在不同使用情境共用存檔。在伺服器及群組對話中,回覆通常只有你看得到;與 Bot 一對一私訊時,回覆會出現在該對話。若權限允許,部分結果可按 公開結果 分享。互動介面 14 分鐘後失效,重新執行指令即可繼續使用已保存的資料。

角色編輯器

執行 /profile edit,再選對應的編輯分類。表單較長時,可用「上一組欄位」和「下一組欄位」切換。

基本設定
選擇賽季並填玩家編號、伺服器及職業。玩家編號前 7 位會帶入伺服器。修改伺服器會保留原玩家編號,若兩者不一致請修正。換職業時會清除不適用的裝備選擇。
角色經驗與目標時間
填目前角色等級、該級已累積經驗、每小時經驗及目標時間。再到 加速、累計原初與大礦 設今日免費加速是否已使用、加速石及累計原初。表單顯示上次記錄的該級經驗,更新時請填遊戲中的數值。只改目標時間會保留原取樣時間。只改每小時經驗時,系統會先按原時產累積到儲存當下。
目前等級與目標等級
裝備 5 件、技能 8 個、寵物 4 隻、古遺物 20 個,可整組或逐項輸入。技能依序為戰技 1–4、秘法 1–4。古遺物以目前等級由低至高配對目標。整組輸入留空會保留原值,逐項目標留空則會清除該目標。
持有資源、每小時產出及素材秘境
「持有資源」和「每小時產出」都按素材分開編輯,三種凍乾各有入口。角色經驗請在 角色經驗與目標時間 填寫。在 素材秘境 填各素材的每次平均產量。預測沿用存檔中的每日次數,新存檔預設為 0。
裝備與禮物
在 裝備選擇 逐欄選取實際裝備。在 禮物 選 夥伴 或 星間之神,再選 日用品、花、書 或 貴重品,並填好感、各國度幣和各品質持有禮物。

單位與時間

數字欄只填數字。若指令提供 _unit,可用它選單位。無單位 為 ×1、千/k 為 ×1,000、萬 為 ×10,000、m 為 ×1,000,000、億 為 ×100,000,000、b 為 ×1,000,000,000。指令的單位只有同時提供對應數字時才生效,換算後仍須符合欄位限制。

編輯器內的每小時經驗與羅拉欄預設為 萬,其他有單位選單的欄位預設為無單位。角色目前已累積經驗、加速石、原初之星及等級欄位直接填原數字。編輯器的單位設定會跟著賽季存檔保存。

時間可填 2026-12-01 20:00,會視為 UTC+8。也接受含時區的 ISO 格式,例如 2026-12-01T20:00:00+08:00。結果以 UTC+8 顯示。

指令參考

各指令說明回傳內容及每個參數的效果。標為必填的欄位須在 Discord 輸入,部分指令也會要求先有角色,或至少填一個選填欄位。

/help Discord 內建說明

/help

打開 Bot 的內建說明。省略參數時顯示入門步驟及功能分類。

command 選填
選擇 profile、primordial、exp、equipment、gift、world、ask、remember 或 data,只查看該功能的說明。

範例 /help command:equipment

/profile 角色與存檔

/profile create

建立角色、設為目前角色,並開啟編輯介面。

name 必填
角色名稱,去除前後空白後須為 1–60 字。同一帳號的角色名稱不可重複。
season 必填
從自動完成選擇起始賽季。這會決定先建立哪一季的存檔,以及計算所用的遊戲資料。

範例 /profile create name:Main season:s1

/profile list

列出你的角色及各自目前選用的賽季。

無參數。

/profile use

將選定角色設為後續指令的預設角色。

profile 必填
從自動完成選擇要操作的角色。

範例 /profile use profile:Main

/profile show

查看所選賽季、職業、遮蔽後的玩家編號、伺服器、角色等級、每小時經驗、各項等級及存檔版本。

profile 選填
從自動完成選擇自己的角色。省略時使用目前角色。

範例 /profile show profile:Main

/profile edit

開啟所選角色的編輯介面。選分類及區域後提交表單即保存。賽季選擇器會切到該季的獨立存檔。

profile 選填
從自動完成選擇自己的角色。省略時使用目前角色。

範例 /profile edit

/profile rename

更改角色名稱,原有各賽季存檔仍屬於同一角色。

profile 必填
從自動完成選擇要操作的角色。
name 必填
新名稱,同樣須為 1–60 字且不可重複。

範例 /profile rename profile:Main name:Alt

/profile delete

按下確認後刪除角色及其所有賽季存檔。若刪除的是目前角色,請重新選擇或建立角色再使用預設角色。

profile 必填
從自動完成選擇要操作的角色。

範例 /profile delete profile:Alt

/primordial 原初之星與升級資源

/primordial recommend

預覽當季推薦的角色、裝備、技能、寵物及古遺物目標。按 套用目標 才會儲存,目前等級及持有資源會保留。

tier 必填
選擇 一般、重課 或 超重課。不同檔位會查出該賽季不同的目標等級組合。若缺少該季檔位資料,Bot 會提示。
profile 選填
從自動完成選擇自己的角色。省略時使用目前角色。

範例 /primordial recommend tier:一般

/primordial score

依存檔的目標等級列出分項賽季分數、本季原初及加上既有累計原初的總量。請先設定目標,未設定的項目不計分。

profile 選填
從自動完成選擇自己的角色。省略時使用目前角色。

範例 /primordial score

/primordial resources

比較存檔的目前與目標等級,列出需求、持有、預期產出及缺口。請在編輯器填目標時間、每小時產出和素材秘境平均產量。持有經驗按角色經驗設定推算。額外來源只計素材秘境。凍乾統一換算普通凍乾等值(普通 1、優質 8、精品 40)。缺少成本的等級區間會標示。

profile 選填
從自動完成選擇自己的角色。省略時使用目前角色。

範例 /primordial resources

/exp 經驗與升級時間

/exp eta

估算尚需經驗、達成時間及加速折合時數。請先在角色編輯器填目前等級、已累積經驗、每小時經驗及可用加速。若經驗不足且時產為 0,無法算出達成時間。

target_level 選填
要達到的角色等級。換算單位後須為 1–1000 的整數。省略時算下一級。若指定目前等級或更低,結果為已達成。
target_level_unit 選填
只換算 target_level。省略時按原數字計算,例如 target_level:1 target_level_unit:k 代表 1000 級。
profile 選填
從自動完成選擇自己的角色。省略時使用目前角色。

範例 /exp eta target_level:100

/exp reachable

使用和 ETA 相同的存檔輸入,預估指定時間可達等級、可用經驗及加速時數。超出已知資料範圍的結果會標示為估算。

target_time 必填
預測時間,接受 UTC+8 或附時區的 ISO 8601。填未來時間才會計入未來產出;填過去時間會按目前狀態做零小時預測。
profile 選填
從自動完成選擇自己的角色。省略時使用目前角色。

範例 /exp reachable target_time:2026-12-01 20:00

/exp hoard

依所選角色的賽季規則,算出為下一季囤積經驗的開始時間。回覆會列出賽季結束時間及須提前的時數。

season_end 選填
指定實際賽季結束時間,覆蓋伺服器時程。省略時按存檔中的伺服器及賽季查找;缺少時程時請手動填寫。本指令只回覆時間。
profile 選填
從自動完成選擇自己的角色。省略時使用目前角色。

範例 /exp hoard season_end:2026-12-01 05:00

/equipment 裝備、碎片與副本

/equipment fragment

估算分解產量、抽成前後售價及每組收益。需要角色存檔。請在指令參數填寫本次交易資料。省略的參數沿用存檔值,抽成模式的例外見下方。

fragment 選填
從自動完成選碎片種類,決定使用哪個分解比例。角色已有碎片存檔時,可省略此參數。
quantity 選填
要分解的碎片總數,單位換算後須為整數,會影響精鍛石總產量。收益仍按每組顯示。
fragment_price 選填
每組碎片的買價。抽成後售價減去這個值,即為每組收益。
stone_price 選填
每組精鍛石的售價,影響抽成前後的出售收入。
fee_mode 選填
正常 可選 10、20、30、50 或 70%;優惠 可選 5、12、20、40 或 60%。指定模式卻沒填 fee_rate 時,使用該模式第一個比例(10% 或 5%)。
fee_rate 選填
從售價扣除的百分比,5% 填 5。最終值必須符合所選或存檔中模式的可用抽成。
quantity_unit 選填
只換算 quantity,例如 quantity:1.5 quantity_unit:k 等於 1,500 個碎片。
fragment_price_unit 選填
只換算 fragment_price,例如 fragment_price:1.2 fragment_price_unit:萬 等於每組 12,000。
stone_price_unit 選填
只換算 stone_price,例如 stone_price:2 stone_price_unit:k 等於每組 2,000。
fee_rate_unit 選填
只換算 fee_rate。一般填百分比時留空,換算後仍須是該抽成模式允許的比例。
profile 選填
從自動完成選擇自己的角色。省略時使用目前角色。

選取碎片後的範例 /equipment fragment quantity:1.5 quantity_unit:k fragment_price:500 stone_price:800 fee_mode:優惠 fee_rate:5

/equipment score

依所選賽季與職業,評估存檔的主武器、副武器、頭盔、護甲與鞋子。先在編輯器填職業及逐件選擇裝備,回覆會列出分項分數、總分及可查到的評級。

profile 選填
從自動完成選擇自己的角色。省略時使用目前角色。

範例 /equipment score

/equipment dungeon

查副本賽季、等級門檻、各難度所需戰力及精鍛石收益。不需要角色存檔。

dungeon 必填
從自動完成選取副本。建議項目含賽季,遇到同名副本請核對賽季。

/gift 好感與禮物

/gift calculate

比較「最少溢出」和「優先持有」方案。先在編輯器填對象、類別、目前好感等級與該級進度、目標等級、持有禮物及各國度幣。回覆按國度及品質列出購買項目、費用、好感與缺口。試算不會扣除存檔的幣或禮物。

profile 選填
從自動完成選擇自己的角色。省略時使用目前角色。

範例 /gift calculate

/gift reference

查看各品質的好感、價格,以及各類禮物由哪些國度販售。不需要角色存檔。

無參數。

/world 伺服器、國度與世界集會

/world server

查伺服器名稱、國度代碼、世界編號和合服狀態。直接填伺服器或玩家編號時可不使用角色。

player_number 選填
輸入 12 位玩家編號,前 7 位用來判定伺服器。若同時填 server,兩者必須一致。
server 選填
輸入 600XXYY 格式的 7 位伺服器編號,最後兩位是世界編號 01 至 16。有建議時可從自動完成選取。
season 選填
Discord 會顯示此選項,但查詢只回傳伺服器資料中記錄的目前狀態,填入賽季不影響結果。
profile 選填
選擇角色。兩種編號都沒填時,使用所選角色的存檔;也省略 profile 時用目前角色。直接輸入的編號優先於存檔。

範例 /world server server:6002601

/world realm

列出同一國度內已知的伺服器。查詢的伺服器若在清單中會標上 ★。

player_number 選填
輸入 12 位玩家編號,前 7 位用來判定伺服器。若同時填 server,兩者必須一致。
server 選填
輸入 600XXYY 格式的 7 位伺服器編號,最後兩位是世界編號 01 至 16。有建議時可從自動完成選取。
season 選填
此選項不影響清單。查詢以伺服器的國度代碼為準。
profile 選填
選擇角色。兩種編號都沒填時,使用所選角色的存檔;也省略 profile 時用目前角色。直接輸入的編號優先於存檔。

範例 /world realm server:6002601

/world rally

依該賽季規則查所選伺服器的世界集會分組。若未開放或缺少賽季規則,Bot 會明確提示。

player_number 選填
輸入 12 位玩家編號,前 7 位用來判定伺服器。若同時填 server,兩者必須一致。
server 選填
輸入 600XXYY 格式的 7 位伺服器編號,最後兩位是世界編號 01 至 16。有建議時可從自動完成選取。
season 選填
選擇要套用哪一季的分組規則。使用角色存檔時可省略,沿用角色賽季。直接輸入編號且未填 profile 時,即使有目前角色也要指定 season。
profile 選填
選擇角色。兩種編號都沒填時,使用所選角色的存檔;也省略 profile 時用目前角色。直接輸入的編號優先於存檔。

範例 /world rally server:6002601 season:s1

/ask 遊戲知識庫

/ask

搜尋遊戲知識庫。管理員有設定回答模型時,Bot 可能根據命中的段落生成答案,也可能直接引用來源或回報沒有結果。須啟用知識庫,不需要角色存檔。

question 必填
以自然語言提問,最多 500 字。視問題加上賽季、職業、副本或難度,可提高相關性。請勿填入個人資料或憑證。

範例 /ask question:二轉術士打競技場怎麼配?

/remember 投稿遊戲知識

/remember

將可公開引用的遊戲資料投稿到 bot 知識庫。其他玩家可以用 /ask 和 /chat 查到通過審查的文字。Bot 會私下回覆投稿編號。

game_info 必填
可公開引用的遊戲文字,最多 4,000 字。建議填寫適用賽季、伺服器或版本。搜尋索引只使用這個欄位。
url 選填
最多 2,000 字的 HTTP 或 HTTPS 網址,不可在網址內夾帶帳密。Bot 保存的是連結本身。
image 選填
在 Discord 上傳 PNG、JPEG、GIF 或 WebP 圖片附件,上限 8 MiB。Bot 會保存圖片原檔。

範例 /remember game_info:S3 的活動兌換規則……

/data 版本與支援資料

/data

查看 Bot 與 Discord 函式庫版本、遊戲資料版本和擷取時間、支援賽季,以及伺服器和副本筆數。回報問題時可附資料版本、實際指令和結果頁的追蹤編號。

無參數。