按住分解 - 防止误拆建筑 - Valheim 1.0

[center][size=6][b]按住拆除[/b][/size]
[size=4]防止误拆建筑[/size][/center]

按住拆除为 Valheim 的常规建筑拆除添加了一个简单的安全步骤。

再也不会因为在错误的时机轻点“移除”，而误删墙壁、屋顶部件、箱子平台或精心摆放的装饰了。

[center][b]按住以确认。松开以拆除。[/b][/center]


[size=5][b]功能特性[/b][/size]
[list]
[]防止误拆建筑[/]
[]轻点“移除”不会拆除任何东西[/]
[]按住“移除”以确认操作[/]
[]准星处实时显示确认百分比[/]
[]达到 100% 时显示“就绪”[/]
[]确认后松开即可正常拆除[/]
[]可配置按住时长[/]
[]按钮/操作提示与状态可独立开关[/]
[]可配置准星 UI 的 X/Y 偏移[/]
[]使用 Valheim 自身的“移除”按键绑定显示[/]
[]Alt + 移除的复制部件行为保持原版[/]
[]确认后使用 Valheim 原有的 Player.RemovePiece 逻辑[/]
[]无自定义 Update 循环或协程[/]
[]无自定义物品、预制体、资源或存档数据改动[/]
[]不依赖 Jotunn[/]
[/list]


[size=5][b]工作原理[/b][/size]

装备常规的锤子或其他可拆除部件的建造工具，并瞄准可拆除的建筑部件。

[code]轻点移除
-> 什么都不会发生
-> 建筑部件保留

按住移除
-> 0% ... 100%
-> 就绪

松开移除
-> Valheim 执行正常拆除[/code]
在达到配置的按住时长前松开：

[code]按住移除
-> 48%
-> 松开

拆除已取消[/code]
建筑部件会原地保留不动。



[size=5][b]准星反馈[/b][/size]

使用默认 UI 设置时：

[code][按住移除] 拆除 43%[/code]
达到 100% 时：

[code][松开移除] 拆除 就绪[/code]
显示的“移除”绑定使用 Valheim 自身的按键标记本地化，因此会跟随玩家配置的输入。



[size=5][b]灵活的 UI[/b][/size]

按钮/操作提示与百分比/就绪状态可独立开关。

例如：

[code]ShowButtonHint = false
ShowStatus = true[/code]
此时仅显示当前状态：

[code]43%
就绪[/code]
或者：

[code]ShowButtonHint = true
ShowStatus = false[/code]
此时仅显示按钮/操作提示。

若两项均禁用，按住保护仍会生效，只是不显示自定义准星文本。



[size=5][b]可调位置[/b][/size]

自定义准星提示可水平与垂直移动：

[code]OffsetX = 0
OffsetY = -35[/code]
该偏移仅在“按住拆除”的自定义 UI 可见时生效。

当提示未激活时，Valheim 的常规悬浮文本位置会恢复。



[size=5][b]原版拆除行为[/b][/size]

按住拆除自身不会销毁建筑部件。

Valheim 已经会追踪常规“移除”按钮被按住的时长，并在该输入松开时调用 [b]Player.RemovePiece[/b]。

本模组仅检查按住时长是否达到配置的阈值。

若达到，Valheim 的原始方法会继续正常运行。

这意味着以下事项仍由 Valheim 负责：
[list]
[]目标射线检测[/]
[]移除权限检查[/]
[]结界访问[/]
[]工作台/站点要求[/]
[]CanBeRemoved 检查[/]
[]资源返还[/]
[]所有权与网络同步[/]
[]体力消耗[/]
[]工具耐久消耗[/]
[]效果与动画[/]
[]建筑部件的实际销毁[/]
[/list]
本模组不会替换或复制这些系统。



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

配置文件会在首次启动后自动生成：

[code]BepInEx\config\kumasan.valheim.holdtodeconstruct.cfg[/code]
默认设置：

[code][General]
Enabled = true

[Confirmation]
HoldDuration = 0.75

[UI]
ShowButtonHint = true
ShowStatus = true
OffsetX = 0
OffsetY = -35

[Debug]
DebugLogging = false[/code]

[b]HoldDuration[/b]
控制松开“移除”前需按住的时长，达到后才能拆除目标部件。
默认：
[code]0.75 秒[/code]
允许范围：
[code]0.25 - 3.0 秒[/code]

[b]ShowButtonHint[/b]
显示或隐藏：
[code][按住移除] 拆除[/code]
以及：
[code][松开移除] 拆除[/code]
[b]ShowStatus[/b]
显示或隐藏：
[code]43%
就绪[/code]

[b]OffsetX / OffsetY[/b]
相对于 Valheim 常规准星悬浮文本位置移动自定义拆除 UI。



[size=5][b]需求[/b][/size]
[list]
[]Valheim 1.0+[/]
[]BepInEx 5[/]
[/list]
不依赖 Jotunn。



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

[b]需要 BepInEx 5。[/b]

1. 为 Valheim 安装 BepInEx 5。
2. 下载“按住拆除”。
3. 将压缩包解压到你的 Valheim 安装文件夹。

最终的 DLL 应位于此处：

[code]Valheim
└── BepInEx
    └── plugins
        └── Kumasan.Valheim.HoldToDeconstruct
            └── Kumasan.Valheim.HoldToDeconstruct.dll[/code]
正常启动游戏。

配置文件会在首次启动后自动生成。



[size=5][b]卸载[/b][/size]

删除：

[code]BepInEx\plugins\Kumasan.Valheim.HoldToDeconstruct[/code]
可选的配置清理：

[code]BepInEx\config\kumasan.valheim.holdtodeconstruct.cfg[/code]
按住拆除不会添加任何自定义物品、预制体或世界数据。


[url=https://ko-fi.com/kumasan_][b][size=4]☕ 在 Ko-fi 上支持我[/size][/b][/url]