B.A.R.K.

[size=6][b]B.A.R.K.[/b][/size]

[i]一个可制作、会死亡的基地防御哨戒人偶，带有可配置的目标选择模式，适用于 Valheim。[/i]

[b]B.A.R.K.[/b]（Battle-Automaton Robotic Knight，战斗自动机械骑士）是一台装甲基地防御哨戒人偶，配备可配置的目标选择模式、可自定义的战斗属性和完整的多人同步——同时完全不影响原版 T.W.I.G. 训练假人。

在锤子的防御分类下建造 B.A.R.K.，它会通过向敌对入侵者投掷精准的石弹、与玩家切磋，或以被动哨兵模式站岗来保卫定居点。哨戒单位具备持久的单台模式与射程记忆、实时视觉指示光效、可自定义的护甲与萝卜头外观，以及服务器权威配置强制。

[line]

[size=5][b]特性[/b][/size]

[list]
[][b]专用防御哨戒[/b]：使用核心木材和铁钉，直接从锤子建造菜单的防御分类中制作 B.A.R.K.。[/]
[][b]不受影响的原版切磋假人[/b]：完全保留 piece_TrainingDummy 不变，仍为不朽、安全的 1 点伤害训练伙伴。[/]
[][b]会死亡且可修复[/b]：哨戒单位拥有生命值，会受到怪物和袭击的伤害，可用锤子修复，并在脱战后缓慢自我修复。[/]
[/list]
[size=4][b]战斗与弹道[/b][/size]

[list]
[][b]高速石弹齐射[/b]：投掷石头时带有弹道轨迹补偿且无阻力，确保在 40 米内所有距离直接命中目标。[/]
[][b]防自爆保护[/b]：内置 PhysX 碰撞过滤，防止过大的投射物在人偶或附加护甲上引爆。[/]
[][b]可配置投射物缩放[/b]：通过 ProjectileScale 将投掷的石块尺寸从小石子自定义到攻城石。[/]
[][b]持续 360 度追踪[/b]：哨戒单位会平滑转向已获取的目标，追踪接近的敌人，没有盲区。[/]
[/list]
[size=4][b]目标选择与动态模式[/b][/size]

[list]
[][b]仅敌人（默认）[/b]：防御敌对森林生物、入侵者和袭击事件。[/]
[][b]玩家与敌人[/b]：攻击范围内的怪物和玩家。[/]
[][b]仅玩家[/b]：作为玩家的主动战斗切磋伙伴。[/]
[][b]被动[/b]：原地待命，不获取目标也不投掷石头。[/]
[][b]单台射程预设[/b]：将单个哨戒单位调整为在 10m、15m、20m、30m 或 40m 距离交战。[/]
[][b]模式指示光效[/b]：漂浮的发光球体指示当前目标模式（绿色 = 敌人，橙色 = 两者，红色 = 玩家，灰色 = 被动）。[/]
[/list]
[size=4][b]外观与自定义[/b][/size]

[list]
[][b]装甲外观重做[/b]：配备金属深色木纹身体着色、铁头盔和条带盾。[/]
[][b]Jack-o-Turnip 头[/b]：具有雕刻、发光的 Jack-o-turnip 灯笼头，内部有烛光。[/]
[][b]自定义装备[/b]：可装备其他原版头盔和盾牌，或通过配置禁用装备。[/]
[][b]自定义纹理加载[/b]：将名为 bark_diffuse.png 的 PNG 纹理放入 BepInEx/plugins/BARK/textures/ 即可自定义哨戒单位身体皮肤。[/]
[/list]
[line]

[size=5][b]操作与按键（如适用）[/b][/size]







[table][tr][td][b]操作[/b][/td]
[td][b]快捷键[/b][/td]
[td][b]说明[/b][/td]
[/tr]
[tr][td][b]循环切换目标模式[/b][/td]
[td]E[/td]
[td]循环切换目标模式（仅敌人、玩家与敌人、仅玩家、被动）[/td]
[/tr]
[tr][td][b]循环切换攻击射程[/b][/td]
[td]潜行 + E[/td]
[td]循环切换攻击射程预设（10m、15m、20m、30m、40m）[/td]
[/tr]
[tr][td][b]切换指示光效[/b][/td]
[td]Shift + E[/td]
[td]切换哨戒单位上方发光的指示球体和灯光[/td]
[/tr]
[tr][td][b]修复哨戒单位[/b][/td]
[td]锤子（攻击）[/td]
[td]将受损的哨戒单位修复至满生命值（消耗背包中的木材）[/td]
[/tr]
[/table]
[line]

[size=5][b]配置[/b][/size]

配置文件会自动生成于 [b]BepInEx/config/com.jubaroo.bark.cfg[/b]。所有设置均可通过配置管理器（例如 BepInEx Configuration Manager 或 ConfigForge）在游戏内调整，或直接编辑：




























