配置与 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)。
返回 首页