按住以放置物品架 - 防止意外放置 - Valheim 1.0

[center][size=6][b]按住以放置物品架[/b][/size]
[size=4]防止意外放置[/size][/center]

按住以放置物品架可防止 Valheim 的物品架在你只想装备或使用快捷栏物品时将其抢走。

[center][b]轻按执行普通快捷栏操作。按住将物品放到物品架上。[/b][/center]


[size=5][b]功能[/b][/size]
[list]
[]防止通过快捷栏按键意外放置到物品架[/]
[]轻按快捷栏按键正常使用或装备物品[/]
[]按住同一按键有意附着物品[/]
[]显示从 0% 到 100% 的确认进度[/]
[]按住时显示当前活动的快捷栏槽位[/]
[]提前松开则改为执行普通快捷栏操作[/]
[]确认前移开视线则改为执行普通快捷栏操作[/]
[]确认后使用 Valheim 原有的 ItemStand 逻辑[/]
[]支持两种原版物品架变体[/]
[]已占用和特殊物品架保持原版行为[/]
[]空闲时无永久逐帧轮询[/]
[]无自定义物品、预制体、资源或存档数据更改[/]
[]无 Jotunn 依赖[/]
[/list]

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

将物品放入快捷栏并瞄准一个空的物品架。

例如：

[code]锤子位于快捷栏槽位 3

轻按 3
-> 锤子执行其普通快捷栏操作
-> 物品架保持为空

按住 3
-> 0% ... 100%
-> Valheim 执行普通物品架放置
-> 锤子被附着[/code]
在达到 100% 之前松开按键：

[code]按住 3
-> 57%
-> 松开

-> 锤子执行其普通快捷栏操作
-> 物品架保持为空[/code]
因此同一个快捷栏按键可同时保留两种行为：

[code]轻按 = 普通物品操作
按住 = 有意放置到物品架[/code]


[size=5][b]智能悬停文本[/b][/size]

在开始按住之前：

[code]物品架
[按住 1-8] 附着物品[/code]
一旦按住某个快捷栏按键，就会显示真实槽位和当前进度：

[code]物品架
[按住 3] 附着物品 64%[/code]
附着操作使用 Valheim 自带的本地化物品架文本。



[size=5][b]支持的物品架[/b][/size]

版本 1.0.0 已使用两种原版展示变体进行测试：
[list]
[]物品架[/]
[]物品架（水平）[/]
[/list]
按住以放置物品架针对的是普通、可移除、非自动展示的物品架。

基于 ItemStand 的特殊对象保持原版行为，包括：
[list]
[]Boss 献祭物品架[/]
[]守护者之力挂钩[/]
[]自动附着物品架[/]
[]不可移除的特殊物品架[/]
[]已占用的物品架[/]
[/list]


[size=5][b]原版附着行为[/b][/size]

按住以放置物品架不会替换 Valheim 的附着系统。

该模组仅将放置延迟到按住达到 100% 为止。

确认后，Valheim 原有的 [b]ItemStand.UseItem[/b] 逻辑执行实际动作。

这意味着 Valheim 仍负责：
[list]
[]检查物品是否可以附着[/]
[]网络与所有权[/]
[]从你的物品栏中移除展示的物品[/]
[]必要时卸下该物品[/]
[]将展示的物品保存在物品架上[/]
[]视觉更新与效果[/]
[/list]
如果 Valheim 不允许某物品放到物品架上，原版行为仍保持控制。



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

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

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

[code][General]
Enabled = true

[Confirmation]
HoldDuration = 0.75

[Debug]
DebugLogging = false[/code]

[b]HoldDuration[/b]
控制允许 Valheim 附着物品之前必须按住快捷栏按键的时长。
默认：
[code]0.75 seconds[/code]
允许范围：
[code]0.25 - 3.0 seconds[/code]


[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.HoldForItemStand
            └── Kumasan.Valheim.HoldForItemStand.dll[/code]
正常启动游戏。

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



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

删除：

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

[code]BepInEx\config\kumasan.valheim.holdforitemstand.cfg[/code]
按住以放置物品架不添加任何自定义物品、预制体或世界数据。


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