DSPMiaoToolbox
妙妙工具箱【测试版】(作者:妙妙在路上 抖音@妙妙在路上)。如果此工具箱对您制作蓝图时有帮助,欢迎您来抖音给我点个关注!❤❤❤❤❤。默认快捷键【Alt+5】,小功能详见readme。 English: Miao Toolbox [Test] — small helpers for blueprint building. Default hotkey Alt+5. See readme.
| Date uploaded | 2 weeks ago |
| Version | 2.20.2 |
| Download link | miaomiaodouyin-DSPMiaoToolbox-2.20.2.zip |
| Downloads | 46 |
| Dependency string | miaomiaodouyin-DSPMiaoToolbox-2.20.2 |
This mod requires the following mods to function
README
妙妙工具箱(DSPMiaoToolbox)
中文
作者:妙妙在路上(抖音@妙妙在路上) 此工具箱是为极限密铺蓝图创作而设计,如果此模组对您有帮助,请来抖音给个关注!❤❤❤❤❤ 模组会跟随游戏语言自动切换中英文UI显示。 模组有些思路是抄的Soar和时桑等大佬的,感谢各位尊贵的大佬!
最早是把几个功能重复、配置分散的小模组合并成一个 DLL 方便管理,后来干脆把自己日常玩的时候想要的功能一个个都写进去了。现在这一个包里包含:传送带间距、蓝图工具箱、蓝图拖拽对齐、回归线自由摆放、悬停坐标、无碰撞摆放、隐藏建筑、指北针、统计信息悬浮显示、传送带定高、悬浮传送带、建造秒完成、建造师模式、传送带切割、一键填埋矿脉、分拣器伸入。
所有功能的开关和快捷键都集中在游戏内的「妙妙蓝图工具箱」窗口(Alt+5)里改,改完立即生效并写回各自的 cfg,不用退出游戏。
本身制作蓝图就是很枯燥的事情,所以UI的有些按钮标了颜色,增加可读性,机械化走线时不至于点错功能 :)
需要 BepInEx 5.4.17。
更新
开启无碰撞模式时物流运输站相隔太近依然会提示「物流运输站相隔太近」
安装
用 r2modman / Thunderstore Mod Manager 导入本包,或者手动把 BepInEx/plugins/DSPMiaoToolbox/ 整个目录放进游戏的 BepInEx/plugins/ 下面。
建议先把原来装的独立版小模组(TropicBeltSpacing、DSPBlueprintOffset 这些)卸掉再装本包,功能重复虽然不至于出错,但没必要装两份。DSPBlueprintOffset 和 DSPBPColliderSnap 首次运行时会自动把旧模组目录里的配置复制过来,之前自定义的快捷键都能保留。
更新版本直接覆盖 DLL 就行,cfg 全部向后兼容,迁移逻辑会自动处理(比如快捷键拆分、默认值变更这类事都会一次性自动迁,不会覆盖你自己改过的键位)。
功能逐条说明
下面按功能逐个讲。每条都会写清楚:它是干什么的、怎么用、默认快捷键、有哪些可以调的地方。
1. 传送带间距(F9 开关)
拉传送带的时候自动把节点间距放大,用更少的传送带覆盖同样的距离,省料也省设施。
- 默认「自由间距」模式:1.6~1.8 当地格一节,每节不超过 √5.3 米(2.302m,原版硬上限减 3cm 余量),所以建出来的带子蓝图在原版游戏里照样能重建。
- 「蓝图安全(整数格)」模式:严格只用原版的整数格节点,间距全部是整数格,对蓝图洁癖玩家友好。cfg 里
BlueprintSafe可开。 - 爬坡自动处理:有高度差的路段会自动缩小水平间距,避免 2 格节撞上 TooFar 判定。
- 垂直抽稀(默认开):竖直往上拉带时,把高度差均分成不超过 1.45 格的节,每一段都走游戏的「直接连接」机制,又省料又美观。斜坡带同样生效。
- 远距延伸(默认开):原版网格行走最多 256 个点,1 格间距下大概 322m 就到顶了。开启后超远的传送带会自动按当前间距继续延伸,最远约 580m,末端精确落在终点上。
- 太近的强制连接(默认开):两端接口落在同一个网格里(间距不足 1 格)时原版是绝对连不上的,这里会直接建一节短带把它们连起来;拉带过程中双击 R 也有类似效果。
- F9 一键开关全部间距逻辑。cfg 里还有 SkipClimb、SkipVertical(特殊地形整条交给原版)、LogSpacing(日志)等细项可调。
2. 蓝图工具箱(Alt+5 开关窗口)
打开「妙妙蓝图工具箱」窗口,里面是蓝图的各种变换工具,两个页签:「偏移工具」和「快捷键和功能开关」。
坐标偏移:把整张蓝图沿 X/Y/Z 平移。输入框支持 4 位小数,可以反复叠加(工具会记录累计净偏移)。每次操作后都能点「还原到读取时的状态」一键撤销。
垂直叠加:把蓝图沿 Z 轴复制成多层,层与层之间不互连。层数和每层间隔自己填。
线性变换:三轴缩放 + 绕竖直轴旋转,支持选择基准点/基准轴(居中、选第一个建筑等模式)。配合回归线自由摆放,斜着贴着赤道摆一排厂房就靠这个。
数字输入纠错:输入框对中文输入法相当宽容——全角数字、中文句号、手滑多敲的小数点(0..25)、从别处复制粘贴带进来的零宽字符,都能自动纠正。真纠不了的会明确告诉你哪个框、原文是什么。
连接修复:偏移/叠加之后传送带和分拣器的连接关系会自动修复——重复的传送带节去重、拉开的空档按缺口补节(直线 2~4 格)、跨距不再是 1~3 格直线的分拣器自动移除。建筑上限也从原版的 255 解锁到了 15000。
写回剪贴板:改完点这个按钮,蓝图以新状态写回剪贴板,再去游戏里粘贴就是改好的。
3. 蓝图拖拽碰撞对齐(Ctrl+Shift+N 开关)
粘贴蓝图拖拽摆放时,按整组建筑真实的碰撞盒角跨度来贴合排布,而不是原版那样忽略地面网格导致建筑之间留缝或者重叠。鼠标靠近已建建筑时会自动磁吸贴合。拖拽复制的份数上限同样解锁到 15000,默认99,设置数量太大会导致游戏性能暴降!
4. 悬停坐标(Ctrl+Shift+K 开关,默认关)
鼠标悬停在建筑上时显示:当前经纬度、与建筑 X/Y/Z 轴的距离、建筑模型体积、最近碰撞距离。对同类高塔(风电、物流塔这类)会额外显示最近同类的碰撞距离,用来对齐 spacing 很方便。
5. 蓝图回归线自由摆放(Alt+U 开关,默认关)
粘贴蓝图时无视回归线(纬度 45~48)的摆放限制和地基平台越界判定,蓝图跟着光标连续移动、不瞬移。同时统一做刚性摆放锁死蓝图物理尺寸——东西向格距按锚点纬度做 1/cos 补偿(球面经线收敛),任意纬度不变形不碰撞,跨回归线零跳变。默认关闭是因为改动原版摆放规则比较激进,需要的时候 Alt+U 打开。
6. 无碰撞摆放(Alt+W 开关)
开启后摆放建筑忽略碰撞体积,可以重叠放置;机甲行走时也能穿过建筑。摆放蓝图时同样放行碰撞判定。手动摆放只放行「唯一失败原因是碰撞」的情况,缺料、距离太远这些其它错误照常拦截,不会误放。
7. 隐藏建筑模型(Alt+A 三态循环)
按一次隐藏所有建筑模型,再按一次连分拣器(爪子)也隐藏,第三次恢复显示。隐藏状态下传送带、矿脉、植被、蓝图虚影照常显示,被隐藏的建筑也无法被鼠标选中(拾取射线做了过滤),不会挡住你的点击。换星球自动保持生效。
8. 星球缩略图指北针(Alt+N 开关,默认开)
左下角星球卡片上显示紫色 N + 箭头,随视角实时旋转指向星球北极。此功能主要目的是为了直观的体现偏移是+还是-数。还有个调试模式会在小地图上叠加 P/+Y/-Y 标记用来校准。
9. 统计信息显示(Alt+M 开关,默认开)
此功能是为了在制作蓝图时方便观察个中间产物的详细信息,当前版本下可以同时监控30个材料。筛选是按照统计面板的★标记统计的。同时也兼容了击杀统计显示(某些黑雾农场可能用得到)。
左下角星球卡片上方的实时信息悬浮显示,从上到下:
- 发电性能(青色)和实时耗电(橙色):口径与统计面板一致。实时耗电是电网当下实际送达的功率,供电不足时会真实反映缺口。
- 范围选项卡:统计全星区 / 当前星球 / 各行星系 / 各星球……选项与统计面板的范围下拉框动态同步,在这里选等于直接切面板的范围,两处永远一致。飞离星球(太空/星系视图)时如果选的是「当前星球」,会自动按统计全星区口径兜底显示。
- 时间选项卡:1 分钟 / 10 分钟 / 1 小时 / 10 小时 / 100 小时 / 总计,六档与面板时间框一致。
- 收藏夹筛选行:统计面板里收藏(★ 标记)的物品会显示在这里——每行是物品图标 + 生产数值 + 消耗数值,口径与面板同行数字完全相同。统计面板击杀页收藏的敌人(枪骑、强袭者这些)也会显示为敌人图标 + 击杀数。物品按生产+消耗降序、击杀按击杀数降序,最多 6 列 × 5 行共 30 个。面板没勾选任何收藏筛选时,显示全部已收藏物品。
- 数字不带 /min 后缀;面板没勾选收藏筛选但收藏了物品时,会显示全部收藏内容。
10. 工具箱快捷按钮
星球卡片右侧边缘有个圆形「妙」字按钮(原生按钮克隆,带悬停提示和点击音效),点击开关工具箱窗口。不想显示可以在 cfg 里关。
11. 传送带定高(Alt+C)
拉传送带时按 Alt+C 打开高度输入框,输入高度后点「应用」(或回车),整条带子精确抬到这个高度。
- 支持小数点后 4 位,按输入精确生效、不取整到层——输入 3.63 就是恰好 3.63 格。
- 单位可以选「格」或「米」(1 格 = 1.3333 米),输入时也可以加后缀临时切:
4格/4c= 4 格,5m= 5 米。 - 再按一次 Alt+C(或 Esc)关闭输入框;解除定高 = 输入 0 后点应用,或者退出建造时自动解除恢复贴地。
- 定高生效期间原版的传送带高度增减键被接管;解除后照常可用。
- 窗口打开期间在输入框里打字不会误触游戏键位。
12. 拉传送带时按住 Shift 保持高度
拉带过程中按住 Shift 不松,整条带子保持在起点的高度水平延伸(不随地形起伏),松开恢复原版。和定高功能自动互让:定高生效时 Shift 保持高度让位,松开 Shift 后定高继续。
13. 悬浮传送带(Alt+V)
手持传送带,悬停在任意一条已有传送带上按 Alt+V,弹出输入框输入高度(格,支持负数 = 沉入地下),点生成——在所指传送带正上方生成一格同向的悬浮传送带,XY 不变,立即完工。
- 扣料顺序:先扣个人背包,背包不够的部分自动从物流清单(合成器物品清单里勾「物流」的那份库存)扣除,两边都没有才会失败。
- 高度可以微调到小数,用来做高低分层输送带、跨带桥接都很方便。
14. 建造秒完成(Alt+B 开关,默认开)
开启后:缺料的待建建筑(蓝图粘贴出来的白影)会自动从背包补料,凑齐立即建成;手动放置或粘贴时已经付了料的建筑直接完工,不再等无人机过来。每 6 tick 分片扫描一轮,大基地也不卡。
如果装了 starfi5h 的 DeliverySlotsTweaks,本模组会自动接管其 GetItemCount/TakeItem 静态替换,建造师模式和秒完成照样工作,不会出现「点击建造栏仍提示物品不足」的问题。
15. 建造师模式(免费建造)
开启后背包数量判定被接管为 888:建造不消耗物品、背包为空也能建,底部建造栏的数量恒显示 888。和秒完成是两个独立开关——建造师管「免费」,秒完成管「速度快」。
16. 传送带切割(Alt+X)
鼠标悬停在某节传送带上按 Alt+X,断开它与下游传送带的连接。传送带本体保留、不掉落物品,用来把一条长带截成两段独立运转。
17. 一键填埋/恢复矿脉(Ctrl+Shift+M)
第一次按:整星掩埋全部矿脉(复用游戏沙盒的原生「改造整星」机制,不消耗地基);第二次按:恢复矿脉,资源储量不变。装了独立版 PlanetVeinBurier 的话本功能自动休眠,不会冲突。
18. 分拣器伸入(按住 LeftCtrl)
注意!此功能无法保存合法蓝图!也可以理解为毫无意义的功能!主要是我为了查看每种建筑加了爪子后的模型大小关系。
拉爪子(分拣器)连接到建筑时按住 LeftCtrl:整个爪子沿「从底座指向建筑」的方向向建筑滑动 0.27 格(cfg 可调),头充分伸进建筑端口、连接视觉到位。松开按键恢复原版位置。连接数据不变,蓝图保存后依然可用。
快捷键一览
| 快捷键 | 功能 | 默认 |
|---|---|---|
| F9 | 传送带间距 开/关 | 开 |
| Alt+5 | 工具箱窗口 开/关 | 关 |
| Alt+W | 无碰撞摆放 开/关 | 关 |
| Alt+A | 隐藏建筑模型 三态循环 | 显示 |
| Alt+N | 星球指北针 开/关 | 开 |
| Alt+M | 统计信息显示 开/关 | 开 |
| Alt+B | 建造秒完成 开/关 | 开 |
| Alt+U | 蓝图回归线自由摆放 开/关 | 关 |
| Ctrl+Shift+K | 悬停坐标 开/关 | 关 |
| Ctrl+Shift+N | 蓝图拖拽碰撞对齐 开/关 | 关 |
| Ctrl+Shift+M | 一键填埋/恢复矿脉 | — |
| Alt+X | 传送带切割 | — |
| Alt+V | 悬浮传送带 | — |
| Alt+C | 传送带定高输入框 | — |
| 按住 LeftCtrl | 分拣器伸入 | 开 |
| 拉带时按住 Shift | 保持当前高度 | 开 |
所有快捷键都能在游戏内「快捷键修改」页改(格式:键名用 KeyCode 枚举名,+ 分隔,顺序随意,例如 LeftAlt + N、K + LeftShift + LeftControl),改完立即生效并写回 cfg。
配置文件
各功能的 cfg 保持原模组的位置与文件名:
BepInEx/config/TropicBeltSpacing.cfg—— 间距相关的所有细项(蓝图安全、垂直抽稀、远距延伸、强制连接、日志等)BepInEx/plugins/DSPMiaoToolbox/DSPBlueprintOffset.cfg—— 蓝图工具箱、统计信息显示、指北针、无碰撞、隐藏建筑、秒完成等合并版新增功能BepInEx/config/dsh.hovercoord.cfg—— 悬停坐标BepInEx/plugins/DSPMiaoToolbox/DSPBPColliderSnap.cfg—— 蓝图拖拽碰撞对齐BepInEx/config/BPTropicFree.cfg—— 回归线自由摆放
r2modman 的 Config editor 可以直接编辑 2 号和 4 号(在 DSPMiaoToolbox 模组目录下)。统计范围、时间档、各快捷键也可以直接在游戏内悬浮显示和「快捷键修改」页改,效果与改 cfg 完全相同。
兼容性
- 与 LongerBelts 等改传送带路径的模组兼容(间距逻辑会自动接管其路径生成,可用
UseVanillaGridPath关闭接管)。 - 与 DeliverySlotsTweaks 兼容:自动接管其背包替换,建造师模式/秒完成正常工作。
- 装了独立版 PlanetVeinBurier 时,内置的一键填埋功能自动休眠。
- 五个合并模组的补丁目标互不重叠,合并后行为与分开安装完全一致。
从源码构建
powershell -ExecutionPolicy Bypass -File .\build.ps1 -Zip
# 可选参数:
# -GameDir "X:\...\Dyson Sphere Program"
# -BepInExCore "X:\...\BepInEx\core"
生成 dist\DSPMiaoToolbox.dll 与可发布的 dist\DSPMiaoToolbox-<版本>.zip(版本号取自 manifest.json)。
已知的小事项
- 统计信息显示在飞离星球(太空/星系视图)时仍会显示,此时如果范围选的是「当前星球」会自动按统计全星区兜底,落回星球后恢复。
- 无碰撞摆放会保留游戏对「物流运输站相隔太近」的判定:即便开启无碰撞,物流站间距过近时依然会被拦截(TowerTooClose 检查保留)。
- 蓝图安全模式的间距模式下,如果拉带距离特别短且不在整数格上,会强制直连一节短带(可在 cfg 关闭 ForceConnectTooClose,改为直接失败)。
- 隐藏建筑模型后,被隐藏的建筑不可被鼠标选中是刻意设计(方便点击被挡住的设施)。
- 机甲无碰撞开启时会顺带能穿过敌人(玩家和实心建筑同在碰撞层 12,Unity 层级机制所限)。
English
Author: MiaoMiaoOnTheRoad (Douyin@MiaoMiaoOnTheRoad) This toolbox was built for extreme-dense blueprint layouts. If this mod helps you, please follow me on Douyin! ❤❤❤❤❤ The mod's UI automatically switches between Chinese and English to match the game language. Some ideas were borrowed from great modders like Soar and Shi Sang — many thanks to them all!
This started as a merge of several small mods with duplicated features and scattered configs, combined into a single DLL for easy management. Over time I kept adding everything I wanted during my own playthrough. This one package now includes: belt spacing, blueprint toolbox, blueprint drag alignment, free placement across tropics, hover coordinates, no-collision placement, hide buildings, planet compass, stats overlay, precise belt height, hover belt, instant build, builder mode, belt cutter, vein burier, sorter advance.
All feature toggles and hotkeys live in the in-game "Miao Blueprint Toolbox" window (Alt+5). Changes apply instantly and are written back to each module's cfg file — no game restart needed.
Making blueprints is tedious by nature, so some buttons in the UI are colour-coded for readability — no misclicks while running repetitive belt routes :)
Requires BepInEx 5.4.17.
Update
With no-collision enabled, the "logistics stations are too close" warning still shows properly.
Install
Import this package with r2modman / Thunderstore Mod Manager, or drop the whole BepInEx/plugins/DSPMiaoToolbox/ folder into the game's BepInEx/plugins/.
It is recommended to remove the old standalone mods (TropicBeltSpacing, DSPBlueprintOffset, etc.) first — duplicates won't crash anything, but there is no point running both. On first run, DSPBlueprintOffset and DSPBPColliderSnap automatically migrate configs from the old mod folders, so previously customized hotkeys are kept.
To update, just overwrite the DLL. All cfg files are backward compatible; migrations run automatically (hotkey splits, default changes, etc.) and never overwrite keys you customized yourself.
Features, one by one
Each entry below covers: what it does, how to use it, the default hotkey, and what can be tuned.
1. Belt spacing (toggle with F9) Automatically enlarges belt node spacing while pulling belts — fewer belts for the same distance, saving materials and buildings.
- Default "free spacing" mode: 1.6–1.8 local grids per segment, each ≤ √5.3 m (2.302 m — the vanilla hard limit minus a 3 cm margin), so blueprints built this way can still be rebuilt in vanilla.
- "Blueprint-safe (integer grid)" mode: strictly vanilla integer-grid nodes only, all spacing in whole grids — for players who want pixel-perfect legal blueprints. Enable via
BlueprintSafein the cfg. - Climbs handled automatically: horizontal spacing shrinks on climbs so 2-grid segments don't hit the TooFar check.
- Vertical thinning (default on): when pulling belts upward, the height difference is split into segments of at most 1.45 grids, each using the game's "direct connect" mechanic — material-saving and clean. Works on slopes too.
- Long reach (default on): vanilla grid walking caps at 256 points (~322 m at 1-grid spacing) and very long belts simply can't be pulled. With this on, over-long belts keep extending at the current spacing up to ~580 m, with the end node landing exactly on target.
- Force connect (default on): when both belt ends land inside the same grid (< 1 grid apart), vanilla absolutely refuses to connect — this builds a short belt to join them anyway; double-tapping R while pulling does something similar.
- F9 toggles all spacing logic at once. Fine knobs in the cfg: SkipClimb, SkipVertical (hand special terrain to vanilla), LogSpacing (logging), etc.
2. Blueprint toolbox (Alt+5 toggles the window) Opens the "Miao Blueprint Toolbox" window with the blueprint transform tools. Two tabs: "Tools" and "Hotkeys & Toggles".
Offset: translate the whole blueprint along X/Y/Z. Input boxes accept 4 decimals and operations stack (the net offset is tracked). Every operation can be undone with one click via "restore to loaded state".
Stack: copies the blueprint into multiple layers along Z; layers are not interconnected. Layer count and per-layer gap are yours to fill.
Linear transform: scale on all three axes + rotate around the vertical axis, with anchor presets (centre, first building, etc.). Combined with free tropic placement, this is how you line up a row of assemblers hugging the equator.
Number input correction: the input boxes are very forgiving of Chinese IME artefacts — full-width digits, CJK periods, accidental double dots (0..25), zero-width characters pasted in from elsewhere — all auto-corrected. When truly unparseable, it tells you which box failed and what the raw text was.
Connector repair: after offset/stack, belt and sorter connections are repaired automatically — duplicate belt segments deduped, opened gaps of 2–4 straight grids refilled, sorters whose span is no longer a 1–3-grid straight line removed. The building cap is also unlocked from the vanilla 255 to 15000.
Write back to clipboard: after editing, click this button and the blueprint is written back to the clipboard in its new state — paste it in game and you get the edited version.
3. Blueprint drag collider alignment (Ctrl+Shift+N toggles) When dragging pasted blueprints, layout fits by the real collider corner spans of the whole group instead of ignoring the ground grid and leaving gaps or overlaps between buildings. Dropping near existing buildings magnet-snaps to their collider edges. The drag-copy cap is unlocked to 15000 — default 99; very large counts will tank your FPS!
4. Hover coordinates (Ctrl+Shift+K toggles, default off) While hovering a building it shows: current latitude/longitude, X/Y/Z axis distances to the building, model volume, and nearest collider distance. For same-type towers (wind turbines, storage towers, etc.) it also shows the distance to the nearest same-type collider — very handy for aligning spacing.
5. Free placement across tropics (Alt+U toggles, default off) When pasting, ignores the tropic (latitude 45–48) placement restriction and foundation platform bounds; the blueprint follows the cursor continuously without teleporting. It also applies uniform rigid placement that locks the blueprint's physical size — east-west grid pitch is compensated by 1/cos(latitude) (spherical meridian convergence), so it never deforms or collides at any latitude, with zero jitter across tropic lines. Off by default because it changes vanilla placement rules quite aggressively — Alt+U when you need it.
6. No-collision placement (Alt+W toggles) While on, buildings ignore collider volumes and can overlap; the mecha walks through buildings too. Blueprint pasting also bypasses collision checks. Manual placement only bypasses when collision is the ONLY failure — missing items or range errors are still blocked normally.
7. Hide building models (Alt+A, 3-state cycle) First press hides all building models, second press also hides sorters, third shows everything again. While hidden, belts, veins, vegetation and blueprint ghosts stay visible, and hidden buildings cannot be picked with the mouse (raycast filtered) — they never block your clicks. Persists across planet changes.
8. Planet compass (Alt+N toggles, default on) Purple N + arrow on the planet card at the bottom left, rotating in real time to point at the planet's north pole. The main purpose of this feature is to show at a glance whether an offset is + or −. A debug mode also overlays P/+Y/-Y markers on the minimap for calibration.
9. Stats overlay (Alt+M toggles, default on) Made for watching detailed info of intermediate products while building blueprints — the current version can monitor up to 30 materials at once. Filtering follows the ★ favourites in the statistics panel. Kill statistics are supported too (some dark-fog farms may want this).
The live overlay above the planet card, top to bottom:
- Power gen (cyan) and power load (orange): same metrics as the statistics panel. Load is what the grid actually delivered right now, so shortages show up honestly.
- Scope tab: all galaxy / local planet / each system / each planet... — options are live-synced with the statistics panel's scope dropdown; choosing here directly switches the panel's scope, and the two always agree. Away from a planet with "local planet" selected, it automatically falls back to all-galaxy for display.
- Time tab: 1 min / 10 min / 1 h / 10 h / 100 h / Total — six levels matching the panel's time box.
- Favourites rows: items starred (★) in the statistics panel show here — one row per item: icon + production + consumption, exactly the same numbers as the panel row. Enemies starred on the kill page (Gun Rider, Marauder, etc.) show as enemy icon + kill count. Items sorted by production+consumption descending, kills by kill count descending, up to 6 columns × 5 rows = 30. With no favourite filter selected in the panel, all starred entries show.
- Numbers carry no /min suffix; when no favourite filter is selected but items are starred, all starred entries show.
10. Toolbox quick button A round 妙 button on the right edge of the planet card (native button clone with hover tip and click sound) toggles the toolbox window. Can be disabled in the cfg.
11. Precise belt height (Alt+C) While pulling a belt, Alt+C opens a height input box; type a height and click Apply (or press Enter) — the whole belt is lifted to exactly that height.
- Up to 4 decimals, applied exactly as typed — no rounding to layers. 3.63 means exactly 3.63 grids.
- Units: "grid" or "meters" (1 grid = 1.3333 m); type a suffix to switch on the fly:
4格/4c= 4 grids,5m= 5 m. - Alt+C again (or Esc) closes the box; enter 0 and apply to return belts to the ground, or exit build mode to disarm automatically.
- While armed, the vanilla belt height keys are taken over; disarm restores them.
- Typing in the input box never leaks keystrokes to game hotkeys.
12. Hold Shift while pulling belts to keep height Hold Shift during the pull and the whole belt stays at the starting height (flat, ignoring terrain); release to return to vanilla. Cooperates with precise belt height: when belt height is armed, Shift-hold yields, and resumes after.
13. Hover belt (Alt+V) Hold a belt item, hover over any existing belt and press Alt+V: a box opens for the height in grids (negative allowed = sink underground), click Build — one same-direction hover belt is created right above the target, XY unchanged, finished instantly.
- Cost order: player inventory first; anything missing is taken from the logistics list (the inventory shown in the synthesizer's item list with the "logistics" tick). Fails only if neither has the belts.
- Heights accept decimals — handy for layered conveyors and bridging over belts.
14. Instant build (Alt+B toggles, default on) When on: under-fed ghosts (e.g. from pasted blueprints) automatically pull the missing items from your inventory and finish as soon as they're complete; manually placed or pasted buildings that were already paid for finish immediately without waiting for drones. Scans in shards every 6 ticks so even huge bases stay smooth.
If starfi5h's DeliverySlotsTweaks is installed, this mod automatically takes over its GetItemCount/TakeItem static replacements, so builder mode and instant build keep working — no more "not enough items" when clicking the build bar.
15. Builder mode (free building) When on, inventory count checks are taken over as 888: building costs nothing and works with an empty inventory, and the build bar always shows 888. Separate from instant build — builder mode handles "free", instant build handles "fast".
16. Belt cutter (Alt+X) Hover over a belt segment and press Alt+X to disconnect it from the downstream belt. The segment itself stays and no items drop — useful to split one long belt into two independent runs.
17. Vein burier / restore (Ctrl+Shift+M) First press buries all veins on the planet (reusing the sandbox's native "reform planet" mechanic, no foundations consumed); second press restores them with reserves unchanged. Automatically sleeps if the standalone PlanetVeinBurier mod is installed.
18. Sorter advance (hold LeftCtrl) Note! Belts placed this way cannot be saved as a legal blueprint — honestly, it is a niche feature I added mainly to inspect model size relationships with sorters attached.
While connecting a sorter to a building, holding LeftCtrl slides the whole sorter (base + head) 0.27 grid toward the building (configurable) so the head properly reaches into the port. Release to restore. Connection data unchanged, and saved blueprints still work.
Hotkeys
| Hotkey | Function | Default |
|---|---|---|
| F9 | Belt spacing on/off | on |
| Alt+5 | Toolbox window | off |
| Alt+W | No-collision placement | off |
| Alt+A | Hide building models (3-state) | shown |
| Alt+N | Planet compass | on |
| Alt+M | Stats overlay | on |
| Alt+B | Instant build | on |
| Alt+U | Free placement across tropics | off |
| Ctrl+Shift+K | Hover coordinates | off |
| Ctrl+Shift+N | Blueprint drag collider alignment | off |
| Ctrl+Shift+M | Vein burier / restore | — |
| Alt+X | Belt cutter | — |
| Alt+V | Hover belt | — |
| Alt+C | Belt height input | — |
| Hold LeftCtrl | Sorter advance | on |
| Hold Shift (pulling) | Keep belt height | on |
Every hotkey can be changed in-game on the "Hotkeys & Toggles" tab (format: KeyCode names joined with +, order free, e.g. LeftAlt + N, K + LeftShift + LeftControl). Changes apply instantly and are written to the cfg files.
Config files
Each feature keeps its original module's cfg location:
BepInEx/config/TropicBeltSpacing.cfg— all belt-spacing fine options (blueprint-safe, vertical thinning, long reach, force connect, logging, etc.)BepInEx/plugins/DSPMiaoToolbox/DSPBlueprintOffset.cfg— toolbox, stats overlay, compass, no-collision, hide buildings, instant build and the other merged featuresBepInEx/config/dsh.hovercoord.cfg— hover coordinatesBepInEx/plugins/DSPMiaoToolbox/DSPBPColliderSnap.cfg— blueprint drag collider alignmentBepInEx/config/BPTropicFree.cfg— free placement across tropics
r2modman's Config Editor can edit #2 and #4 directly (under the DSPMiaoToolbox mod folder). Scope, time level and hotkeys can also be changed in-game with the same effect.
Compatibility
- Works with LongerBelts and other belt-path mods (spacing logic takes over their path generation;
UseVanillaGridPathdisables the takeover). - Works with DeliverySlotsTweaks: its inventory replacement is taken over so builder mode / instant build keep working.
- Auto-sleeps when the standalone PlanetVeinBurier mod is present.
- The five merged modules have non-overlapping patch targets; merged behaviour equals separate installation.
Build from source
powershell -ExecutionPolicy Bypass -File .\build.ps1 -Zip
# Optional parameters:
# -GameDir "X:\...\Dyson Sphere Program"
# -BepInExCore "X:\...\BepInEx\core"
Produces dist/DSPMiaoToolbox.dll and a publishable dist/DSPMiaoToolbox-<version>.zip (version from manifest.json).
Known notes
- The stats overlay keeps showing in space/system view; if scope is "local planet" it automatically falls back to all-galaxy, and restores when you land.
- No-collision placement preserves the vanilla "logistics stations are too close" check: even with no-collision enabled, stations that are too close together are still blocked (TowerTooClose kept).
- In blueprint-safe spacing mode, very short non-grid-aligned pulls force-connect a short segment (disable ForceConnectTooClose in the cfg to make it fail instead).
- Hidden buildings being un-selectable is intentional (so you can click what was behind them).
- With no-collision on, the mecha also walks through enemies (players and solid buildings share physics layer 12 — a Unity limitation).