智能枪套 - 键盘与手柄 - 英灵神殿 1.0

[center][size=6][b]智能收鞘[/b][/size]
[size=4]轻松切换武器套装[/size][/center]

[b]智能收鞘支持键盘和手柄，并支持自定义控制（手柄），带来无缝的游戏体验。[/b]

厌倦了在相同的武器配置之间来回手动切换？

[b]智能收鞘[/b]将《英灵神殿》的普通键盘收鞘键变为快速的武器套装切换，同时不会移除原有的收鞘 / 拔鞘行为。

[center][b]轻按切换武器套装。长按收鞘。[/b][/center]


[size=5][b]功能[/b][/size]
[list]
[]轻按普通收鞘键，在最近使用的两套武器套装之间切换[/]
[]再次轻按即可立即切换回去[/]
[]长按同一按键执行《英灵神殿》原版的收鞘 / 拔鞘[/]
[]记住完整的左手和右手组合[/]
[]适用于剑 + 盾、斧 + 火把、弓、双手武器等[/]
[]切换到兼容的单手武器时保留你的盾牌[/]
[]对弓和双手武器正确移除不兼容的副手装备[/]
[]可选无《英灵神殿》原版拔武器减速的即时切换[/]
[]可单独关闭收鞘 / 拔鞘动画[/]
[]无自定义物品、预制体或存档数据修改[/]
[]不依赖 Jotunn[/]
[/list]

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

正常装备你的武器套装。

例如：

[code]套装 A：斧 + 火把
套装 B：剑 + 盾[/code]
然后使用《英灵神殿》的普通收鞘键，默认为 [b]R[/b]：

[code]轻按 R
-> 斧 + 火把

再次轻按 R
-> 剑 + 盾

长按 R
-> 《英灵神殿》原版收鞘 / 拔鞘[/code]
默认长按阈值为：

[code]0.35 秒[/code]
如果智能收鞘尚未学习到第二套武器套装，轻按 R 只会回退到《英灵神殿》原版的收鞘操作。



[size=5][b]完整武器套装追踪[/b][/size]

智能收鞘会记住双手的完整组合，而不是只记住上一个单独物品。

这意味着如下配置可以完全按预期工作：

[code]斧 + 火把
<->
剑 + 盾[/code]
或者：

[code]弓
<->
剑 + 盾[/code]
双手会被作为一个完整配置记住。



[size=5][b]智能武器 + 盾牌处理[/b][/size]

智能收鞘理解先装备武器再添加盾牌仍属于同一套武器套装。

示例：

[code]A = 斧

装备剑
装备盾

B = 剑 + 盾[/code]
临时的仅剑状态不会替换你的斧配置。

你记住的套装仍然为：

[code]斧
<->
剑 + 盾[/code]


[size=5][b]合理时保留你的盾牌[/b][/size]

如果你切换到一把最初被记住为没有副手物品的单手武器，智能收鞘会保留你当前持有的盾牌。

示例：

[code]A = 斧
B = 剑 + 盾

从 B 轻按 R
-> 斧 + 盾

再次轻按 R
-> 剑 + 盾[/code]
盾牌不会仅仅因为斧最初是单独装备的而消失。

如果目标武器与盾牌不兼容，仍会应用《英灵神殿》的原版行为。

例如：

[code]剑 + 盾
-> 弓[/code]
盾牌会正常被移除。

双手武器同样如此。



[size=5][b]斧 + 火把？没问题[/b][/size]

智能收鞘会记住完整的双手组合。

例如：

[code]斧 + 火把
<->
剑 + 盾[/code]
轻按 R，完整的斧 + 火把配置会返回。

再次轻按 R，剑 + 盾会返回。

智能收鞘切换的是[b]武器套装[/b]，而不仅仅是上一个单独物品。



[size=5][b]可选无减速切换[/b][/size]

默认：

[code]DisableSwapSlowdown = true[/code]
智能收鞘可以在执行轻按切换时跳过《英灵神殿》原版的拔武器动画。

这避免了通常拔装备时出现的临时移动减速。

如果你更喜欢《英灵神殿》原版的拔武器动画：

[code]DisableSwapSlowdown = false[/code]


[size=5][b]可选收鞘动画[/b][/size]

长按收鞘操作有独立的设置。

默认：

[code]DisableHolsterAnimation = false[/code]
这会保留《英灵神殿》原版的收鞘 / 拔鞘动画。

将其设置为：

[code]DisableHolsterAnimation = true[/code]
即可在没有原版手部动画的情况下收鞘和拔鞘。



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

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

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

[code][General]
Enabled = true

[Input]
HoldDuration = 0.35

[Swap]
DisableSwapSlowdown = true
HistorySettleTime = 0.15

[Holster]
DisableHolsterAnimation = false

[Debug]
DebugLogging = false[/code]

[b]HoldDuration[/b]
控制收鞘键必须按住多久，智能收鞘才会执行原版收鞘 / 拔鞘操作。
默认：
[code]0.35[/code]

[b]HistorySettleTime[/b]
控制手部配置必须保持不变多久，智能收鞘才会将其存储。
这一小段延迟有助于让剑 + 盾等组合成为一个完整武器套装，而不是存储临时的仅剑状态。


[b]DisableSwapSlowdown[/b]
默认：
[code]true[/code]
在轻按切换期间跳过原版拔武器动画，以避免临时移动减速。


[b]DisableHolsterAnimation[/b]
默认：
[code]false[/code]
如果你也希望长按收鞘 / 拔鞘时不播放原版动画，请将其设置为 true。



[size=5][b]输入支持[/b][/size]

版本 1.0.0 修改了[b]键盘收鞘操作[/b]。

《英灵神殿》默认键盘按键为：

[code]R[/code]
手柄收鞘行为保持原版。



[size=5][b]安全性 / 原版行为[/b][/size]

智能收鞘不会创建替换装备，也不会将武器套装存储在角色或世界存档中。

它使用你背包中已存在的真实物品。

智能收鞘不会强制装备：
[list]
[]已不在你背包中的物品[/]
[]耐久度已损坏的物品[/]
[]无效的装备组合[/]
[/list]
空手不会被记录为武器套装。

因此普通收鞘和游泳不会污染你的武器套装历史。



[size=5][b]需求[/b][/size]
[list]
[]《英灵神殿》1.0+[/]
[]BepInEx 5[/]
[/list]不依赖 Jotunn。



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

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

1. 为《英灵神殿》安装 BepInEx 5。
2. 下载智能收鞘。
3. 将压缩包解压到你的《英灵神殿》安装文件夹。

最终的 DLL 应位于此处：

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

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


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

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

[code]BepInEx\config\kumasan.valheim.smartholster.cfg[/code]
智能收鞘不添加任何自定义物品、预制体或世界数据。


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