SurvivalcraftApi 发行版

最新版

API_1.9.0.2

2026-04-03 01:08

最后提交信息为：更新版本号

2026-03-14 02:10

API 1.9

> 这是旧版！[点此查看最新版](https://gitee.com/SC-SPM/SurvivalcraftApi/releases/latest)
## 新增

* 新增网页版，性能约为各系统专用版的一半，需要支持 SharedArrayBuffer、OffscreenCanvas、Origin Private File System 等现代浏览器特性的浏览器，例如最新的 Chrome。打开 [https://scapiweb.netlify.app/](https://scapiweb.netlify.app/) 即可游玩（感谢 Nome Criativo 的初步技术验证和过程帮助）
* 新增手动添加/选择社区服务器的功能，并更新中文社区默认网址
* “设备兼容和日志”界面新增“管理类替换”界面的入口，在这个新界面，你可以管理子系统、实体组件使用哪个模组中的版本，游戏启动时的弹窗也得到改进
* 游戏启动时传入 `-play <存档所在文件夹名称>` 参数，将在启动游戏后自动进入存档
* 模组管理界面新增手动调整模组加载顺序的功能
* 感谢 Kitão Gameplay's（Discord：ekitonmjjefgs）添加葡萄牙语

## 提示

* 最低安卓版本要求提升至 6.0

## 修复

* 完全修复 Android 系统鼠标相关问题
* 修复隐藏移动查看图标后不能跳跃的问题
* 修复一些方块下方是半砖时，底面不渲染的问题
* 修复模组包名不合法时仍然会加载等多个模组加载问题
* 修复游戏过程中启用展示加载日志后，进入存档时会出错的问题
* 修复一个可能导致文本输入框无法使用的问题
* Linux 系统可能的鼠标位置错误问题
* 修复一些界面显示问题

## 改进

* 新的基于 [ANGLE](https://github.com/google/angle) 的 Windows 系统专用兼容包，它通过更广泛支持的 Direct3D 图形接口来接管 OpenGL ES 图形接口，以实现在不支持 OpenGL ES 的显卡驱动上运行游戏；但只支持到 OpenGL ES 3.0
* Android 系统点击文本输入框后会立即弹出键盘
* 性能图示的绿线位置现在会根据屏幕刷新率调整
* 安全模式也能在“模组管理界面”管理模组了
* 导出文件后会显示其路径（之前只显示文件名）
* `modinfo.json` 损坏/不合法时会输出更友好的错误日志
* 不再允许导入文件名相同的模组
* 改善一些中文翻译、越南语翻译

## 对于开发者

**<center>欢迎来到 AI 模组开发时代！</center>**
**<center>推荐使用 HarmonyX 注入方法！</center>**

* 新增适合 AI Agent 从零开始开发模组的文档 [docs/HowToDevelopAMod.md](https://gitee.com/SC-SPM/SurvivalcraftApi/blob/SCAPI1.9/docs/HowToDevelopAMod.md)，你可以尝试向你的 AI Agent 这么说，就能快速得到一个可用的模组（可能存在少量问题）

```
请阅读此文档，帮我做一个在游戏中显示当前天气+距离晴天/下雨还有多久的生存战争插件版模组，最后把做好的 .scmod 文件发给我
https://gitee.com/SC-SPM/SurvivalcraftApi/raw/SCAPI1.9/docs/HowToDevelopAMod.md
```
> AI Agent： 例如 [OpenClaw](https://openclaw.ai/)、[Claude Code](https://claude.com/product/claude-code)、[OpenCode](https://opencode.ai/)、[CodeBuddy](https://www.codebuddy.cn/)

* 项目结构已重构，详见新增的 [架构文档](https://gitee.com/SC-SPM/SurvivalcraftApi/blob/SCAPI1.9/docs/Architecture.md)
* 新增多篇 AI 生成技术文档，详见 [docs](https://gitee.com/SC-SPM/SurvivalcraftApi/tree/SCAPI1.9/docs)
* 新增 [HarmonyX](https://github.com/BepInEx/HarmonyX) 包引用，通过它你可以非常方便地注入、修改、替换方法，使用方法详见此处：[HarmonyX Wiki](https://github.com/BepInEx/HarmonyX/wiki)
* 改进以下三个 xml 数据文件的合并方式（旧写法仍然兼容），同时新增一个专门用来移除继承来的组件的空组件 `ComponentNoEffect`

| 数据类型 | 游戏内文件 | 模组内文件 | 合并方式 |
|----------|------------|------------|----------|
| 衣物表 | `Clothes.xml` | `*.clo` | 按 Index 匹配，支持 `New-` 前缀修改多个属性、`Remove` 删除元素 |
| 合成表 | `CraftingRecipes.xml` | `*.cr` | 追加新合成配方，支持 `New-` 前缀修改单个属性、`Remove` 删除元素（需要其他每个属性都相同） |
| 数据库 | `Database.xml` | `*.xdb` | 追加新数据，按 Guid 匹配，支持 `New-` 前缀修改单个属性、`Remove` 删除元素 |

* `ModsManager.HookAction` 方法新增带有 `int priority` 参数的重载，越小优先级越高
* `ModLoader.OnMinerPlace` 接口方法新增带有 `BlockPlacementData placementData` 参数的重载
* `ModLoader` 类新增以下接口：`OnSwitchScreen`、`OnShowDialog`、`OnHideDialog`
* `Engine.Touch` 新增 `IsTouched` 字段
* `Engine.Window` 新增 `Scale` 字段，用以表示窗口实际渲染大小 / 系统返回的窗口大小
* `ListPanelWidget` 新增 `SwapItems` 方法
* 游戏启动时传入的参数将储存到 `Program` 类的 `Dictionary<string, string> StartupParameters` 字段中，例如：
```bat
Survivalcraft.exe -play World1 -yourCustomParameter 123
```
将设置 `Program.StartupParameters["play"]` 为 `"World1"`，`Program.StartupParameters["yourCustomParameter"]` 为 `"123"`  
对于 Android，等效的代码是
```kotlin
startActivity(Intent().apply {
    component = ComponentName("com.candy.survivalcraftAPI1_9", "com.candy.survivalcraftAPI1_9.crc64251ea0d6925f8f9e.MainActivity")
    putExtra("play", "World1")
    putExtra("yourCustomParameter", "123")
    addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
})
```
* `modinfo.json` 新增 `GameplayImpactLevel`（玩法影响等级）字段，用于标识模组对游戏平衡性的影响程度，会保存到存档中，默认为 `Cosmetic`，有以下选项：

* 新增 `modinfo-scheme.json` 文件，能在 IDE 中验证 `modinfo.json` 的数据结构是否正确
* 支持在 `.xdb` 数据库中直接编写生物生成规则，具体且查看 `Game.StandardCreatureSpawnRule` 类，写法举例：

```xml
<ParameterSet Name="CreatureSpawnRules" Guid="98c19e0b-ff62-4acc-8e58-def30e6257a3">
  <ParameterSet Name="TemplateRuleWerewolf">
    <Parameter Name="Name" Value="Duck" Type="string" />
    <Parameter Name="Class" Value="Game.StandardCreatureSpawnRule" Type="string" />
    <Parameter Name="SpawnLocationType" Value="Surface" Type="Game.SpawnLocationType" />
    <Parameter Name="RandomSpawn" Value="True" Type="bool" />
    <Parameter Name="ConstantSpawn" Value="false" Type="bool" />
    <Parameter Name="MinTemperature" Value="5" Type="int" />
    <Parameter Name="MaxTemperature" Value="15" Type="int" />
    <Parameter Name="MinHumidity" Value="9" Type="int" />
    <Parameter Name="MaxHumidity" Value="15" Type="int" />
    <Parameter Name="AboveTopBlock" Value="True" Type="bool" />
    <Parameter Name="MinShoreDistance" Value="40" Type="float" />
    <Parameter Name="MaxShoreDistance" Value="Infinity" Type="float" />
    <Parameter Name="Blocks" Value="LeavesBlock;WaterBlock;GrassBlock;DirtBlock" Type="string" />
    <Parameter Name="Suitability" Value="2.5" Type="float" />
    <Parameter Name="Count" Value="1" Type="int" />
  </ParameterSet>
</ParameterSet>
```

* 不再删除着色器中的 `highp`、`mediump` 、`lowp`
* 移除无人使用且不完善的 ModList 功能

</details>

最后提交信息为：微调网页版

2026-01-01 23:06

最后提交信息为：解决一些警告和小错误

2025-12-24 22:20

最后提交信息为： FlatBatch2D 和 FlatBatch3D 新增一些实用方法，CellFace的GetVertices方法改成两个方法

API_1.8.2.1

fb63597

2025-11-24 10:43

API 1.8.2.1

最后提交信息为：更新版本号到1.8.2.1

API_1.8.2

bc448c5

2025-11-16 22:00

API 1.8.2

> 这是旧版！[点此查看最新版](https://gitee.com/SC-SPM/SurvivalcraftApi/releases/latest)
## 新增
* Android 系统打开或分享`.scworld`、`.scmod`等格式文件时，如选择插件版，文件将自动导入到合适的位置，不再需要手动在文件管理器手动复制粘贴了；Windows 系统同理，第一次运行插件版后，将可以直接双击这些格式的文件来导入
* Android 系统上导出存档、家具包等文件后，能立即进行分享
* 再次支持 iOS 系统，安装注意事项详见[此处](https://gitee.com/SC-SPM/SurvivalcraftApi#iosipados-%E7%B3%BB%E7%BB%9F%E7%9C%8B%E8%BF%99%E9%87%8C)
* 创建世界时可编辑真种子（并在多个位置显示真种子），可选择地形生成器版本
* 扩大创建世界时多个选项的范围，包括：岛屿大小、生物群落大小、年天数、平坦地面方块、海平面高度
* 界面设置新增自定义截图分辨率
* 控制设置新增手柄相关设置，且可使用组合键；新增物品快捷栏循环滚动设置
* 视角设置会显示具体角度
* Mod 管理界面新增“查看主页”按钮
* 启动游戏失败会有更具体的提示
* 日志文件能直接从游戏内打开
* 插件版在 Android 系统退出后，会自动从多任务界面移除
* 给 Android 系统的自适应图标添加单色图标

## 修复
* 玩家皮肤显示错误的问题
* 背包空间不足，捡起过多的掉落物时，多余的掉落物会消失的问题
* 南瓜能种在不合适方块上的问题
* 蹲着不能跳的问题
* 创造模式使用桶时的行为与原版不一致的问题
* Windows 系统上文本框中光标与输入法位置不匹配、鼠标点击后光标位置错误、左右滚动过头的问题
* 使用手柄时，打开对话框会把实际鼠标也居中的问题
* Android 系统上第一次启动游戏，跳转到管理所有应用的所有文件访问权限的界面的问题（应该跳转到管理自身的所有文件访问权限的界面）
* 其他小问题

## 对于 mod 开发者
* .Net SDK 升级到 10.0（如果您开发的 mod 没有使用新版增加的东西，可以不用升级引用包和目标框架版本）
* `Engine.Storage`新增多个实用方法：`OpenFileWithExternalApplication`（使用其他应用打开文件）、`ShareFile`（分享文件到其他应用）、`ChooseFile`（使用系统文件选择器选择文件）
* `Engine.Display` 新增 `MaxTextureSize`
* `ClothingData` 新增 `UseLazyLoading`，用于设置纹理是否直接加载或者按需加载，当mod的高清纹理衣服过多时，可以采用按需加载，加快游戏启动速度
* 读取 json 时允许注释和尾随逗号
* 将优先读取 scmod 压缩包根目录的`icon.webp`作为 mod 图标（仍然支持`icon.png`）
* 建议积极设置`modinfo.json`中的 Link，因为玩家将能从 Mod 管理界面打开该链接

### `modinfo.json`重大更新：

<details>
    <summary>点击展开</summary>
在之前的插件版中，Dependencies只支持固定的一个版本号，从该发布版开始，Dependencies 将支持范围版本，写法上支持 Nuget 风格和少量 SemVer 风格，规则如下表：

| Nuget 示例 | 范围 | 说明 |
| --- | --- | --- |
| 1.0 | x >= 1.0 | 直接一个版本号 |
| [1.0,) | x >= 1.0 | `[` 表示大于等于 |
| (1.0,) | x > 1.0 | `(` 表示大于 |
| (,1.0] | x <= 1.0 | `]` 表示小于等于 |
| (,1.0) | x < 1.0 | `)` 表示小于 |
| [1.0,2.0] | 1.0 <= x <= 2.0 | / |
| [1.0,2.0) | 1.0 <= x < 2.0 | / |
| (1.0,2.0] | 1.0 < x <= 2.0 | / |
| (1.0) | 无效 | 无效 |

| SemVer 示例 | 范围 | 说明 |
| --- | --- | --- |
| =1.0.0 | x = 1.0.0 | / |
| >1.0.0 | x > 1.0.0 | / |
| >=1.0.0 | x >= 1.0.0 | / |
| <2.0.0 | x < 2.0.0 | / |
| <=2.0.0 | x <= 2.0.0 | / |
| ^1.0.0 | 1.0.0 <= x < 2.0.0 | 主要版本号相同 |
| ~1.0.0 | 1.0 <= x < 1.1.0 | 次要版本号相同 |

> 两种写法不支持混合使用！

版本号的写法是 `Major.Minor.Patch.Revision[-Suffix]`，即：主要版本号、次要版本号、补丁版本号、修订版本号、可选后缀，四个版本号均为数字，使用小数点分隔，最后的后缀前面要有`-`，例如：`1.2.3.4-beta`。  
如果转换失败，加载依赖时将只对比字符串是否相同，而不判断范围（像以前的插件版那样）

同时 Dependencies 新增了一种写法，先看旧写法：
```json
{
    "Dependencies": [
        "PackageNameOfModA:1.2",
        "PackageNameOfModB:3.4",
        "PackageNameOfModC:5.6"
    ]
}
```
现在支持新写法：
```json
{
    "Dependencies": {
        "PackageNameOfModA": "1.2",
        "PackageNameOfModB": "3.4",
        "PackageNameOfModC": "5.6"
    }
}
```
两种写法效果相同，但新写法更直观清晰，希望大家喜欢

> ApiVersion 也支持上面写法，但和以前一样，没有实际作用

</details>

最后提交信息为：完善readme中的iOS系统说明

API_1.8.1.3

016b36c

2025-08-31 12:35

API 1.8.1.3

> 这是旧版！[点此查看最新版](https://gitee.com/SC-SPM/SurvivalcraftApi/releases/latest)

这是一个修复了很多问题的小型更新

* 新增
  * Windows端新增使用Direct3D11图形API的兼容补丁
  * 从这个版本开始正式支持Linux系统
  * 家具上限翻倍（4096→8192）
  * 罗马尼亚语，感谢Discord用户NBG
* 优化：
  * 扩宽视角设置的范围
  * 新增隐藏十字准星的设置
  * JS运行对话框添加复制输出的按钮
  * 同时只能一个线程保存设置，避免冲突
  * 调整一些提示的文字，意思更清晰
* 修复：
  * 中文以外语言基本不可用的问题
  * Android端应用在后台会自杀的问题
  * Android端日志超2MB不创建新日志文件的问题
  * 主界面更新按钮图标颜色错误的问题
  * Windows端切换全屏/窗口会导致视角突变的问题
  * ogg音频文件只会播放一半的问题
  * 存档选择界面不显示世界数量和总大小的问题
  * 南瓜灯不能放在一般方块上的问题
  * 射弹反弹速度过大的问题
  * 一个mod有多个mod图标导致modinfo加载失败的问题
  * ContentManager无法直接读取JsonArray、JsonObject的问题
  * Widget.IsUpdateEnabled没用的问题
  * 部分界面内容溢出屏幕、内容框的问题
* 对于开发者：
  * ModLoader新增接口：ClothingProcessSlotItems、IsLevelSufficientForTool、OnAppendModelMeshPart、OnAppendModelMesh
  * 新增TransformedShader类
  * ModelWidget支持自定义着色器
  * 更多图形相关的类中的private改为public，给很多方法加上virtual，部分类新增Tag
  * 可以通过EnableDressLimit去除衣服穿戴等级限制
  * TextBoxWidget新增属性EnterAsNewLine、MaxLinesCount
  * 攻击新增参数ArmorProtectionDivision，射弹新增参数MinVelocityToAttack
  * Mount增加allowToStartRange，ScoreMount返回负数时禁止骑乘，ComponentRider增加DetectSurroundingMountRange
  * 增加使用旧版参数的DrawCubeBlock的重载方法
  * 项目源码已大幅调整结构，解决警告，并统一代码格式

最后提交信息为：增加兼容补丁使用说明