[table][tr][td][b]设置[/b][/td]
[td][b]默认值[/b][/td]
[td][b]说明[/b][/td]
[/tr]
[tr][td]Lock Configuration[/td]
[td]true[/td]
[td]若开启，配置将锁定为服务器设置，只能由管理员修改。[/td]
[/tr]
[tr][td]EnableMod[/td]
[td]true[/td]
[td]启用 B.A.R.K. 模组。若禁用，则保留原版行为。[/td]
[/tr]
[tr][td]DebugLogging[/td]
[td]false[/td]
[td]在 BepInEx 日志中启用 B.A.R.K. 目标选择与 AI 的详细调试日志。[/td]
[/tr]
[tr][td]ShowStatusNotification[/td]
[td]true[/td]
[td]切换 B.A.R.K. 的目标模式或射程时，在屏幕左上角显示通知。[/td]
[/tr]
[tr][td]ShowStatusIndicator[/td]
[td]true[/td]
[td]在 B.A.R.K. 头顶显示发光指示球体，指示其当前目标模式。[/td]
[/tr]
[tr][td]AllowPassiveWildlifeTargeting[/td]
[td]false[/td]
[td]敌人模式是否也应攻击鹿和野兔等被动野生动物。[/td]
[/tr]
[tr][td]TargetTamedCreatures[/td]
[td]false[/td]
[td]敌人模式是否应以玩家的驯养生物为目标。[/td]
[/tr]
[tr][td]Health[/td]
[td]500[/td]
[td]B.A.R.K. 战斗哨戒单位的最大生命值。[/td]
[/tr]
[tr][td]Damage[/td]
[td]40[/td]
[td]B.A.R.K. 战斗哨戒单位造成的攻击伤害。[/td]
[/tr]
[tr][td]AttackRange[/td]
[td]20[/td]
[td]B.A.R.K. 侦测敌人并投掷石头的最大射程（米，默认：20m）。[/td]
[/tr]
[tr][td]ProjectileScale[/td]
[td]2[/td]
[td]B.A.R.K. 投掷石弹的尺寸倍率（1.0 = 原版石头，2.0 = 大石块）。[/td]
[/tr]
[tr][td]CoreWoodCost[/td]
[td]5[/td]
[td]制作 B.A.R.K. 所需的核心木材数量[/td]
[/tr]
[tr][td]IronNailsCost[/td]
[td]10[/td]
[td]制作 B.A.R.K. 所需的铁钉数量[/td]
[/tr]
[tr][td]EctoplasmCost[/td]
[td]0[/td]
[td]制作 B.A.R.K. 所需的灵质数量（0 = 禁用）。[/td]
[/tr]
[tr][td]RepairWoodCost[/td]
[td]2[/td]
[td]用锤子修复受损 B.A.R.K. 时从背包消耗的木材数量。[/td]
[/tr]
[tr][td]SelfRepairPerSecond[/td]
[td]1[/td]
[td]B.A.R.K. 闲置（脱战）时每秒恢复的生命值。[/td]
[/tr]
[tr][td]HelmetPrefab[/td]
[td]None[/td]
[td]B.A.R.K. 所装备头盔的预制体名称（例如 HelmetIron、HelmetBronze、Turnip、None）。[/td]
[/tr]
[tr][td]ShieldPrefab[/td]
[td]None[/td]
[td]B.A.R.K. 所装备盾牌的预制体名称（例如 ShieldBanded、ShieldSilver、None）。[/td]
[/tr]
[tr][td]TurnipHead[/td]
[td]true[/td]
[td]为 B.A.R.K. 启用雕刻、发光的 Jack-o-turnip 灯笼头。[/td]
[/tr]
[tr][td]TurnipHeadScale[/td]
[td]1.0[/td]
[td]B.A.R.K. 的 Jack-o-turnip 头缩放倍率（0.1–3.0）。[/td]
[/tr]
[tr][td]TurnipHeadYOffset[/td]
[td]0.0[/td]
[td]Jack-o-turnip 头的垂直高度偏移（米，-1.0 至 1.0）。[/td]
[/tr]
[tr][td]TurnipHeadRotation[/td]
[td]0.0[/td]
[td]Jack-o-turnip 头的 Y 轴旋转偏移（度，-180 至 180）。[/td]
[/tr]
[tr][td]BodyColorTint[/td]
[td]#6A645D[/td]
[td]未使用自定义纹理时，应用于 B.A.R.K. 木质身体的十六进制颜色着色。[/td]
[/tr]
[tr][td]Metalness[/td]
[td]0.35[/td]
[td]B.A.R.K. 身体材质的金属表面反射（0.0 至 1.0）。[/td]
[/tr]
[tr][td]Smoothness[/td]
[td]0.3[/td]
[td]B.A.R.K. 身体材质的光泽度和平滑度（0.0 至 1.0）。[/td]
[/tr]
[/table]
[line]

[size=5][b]安装[/b][/size]

[size=4][b]使用模组管理器（推荐）[/b][/size]
通过 [b]Thunderstore Mod Manager[/b]、[b]r2modman[/b] 或 [b]Gale[/b] 安装：
[list=1]
[]搜索 [b]BARK[/b]。[/]
[]点击 [b]Download with Mod Manager[/b]。[/]
[/list]
[size=4][b]手动安装[/b][/size]
[list=1]
[]确保已安装 [url=https://valheim.thunderstore.io/package/denikson/BepInExPack_Valheim/]BepInExPack Valheim[/url]。[/]
[]解压模组包归档文件。[/]
[]将 [b]BARK.dll[/b] 放入 [b]Valheim/BepInEx/plugins/[/b] 目录。[/]
[]启动游戏！[/]
[/list]
[line]

[size=5][b]兼容性与多人游戏[/b][/size]

[list]
[][b]客户端与服务器[/b]：建议客户端和服务器都安装。客户端需要该模组才能查看模型、UI 提示和目标指示球体；服务器需要该模组以强制权威的生命值、伤害和目标选择同步。[/]
[][b]ServerSync[/b]：专用服务器强制执行配置锁定（Lock Configuration = true），自动将管理员的战斗数值、配方和修复成本复制给所有连接的玩家。[/]
[][b]控制器支持[/b]：通过 Valheim 原生交互系统完全兼容游戏手柄和自定义按键绑定。[/]
[/list]