Astar.DatabaseBypass v0.1.0

这是一个面向 SPT 4.1.x 的服务端 Mod，用于绕过 SPT 官方数据库文件的 Hash 一致性校验。

适合自行修改过 SPT 数据库，但因为数据库文件 Hash 与官方记录不一致，导致服务端拒绝继续加载的玩家或 Mod 作者使用。

本 Mod 只绕过 Hash 校验，不负责修复错误数据。

---

主要功能

• 关闭 SPT 数据库导入前的官方 Hash 一致性校验；

• 允许服务端继续尝试加载经过用户修改的数据库文件；

• 不写入、修改或删除数据库文件；

• 不写入、修改或删除玩家存档文件；

• 不替换 SPT 原有数据库加载器；

• 保留正常的 JSON 解析、反序列化和服务端错误处理。

非法 JSON、无效引用、错误字段、类型不匹配以及其他数据库问题，仍然会正常报错。

---

工作原理

SPT 在导入数据库前，会根据官方 Hash 记录检查数据库文件是否发生变化。

Astar.DatabaseBypass 会在当前服务端进程开始导入数据库前，关闭本次加载使用的数据库 Hash 校验。

它只改变当前服务端进程中的校验行为，不会修改磁盘上的数据库文件、Hash 文件或玩家存档。

执行流程大致如下：

启动 SPT 服务端
→ Astar.DatabaseBypass 关闭本次数据库 Hash 校验
→ SPT 按原流程读取数据库
→ 正常执行 JSON 解析和数据反序列化
→ 数据存在错误时，仍由 SPT 正常报错

---

兼容性

SPT 4.1.0：已完成实际运行测试
SPT 4.1.x：按照官方 4.1.x 服务端源码设计兼容
其他主版本：不在当前支持范围内

当前已在 SPT 4.1.0 上完成以下验证：

• 修改数据库文件后能够触发官方 Hash 校验失败；

• 安装本 Mod 后能够绕过 Hash 校验；

• 服务端能够继续进入正常数据库加载流程；

• 非法 JSON 仍然会正常报错；

• 数据库文件在运行前后保持不变；

• 玩家存档文件不会被本 Mod 写入或修改。

后续 SPT 4.1.x 补丁版本如果修改数据库加载方法或服务端内部结构，仍可能需要重新适配。

---

安装方法

1. 关闭 SPT 服务端；

2. 下载并解压正式发布包；

3. 将压缩包中的：

SPT_Runtime

合并到 SPT 安装根目录；

1. 正常启动 SPT 服务端。

安装完成后的文件位置应为：

SPT_Runtime\user\mods\Astar.DatabaseBypass\
├── Astar.DatabaseBypass.dll
├── DISCLAIMER.txt
└── VirusTotal_DLL.txt

这是服务端 Mod，不需要安装到客户端插件目录。

---

如何确认已经生效

启动 SPT 服务端后，控制台会出现类似提示：

[Astar.DatabaseBypass] WARNING
SPT database hash verification has been disabled.
This mod does not write, modify, or delete database
or player profile files.
JSON parsing and normal server errors remain enabled.
Custom and third-party edits are used at your own risk.

看到该提示，说明 Mod 已经成功加载，并关闭了当前服务端进程的数据库 Hash 校验。

运行截图

---

卸载方法

关闭 SPT 服务端，然后删除：

SPT_Runtime\user\mods\Astar.DatabaseBypass

卸载后，SPT 会恢复官方数据库 Hash 校验。

卸载本 Mod 不会撤销此前已经对数据库做出的修改。

---

使用注意事项

1. 本 Mod 不是数据库修复工具

它只能绕过 Hash 校验，不能自动修复：

• JSON 格式错误；

• 缺失字段；

• 错误的数据类型；

• 无效物品 ID；

• 错误模板引用；

• 数据库版本不兼容；

• Mod 之间的数据冲突；

• 其他自定义数据错误。

数据库本身存在问题时，服务端仍然可能启动失败或在运行过程中报错。

2. 用户及第三方修改风险由使用者自行承担

用户自行修改数据库、使用第三方数据库修改工具，或者加载其他人提供的修改数据，即视为已经理解并自行承担这些修改可能带来的风险。

可能出现的问题包括但不限于：

• 服务端无法启动；

• 数据库加载失败；

• 物品、任务或商人数据异常；

• 自定义数据不兼容；

• 第三方 Mod 冲突；

• 与自定义数据有关的存档异常。

Astar.DatabaseBypass 不会主动产生这些数据修改，也不会验证用户或第三方修改是否正确。

3. 建议保留可恢复副本

进行重要数据库修改前，建议保留数据库和玩家存档的可恢复副本。

备份不是安装或运行本 Mod 的强制条件，但能够显著降低错误修改后的恢复成本。

4. 不要安装到其他 SPT 主版本

当前声明范围仅为：

SPT 4.1.x

不要直接安装到 SPT 4.0、未来的 SPT 4.2 或其他主版本。

5. 同类服务端补丁可能产生冲突

如果其他服务端 Mod 同时修改数据库导入、Hash 校验或相关启动流程，可能出现补丁冲突或加载顺序问题。

出现异常时，请优先排除其他同类 Mod。

---

发布包内容

正式 ZIP 内仅包含：

SPT_Runtime\user\mods\Astar.DatabaseBypass\
├── Astar.DatabaseBypass.dll
├── DISCLAIMER.txt
└── VirusTotal_DLL.txt

不包含游戏本体、SPT 服务端文件或其他第三方 Mod。

---

文件校验

正式 ZIP SHA-256

8BFD6C45478E9C6A3E58B914B0B19DA6F965938D5369BDD46B24595404F0026B

DLL SHA-256

CFEBA30DBBABA9D62293AEFB9DBBE87AEA841A46B3D7CB68CE33963EF8065734

GitHub Release 中同时提供：

SHA256.txt
VirusTotal_ZIP.txt

可用于独立核对正式安装包。

---

VirusTotal 检测

正式 ZIP

检测报告：

https://www.virustotal.com/gui/file/8BFD6C45478E9C6A3E58B914B0B19DA6F965938D5369BDD46B24595404F0026B

检测状态：

Status     : completed
Malicious  : 0
Suspicious : 0

DLL

检测报告：

https://www.virustotal.com/gui/file/CFEBA30DBBABA9D62293AEFB9DBBE87AEA841A46B3D7CB68CE33963EF8065734

DLL 的扫描记录也已经随安装包提供：

VirusTotal_DLL.txt

---

免责声明

本 Mod 只负责绕过数据库 Hash 校验。

它不会写入、修改、删除、修复、迁移或验证数据库文件及玩家存档文件。

用户自定义修改或第三方修改造成的启动失败、运行异常、数据冲突、Mod 冲突、存档异常或其他问题，由使用者自行承担，与作者无关。

使用前请阅读安装包内的：

DISCLAIMER.txt

---

作者

Astar