《PapyrusUtil SE – 模组作者脚本实用功能》（PapyrusUtil SE – Modders Scripting Utility Functions）

❮❯

原文描述
本版本适用于《上古卷轴5：天际特别版》，可在此处获取原版。重要提示：如果你使用的是1.6及以上版本的《天际》，必须安装周年纪念版（AE）版本的PapyrusUtil和地址库。即使你没有周年纪念版DLC也没关系；任何高于1.5.97的版本都被视为AE。请确保你的地址库和SKSE64已完全更新到最新版本。和往常一样，请确认没有模组将最新版的PapyrusUtil覆盖为旧版本（比如Simply Knock、Campfire和Wearable Lanterns这些模组）。如果你仍然在某处收到错误信息，请尝试从Steam直接启动一次默认的《天际》启动器（通过主文件夹里的SkyrimSELauncher.exe），之后再用skse和/或你的模组管理器启动游戏。最新版本仅与Steam上发布的最新版本兼容，当前版本为v1.6.1170。除此之外的任何版本都不受支持，你必须下载与你安装的游戏版本相匹配的旧版PapyrusUtil。显然，如果你拥有GOG版本的1.6.1179游戏，请安装GOG版本。1. 说明 2. 需求 3. 安装 4. 卸载 5. 更新 6. 兼容性与问题 7. 鸣谢 8. 更新日志 1. 说明 这是一个SKSE插件，允许你通过Papyrus脚本在任意表单上或全局保存任意数量的整数、浮点数、表单和字符串值。同时支持这些数据类型的列表。这些值可以从任意模组访问，便于实现轻松的动态兼容。PapyrusUtil.psc
– 版本检查与变量初始化数组。StorageUtil.psc
– 在表单上存储变量和数据列表，可通过表单和变量名作为键取回数据。查看psc文件获取相关文档说明。JsonUtil.psc
– 与StorageUtil.psc类似，但将数据保存到自定义外部.json文件而非表单，让数据可以在游戏外自定义，且独立于用户存档文件存储。MiscUtil.psc
– 一些杂项命令。ActorUtil.psc
– 角色包覆盖。2. 需求 SKSE SE/AE 2.2.6+ http://skse.silverlock.org/ SKSE插件地址库：https://www.nexusmods.com/skyrimspecialedition/mods/32444 3. 安装 使用模组管理器，或手动解压文件。4. 卸载 移除你在安装步骤中添加的所有文件。5. 更新 直接覆盖所有文件即可。6. 兼容性与问题 应与所有内容兼容。7. 鸣谢 exiledviper
– 持续维护与重构原插件的源代码 meh321
– 原版本、创意、地址库适配工作 SKSE团队
– 让该插件的开发成为可能 milzschnitte
– 提供建议 eventHandler、Expired、aers、arha、ianpatt
– SKSE64适配与更新协助 8. 更新日志 4.6 AE/SE
– 2024年1月18日 适配SKSE64 AE/SE 2.2.6与《天际》1.6.1170 4.5 AE/SE
– 2023年12月5日 适配SKSE64 AE/SE 2.2.4与《天际》1.6.1130 4.4 AE/SE
– 2022年1月7日 适配SKSE AE构建版2.2.2 在StorageUtil和JsonUtil中新增ListRandom()函数 修复若干漏洞 4.3 AE/SE
– 2022年1月7日 适配SKSE AE构建版2.1.5 4.2 AE/SE
– 2021年12月14日 适配SKSE AE构建版2.1.4 4.1 AE/SE
– 2021年11月23日 适配SKSE AE构建版2.1.3 适配地址库 4.0 AE/SE
– 2021年11月19日 适配SKSE AE构建版2.1.2 在PapyrusUtil.psc中新增RemoveDupe()、GetDiff()和GetMatching()函数 修复了当关联插件卸载时JsonUtil返回错误表单值的问题 3.9 SE
– 2020年2月4日 修复了从共存档加载FF分配表单的问题 将日志文件位置更改为我的文档/我的游戏/上古卷轴5天际特别版/SKSE/PapyrusUtilDev.log 3.8 SE
– 2019年11月22日 适配SKSE 2.0.17 修复了对来自ESL文件的表单的处理逻辑 3.7b SE
– 2019年6月17日 适配SKSE64 SE 2.0.16 3.7 SE
– 2019年3月19日 适配SKSE 2.0.13-15 新增MiscUtil.FoldersInFolder()函数 3.6b SE
– 2018年9月10日 适配SKSE64 SE 2.0.11 3.6 SE
– 2018年9月10日 适配SKSE64 SE 2.0.9/2.0.10 3.5 SE
– 2018年9月10日 适配SKSE64 SE 2.0.8 修复了MiscUtil的扫描单元格相关函数 3.4b SE
– 2018年4月5日 适配SKSE64 SE 2.0.7 将脚本复制到创造套件路径 /source/scripts 3.4 SE
– 2018年1月5日 重新添加与TFC相关的函数 重新添加ActorUtil包覆盖相关函数 修复了当加载顺序中存在活跃.esl文件时，表单有时会存储/返回错误值的问题 3.3c SE热修复
– 2017年12月4日 适配SKSE64 SE 2.0.6 3.3b SE热修复
– 2017年11月12日 适配SKSE64 SE 2.0.5 重新添加MiscUtil.SetMenus()函数 3.3 SE- 2017年10月21日 首个SKSE64版本发布 3.3
– 2016年9月15日 针对各类崩溃与性能问题进行多项修复 JsonUtil 新功能：新增任意路径函数以支持自定义JSON格式 新增JsonInFolder(string folder)函数，用于获取指定文件夹内的所有JSON文件数组 MiscUtil 新功能：新增ScanCellNPCsByFaction()函数，可在单元格内搜索属于指定阵营的角色 PapyrusUtil 新功能：新增GetScriptVersion()函数，获取当前安装的脚本版本，该版本可能与GetVersion()返回的DLL值不同，具体取决于用户不同的/错误的模组安装情况 修复内容：针对JsonUtil文件处理与缺失值的若干修复 以及许多我此刻无法明确回忆起来的其他修复 3.2
– 2016年1月4日
– 针对各类崩溃与性能问题进行多项修复
– JsonUtil新功能：Unload()
– 将JsonUtil已使用的文件从内存中卸载，可选择先保存修改内容 IsPendingSave()
– 检查指定的JSON文件自上次加载/保存后是否已被修改 IsGood()
– 检查指定的JSON文件当前是否已加载且无错误 GetErrors()
– 如有JSON解析错误，返回格式化后的错误字符串 JsonInFolder()
– 返回指定目录下所有JSON文件的数组
– StorageUtil新功能：CountObj<type>Prefix()
– 统计指定对象上以特定字符串开头的键的数量 ClearObj<type>Prefix()
– 移除指定对象上所有键以特定字符串开头的值
– MiscUtil新功能：FilesInFolder()
– 返回文件夹内所有文件的数组，或指定扩展名的文件数组 ScanCellActors()
– 获取单元格内符合条件的附近角色数组 ScanCellObjects()
– 获取单元格内符合条件的、属于指定表单类型的附近对象数组 WriteToFile()
– 在上次更新中移除后重新添加 ReadFromFile()
– 在上次更新中移除后重新添加 3.1
– 2015年9月1日
– 修复了导致部分用户在加载存档时崩溃的漏洞
– 在StorageUtil和JsonUtil中新增Count<type>Prefix()函数
– 统计以特定字符串开头的键的数量
– 在StorageUtil中新增Clear<type>Prefix()函数
– 移除所有键以特定字符串开头的值
– 在StorageUtil中新增Pluck<type>()函数
– 获取并返回一个值，随后将其从存储中移除
– 在StorageUtil中新增Shift<type>List()函数
– 获取列表的第一个值，随后将其从该列表中移除
– 在StorageUtil中新增Pop<type>List()函数
– 获取列表的最后一个值，随后将其从该列表中移除 3.0
– 2015年8月21日
– 需要SKSE 1.7.3
– StorageUtil与JsonUtil中的Int/Float/String/FormListToArray()函数
– PapyrusUtil.psc中新增各类全新实用函数与数组操作函数
– 其他一些我记不清的新函数，大多与处理或返回数组相关
– 修复各类与崩溃相关的漏洞
– 提升了许多函数的运行性能
– 移除MiscUtil.WriteToFile()、ReadFromFile()、ExecuteBat()函数
– 这些函数使用率极低，存在安全风险，且可通过其他更合适的方式实现相同功能 2.8
– 2014年10月3日
– 修复了导致StringListRemove执行效果与预期完全相反的关键漏洞
– 修复了部分用户在插件加载外部JSON文件进行读取时遇到的崩溃问题
– 在PapyrusUtil.psc中新增Papyrus数组初始化函数 2.7
– 2014年9月9日
– 重新添加包覆盖保存功能
– 在StorageUtil和JsonUtil中新增AdjustInt/FloatValue()和Int/FloatListAdjust()函数，可快捷调整现有值的增减量
– 在JsonUtil中新增ClearAll()函数，用于清空外部JSON文件的内容
– 整理各类原生函数，优化参数校验逻辑以避免潜在崩溃 2.6
– 2014年8月11日
– 修复了尝试加载不存在的外部文件时导致崩溃/卡死的漏洞 2.5
– 2014年8月8日
– 需要SKSE 1.7.1
– 重写插件源代码
– 新增JsonUtil脚本
– 新增ListSlice()函数，用于将列表复制到Papyrus数组中
– 新增ListCopy()函数，用于将Papyrus数组复制到列表中
– 新增ListResize()函数，用于更改列表的长度
– 其他各类漏洞修复与小型新功能