SKSE插件地址库

重要！现在分为两个版本：特别版（1.5.x）和周年纪念版（1.6.x）。指向地址的ID在这两个版本之间将不匹配（游戏可执行文件差异太大，无法匹配，即使它们匹配，这些函数中的代码也不同）。

描述

对于普通mod用户：从文件部分下载并安装“一体化”软件包。您可以使用mod manager或手动操作。.bin文件应该放在这里：
数据/SKSE/插件/
你无需阅读本文的其余部分。

对于SKSE DLL插件作者：
这是一个modder资源（头文件）。您可以加载一个存储偏移量的数据库，这样您的DLL插件就可以独立于版本，而不需要重新编译。可以从文件的可选部分下载头文件。对于周年纪念版，头文件名为versionlibdb.h，而不是versiondb.h！如果你使用的是CommonLib，那么所有这些都已经内置了，你不需要这里的任何东西。


如何使用

最快的方法：


现在你想知道那里的“123”值是什么。这是地址的ID。不同版本的数据库将具有相同的地址ID，但它可能指向不同的值。要获取特定版本的所有ID和值对的列表，请执行以下操作：



用你正在反转并熟悉的版本代替1、5、62、0。您必须首先在/Data/SKSE/Plugins目录中拥有相应的数据库文件。

调用此命令后，您应该在Skyrim主目录中有一个名为“offsets-1.5.62.0.txt”的新文件，或者您指定的文件名。它的格式如下：
十进制ID<制表符>十六进制偏移<换行符>

例如，如果你在1.5.62.0中有一个地址142F4DEF8（玩家角色静态指针），你想使其与版本无关，你可以这样做：
1.在偏移文件中查找2F4DEF8。因为这是没有基数140000000的偏移量
请确认ID为517014（十进制！）
3.如果您希望在运行时将此地址添加到DLL中，请执行以下操作：


void*地址为142F4DEF8=db。FindAddressById（517014）；


在那里你有它。

VersionDb结构具有以下功能：


你应该知道并记住的事情：

1.您可以在插件中包含任何（或所有）数据库文件，但这可能会大大增加文件大小（大约2.5 mb）。到目前为止，将此mod标记为依赖项是很常见的。

2.您应该始终在启动时只加载一次数据库，初始化/缓存所需的地址并让其卸载。卸载只是意味着VersionDb结构体被删除或丢失（如果你在堆栈上分配）。这将确保您在游戏运行时不会使用不必要的内存。在游戏过程中不需要一直加载数据库。如果你使用CommonLib，这是一个没有意义的问题，因为它只加载一次，而不是为每个DLL加载一次。

3.数据库包含函数的地址、全局变量、RTTI、vtable以及任何其他可能引用它的地址。它不包含位于函数中间或全局中间的地址。如果你需要在函数中间有一个地址，你应该查找函数基地址，然后自己添加额外的偏移量。它也不包含无用的东西，例如围绕函数的对齐（在rdata中引用），丢弃pdata部分，丢弃rdata中编译器生成的一些SEH信息。

4.您应该始终检查结果，以确保数据库加载成功（bool Load返回true），并且查询的地址实际上返回了有效的结果（不是NULL）。如果它确实无法加载，则意味着文件很可能丢失或版本错误（例如，试图在AE中使用SE头）。如果查询失败，则表示在该版本中找不到地址。这可能意味着游戏代码发生了足够大的变化，使得地址对该版本不再有效，或者数据库本身无法检测到正确的地址。如果发生上述任何一种情况，您应该使插件初始化失败，让SKSE知道您没有正确加载。或者手动显示错误消息。

5.最好在发布DLL插件之前检查以确保该地址存在于游戏的所有版本中。为此，请加载数据库文件的每个版本，并在每个版本中查询相同的地址ID以确保其存在：


这样你就可以确保你的DLL mod在所有版本中都能工作，或者如果它在某些版本中不起作用，你可以在你的mod页面上写下来。

6.有时你需要根据运行的游戏版本做一些不同的事情。您可以通过以下代码片段来实现：


7.请记住：如果您在调试模式下编译SKSE DLL，数据库的加载时间可能约为14秒！在释放模式下，这大约是0.2秒。这是由于标准库容器在该模式（std-map）下非常慢。


权限

做任何你想做的事。