設定與 GUI 整合指南

首頁 / 設定與 GUI

⚙️ 設定架構與伺服器端權威模型

Vanilla Outsider: Better Dogs 採用雙層設定架構模型，在確保用戶端/伺服器端完全同步的同時，保持伺服器端的絕對權威：

┌─────────────────────────────────────────────────────────┐
│                                 全域設定檔                   │
│                      (config/betterdogs.json)           │
│                  僅為「新建立的世界」定義基準初始預設值                │
└────────────────────────────┬────────────────────────────┘
                             │ (世界建立初始化)
                             ▼
┌─────────────────────────────────────────────────────────┐
│                           活躍世界 GameRules                │
│                          (betterdogs:bd_*)              │
│                   既有已存在世界的動態伺服器端絕對權威                │
└─────────────────────────────────────────────────────────┘

WARNING

全域設定檔生效機制警告: 直接修改磁碟上的 config/betterdogs.json 或在主選單 GUI 中修改設定，僅會影響後續新建立的世界預設值。若要修改既有單人存檔或多人伺服器中的設定，請在遊戲內透過 /gamerule betterdogs:<規則名> <值> 修改，或使用內建指令 /betterdogs set <規則名> <值>。

🎨 用戶端 GUI 設定整合 (ModMenu 與 YACL v3)

當與 ModMenu 和 YetAnotherConfigLib v3 (YACL) 一同安裝時，Better Dogs 會自動啟動優雅的用戶端圖形設定介面：

1. ModMenu 介面整合

在 Fabric 的 ModMenu 模組清單中選中 Vanilla Outsider: Better Dogs 並點擊 設定 (Configure)，即可直接打開圖形設定選單。

2. YACL 設定分類與設定項

YACL v3 設定介面精心組織為以下幾個核心分類：

通用選項 (General Options)：全域速度增益、雷暴焦慮開關、懸崖安全防護以及苦力怕偵測規避。
狼的個性 (Wolf Personalities)：為攻擊型、和平型和普通型分別定制生命值加成、疾跑速度修飾符、攻擊傷害倍率以及跟隨起始距離。
遺傳與繁殖 (Genetics & Breeding)：個性繼承機率、跨個性雜交突變率以及近親治癒開關。
野生領地 (Wild Territoriality)：狼群叢集規模、領地衝突決策矩陣（攻擊型對決、攻擊型對普通型等）以及巡視半徑邊界。
贈禮與獎勵 (Gifts & Rewards)：晨禮友好互動次數門檻與贈禮冷卻時間設定。
視覺與效能 (Visual & Performance Options)：守衛警示粒子濃度（關閉、低、中、高）與近親侏儒粒子開關。

🛡️ 伺服器端防崩潰隔離與門禁安全

所有用戶端 GUI 元件（ModMenuIntegration、YaclScreenHelper）均透過用戶端獨立進入點（entrypoints.modmenu）和執行階段環境檢測嚴密隔離。Better Dogs 可直接部署在無需 ModMenu 或 YACL 的獨立無頭專用伺服器 (Dedicated Server) 上，絕不會發生伺服器端類別載入崩潰 (Classloading Crash)。

返回首頁

設定與 GUI 整合指南 ​

⚙️ 設定架構與伺服器端權威模型 ​

🎨 用戶端 GUI 設定整合 (ModMenu 與 YACL v3) ​

1. ModMenu 介面整合 ​