【0.98】控制台前端 Console Frontend v0.3.1
本帖最后由 HIMI 于 2026-10-21 21:01 编辑主界面
其他界面
【2026-10-19 更新】v0.3.1 已发布（见帖子附件）
___
简介
Console Commands 是远行星号上最实用的调试/整活工具之一，但它终归是个命令行：想加 100 万星币得手打 addcredits 1000000，想加物品得先知道 additem 后面那串内部 ID 是什么，想加颗行星更是要自己写一段代码。
控制台前端把这些命令全部摊成一个中文按钮面板：
- 想加金币？点「加星币」按钮，弹出一个只填数字的输入框，填完点执行。- 想加物品？点「加物品」按钮，下拉列表里全是带中文名称的物品，还能直接打字搜索。- 想加行星？点「加自然天体」按钮，类型、半径、轨道半径、公转天数逐个填，说明里还写着原版常见值。- 面板上自动收录所有已装 Mod 注册的命令，装了新 Mod 就多出对应的按钮。
目标是让不熟悉命令行的玩家也能用上控制台的全部能力。
___
功能特性
1. 按钮式执行每个命令一个按钮，按用途分成 10 个大类：经济与资源、舰队与舰船、角色与军官、战斗、星图与移动、市场与殖民地、系统与调试、自然天体、人造设施、删除。目前预置了 94 条命令的中文名称、参数模板与说明；未预置的命令也会自动生成按钮（标签用命令名，参数从语法自动推导）。
2. 参数可自定义，并且会被记住带参数的命令（如「加星币」）执行前会显示参数区，可以自由填写数值。设置一次就会被记住，下次打开还是上次的值，直到你主动修改。- 117 个参数全部带中文标签，其中 48 个还带说明，写清单位、取值范围和原版常见值。- 参数多的时候（例如「加小行星群」有 11 个参数）会自动排成 2~3 列，不会撑出屏幕。- 保存位置：saves/common/config/console_frontend_params.json.data
3. ID 选择器：游戏内名称优先，ID 作为注释保留需要 ID 的参数（加物品、加船、加武器、加船插、选势力、选市场等，共 22 类来源）提供「搜索框 + 分类标签 + 下拉列表」三合一：- 列表每行左边是游戏内显示名称（如「双面神」装置），右边小字是原始 ID（如 JANUS）。- 支持直接输入名称或 ID 过滤，也可以只跟列表走。- 条目按来源 Mod 归类，可以筛选只看某个 Mod 的物品。
4. 天体编辑面板（v0.3.0 新增）在面板里直接生成或删除星系里的天体，不用记 ID、也不用写代码：- 自然天体：行星、星云、行星环、小行星带、小行星群（残骸云）。- 人造设施：空间站、通信中继、导航浮标、不活跃星门。- 删除：列出当前星系内的全部天体与设施，按名称搜索后点选即可，不用手打 ID。行星类型、星云贴图、行星环类型这些选项全部显示中文名（如「紫蓝星云」），写进命令行的仍是游戏认识的原始 ID。生成逻辑走 runcode，不依赖任何第三方天体 Mod。
5. 界面字体可以自己选（不打包字体）界面全部中文，字体默认使用游戏自带的 graphics/fonts/victor16.fnt，本 Mod 不打包任何字体文件。顶栏的「字体」按钮会扫描游戏本体与所有已启用 Mod 的 graphics/fonts 目录，把找到的 .fnt 列出来（含中文的排在前面，并标注来源、行高、字形数），选中即保存、立即生效。想换字体的话，把 .fnt 和配套的同名 _0.png 一起放进Starsector/mods/任意Mod/graphics/fonts/（或 starsector-core/graphics/fonts/），重开面板点「字体」就能看到。若未安装汉化包导致中文显示为方块，可在设置里打开「使用英文标签」。
6. 输出日志区面板底部实时显示命令输出，最新的输出排在最上方，一页正好一屏；滚轮或「上一页 / 下一页」按钮翻页。支持「清空日志」。
7. 危险操作二次确认被标记为危险的命令（解锁全部蓝图、摧毁殖民地、自杀、删除天体等）执行前会弹确认框，可关。
8. 游戏内设置界面（装了 LunaLib 后可以自行调整）呼出热键（默认 ~）/ 需要 Ctrl·Shift·Alt / 面板宽度占比（0.4~1）/ 背景变暗（0~1）/按钮列数（1~8）/ 显示当前不可用命令 / 危险操作二次确认 / 显示输出日志 /日志行数（10~200）/ 记住参数设置 / 选择器显示来源 Mod / 选择器每页条数（10~100）/使用英文标签
___
安装
1. 确认已安装并启用 Console Commands 4.0.x 与 LazyLib（缺一不可，本 Mod 依赖它们运行）。2. 下载帖子附件 ConsoleFrontend-0.3.0.zip 并解压。3. 把解压出的 ConsoleFrontend 文件夹放进 Starsector/mods/。4. 在启动器的 Mod 列表中启用 Console Frontend。5. 进入存档后按 Ctrl + ~ 呼出面板。
卸载：直接在启动器里关掉即可，不会影响存档。
想彻底清理，可顺带删除 saves/common/config/ 下的这两个文件（只存你填过的参数和选过的字体，无其它内容）：
- console_frontend_params.json.data- console_frontend_font.json.data
___
兼容性与注意事项
- 前置：Console Commands（lw_console）；LazyLib 是 Console Commands 的运行依赖，请一并安装并启用。- 无已知冲突 Mod。默认热键是 Ctrl + ~（带 Ctrl 修饰），Console Commands 自带的控制台默认是 ~，两者不会互相抢占；如需调整可在 LunaLib 设置里改键。- 真控制台打开时本面板会自动让位，不会抢输入。- 本 Mod 不修改游戏本体文件，不读写游戏目录以外的文件；运行期只读取 Console Commands 的公开 API 与游戏自带的字体/贴图资源。- 本 Mod 不打包、不修改任何上游 Mod 的代码或素材。
___
来源声明与致谢
- 本 Mod 基于 Console Commands 提供的公开 API 开发，未包含、未复制、未修改其上任何源代码与素材。- Console Commands 的 mod_info.json 中，Mod 作者署名为 LazyWizard、Lukas04；其 GitHub 仓库的代码贡献者（Contributors）还包括 jaghaimo 与 NickNedfinity。感谢以上诸位作者与贡献者。- 上游 license.txt 明确声明："All modders have my permission to copy and use any code I've written."- 感谢 LazyLib、LunaLib 作者提供的前置支持。- AI 使用说明：本 Mod 的源代码、文档与发行包由作者与 AI 助手协作完成；所有改动均在本机游戏中实测通过后才发布。
___
更新日志
v0.3.1（2026-10-19）- 修复：用「加船插」按钮添加某些船插时会加错型号。例如点「加船插」选「自动维修」（armaa_autoModuleRepair），实际加进背包的却是「目标定位干扰器」。 经核查，问题出在控制台本体的加船插命令上：它会先把「隐藏」类船插从候选列表里剔除，再拿剩下的列表做模糊匹配。像「自动维修」这种隐藏船插根本不在列表里，精确匹配必然落空，就被分给了某个「长得像」的可见船插。 本 mod 的选择器本来就能选到这些隐藏船插，给出的 id 也是准确的，这一版改为由本 mod 直接完成添加，不再经过这段模糊匹配；认不出 id 时会如实提示，不再猜测。
v0.3.0（2026-10-18）
新增- 天体编辑面板：「自然天体 / 人造设施 / 删除」三类界面。行星、星云、行星环、小行星带、小行星群（残骸云）都能填参数直接生成；空间站、通信中继、导航浮标等人造设施同理；删除类按当前星系的天体列表挑选，不用手打 ID。- 参数说明全覆盖：48 条说明，写清单位、取值范围和原版常见值。- 枚举参数显示中文名：选项显示「紫蓝星云」这样的中文，写进命令行的仍是原始 ID。
修复- 参数页超出屏幕：像「加小行星群」这种 11 个参数、每个都带说明的命令，底部「执行 / 恢复默认 / 收起」会被顶出屏幕，日志区还会和参数行叠在一起。现在参数区按剩余高度自动排 1~3 列，优先保住日志区。- 说明文字被下一行盖住：长说明折成两行时，第二行会压到下一个输入框上。- 说明文字显示成问号：文案里用了 ≈ ≥ 「 」 ～ → 这些游戏字体没有的字形，现在已全部替换成字体里有的字符。- 枚举中文名污染命令行：枚举框里的中文名会被存回参数草稿，导致命令变成 astroaddnebula key=紫蓝星云 而静默失败。现在写回前会反查回原始值。
改动- 重写 31 条含糊说明。- 已保存的参数、字体与按键设置不受影响，覆盖安装即可。
v0.2.3（2026-10-15）
- 修复：用「加战机」按钮添加战机时可能加错型号。例如点「加战机」选「咏叹调 (M)」，加进来的却是同系列的「苍兰 EX (ASF)」。经核查，战机 Mod 本身的 id 与名称对应没有问题，本 mod 的名称对照表也没有问题，问题出在控制台本体的加战机命令上：它会把你输入的 id当成「显示名」再反查一次 id，遇到同系列前缀相似的战机会串到另一个型号。本 mod 的选择器给出的本来就是准确 id，被它二次改写才出错。这一版改为由本 mod 直接完成添加，不再经过这段改写。- 修复：战机 id 输入不完整时会串到别的战机。例如多写了后缀的 uaf_wing_m_aria_wing以前会错选同系列其它战机；现在按「完全一致 → 忽略大小写完全一致 → 唯一前缀 → 唯一包含」逐级查找，拿不准就如实提示未找到并建议用选择器挑，不再猜测。
v0.2.2（2026-10-13）
- 修复：市场、殖民地管理界面里按热键呼不出面板。在这类界面开着的时候热键完全没反应。原因是游戏规定「已经有一个界面弹窗时不允许再弹新的」，而这个界面又不算弹窗，导致面板没能挂上去；现在改为在对话框开不出来时自动改用「覆盖层」方式，直接把面板叠在当前界面上。- 修复：覆盖层面板能显示却完全点不动，鼠标移上去也不高亮。挂载与事件投递用的反射调用被静默跳过了，而且鼠标事件没有真正交给按钮自己处理；现在改为直接调用游戏接口，并把鼠标事件原样交给按钮，悬停高亮、按下反馈、点击音效都恢复，点击也不会穿透到底下的游戏界面。
v0.2.1（2026-10-11）
- 修复：战斗中打开面板后，所有按钮都点不动。原因是战斗中的面板没有挂进游戏自己的界面树；现在改为面板自己每帧主动接收并投递输入，同时推进控件动画，按钮点击恢复正常。
v0.2.0（2026-10-11）
- 新增「界面字体」选择器：面板顶栏多了一个「字体」按钮。点开后会列出游戏本体与所有已启用 Mod 的graphics/fonts 目录里的全部 .fnt 字体（含中文的排在前面，并标出字体来源、行高与字形数）。选中后立即生效并被记住，不用重启游戏；不想折腾的话保持「游戏自带」即可，外观和 0.1.1 一模一样。- 新增：中文 Mod 的命令直接用中文当按钮名。以前第三方 Mod 的命令按钮只能显示命令名，有些人反馈 psm_addShipXP 这类全大写很难读——现在只要命令自带中文描述，按钮就直接显示中文（如「获得全部兽耳娘」）。- 新增：需要 ID 的命令改用命令自身的自动补全候选。现在列表只列该命令真正接受的 ID。- 新增：「开发模式」这类开关参数，选择器只列自己的可选值（以前会错误地弹出全部商品列表）。- 新增：控制台命令 consolefrontend resetfont：把界面字体恢复成游戏自带。- 修复：命令按钮被显示成全大写（例如 PSM_ADDSHIPXP）。原因是游戏自带的 victor 系列字库属于「小型大写」字形——小写字母画的也是大写形状，而按钮一直用的就是这套字体。现在纯英文按钮改用含真小写的字体，命令名按原始大小写显示。- 修复：搜索框输入后没反应。根因是输入框拿到焦点后按键被原生控件吃掉了，面板只在回车时才去读内容；现在改为每帧主动读取输入框，中文输入法也不会把字截断。- 修复：按钮文字超出按钮或留一大片空白。以前按字符数截断，中文（一个字约两个半角宽）会溢出、英文会剩一大截；现在按实际显示宽度截断并带省略号。- 改动：本版不打包任何字体。字体为运行时扫描你已装的那些，在面板里选；因此压缩包只有 98,636 字节（约 96 KB）。没有选择任何字体时，外观与 0.1.1 完全一致。- 改动：命令「加金币」统一改名为「加星币」。
v0.1.1（2026-10-09）
- 修复「命令输出」区不显示内容的问题（滚动偏移改为带钳位的实现）。- 日志区改为「最新在最上方 + 一页一屏」，支持滚轮与按钮翻页。- 修复「搜索」标签与搜索框未对齐。- 字体统一调大，界面去掉灰色底、只保留边框。
v0.1.0（2026-10-09）
- 首个公开发布版本。
常见问题
Q：按了热键没反应？A：① 确认 Console Commands 与 LazyLib 都已启用；② 默认是 Ctrl + ~，要按住 Ctrl 再按 ~；③ 可能在 LunaLib 设置里被改过键位，或与其它 Mod 热键冲突，必要时换一个键。
Q：中文显示成方块？A：说明当前环境没加载到中文字形，在 LunaLib 设置里打开「使用英文标签」即可。
Q：某个命令找不到？A：① 该命令在你当前场景下不可用（比如战斗中和星图上的命令不同），可在设置里打开「显示当前不可用命令」让它灰显出来；② 装了新 Mod 后点一下「刷新目录」。
Q：为什么有些命令没有中文名字？A：中文名称与参数模板是人工整理的，还没覆盖全部命令。未覆盖的命令会自动生成按钮（用命令名作标签）；也欢迎在帖子里反馈，我按优先级补。
Q：会不会影响存档 / 能不能中途卸载？A：不影响存档，可随时移除。本 Mod 不写存档数据，只在自己维护的参数文件里记录你填过的数值。
Q：我想换个字体 / 字体列表里没有我想要的？A：把字体的 .fnt 与配套的同名 _0.png 一起放进任一 Mod 的 graphics/fonts/ 目录（游戏本体目录 starsector-core/graphics/fonts/ 也可以），重开面板点顶栏「字体」按钮即可看到。列表里标注「无中文」的字体只有拉丁字形，中文会显示成方块，建议优先选含中文的。
Q：加出来的天体能删掉吗？A：能。面板的「删除」分类会列出当前星系内的全部天体与设施，按名称搜索后点选即可。注意删除不可撤销，建议先存个档。
___
下载
见本帖附件：ConsoleFrontend-0.3.1.zip
也可从 GitHub Releases 获取顺便给我点个 star？(✪ω✪)：https://github.com/himi-li/Starsector-ConsoleFrontend/releases
如果有 bug 或想加的内容，欢迎在帖子里回复，我会陆续更新。 离情笃生 发表于 2026-10-24 14:37
安超097之后，lunalib界面可以正常改设置，但是进入存档后无法呼出界面
是0.97版本吗？本mod暂时只适配0.98版本，我电脑上装的也是0.98版本，做不了实际测试。如果可以的话，请把日志私发给我，我看看能不能修（路径一般是Starsector\starsector-core\starsector.log） 安超097之后，lunalib界面可以正常改设置，但是进入存档后无法呼出界面 本帖最后由 HIMI 于 2026-10-18 19:36 编辑
浅色弧光 发表于 2026-10-17 22:27
请问有添加和删除天体的功能吗？控制台本体有添加小行星带的代码，但是生成的小行星带没有背景 ...
已实现，请更新到最新版本0.3.0，感谢反馈，另外如果游玩过程中发现了新bug请告诉我，谢谢 请问有添加和删除天体的功能吗？控制台本体有添加小行星带的代码，但是生成的小行星带没有背景 强强强！！！ 牛的，大佬 本帖最后由 HIMI 于 2026-10-14 23:01 编辑
盐泡虾米 发表于 2026-10-14 21:27
增加序号1的飞机，结果输出的命令是序号2
查出来了，是控制台本体Console Commands的问题，或许也可以算作是uaf的问题？
原因：
1、原版的战机 ID 全都是以 _wing 结尾的（比如 trident_wing），所以控制台命令的作者就默认“所有战机 ID 都长这样”。
2、但 UAF 的战机 ID 不是这个格式。咏叹调(M) 的真实 ID 是 uaf_wing_m_aria，结尾并没有 _wing。
3、于是控制台命令在背后自动给它补了一个 _wing，变成 uaf_wing_m_aria_wing——这个名字根本不存在。
4、找不到的时候它不会报错，而是“猜一个最像的”。而它猜出来的结果正是苍兰EX(ASF)。所以你看到的就是这个结果。
我会尝试在添加战机时绕开控制台命令的这段逻辑，直接按真实 ID 添加，修复预计会在明天发布
感谢反馈{:tieba_35:}
如果方便的话，也请一并反馈给控制台的作者:handshake 本帖最后由 盐泡虾米 于 2026-10-14 21:31 编辑
HIMI 发表于 2026-10-13 10:31
能发一下截图吗？
增加序号1的飞机，结果输出的命令是序号2 哇塞大佬你知道吗 你简直就是神{:tieba_43:}{:tieba_43:}{:tieba_43:} 盐泡虾米 发表于 2026-10-13 08:56
大佬我昨天添加UAF的LAC，添加咏叹调（M）结果是苍风，试了UAF里几个M的LAC也都是变成了SP的LAC。 ...
能发一下截图吗？ 大佬我昨天添加UAF的LAC，添加咏叹调（M）结果是苍风，试了UAF里几个M的LAC也都是变成了SP的LAC。 不赖 yangyilinAlan 发表于 2026-10-11 22:05
貌似手机版用不了，按键呼不出来
如果你装了LunaLib的话，热键是可以在游戏里调整的，试试改个热键？ 貌似手机版用不了，按键呼不出来 虽然我知道这是隔壁的问题啊，但我还是来提一嘴，大远征mod(搜打撤)用不了{:tieba_11:} 哇塞，NB 本帖最后由 HIMI 于 2026-10-11 16:44 编辑
v0.2.0版本已更新，大家可以下载新版本。所有反馈的bug均已修复，并根据反馈添加了新功能 本帖最后由 HIMI 于 2026-10-10 21:44 编辑
相位船爱好者 发表于 2026-10-10 20:41
能不能把开发者模式也做成这样
当前mod还处于测试阶段，等这个mod稳定后，我会考虑的（可能会做成这个mod的新功能？或者做一个新mod？） 能不能把开发者模式也做成这样 随着四行命令敲上去，战斗瞬间索然无味（ 无敌了，这是真轮椅{:tieba_43:}{:tieba_43:} RimWorld？！{:5_121:} 本帖最后由 HIMI 于 2026-10-11 13:55 编辑
EririEX 发表于 2026-10-10 16:33
mod添加的类似于psm_addShipXP的命令会显示为PSM_ADDSHIPXP，全大写阅读起来非常困难，能直接显示原命令吗
...
坏消息：中文显示只能通过我这边添加汉化文本实现，因为部分命令的描述文本很长且不包含命令名称
已实现，但描述过长，超出显示的部分会用省略号代替
好消息：大写已全部修改为小写
为何列出来的是所有商品？不应该是getSuggestions方法的返回的List<String>嘛
不赖，非常好mod 本帖最后由 HIMI 于 2026-10-13 10:35 编辑
苍白而蔷薇 发表于 2026-10-10 16:49
字体能调整吗，在我这种笔记本小屏幕上非常的...
补个图
字体与你安装的汉化包有关，如果要添加字体的话，等我再研究研究。详细见GitHub描述“界面字体使用游戏内置、且已含 CJK 字形的 graphics/fonts/victor16.fnt （本面板不打包字体文件，直接读取游戏自带的字库）。 若未安装汉化包，可在设置中开启 使用英文标签。”
现在可以调整字体了，用的依然是游戏内置的，需要其他字体的话请自行下载安装 我去，这么强 本帖最后由 苍白而蔷薇 于 2026-10-10 16:57 编辑
字体能调整吗，在我这种笔记本小屏幕上非常的...
补个图
EririEX 发表于 2026-10-10 16:33
mod添加的类似于psm_addShipXP的命令会显示为PSM_ADDSHIPXP，全大写阅读起来非常困难，能直接显示原命令吗 ...
稍等，我看看怎么改 本帖最后由 EririEX 于 2026-10-10 16:35 编辑
mod添加的类似于psm_addShipXP的命令会显示为PSM_ADDSHIPXP，全大写阅读起来非常困难，能直接显示原命令吗
像这种是否可以检测一下描述有没有中文，有的话直接显示描述？ 宝石视觉 发表于 2026-10-10 15:56
ai时代的风终究吹到了远神，这种优化操作的ui交互模组ai好像挺在行的
远神没有ui编辑器，手搓ui全靠穷举进游戏调节位置，但是对ai来说这种抽象操作就没问题 好耶，大佬NB，终于不用每次都手敲或去翻笔记本了 ai时代的风终究吹到了远神，这种优化操作的ui交互模组ai好像挺在行的{:tieba_12:} 强强强，感谢大佬 盐泡虾米 发表于 2026-10-10 15:50
大佬NB，晚上回家试试
感谢支持！其实没这么强，主要靠dsh制作，我负责整理、测试和调细节。遇到 bug 欢迎反馈。{:tieba_01:} 大佬NB，晚上回家试试
页:
[1]