Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
ShipSortNexus
by shuanghuasama1145 // Frost sama — F8 orbital console, feet anchors, tool/scrap bulk suction with scrap coordinate preservation, same-type follow and orbit-only soul camera for ShipSort 5.2.1.
By frostsama
| Last updated | 3 days ago |
| Total downloads | 12 |
| Total rating | 0 |
| Categories | BepInEx Client-side Tweaks & Quality Of Life AI Generated |
| Dependency string | frostsama-ShipSortNexus-1.3.5 |
| Dependants | 0 other packages depend on this package |
This mod requires the following mods to function
BepInEx-BepInExPack
BepInEx pack for Mono Unity games. Preconfigured and ready to use.
Preferred version: 5.4.2304baer1-ShipSort
Highly customizable mod that organizes all items on your ship
Preferred version: 5.2.1README
ShipSort Nexus 1.3.5 // Frost sama
作者:shuanghuasama1145
FROST SAMA // 霜华sama
本模组由 shuanghuasama1145(Frost sama / 霜华sama) 制作与维护。
ShipSort 的客户端扩展:为 ShipSort 5.2.1 增加一个科技感 F8 控制台、脚下锚点布局、
物品快速移动、工具/单手废料/双手废料分类吸取、同类物品跟随首件,以及仅限外太空使用的
灵魂模式自由相机。菜单右上角带有动态 FROST SAMA // 霜华sama 徽标。
重要:本安装包只包含 ShipSort Nexus,不包含 ShipSort 本体。 必须先安装 ShipSort 5.2.1 及其依赖,否则 BepInEx 会报:
Could not load [ShipSort Nexus] because it has missing dependencies: baer1.ShipSort
必须先安装的依赖
- BepInExPack 5.4.x
- ShipSort 5.2.1(
baer1.ShipSort) - ChatCommandAPI 1.2.1(ShipSort 的依赖)
- LethalModUtils 1.0.1(ShipSort 的依赖)
使用 Thunderstore Mod Manager / r2modman 时,安装 ShipSort 会自动带上依赖;
如果手动解压 zip,必须把 ShipSort、ChatCommandAPI、LethalModUtils 一起装进
BepInEx/plugins/,只装 ShipSortNexus 不会生效。
安装
- 确认游戏已安装 BepInEx 5.4.x。
- 安装上面的 ShipSort + ChatCommandAPI + LethalModUtils。
- 确认
BepInEx/plugins/下只有一份 ShipSort(文件夹名可能是baer1-ShipSort或baer1-ShipSort-5.2.1)。 - 将本目录的
BepInEx/plugins/ShipSortNexus/整个复制到游戏的BepInEx/plugins/下:BepInEx/ plugins/ baer1-ShipSort/ baer1.ShipSort.dll ShipSortNexus/ ShipSortNexus.dll - 启动游戏,进入飞船后按 F8。
如果之前装过重复的 ShipSort 文件夹,请移除或改名,只保留一份;重复安装会导致 BepInEx 跳过其中一份并产生程序集歧义。
快捷键
| 按键 | 功能 |
|---|---|
| F8 | 打开 / 关闭 ShipSort Nexus 控制台 |
| F6 | 进入 / 退出灵魂模式(仅外太空) |
| F9 | 将当前手持物品捕获为“脚下锚点” |
| F10 | 应用全部锚点布局 |
| ESC | 关闭菜单;灵魂模式下返回身体 |
快捷键可在 BepInEx/config/wwaa.ShipSortNexus.cfg 中改成其他 Unity Input System 键名,
例如 F8、F7、Insert 等。
菜单结构
01 总览 OVERVIEW
- 轨道状态、物资数量、锚点数量、灵魂链路状态。
- 快速操作:
- 手持物品 → 脚下:立即把当前手持物放在脚下。
- 捕获脚下锚点:把当前手持物的内部名称 + 飞船本地坐标 + 朝向写入布局。
- 应用全部锚点:按捕获的布局重排物资。
- 进入 / 返回灵魂模式:与 F6 相同。
- 右上角显示动态
FROST SAMA // 霜华sama徽标。
02 布局 LAYOUT
- 列出所有已捕获锚点:内部名、显示名、飞船本地坐标、旋转、是否同类首件。
- 定位:进入灵魂模式并把相机移到锚点附近。
- 首件:把这条锚点设为该物品类型的“同类首件”。之后应用布局时, 所有同内部名的物品都会使用这条锚点的位置和朝向。
- 删除:删除单条锚点。
- 清空全部:需要二次确认,同时清除单件锚点和集中点。
- 分类吸取(单击一次即执行,不是开关):
- 整理/吸取时不会丢下手中物品:手持物会被排除在排序之外,并临时拦截 ShipSort 的自动丢弃。
- 摆放带偏移与朝向变化:物品不再全部叠在同一点或朝向同一方向,会按索引产生小范围散开和角度变化。
- 工具:吸取所有工具,包含单手和双手,不含废料。
- 小刀
KnifeItem与霰弹枪ShotgunItem强制归为工具,即使游戏原属性标记为废料; 它们不会被单手/双手废料吸取,并且物资页会显示为TOOL。 - 单手废料:只吸取单手废料。
- 双手废料:只吸取双手废料。
- 每类都有 吸取 / 定位 / 清除:
- 吸取:在脚下生成该类集中点并立即应用;灵魂模式下取准星落点。
- 定位:一键进入灵魂模式并把相机移到该类集中点。
- 清除:单独取消该类集中点。
- 工具吸取:会覆盖工具已有坐标,只按工具集中点重排所有工具。
- 废料吸取:会保留废料已有坐标(单件锚点 / 同类首件),集中点只接收尚未设点的废料;
废料集中点本身会写入
anchors.tsv保存。 - 删除原版脚本选择按钮:菜单不再提供“运行 ShipSort”入口。
- 捕获时同类跟随(默认开启):
- 捕获一个物品锚点时,自动把它设为该类型的首件。
- 再捕获同类型物品,会移动这个首件的位置,而不是新增第二个分散锚点。
- 想要同类型多位置时,关闭此开关,再逐条捕获。
03 灵魂 SOUL
- 进入 / 返回:切换脱离身体的自由相机。
- 移动速度、鼠标灵敏度可调。
- 显示物品标记开关。
- 飞行控制:WASD 水平移动,SPACE / CTRL 升降,SHIFT 加速。
- 空手时准星选择:
- 第一次左键:选中准星中间的物品,HUD 显示
SELECT和物品中文名。 - 第二次左键:把当前准星落点设为该物品的坐标点。
- 右键:取消选择。
- 手持物品时左键仍直接捕获手持物品,不进入选中模式。
- 第一次左键:选中准星中间的物品,HUD 显示
04 物资 ITEMS
- 扫描飞船内所有可抓取物。
- 名称中文化:优先调用已安装的 LC Chinese Project 运行时翻译;没有该模组时使用内置中文名表。
小刀
KnifeItem、霰弹枪ShotgunItem也显示为中文,并归入工具。 - 筛选:全部 / 废料 / 工具 / 手持。
- 定位:进入灵魂模式并看向该物品。
- 脚下:把该物品移动到玩家脚下(手持物走原版丢弃 RPC,非手持物走 ShipSort 同款放置 RPC)。
05 设置 SETTINGS
- 锚点重新载入 / 保存。
- 灵魂相机速度、鼠标灵敏度恢复默认。
- 配置文件与数据文件位置说明。
灵魂模式规则
灵魂模式不是网络传送,也不会移动玩家身体:
- 玩家身体留在飞船内;只有本地相机脱离。
- 相机可穿过船体自由飞行,用于观察和定位摆放点。
- 仅当以下条件全部满足时允许:
StartOfRound.inShipPhase == trueshipIsLeaving == false- 没有在离舰 / 加载流程中
- 一旦进入地表、开始降落、离舰或场景切换:
- 系统在
Update中检测到!IsOrbit; - 立即销毁灵魂相机、恢复游戏相机与输入;
- 显示“已进入地表层:灵魂模式强制终止”;
- 不需要手动返回,也不会把身体留在外面。
- 系统在
锚点与布局
锚点文件:
BepInEx/config/ShipSortNexus/anchors.tsv
格式为制表符分隔(v2):
key x y z rotation display type utc_ticks follow_first
@GROUP tool x y z rotation
@GROUP one_scrap x y z rotation
@GROUP two_scrap x y z rotation
key是物品的内部名,例如ClipboardManual、ShotgunItem,不是显示名clipboard。- 坐标是
/Environment/HangarShip的本地坐标。 - 旋转是玩家朝向(度)。
follow_first = 1表示这条锚点是该物品类型的“同类首件”;该类型所有物品都会使用它。@GROUP tool/one_scrap/two_scrap分别是工具 / 单手废料 / 双手废料集中点; 没有对应行表示未设置。- 旧版
@GROUP one/two/one_tool/two_tool都会按“工具集中点”读取。 - 关闭“捕获时同类跟随”后,同一个内部名可以保存多条分散锚点,应用时按捕获顺序匹配同类物品。
- 应用布局时,插件在内存中生成 ShipSort v5 的 Lua 脚本,并调用
LethalShipSort.Sort(...)。因此物品垂直偏移、放置 RPC、网络同步都复用 ShipSort 的逻辑。
布局优先级按类别区分:
- 工具:
- 工具集中点;
- 同类首件(
follow_first); - 普通单件锚点。 只要设置了工具集中点,所有工具都会被吸到该点,不保留工具原坐标。
- 废料:
- 同类首件(
follow_first); - 普通单件锚点;
- 单手 / 双手废料集中点(只接收未设点废料)。
废料吸取会保留已有废料坐标,同时把废料集中点保存到
anchors.tsv。
- 同类首件(
清除对应集中点后,该类才会回退到单件锚点 / 同类首件。
相关配置
BepInEx/config/wwaa.ShipSortNexus.cfg:
Layout/FollowSameTypeOnCapture(默认true):捕获时自动把该物品设为同类首件。Layout/MaxAnchors:普通锚点数量上限。Soul/Speed、Soul/Sensitivity、Soul/ShowItemMarkers:灵魂相机参数。Keys/Menu、Keys/Soul、Keys/Capture、Keys/Apply:快捷键。
客户端 / 联机
- 每个客户端都要安装 ShipSort 5.2.1 和 ShipSortNexus;本面板不是主机专属。
- 菜单、灵魂模式、锚点捕获、分类吸取在客户端本地都能打开和操作。
- 物品移动通过本地玩家的 ShipSort / 放置 RPC 发送给服务器,最终位置由服务器同步。
- 菜单头部和设置页会显示当前角色:
HOST或CLIENT。 anchors.tsv是本地文件,默认每个客户端各自保存自己的布局。 如果希望客户端与主机使用完全相同的布局,把主机的BepInEx/config/ShipSortNexus/anchors.tsv复制到客户端对应位置即可。- 客户端移动非自己持有的物品时,服务器仍是最终权威;被服务器拒绝时以服务器状态为准。
故障排查
F8 没反应
- 看
BepInEx/LogOutput.log是否有ShipSort Nexus v1.1.0 online。 - 确认没有第二份 ShipSort 安装。
- 本插件使用一个
DontDestroyOnLoad的运行宿主;Lethal Company 在读取存档时会销毁 BepInEx 管理器,宿主会在下一次sceneLoaded时自动重建。 - 如果菜单打开但鼠标点不到,确认游戏窗口在前台;菜单打开时插件会主动解锁鼠标。
提示“未检测到 ShipSort 运行时”
- ShipSort 未安装,或安装了两份导致引用到未激活的那一份。
- 只保留
baer1-ShipSort-5.2.1,重新启动游戏。
应用布局后物品没动
- 检查锚点的
key是否写成了显示名;应使用内部名。 - 看日志是否有
Sorted x/y;0/16表示布局里没有匹配当前物品内部名的条目。 - 单手 / 双手集中点会覆盖普通锚点;先点“清除单手 / 清除双手”再应用单件布局。
联机时物品不同步
- 客户端也可以使用本面板;物品放置走本地玩家的 RPC,最终由服务器同步。
- 如果客户端没有安装 ShipSort / ShipSortNexus,客户端无法使用本面板。
- 客户端移动非自己持有的物品时,最终以服务器状态为准。
- 布局文件默认是每个客户端本地的;需要统一布局时复制主机的
anchors.tsv。
构建
E:\wwaa\.dotnet\dotnet.exe build E:\wwaa\ShipSortNexus\ShipSortNexus.csproj -c Release
产物:
E:\wwaa\ShipSortNexus\dist\BepInEx\plugins\ShipSortNexus\ShipSortNexus.dll
项目引用游戏目录下的:
Assembly-CSharp.dllUnity.Netcode.Runtime.dllUnityEngine*.dllUnity.InputSystem.dllBepInEx/core/BepInEx.dllBepInEx/plugins/baer1-ShipSort-5.2.1/baer1.ShipSort.dll
版本
-
1.3.5 — 作者名统一为
shuanghuasama1145,补充 Thunderstore 发布用图标、CHANGELOG 和根目录 README。 -
1.3.4 — 模组显示名、介绍和界面加入 Frost sama / 霜华sama 水印。
-
1.3.3 — 灵魂模式空手左键选中准星物品,再次左键设置坐标,右键取消选择。
-
1.3.2 — 整理/吸取保留手持物品;摆放增加小范围位置偏移和旋转变化,避免全部同点同向。
-
1.3.1 — 将小刀
KnifeItem与霰弹枪ShotgunItem强制归类为工具,而不是废料。 -
1.3.0 — 合并为“工具吸取 + 单手废料 + 双手废料”;工具吸取覆盖工具坐标, 废料吸取保留已有坐标并保存废料集中点;新增右上角霜华sama动态徽标。
-
1.2.0 — 新增四分类吸取(单手/双手 × 物品/废料)、每类一键定位、右上角霜华sama动态徽标; 移除“运行 ShipSort”原版脚本入口;吸取只作为未设点物品的兜底,不再覆盖单件/同类首件坐标。
-
1.1.0 — 新增单手/双手一键归位、同类首件跟随、捕获时同类跟随开关; 修复清除集中点时的空引用;修复菜单/灵魂模式打开时物品输入未被拦截的问题。
-
1.0.0 — 初版:F8 控制台、脚下锚点、布局应用、物品列表、外太空灵魂相机、地表强制回归。