DSPEasy Framework
DSPEasy 系列模组共用的框架：按命名空间隔离的旁车存档、面板基座、配方求解等。本身不含玩法，只有其它 DSPEasy 模组依赖它时才需要安装。
| Last updated | 15 hours ago |
| Total downloads | 86 |
| Total rating | 0 |
| Categories | Libraries |
| Dependency string | Suntion-DSPEasy_Framework-0.2.32 |
| Dependants | 2 other packages depend on this package |
This mod requires the following mods to function
README
DSPEasy Framework
Dyson Sphere Program（戴森球计划）DSPEasy 系列模组共用的框架库。
这个包本身不提供任何玩法功能。 只有当你安装的其它模组（例如
DSPEasy Buildings、DSPEasy Exchange） 依赖它时，或者你要基于它做开发时，才需要安装。汇报问题(Bug/Issue)：github
包含什么
| 模块 | 能力 |
|---|---|
DSPEasy.Framework.Save |
命名空间旁车存档：在存档旁边写一个 .mod.dat，数据块按 命名空间/块ID 分区，一个模组的数据不会踩到另一个模组；原子写入（先写 .tmp 再替换），文件格式 2，可读旧格式 1 并自动升级。 |
DSPEasy.Framework.UI |
面板基座：UiFactory 提供文本 / 按钮 / 滑条的工厂方法与配色；UiDrag 处理窗口拖动（轮询式，口径同原版 UIWindowDrag）；UiFocus 处理层级——只在打开时提层一次，不会像每帧抢置顶那样把游戏的物品提示条压掉。 |
DSPEasy.Framework.Recipes |
RecipeSolver：配方树递归展开，带环检测与深度上限，用于「需要哪些材料」这类计算。 |
DSPEasy.Framework.Items |
物品栈辅助。 |
DSPEasy.Framework.Blueprint |
模组之间的蓝图数据通道。 |
DSPEasy.Framework.Abnormal |
异常状态守卫：动工厂之前先确认游戏状态正常。 |
安装
- 先装 BepInEx 5.4.17（x64，Mono）（已写在依赖里，模组管理器会自动处理）。
- 把
DSPEasy.Framework.dll放进BepInEx/plugins/（Thunderstore Mod Manager / r2modman 会自动放好）。 - 启动一次游戏，日志里能看到依赖它的模组正常加载。
⚠️
BepInEx/plugins/下只能有一份DSPEasy.Framework.dll。 BepInEx 会递归加载plugins/下所有 DLL，每一份都会建立自己的静态注册表——有了两份， 一份写进去的数据另一份看不到，表现就是「设置存了，重进游戏却全没了」。 升级时请把旧副本删干净。
兼容性
- 游戏：戴森球计划
0.10.35.29151（Unity 2022.3.62f3c1，64 位）。 - BepInEx：
5.4.17.0（Mono）。 - 旁车存档格式：2（能读格式 1，旧档会自动升级，不需要手动迁移）。
开发者参考
// 注册一个带命名空间的存档块（块 ID 必须是 4 个可打印 ASCII 字符）
ModSave.Register("MyMod", new MyStateChunk(MyState.Table));
// 显式指定命名空间读写（不传参数则读写「本程序集注册的全部块」）
ModSave.WriteForSaveName(saveName, "MyMod");
// 面板：自己拼控件 + 处理层级
var root = UiFactory.NewRect(transform, "MyPanel");
UiFactory.Place(root, ...).Pos(...);
UiFocus.BringToFront(root); // 打开时提层一次即可，不要每帧抢置顶
- 命名空间：
DSPEasy.Framework.Save/.UI/.Recipes/.Items/.Blueprint/.Abnormal。 - 依赖方向是单向的：框架只引用游戏的
Assembly-CSharp与 BepInEx / 0Harmony，不引用任何使用它的模组。
