Wiki 条目

Starminer 模组入门

StarminerBridge 拥有官方清单模式、示例、验证脚本和包规则的所有权。此页面将这些规则转化为第一个公共门户条目。

模组作者设置

从 StarminerBridge 清单模式或已验证的官方示例开始。在本地测试模组时，针对复制的 Starminer 安装进行操作。

powershell -ExecutionPolicy Bypass -File .\tools\Starminer.NewMod.ps1 -Name MyMod
powershell -ExecutionPolicy Bypass -File .\tools\Starminer.ValidateManifests.ps1 -Root ".\MyMod"

清单文档 API 合约桥接层版本

运行时配置文件

管理器安装 StarminerBridge 所需的固定 UE4SS 运行时配置文件，此门户也会镜像该配置。

GET /api/v1/runtime/latest.json

模组依赖 starminer.bridge；它们不捆绑 UE4SS。

包合约

Starminer 模组包包含一个顶级模组目录或一个根级清单。

ExampleMod/
  manifest.json
  Scripts/
    main.lua
  Binaries/
    Win64/
      ExampleMod.dll
  Paks/
    ExampleMod-WindowsNoEditor.pak
  Config/
    ExampleMod.ini

清单基础

第一个门户 API 追踪管理器在安装前所需的字段。

稳定的小写 ID 匹配 ^[a-z0-9][a-z0-9._-]{1,63}$。
语义版本，例如 0.1.0。
目标 Starminer 游戏构建。
ue4ss-lua、ue4ss-cpp 或 pak 的入口点。
通过 loadAfter 显式指定加载顺序。

依赖

官方 DataTable pak 模组应在管理器元数据和包清单中都声明桥接层依赖。

{
  "dependencies": {
    "starminer.bridge": ">=0.1.7-dev-preview"
  },
  "loadAfter": [
    "starminer.bridge"
  ]
}

验证

在上传 ZIP 到门户之前运行本地验证。

powershell -ExecutionPolicy Bypass -File .\tools\Starminer.ValidateManifests.ps1 -Root ".\MyMod"

门户验证将拒绝绝对路径、遍历路径、意外的可执行文件位置、防病毒扫描失败、不允许的文件签名、归档内容策略违规、清单元数据不匹配以及无法安全哈希的归档文件。

发布路径

在账户启用后创建免费的模组作者账户。
从官方 DataTable 模板或现有的官方跟踪模组构建版本化 ZIP。
上传包和清单元数据。
等待验证和审核。
已发布的版本会出现在目录和管理器 API 中。

公共上传流程接受来自已验证模组作者账户的已审核 ZIP 和 sidecar 元数据，然后通过验证和审核后才会进行目录发布。手动导入器仍然是受控维护和恢复的操作员后备方案。

打开上传流程查看目录 JSON API 合约官方 DataTable 示例 ObjectDefinitions 调整包

故障排查

如果管理器显示模组不兼容，请对比模组的 targetGameBuild 与运行时配置文件的构建版本。
如果模组需要桥接层更新，在启用模组前安装最新的 starminer.bridge 版本。
如果包被拒绝，检查绝对路径、.. 遍历路径、缺失的清单字段或意外的可执行文件位置。
如果模组未加载，确认管理器已在 ILLSpace/Binaries/Win64/Mods/mods.txt 中启用它。
如果 UE4SS 无法启动，使用运行时配置文件确认所需文件位于 ILLSpace/Binaries/Win64 中。