BZG 莎草纸魔法扩展 (SKSE 插件)

适用于《天际》周年纪念版/特别版

一个Skyrim SE/AE的SKSE插件，为Papyrus提供额外的原生函数，涉及玩家魔法、龙吼、活动效果以及施法事件。
此模组主要为模组作者提供一个轻量级框架/资源，以便更可靠地从Papyrus获取与魔法相关的运行时信息。

作用说明

这个插件提供两大主要功能集。

施法完成事件
一个事件，可在当前角色施法完成或被打断时通知Papyrus脚本。
它允许脚本从以下来源注册施法完成通知：

• 表单
• 参考别名
• 主动效果
  

它同样支持过滤注册，因此脚本可以仅监听特定的法术来源，而不会接收到每一次施法事件。
发送到已注册脚本的事件为：

事件 在BZG施法完成时触发(施法者 akCaster, 来源 akSource, 施法来源类型 aiCastingSource, 是否被打断 abInterrupted)
结束事件

这对于需要在法术、能力、卷轴、法杖或其他魔法来源实际完成或被中断后作出反应的模组来说非常有用。

玩家魔法/龙吼工具函数
BZG_PapyrusMagics还添加了原生的Papyrus辅助功能，用于检查和获取玩家已知的与魔法相关的数据。
此外，这些获取函数将大体上与游戏内魔法菜单中可用的魔法数据相匹配。

包含的功能允许Papyrus脚本：

• 获取玩家拥有的 法术 作为法术[]
• 获取玩家拥有的 法术 作为 Form[]
• 获取玩家所拥有的 喊叫 作为Shout[]
• 获取玩家拥有的 喊叫 作为 Form[]
• 获取玩家信息 当前启用的效果 作为ActiveMagicEffect[]
• 获取玩家的 当前激活效果 作为Form[]
• 检查玩家是否已学习特定内容 法术
• 检查玩家是否已经学会了特定技能 喊叫
  

Papyrus API

Form[] Function GetOwnedSpellForms() Global Native
Spell[] Function GetOwnedSpells() Global Native

Form[] Function GetOwnedShoutForms() Global Native
Shout[] Function GetOwnedShouts() Global Native

Form[] Function GetPlayerActiveEffectForms() Global Native
ActiveMagicEffect[] Function GetPlayerActiveEffects() Global Native

Bool函数 PlayerHasLearnedSpell (法术 a_spell) 全局 原生
Bool Function PlayerHasLearnedShout(Shout a_shout) Global Native

强制转换完成的注册函数也可以从同一个脚本中调用：

Function RegisterForm(Form akForm) Global Native
Function UnregisterForm(Form akForm) Global Native

函数 RegisterAlias(Alias akAlias) 全局 原生
函数 UnregisterAlias(别名 akAlias) 全局 原生

Function RegisterActiveEffect(ActiveMagicEffect akEffect) Global Native
函数 UnregisterActiveEffect(ActiveMagicEffect akEffect) 全局 原生

函数 RegisterFormFiltered(Form akForm, Form akSource) 全局 原生
函数RegisterAliasFiltered(别名akAlias, 表单akSource) 全局原生
函数 RegisterActiveEffectFiltered(ActiveMagicEffect akEffect, Form akSource) 全局 原生

Function ClearRegistrations() Global Native

安装
使用您常用的模组管理器进行安装。
此模组包含：

SKSE/Plugins/BZG_PapyrusMagics.dll
Scripts/BZG_PapyrusMagics.pex

原文本为空，请提供需要翻译的内容。

 Scripts/source/BZG_PapyrusMagics.psc

为模组作者提供。

兼容性
此插件不会修改游戏存档、任务、法术、技能或等级列表。
这是一个SKSE/Papyrus实用插件，旨在与大多数模组兼容。
请勿同时安装已合并插件的旧版独立版本，如果您之前是分开使用它们的话。

面向Mod作者

BZG_PapyrusMagics旨在减少处理玩家魔法状态和施法流程时对脆弱的Papyrus变通方案的需求。
典型用例包括：

• 检测法术施放实际结束的时机
• 检测被打断的施法
• 构建自定义法术或 shouts 菜单
• 追踪已学习的法术和龙吼
• 读取当前玩家的活跃效果
• 筛选对特定魔法源的反应
  

所有功能均由单个Papyrus脚本公开：

BZG_PapyrusMagics

备注

此模组本身不添加任何游戏玩法功能。
它主要是一个供其他模组或高级Papyrus脚本使用的实用/框架插件。