Dyson Sphere Program
Install with App

Details

Latest version
0.2.35
Last Updated
First Uploaded
Downloads
671
Likes
0
Size
49KB
Dependants

Categories

DSPEasy Framework

Dyson Sphere Program(戴森球计划)DSPEasy 系列模组共用的框架库。

这个包本身不提供任何玩法功能。 只有当你安装的其它模组(例如 DSPEasy Buildings、DSPEasy Exchange) 依赖它时,或者你要基于它做开发时,才需要安装。

汇报问题(Bug/Issue):github


包含什么

模块 能力
DSPEasy.Framework.Save 命名空间旁车存档:在存档旁边写一个 .mod.dat,数据块按 命名空间/块ID 分区,一个模组的数据不会踩到另一个模组;原子写入(先写 .tmp 再替换),文件格式 2,可读旧格式 1 并自动升级。SaveLifecycle 把载入/写出/重置钩子统一成一份,多个模组各注册自己的命名空间;ModSave.RegisterLegacyNamespace 可把旧命名空间登记为别名,旧存档自动迁移。
DSPEasy.Framework.UI 面板基座:PanelFrame / PanelHost 提供统一样式的外壳(标题栏、贴边/居中锚点、拖动提示、关闭按钮)与显隐/层级接管;UiFactory 提供文本 / 按钮 / 滑条的工厂方法与配色;UiDrag 处理窗口拖动(轮询式,口径同原版 UIWindowDrag),KeepOnScreen 把窗口夹在画布可见范围内;ItemPickerFilter 统一物品选择器的白名单与页签过滤;UiFocus 处理层级——只在打开时提层一次,不会像每帧抢置顶那样把游戏的物品提示条压掉。
DSPEasy.Framework.Recipes RecipeSolver:配方树递归展开,带环检测与深度上限,用于「需要哪些材料」这类计算。
DSPEasy.Framework.Items 物品栈辅助。
DSPEasy.Framework.Blueprint 模组之间的蓝图数据通道:把建筑设置写进原版蓝图的 content 字符串并在粘贴时读回;BlueprintChannel.Install() 显式安装复制/粘贴补丁。
DSPEasy.Framework.Abnormal 数据异常(ABN_*)守卫:AbnormalityGuard.Install() 拦截异常记录,并在载入/写出存档时清掉历史记录,避免模组改动原型后成就、元数据与银河上传被停用。
DSPEasy.Framework.Diagnostics 性能面板统计:在原版「分析面板 → 性能测试 → CPU」列表里给依赖本框架的模组追加三级耗时行(模组 → 建筑/功能 → 主要逻辑),面板关闭或不勾「实时检测」时不采样。

安装

  1. 先装 BepInEx 5.4.17(x64,Mono)(已写在依赖里,模组管理器会自动处理)。
  2. 把 DSPEasy.Framework.dll 放进 BepInEx/plugins/(Thunderstore Mod Manager / r2modman 会自动放好)。
  3. 启动一次游戏,日志里能看到依赖它的模组正常加载。

⚠️ 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);   // 打开时提层一次即可,不要每帧抢置顶

// 面板:统一外壳 + 拖动夹取
var frame = PanelFrame.Create(transform, "MyPanelBody", 420f, 520f,
    PanelAnchor.LeftEdge, "我的面板", Close);

// 物品选择器:只显示指定物品(policy 里还可要求已解锁 / 隐藏「改版建筑」页签)
ItemPickerFilter.Begin(ids, new ItemPickerPolicy { RequireUnlocked = false, IncludeUnpaged = true });

// 旁车生命周期:注册命名空间后统一安装读/写/重置钩子
SaveLifecycle.Register("MyMod", Reset, OnLoaded, null, AfterLoad);
SaveLifecycle.Install();

// 性能面板:注册模块与子步骤,Measure() 之外的时间不计入
var module = ModProfiler.RegisterModule("模组 MyMod");
var step = module.GetOrAddChild("我的步骤");
using (step.Measure()) { /* 可能耗时的工作 */ }
ModProfiler.Install(LogInfo, LogWarn);   // 安装面板补丁;多次调用只装一次
  • 命名空间:DSPEasy.Framework.Save / .UI / .Recipes / .Items / .Blueprint / .Abnormal / .Diagnostics。
  • 依赖方向是单向的:框架只引用游戏的 Assembly-CSharp 与 BepInEx / 0Harmony,不引用任何使用它的模组。
Thunderstore development is made possible with ads. Please consider making an exception to your adblock.