模组简介

这是专门面向《上古卷轴5：天际 特别版》模组创作者开发的SKSE扩展工具插件，核心作用是通过扩展Papyrus脚本的可用能力，解决原版脚本在自定义数据存储、批量文件处理、角色行为干预等场景下的功能限制，所有功能均为模组作者提供便利的底层调用接口，普通玩家安装后无需手动调整任何参数，即可让其他依赖该插件的游戏模组正常运行。它允许开发者在任意游戏表单或全局维度下存储不限数量的整数、浮点数、表单与字符串类型数据，同时支持对应类型的列表存储，不同模组可通过约定规则读取对应数据，大幅降低了跨模组动态兼容的开发成本，避免多个同类模组同时运行时出现数据冲突或功能覆盖问题。

核心功能要点

提供StorageUtil工具脚本，支持将各类数据直接绑定到指定游戏表单上，以自定义变量名为键即可随时存取对应数据，所有绑定数据会跟随玩家存档同步保存，不会出现存档数据丢失的情况。

提供JsonUtil工具脚本，支持将自定义数据导出到独立的外部.json文件中存储，数据完全独立于游戏存档文件，玩家或开发者可直接在游戏外部编辑JSON内容修改模组配置，无需进入游戏调整参数。

提供MiscUtil工具脚本，集成大量实用的杂项功能命令，包括扫描指定单元格内符合条件的角色、物品对象，遍历读取指定文件夹内的文件列表、目录列表，直接读写外部文本文件等能力，覆盖原版Papyrus脚本无法实现的系统级文件操作需求。

提供ActorUtil工具脚本，实现角色AI行为包的覆盖干预功能，开发者可借助该接口快速调整特定角色的行为逻辑，无需修改原版游戏的AI配置文件。

主脚本PapyrusUtil自带多种数组处理工具函数，支持快速移除数组内重复元素、对比数组差异值、筛选数组内符合匹配规则的内容，大幅简化模组开发时的数组运算代码量。

前置依赖要求

运行该模组需要提前安装适配对应游戏版本的SKSE64 2.2.6及以上版本，以及对应版本的SKSE插件地址库，二者均需要更新到与当前游戏版本匹配的最新稳定版，否则插件将无法正常加载运行。如果你的游戏版本为1.6及以上，哪怕没有安装周年纪念版DLC，也需要选用适配周年版架构的对应版本文件，所有高于1.5.97的游戏版本都属于AE架构范畴，必须对应匹配的插件资源，无法直接使用旧的SE版插件文件。

手动安装步骤

解压模组压缩包后，将压缩包内的所有脚本文件、SKSE插件相关文件按压缩包内说明路径放置，包含PapyrusUtil.psc、StorageUtil.psc、JsonUtil.psc、MiscUtil.psc、ActorUtil.psc等源码文件需要放到创造套件对应/source/scripts目录下，动态链接库、日志配置相关的dll类文件放置到游戏SKSE插件指定目录，插件运行生成的日志文件会默认输出到我的文档/我的游戏/上古卷轴5天际特别版/SKSE/路径下，生成文件名为PapyrusUtilDev.log。所有未明确标注的文件放置规则以压缩包内附带的说明文档为准，请勿随意修改文件后缀或移动存放位置。

版本兼容与注意事项

当前最新正式版本仅适配Steam平台发布的1.6.1170版本游戏，如果你使用的是GOG平台的1.6.1179专属版本，需要单独下载对应适配GOG版本的插件安装包，其他未在更新日志中标注支持的游戏版本均不受官方维护，强行安装很可能出现插件加载失败、存档崩溃等异常问题。安装前需要检查已加载的其他模组，部分常见模组比如Simply Knock、Campfire、Wearable Lanterns可能自带旧版本的PapyrusUtil文件，安装时会直接覆盖新版文件，导致功能调用报错，需要手动确认所有这类自带旧文件的模组，将其附带的旧版插件文件替换为当前安装的新版本，保证全游戏环境内的PapyrusUtil版本统一。如果安装完成后仍然出现脚本相关报错，可以直接通过游戏主目录内的SkyrimSELauncher.exe启动一次原版默认游戏，完成初始化配置后再通过SKSE启动游戏即可解决大部分异常加载问题。该模组本身仅作为底层功能接口存在，和绝大多数非底层修改类模组都不会出现功能冲突，日常游玩过程中玩家无需对其进行任何手动调整即可正常运行，不需要额外修改配置文件参数。

常见问题说明

如果其他依赖本插件的模组提示找不到PapyrusUtil，首先检查对应的SKSE64版本和地址库版本是否更新到与当前游戏版本匹配的最新版，再确认插件的dll文件是否放到了正确的SKSE插件目录下，不要放到错误的路径中导致游戏加载时读取不到文件。如果JSON文件相关的模组功能出现异常，可首先查看位于我的文档目录下的PapyrusUtilDev.log日志文件，日志内会直接标注JSON解析错误的具体位置，方便快速定位配置文件的格式问题。如果更新该模组的版本，直接覆盖所有旧版本的相关文件即可完成更新，无需额外卸载旧文件的步骤，不会影响已生成的存档数据或外部JSON配置文件。卸载该模组时只需要移除所有安装过程中添加到游戏目录的对应文件，重启游戏后所有相关的底层扩展功能都会自动失效，不会在存档内残留冗余数据。