手部动作输入 - Papyrus 扩展 for SKSE

适用于Skyrim AE/SE（不兼容VR）
此模组面向需要一种可靠方式的模组作者，用以让Papyrus脚本模拟玩家通常通过操作界面执行的手部动作。
根据所装备的物品，这些手部动作可能会施放法术、使用法杖、挥动武器、双持攻击、格挡，或触发天际常规输入系统处理的其他手部绑定行为。
这本身并不是一次游戏玩法大改。
这是一个实用插件/模组开发者资源，旨在作为其他模组的依赖项使用。

帕皮鲁斯主要功能

; preferredDevice 数值：
; 0 = 自动：使用最佳可用映射设备
; 1 = 鼠标：使用鼠标按键进行对应手部的攻击/格挡控制
; 2 = 手柄：使用手柄按键绑定来执行对应手的攻击/格挡控制
; 右手：天际控制“右手攻击/格挡”。
Bool Function PressRightHand(Int preferredDevice = 0) Global Native
Bool Function ReleaseRightHand(Int preferredDevice = 0) Global Native
Bool Function TapRightHand(Float holdSeconds = 0.08, Int preferredDevice = 0) Global Native

; 获取玩家当前映射的“右攻击/格挡”输入。
Int Function GetRightHandMappedKey(Int preferredDevice = 0) Global Native
Int Function GetRightHandMappedDevice(Int preferredDevice = 0) Global Native
String Function GetRightHandMappedButtonName(Int preferredDevice = 0) Global Native

; 左手：天际控制“左攻击/格挡”。
Bool Function PressLeftHand(Int preferredDevice = 0) Global Native
Bool Function ReleaseLeftHand(Int preferredDevice = 0) Global Native
Bool Function TapLeftHand(Float holdSeconds = 0.08, Int preferredDevice = 0) Global Native

; 获取玩家当前为“左攻击/格挡”映射的输入。
Int Function GetLeftHandMappedKey(Int preferredDevice = 0) Global Native
Int Function GetLeftHandMappedDevice(Int preferredDevice = 0) Global Native
String Function GetLeftHandMappedButtonName(Int preferredDevice = 0) Global Native

; 手柄状态辅助函数。
Bool Function IsGamepadEnabled() Global Native
Bool Function IsGamepadConnected() 全局原生

; 物理鼠标按键控制。
; 此项直接控制鼠标按键，而非天际的手部映射。
;
; buttonId:
; 0 = 鼠标左键
; 1 = 鼠标右键
; 2 = 鼠标中键
; 3-7 = 额外的鼠标按键，取决于硬件/驱动程序支持
;
; 已按下：
; true = 按下鼠标按键
; false = 释放鼠标按钮
;
; heldSeconds:
; 按下时的可选保持持续时间。若大于0.0，插件将发送
; 在《天际》的任务/游戏线程上自动按下并释放。
;
; 此处不支持鼠标滚轮上下滚动。
Bool Function ControlMouseButton(Int buttonId, Bool pressed, Float heldSeconds = 0.0) Global Native

主要特性

◆ 用于右手动作输入的Native Papyrus函数
◆ 左手动作输入的本地Papyrus函数
◆ 支持短按、松开及定时点击/长按操作
◆ 使用天际的映射手部控制而非硬编码手部按键
◆ 支持键盘/鼠标和手柄对手部动作的按键映射
◆ 可查看每只手当前映射的按键、设备和按钮名称
◆ 包含手柄启用/连接状态辅助功能
◆ 包含鼠标按键0-7的直接物理鼠标按键控制
◆ 专为脚本化装备、法术、法杖、快捷键及战斗辅助系统设计
◆ 轻量级SKSE实用插件
◆ 插件本身无需ESP记录

这是用来干什么的

此资源适用于那些需要在更改玩家装备、当前法术、法杖、武器或快捷键状态后触发手部动作的模组。
示例用法：
◆ 通过自定义快捷键装备法术后自动施放该法术
◆ 通过脚本装备职员后触发该职员
◆ 支持自定义快捷键、环形菜单或工具箱系统
◆ 模拟帕派瑞斯从左或右发动的攻击
◆ 创建脚本化战斗工具行为
◆ 让装备驱动的动作更贴近玩家的原生输入
◆ 检查玩家当前为每个手部动作使用的按键或设备
◆ 在需要时，直接从Papyrus触发现有的鼠标按键

重要说明

此插件不会直接按表单ID“施放法术”、“发射法杖”或“挥动武器”。
相反，手部功能会触发《天际》正常映射的手部动作输入。
这意味着结果取决于玩家当前装备了什么，以及上古卷轴5在当前游戏状态下如何解读那个手部动作。
例如，同样的右手动作可能会根据玩家当前装备的不同，施放法术、用武器攻击、使用法杖或执行其他右手行为。

鼠标按键提示

ControlMouseButton 与 PressRightHand 和 PressLeftHand 不同。
按右手和按左手使用天际的映射手部控制。
ControlMouseButton 直接控制物理鼠标按键：
0代表左键单击，1代表右键单击，2代表中键单击，3-7代表鼠标和驱动程序支持的额外鼠标按键。
不支持鼠标滚轮向上/向下，因为它们不是常规的可按住鼠标按键。

兼容性说明

此插件注册了Papyrus脚本名称BZG_HandActionInput。
如果另一个SKSE插件也注册了相同的BZG_HandActionInput函数，游戏可能只会使用其中一个实现。为了获得最佳兼容性，请避免安装多个注册相同Papyrus脚本和函数名称的DLL，除非它们被设计为可以共存。

呐喊

灵感来源： 更好的鼠标和游戏手柄支持（一个SKSE插件）