
血统脚本扩展器(BLSE)
受SKSE启发,Bloodlines Script Extender通过新的Python脚本函数、游戏事件、原生插件支持以及面向模组作者的工具,扩展了《吸血鬼:避世血族》,为更宏大的模组提供了基础。
查看大图[size=6][b]Bloodlines Script Extender (BLSE)[/b][/size]
BLSE 是《[i]吸血鬼:避世血族[/i]》的脚本扩展器。它的灵感来自天际脚本扩展器(SKSE):一个小的共享层,让模组作者能够做到游戏自身脚本无法做到的事情,并让多个模组可以协同工作,而不是各自单独修补游戏。
BLSE 本身不会改变游戏中的任何内容。它为其他模组(Python 脚本和原生插件)提供可响应的事件、可调用的函数,以及更安全的方式来改变游戏行为。如果你只想游玩需要它的模组,安装 BLSE 就是你唯一需要做的事。
[b][url=https://github.com/bigbannng/bloodlines-script-extender]GitHub[/url] ―[/b] [url=https://bigbannng.github.io/blse-dev/]文档[/url](与 docs/ 中相同的指南和参考,更便于浏览)。
[size=5][b]亮点[/b][/size]
[list] [][b]无需改动游戏文件即可运行 Python 模组[/b] – 将 .py 文件放入文件夹,它就会在游戏启动时在游戏自身的 Python 中运行。[/] [][b]原生 C++ 插件[/b] – 具有与 Python 模组相同功能的 DLL,外加对游戏代码的安全挂钩和崩溃隔离。[/] [][b]模组文件夹[/b] – 一个模组就是一个包含模型、声音、地图、对话和数据的文件夹。多个模组可以同时向同一个数据文件或同一张地图添加内容,删除文件夹即可移除模组。[/] [][b]超过 70 种游戏事件[/b] – 死亡、伤害、击杀、任务、对话、戒律、物品、关卡变化、存档、按键、角色创建。[/] [][b]规则修改[/b] – 伤害、戒律的使用和消耗、对话台词和回复、物品数据、NPC AI、实体输入。[/] [][b]添加新内容的能力[/b] – 新的对话、回复、日志任务、新物品和武器、游戏模型的新动画,以及作为同伴跟随玩家的 NPC。[/] [][b]角色和动画[/b] – 缩放模型和单个骨骼、面部、皮肤、色调、材质;在任何 NPC 上播放任何动画,或更改游戏选择的动画。[/] [][b]界面[/b] – 游戏上方的文本、框体、图像、可点击元素和文本字段、模组窗口、重新设计的游戏界面、按钮音效,以及插件的 Direct3D 绘制。[/] [][b]已保存数据[/b] – 保存在存档中的值、任何 NPC 或对象上的值、共享数据库中的值、JSON 文件中的值以及玩家可编辑的设置中的值。[/] [][b]指明模组的崩溃报告[/b] – BLSE 将其所知的信息添加到游戏的崩溃日志中,并捕获游戏未报告的崩溃。[/] [/list][size=5][b]要求[/b][/size] [list] []带有[b]非官方补丁[/b](Basic 或 Plus)的《[i]吸血鬼:避世血族[/i]》。BLSE 通过该补丁提供的模组加载器加载。[/] [/list]BLSE 能识别非官方补丁生成的游戏版本。在它无法识别的版本上,Python API、插件和不依赖游戏代码的事件仍然可以工作,其余功能会自动关闭(见 blse.log)。
[size=5][b]安装[/b][/size]
[list=1] []下载发布版 zip 并解压到任意位置。[/] []将 zip 中的 Bin 文件夹复制到游戏文件夹(包含 Vampire.exe 的那个文件夹),与现有的 Bin 文件夹合并。这会添加 Bin/loader/blse.vtm 以及文件夹 Bin/loader/blse/scripts(Python 模组)、Bin/loader/blse/plugins(原生插件)和 Bin/loader/blse/mods(模组文件夹)。[/] []启动游戏。打开控制台并输入 blse:它会显示 BLSE 的状态、已加载的插件和模组,以及模组添加的控制台命令。[/] []按照模组作者描述的方式安装需要 BLSE 的模组:通常是将 .py 文件放入 scripts、将 .dll 放入 plugins 或将文件夹放入 mods。[/] [/list]一个同伴模组和一个冲刺模组作为单独的可选下载提供。日志会写入 Bin/loader/blse/blse.log(上一次运行的日志为 blse.log.old);报告问题时请附上该日志。
[b]卸载:[/b]删除 Bin/loader/blse.vtm 和 Bin/loader/blse 文件夹。
[size=5][b]功能详解[/b][/size]
[size=4][b]模组及其加载方式 [/b][/size] [b]Python 模组。[/b]Bin/loader/blse/scripts 中的每个 .py 文件都会在游戏启动时运行,无需编辑任何游戏文件。《避世血族》本身已经用 Python 运行自己的脚本,但没有地方添加你自己的脚本:对它进行模组制作意味着替换游戏文件,而且脚本只有在某个地图、某句对话或引擎调用游戏自身的某个脚本函数时才会运行。BLSE 为这个相同的 Python 提供了一个模组文件夹,外加事件(死亡、伤害、物品、任务、关卡变化、按键)和能够触及游戏脚本无法触及之处的函数(伤害规则、戒律、对话、NPC AI、生成、屏幕 UI)。模组可以添加自己的控制台命令,而失败的脚本会被记录,不会阻止其他脚本运行。
[b]原生插件。[/b]Bin/loader/blse/plugins 中的 32 位 DLL,带有名称、版本和对其他插件的依赖,适用于需要 C++ 速度或触及范围的模组。BLSE 插件就是一个 DLL,和任何 .vtm 一样,但你不必寻找游戏代码、手动挂钩或从头构建一切。BLSE 为插件提供与 Python 模组相同的事件和函数、一个共享消息系统以便插件和 Python 模组协同工作,以及一个挂钩系统:它首先检查游戏代码,并拒绝会与另一个模组重叠的补丁。如果某个插件在 BLSE 调用它时崩溃,BLSE 会禁用该插件并记录是哪一个,因此游戏通常可以继续运行。其他位置的崩溃(插件自身的线程,或它自己修补的代码)仍然可能导致游戏崩溃,此时崩溃日志会指明该插件。
[b]模组文件夹。[/b]一个模组可以是 Bin/loader/blse/mods 中的一个文件夹。它的游戏文件(模型、材质、声音、地图、对话、数据)会被游戏当作自己的文件找到,而不会替换游戏文件夹中的任何内容。多个模组可以同时更改同一个文件:
[list] [][b]合并文件[/b] 逐键添加到游戏的数据文件(任务、物品、商人库存、角色创建、属性)中,而不是替换它们。[/] [][b]对话台词[/b] 可以逐行合并,纯文本文件可以在开头或结尾扩展。[/] [][b]地图补丁[/b] 在地图加载时添加、移除或更改其实体。[/] []config/loadorder.txt 设置加载顺序(靠后的模组优先),mod.ini 为模组提供名称和版本,模组可以自带 Python 模块和脚本。[/] []BLSE 拒绝会破坏游戏的更改,例如戒律数量不同的 stats.txt,并在日志中说明原因。[/] [/list][b]模组间的协作。[/b]Python 模组和插件发布和订阅相同的消息。来自多个模组的规则(伤害、戒律、对话、动画)按固定的、有文档记载的顺序组合,模组文件夹之间的冲突会列在日志中。
[size=4][b]事件[/b][/size]
[list] [][b]关卡和帧事件[/b] – 关卡变化(以及下一个关卡去向)、每一帧、游戏保存、加载、加载失败、新游戏、引擎重启。[/] [][b]实体输出[/b] – 游戏实体触发的每个输出(OnDeath、OnTrigger 等),以及由谁触发。[/] [][b]战斗[/b] – 攻击、伤害、击杀、推搡、战斗和潜行状态变化、每个 NPC 的战斗。[/] [][b]玩法[/b] – 任务、对话台词和选择、戒律使用、属性变化、物品的拾取、给予、装备和使用、实体的出现和消失、玩家正在看或使用的东西。[/] [][b]角色创建[/b] – 每个问卷屏幕和答案、选择的氏族、性别、历史和点数,以及完成的角色。[/] [][b]动画[/b] – 任何角色上动画的开始和结束。[/] [][b]输入和屏幕[/b] – 按键、鼠标按钮和游戏操控(无论绑定到哪个键)、游戏屏幕和菜单的打开和关闭、控制台变量变化。[/] [/list][size=4][b]改变游戏[/b][/size]
[list] [][b]伤害[/b] – 在伤害生效前更改、缩放或取消伤害,可按攻击者、受害者、武器或伤害类型。[/] [][b]戒律[/b] – 阻止玩家、某类 NPC 或某个角色使用某个戒律,或更改其消耗。[/] [][b]对话[/b] – 隐藏回复、重写台词、读取对话的条件。添加全新的对话,以及在游戏自身台词下方添加回复,可与其他模组并列,使用 Python 函数作为条件和动作。日志任务通过合并游戏的任务文件添加。[/] [][b]实体输入[/b] – 阻止或更改发送给实体的输入(门、按钮、脚本化序列)。[/] [][b]物品[/b] – 读取和更改名称、描述、价格和重量;为玩家、NPC 和容器给予、移除、丢弃、移动和装备物品。[/] [][b]NPC AI[/b] – 设置关系和敌人、启动日程、将 NPC 送往某处或让其跟随、将其冻结在原地、设置视觉和听觉、安抚或激怒它们。[/] [][b]生成和传送[/b] – 创建实体、移动任何实体、更改其键值(重命名 NPC、给它一个对话)。[/] [][b]角色创建[/b] – 更改可选氏族,或某个氏族变成什么。[/] [][b]相机和声音[/b] – 视野、相机位置和视角、播放和停止声音及 UI 音效。[/] [][b]控制台变量[/b] – 读取和设置游戏设置,并在它们变化时收到通知。[/] [/list][size=4][b]新内容[/b][/size]
[list] [][b]新物品和武器[/b] – 新物品的行为类似游戏中的某个物品(武士刀、手枪、血包、钥匙),但拥有自己的数据:名称、描述、模型、图片、价格、伤害、弹匣和音效。它在游戏创建物品的所有地方都能工作:地图、商人、控制台的 give、存档。没有代码的模组可以在每个物品的数据文件旁边的文本文件(blse/items.txt)中列出它们的物品。[/] [][b]新对话和任务[/b] – 见上文的对话;多个模组可以向同一个 NPC 添加内容。[/] [][b]新动画[/b] – 动画文件在游戏模型加载时添加到其中,无需编辑任何模型。新动画排在游戏自身动画之后,因此存档和游戏动画继续工作,多个模组可以向同一个模型添加内容。模组也可以按名称替换动画。[/] [][b]同伴[/b] – 一个 NPC 带着其完整状态随玩家穿越关卡变化,跟随、在玩家身边战斗,并在被告知时等待。[/] [/list][size=4][b]角色和动画[/b][/size]
[list] [][b]模型[/b] – 缩放整个模型,以及缩放、移动和旋转单个骨骼。[/] [][b]面部[/b] – 保持面部表情。[/] [][b]外观[/b] – 更改皮肤、身体组、色调和透明度,并为一个角色提供其他材质。可选择保存在存档中。[/] [][b]动画[/b] – 列出模型的动画,在任何 NPC 上播放其中任何一个(一次、循环或保持),读取角色正在播放的动画,并设置规则以更改游戏为某个活动选择的动画。[/] [/list][size=4][b]界面[/b][/size]
[list] [][b]屏幕文本[/b] – 屏幕中间或顶部的消息,或控制台中的消息。[/] [][b]HUD 覆盖层[/b] – 绘制在游戏上方的文本、框体、图像、形状、可点击元素和文本字段,可选择也绘制在其菜单上方,可使用你自己的字体。[/] [][b]游戏自身的屏幕[/b] – 读取、重新设计并添加到游戏的面板:标签、按钮、图像、文本字段、复选框、滑块、下拉菜单、进度条和滚动列表。[/] [][b]窗口和替换屏幕[/b] – 模组可以打开自己的窗口,或阻止游戏屏幕打开并显示自己的屏幕。[/] [][b]按钮音效[/b] – 为游戏菜单的任何按钮提供自己的悬停、按下和点击音效。[/] [][b]Direct3D 绘制[/b] – 原生插件可以使用游戏自身的 Direct3D 9 设备在 BLSE 覆盖层的下方或上方绘制:模糊背景、发光、自定义形状。可与游戏的普通渲染器和 DXVK 一起工作。[/] [][b]键鼠[/b] – 读取按键和操控、阻止按键、为玩家按下按键、在游戏中显示鼠标光标。[/] [/list][size=4][b]数据[/b][/size]
[list] [][b]存档数据[/b] – 模组保存在存档游戏中的值。[/] [][b]实体上的值[/b] – 附加到任何 NPC 或对象上的命名值,随游戏保存并在模组之间共享。[/] [][b]共享数据库[/b] – 一个结构化文档,随游戏保存,Python 模组和插件都可读写。[/] [][b]设置文件[/b] – Bin/loader/blse/config 中的 .ini 文件,玩家可以编辑。[/] [][b]JSON 文件[/b] – 由每个存档共享的结构化数据文件。[/] [][b]翻译[/b] – 每种语言的文本,根据玩家的 Windows 语言选择。[/] [/list][size=4][b]健壮性[/b][/size]
[list] [][b]崩溃报告[/b] – 游戏自身的崩溃日志会得到一个 BLSE 部分,说明正在运行哪个模组;游戏未报告的崩溃会得到带有小型转储的 BLSE 日志。两者都会说明寄存器和堆栈指向什么。[/] [][b]插件隔离[/b] – 在 BLSE 代码内部崩溃的插件会被禁用,而不会导致游戏崩溃。[/] [][b]版本识别[/b] – BLSE 在触及游戏代码之前检查游戏文件,每个需要游戏代码的功能在挂钩之前都会再次检查。[/] [][b]未使用时轻量[/b] – 较大的功能仅在模组首次使用时安装其挂钩,其余功能只做快速检查,因此没有模组的 BLSE 对游戏几乎没有开销。[/] [][b]泄漏检查[/b] – 控制台命令 blse_debug 显示游戏内存和 BLSE 持有的内容,以便跨加载进行比较。[/] [/list][size=5][b]制作模组[/b][/size]
面向模组作者的文档位于[url=https://bigbannng.github.io/blse-dev/]网站[/url]和 [url=https://github.com/bigbannng/bloodlines-script-extender/blob/main/docs/README.md]docs/[/url] 中:[url=https://github.com/bigbannng/bloodlines-script-extender/blob/main/docs/python/getting-started.md]Python 模组[/url]、[url=https://github.com/bigbannng/bloodlines-script-extender/blob/main/docs/plugins/getting-started.md]原生插件[/url]、[url=https://github.com/bigbannng/bloodlines-script-extender/blob/main/docs/python/mod-folders.md]模组文件夹[/url]以及[url=https://github.com/bigbannng/bloodlines-script-extender/blob/main/docs/installing.md]安装和故障排除指南[/url]。发布版 zip 包含一个 SDK 文件夹,其中有插件头文件和示例,包括作为 Python 脚本和作为插件的冲刺模组;相同的文件也在此处的 include/ 和 examples/ 中。
[size=5][b]AI 披露[/b][/size]
BLSE 的绝大多数代码是在 AI 的帮助下完成的。一个如此规模、涉及如此多游戏逆向工程的项目,是我无法独自完成的,因此代码和文档是与 AI 助手一起编写的。我指导开发、进行手动编辑和调整、在游戏内测试模组,并报告问题以供修正。
[size=5][b]致谢[/b][/size] [list] [][b]SKSE 团队[/b],感谢天际脚本扩展器,它展示了脚本扩展器应该为模组作者提供什么,BLSE 以其为范本。[/] [][b]JContainers[/b]、[b]PapyrusUtil[/b] 和 [b]PapyrusExtender[/b],这些天际模组启发了 BLSE 的共享数据库、实体值、JSON 文件和设置文件,以及其额外的实体函数。[/] [][b]Crash Logger[/b],它启发了 BLSE 崩溃报告中的细节。[/] [][b]非官方补丁[/b]团队,他们的加载器使 BLSE 成为可能。[/] []Troika Games,感谢这款游戏。BLSE 是一个粉丝项目,与 Troika、Activision 或 Paradox Interactive 无关。[/] [/list][size=5][b]许可证[/b][/size] BLSE 在 [url=https://github.com/bigbannng/bloodlines-script-extender/blob/main/LICENSE]MIT 许可证[/url]下发布。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。