跳轉至
資源版本5.7.3伺服器版本1.20.1 · Forge

怎麼開始與互動#

這頁教你：怎麼讓 Verity 出現、怎麼跟它說話、以及兩條設定路線（雲端 vs 本機離線）各自要準備什麼。安全與隱私細節請看專頁：「⚠️ 安全與隱私」。

第一次進世界會發生什麼#

本節取自 Verity 5.7.3 反編譯原碼 [反編譯]；實際觸發時機需真玩驗證，標「需人工實測」。

當你第一次進入主世界，模組會自動幫你做三件事：

  • 在你附近的地面生出一個禮物箱（Box box）。
  • 直接給你一把手電筒（Flashlight flashlight）。
  • 在聊天欄丟出設定教學連結（就是下面這兩支，作者放在程式裡的），並把 Verity 對你的好感（karma）設為 10。

⚠️ 這兩支是模組作者自己放在程式裡的官方教學（[反編譯] ModEvents.java:753-759）。 但第一支的標題寫著 for 3.7.0+，而本頁記錄的是 5.7.3——設定畫面與選項可能已經不同。 影片當作流程參考即可，實際欄位以設定表為準（那是直接從 5.7.3 的 jar 反編譯出來的）。

接著右鍵那個禮物箱把它打開——約 2 秒後，Verity 會從箱子裡掉出來，這就是它的登場。開箱同時解鎖成就 「Hello, I'm Verity」。

開不出箱子 / 箱子不見了？ 你也可以自己召喚它：把 Verity™ verity_item 放進一個普通箱子再關上箱子，Verity 就會在那裡生成；或用指令 /recoververity（見下）。

讓 Verity 出現的所有方法#

物品取得與召喚方式 [反編譯]。

方法 怎麼做 備註
開禮物箱 首次進主世界 → 右鍵 Box 標準登場路徑
丟出 verity_item 把 Verity™ 物品丟到地上，靜置約 1 秒 物品會「長成」本體
放進箱子關起來 把 verity_item 放入普通／大型箱子並關閉 物品被吃掉、Verity 在該處生成
指令 /recoververity 世界裡目前沒有 Verity 時可用 1 小時冷卻；不能同時召出兩個
創造模式物品欄 搜尋「Verity™」創造頁籤 4 個物品都在裡面

沒有任何合成配方——生存模式下手電筒與 Verity 由事件自動給予，唱片目前只能從創造物品欄取得。

兩種跟它說話的方式#

按鍵與麥克風流程 [反編譯]；語音辨識品質與延遲需人工實測。

打字聊天#

直接在聊天欄打字即可。Verity 出現後，每一則聊天訊息預設都會送給 AI（設定 requireVerity 預設 false，代表不必提到它的名字）。想讓它只回應含「verity」的句子，把 requireVerity 設成 true。

麥克風（Push-to-Talk）#

按鍵 預設 作用
Talk to Verity V 按住講話、放開送出（不是常時監聽）
Cycle Selected Mic M 沒聲音時按它輪替麥克風裝置

流程：按住 V 開始錄音 → 放開 → 模組把語音轉成文字 → 當成聊天送給 Verity。模組沒有麥克風選單，只用系統偵測到的第一個裝置；選錯就按 M 切換，聊天欄會顯示目前選到哪支。

手電筒沒有按鍵——手持右鍵即可開關。

兩條設定路線：雲端 vs 本機離線#

Verity 要「活過來」需要三個服務：大腦（LLM 對話）、耳朵（STT 語音辨識）、嘴巴（TTS 語音合成）。你可以全走雲端、全走本機、或混用。設定檔在 config/verity-client.toml（改完重啟遊戲生效）。

端點與預設值 [反編譯]；連得上與否需人工實測。

路線 A：雲端（Groq，最省事）#

適合「只想貼一把金鑰就玩」的人。

  1. 去 Groq Console → API Keys 申請一把 API 金鑰（免費方案即可開始）。照做有困難的話，看模組作者的影片教學。
  2. 把金鑰填進 apiKey。
  3. 保持 aiProvider = GROQ、use_ollama = false。

這條路的實際分工（依出廠預設）：

功能 走哪 相關設定
大腦（對話） 雲端 Groq llama-3.3-70b-versatile aiProvider=GROQ
耳朵（語音辨識） 雲端 Groq Whisper useLocalStt=false（預設）
嘴巴（語音合成） 本機 Piper（預設就不外送） useLocalTts=true（預設）

⚠️ 貼上金鑰＝資料會外送。 語音與聊天會送到 Groq。多人伺服器上，金鑰是伺服器主機貼的，等於替全服玩家做了決定。細節見安全頁。

路線 B：本機離線（不外送、免金鑰）#

適合在意隱私、或想完全離線的人。你需要在自己電腦上先跑起對應的本機服務。

本機服務端點 [反編譯]。

  1. 大腦：use_ollama = true，指向本機 LLM 閘道 ollama_url（預設 http://127.0.0.1:4000/v1/，LiteLLM），模型 ollama_ai_model（預設 ollama/qwen2.5:1.5b）。
  2. 耳朵：useLocalStt = true → 用模組內建的 sherpa-onnx Whisper（tiny.en，行程內跑，免另外開服務）；或 use_local_whisper = true 指向外部 Whisper 伺服器 http://127.0.0.1:9000/v1/。
  3. 嘴巴：useLocalTts = true（預設就本機 Piper）；想換 Kokoro 音色則 use_kokoro = true 指向 http://127.0.0.1:8880/v1/。

三項都設好後，安全頁列出的雲端端點就不會被使用。

完整設定欄位、預設值與型別，看「設定表」。卡住了看「疑難排解」。

本頁的操作步驟均由反編譯原碼推得 [反編譯]；「按住講話→辨識→回應」「本機服務連線」等端到端行為尚未實機驗證，屬 需人工實測（怎麼確認：貼上金鑰或啟動本機服務 → 按住 V 說一句話 → 看它是否用聲音回你）。