frostsama-ShipSortNexus icon

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.

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-5.4.2304 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2304
baer1-ShipSort-5.2.1 icon
baer1-ShipSort

Highly customizable mod that organizes all items on your ship

Preferred version: 5.2.1

README

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


必须先安装的依赖

  1. BepInExPack 5.4.x
  2. ShipSort 5.2.1(baer1.ShipSort)
  3. ChatCommandAPI 1.2.1(ShipSort 的依赖)
  4. LethalModUtils 1.0.1(ShipSort 的依赖)

使用 Thunderstore Mod Manager / r2modman 时,安装 ShipSort 会自动带上依赖; 如果手动解压 zip,必须把 ShipSort、ChatCommandAPI、LethalModUtils 一起装进 BepInEx/plugins/,只装 ShipSortNexus 不会生效。


安装

  1. 确认游戏已安装 BepInEx 5.4.x。
  2. 安装上面的 ShipSort + ChatCommandAPI + LethalModUtils。
  3. 确认 BepInEx/plugins/ 下只有一份 ShipSort(文件夹名可能是 baer1-ShipSort 或 baer1-ShipSort-5.2.1)。
  4. 将本目录的 BepInEx/plugins/ShipSortNexus/ 整个复制到游戏的 BepInEx/plugins/ 下:
    BepInEx/
      plugins/
        baer1-ShipSort/
          baer1.ShipSort.dll
        ShipSortNexus/
          ShipSortNexus.dll
    
  5. 启动游戏,进入飞船后按 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 和物品中文名。
    • 第二次左键:把当前准星落点设为该物品的坐标点。
    • 右键:取消选择。
    • 手持物品时左键仍直接捕获手持物品,不进入选中模式。

04 物资 ITEMS

  • 扫描飞船内所有可抓取物。
  • 名称中文化:优先调用已安装的 LC Chinese Project 运行时翻译;没有该模组时使用内置中文名表。 小刀 KnifeItem、霰弹枪 ShotgunItem 也显示为中文,并归入工具。
  • 筛选:全部 / 废料 / 工具 / 手持。
  • 定位:进入灵魂模式并看向该物品。
  • 脚下:把该物品移动到玩家脚下(手持物走原版丢弃 RPC,非手持物走 ShipSort 同款放置 RPC)。

05 设置 SETTINGS

  • 锚点重新载入 / 保存。
  • 灵魂相机速度、鼠标灵敏度恢复默认。
  • 配置文件与数据文件位置说明。

灵魂模式规则

灵魂模式不是网络传送,也不会移动玩家身体:

  • 玩家身体留在飞船内;只有本地相机脱离。
  • 相机可穿过船体自由飞行,用于观察和定位摆放点。
  • 仅当以下条件全部满足时允许:
    • StartOfRound.inShipPhase == true
    • shipIsLeaving == 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 的逻辑。

布局优先级按类别区分:

  • 工具:
    1. 工具集中点;
    2. 同类首件(follow_first);
    3. 普通单件锚点。 只要设置了工具集中点,所有工具都会被吸到该点,不保留工具原坐标。
  • 废料:
    1. 同类首件(follow_first);
    2. 普通单件锚点;
    3. 单手 / 双手废料集中点(只接收未设点废料)。 废料吸取会保留已有废料坐标,同时把废料集中点保存到 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.dll
  • Unity.Netcode.Runtime.dll
  • UnityEngine*.dll
  • Unity.InputSystem.dll
  • BepInEx/core/BepInEx.dll
  • BepInEx/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 控制台、脚下锚点、布局应用、物品列表、外太空灵魂相机、地表强制回归。