pyxis ad astra 星界罗盘

远行星号 Mod 可视化编辑器

Visual mod editor for Starsector

星界罗盘 [Pyxis ad Astra] 是面向 Starsector Mod 作者的 Windows 桌面工具。从舰船与武器,到装配、表格与势力配置,都在可视界面中完成编辑。

Pyxis ad Astra is a Windows desktop tool for Starsector mod authors. Ships and weapons, variants, data tables and faction configs are all edited in a visual interface.

舰船编辑器带有镜像编辑。打开之后,对称的武器槽与引擎会保持同步。

The ship editor has mirror editing. With it on, symmetric weapon slots and engines stay in step.

开火预览可以直接读取尚未保存的武器草稿。预览是只读的,不会写入任何文件。

The fire preview can read a weapon draft you have not saved yet. It is read-only and never writes a file.

已保存的修改会进入文件历史。草稿撤销到头之后,还可以继续回放已经写盘的变更。

Saved changes enter the file history. Once a draft has nothing left to undo, you can keep going and replay changes already on disk.

资源查询优先使用当前 Mod,并从原版补全。使用原版资源与引用之前,请先配置本机的 Starsector 游戏目录。

Assets resolve from the current mod first and fall back to vanilla. Configure your local Starsector folder before using vanilla assets and references.

编辑器Editors

系统Systems

方向键切换条目Arrow keys change entry

表格与数据Tables & data

舰船数据表格与记录详情 / Ship data table with record details

类型:Type: 编辑器Editor

在表格中编辑舰船、武器等数据。被引用的条目以名称、ID 与缩略图呈现,详情栏可以直接打开对应的专用编辑器。

Edit ship, weapon and other data in a grid. Referenced entries show their name, ID and thumbnail, and the details panel opens the matching dedicated editor.

数据表:Data tables: 14

要点Notes

  • 覆盖舰船、武器、战机联队、船体插件、战术系统、描述文本等数据表
  • Covers ships, weapons, fighter wings, hullmods, ship systems, descriptions and more
  • 保留原表头、行序与注释行,按列定义校验输入
  • Original headers, row order and comment rows are preserved; input is validated per column
  • 搜索筛选、新建与删除行,支持逐步撤销与重做
  • Filter, add and delete rows with step-by-step undo and redo

相关条目Related entries

舰船画布Ship canvas

舰船引擎画布与属性编辑 / Ship engine canvas with property inspector

类型:Type: 编辑器Editor

直接在船体贴图上摆放武器槽、引擎与战机甲板的起降口,调整护盾、碰撞范围与边界。右侧检查器同步给出精确数值。

Place weapon slots, engines and fighter bay launch points right on the hull sprite, and adjust shield, collision radius and bounds. The inspector on the right keeps the exact values in view.

文件:Files: .ship

要点Notes

  • 镜像编辑让对称的槽位与引擎保持同步
  • Mirror editing keeps symmetric slots and engines in step
  • 模式快捷键: 总览 [P] 范围 [C] 边界 [B] 武器 [W] 战机甲板 [L] 引擎 [E]
  • Mode hotkeys: overview [P] radius [C] bounds [B] weapons [W] fighter bays [L] engines [E]
  • 引擎尾焰按所选引擎风格在画布上绘制
  • Engine flames are drawn on the canvas in the selected engine style

相关条目Related entries

武器与开火预览Weapons & fire preview

武器开火预览与播放控制 / Weapon fire preview with playback controls

类型:Type: 编辑器Editor

编辑武器、弹体与战术系统规格,再到独立的预览窗口里观察弹体与光束的发射、弹道与尾迹。

Edit weapon, projectile and ship system specs, then watch projectiles and beams fire in a separate preview window: launch, trajectory and trails.

文件:Files: .wpn / .proj / .system

要点Notes

  • 播放、暂停、逐帧步进与播放速度调节
  • Play, pause, step frame by frame and change playback speed
  • 炮塔视图与固定视图随时切换
  • Switch between turret and hardpoint views at any time
  • 可以直接预览尚未保存的草稿,预览本身不写入任何文件
  • Unsaved drafts can be previewed directly; the preview never writes to disk

相关条目Related entries

沉浸式装配Immersive refit

装配的武器、战机与插件配置 / Variant refit with weapons, wings and hullmods

类型:Type: 编辑器Editor

在贴近游戏内的界面里编辑舰船、武器、战机联队与装配。为装配安装武器、战机联队和船体插件,随时查看装配点数、幅能与武器组。

Edit ships, weapons, fighter wings and variants in an interface modeled on the game's own screens. Fit weapons, wings and hullmods while ordnance points, flux and weapon groups stay in view.

文件:Files: .variant / .ship / .wpn / wing_data.csv

要点Notes

  • 读取游戏目录中的原版字体绘制文字,观感贴近游戏内
  • Text is drawn with the fonts from your game install
  • 调整幅能寄存器、耗散通道与武器组
  • Adjust flux capacitors, vents and weapon groups
  • 舰船、武器、战机联队、装配各有一个沉浸式编辑器
  • One immersive editor each for ships, weapons, wings and variants

相关条目Related entries

表单与配置Forms & configs

势力的旗帜、徽章与字段编辑 / Faction flag, crest and field editing

类型:Type: 编辑器Editor

用字段表单编辑势力名称、旗帜、舰队与装备配置。同一工作区还提供 Mod 信息、战役、舰船皮肤与杂项配置的入口。

Edit faction names, flags, fleet and equipment settings through field forms. The same workspace also covers mod info, missions, ship skins and miscellaneous configs.

文件:Files: .faction / mod_info.json / .skin

要点Notes

  • 每个字段同时显示中文名称、原始键名与必填标记
  • Every field shows a readable label, its raw key and a required marker
  • 风险提示,例如修改 ID 会导致存档不兼容
  • Risk hints, for example that changing an ID breaks save compatibility
  • 图片与实体引用从候选目录中选择
  • Image and entity references are picked from candidate lists

相关条目Related entries

文件与工作区Files & workspace

Mod 文件目录浏览 / Mod file tree browser

类型:Type: 编辑器Editor

按目录浏览 Mod 文件,搜索并打开文本。顶部页签在多个 Mod 之间切换,各自保留编辑内容与保存历史。

Browse mod files by folder, search and open text files. Tabs along the top switch between several mods, each keeping its own edits and save history.

要点Notes

  • 打开游戏目录即可从中选择 Mod,也可以直接打开 Mod 根目录
  • Open the game folder and pick a mod from it, or open a mod root directly
  • 内置文本编辑器,支持行列定位
  • Built-in text editor with line and column navigation
  • 下次启动时恢复工作区: 已打开的 Mod、引用设置与列宽
  • The workspace is restored on the next launch: open mods, reference settings and column widths

相关条目Related entries

联合编辑Joint editing

类型:Type: 保存机制Saving

一艘舰船的规格、CSV 行、描述与皮肤分散在多个文件里。联合编辑把它们作为整体读取,并在同一次提交中一起写入。

A ship's spec, CSV row, description and skins live in separate files. Joint editing loads them as one unit and writes them in a single commit.

要点Notes

  • 舰船、武器、战机联队与装配都可以作为联合编辑的入口
  • Ships, weapons, fighter wings and variants can each be the root of a joint edit
  • 一次提交在文件历史中只登记一条记录
  • One commit is recorded as a single file history entry

相关条目Related entries

三方冲突选择Three-way conflicts

类型:Type: 保存机制Saving

提交时比较编辑基线、磁盘现状与你的草稿。互不冲突的修改自动合并,冲突字段由你逐项选择。

A commit compares your baseline, the file on disk and your draft. Independent changes merge on their own; conflicting fields are yours to choose.

要点Notes

  • 冲突时并排列出三个来源的值
  • On a conflict, the values from all three sources are shown side by side
  • 确认之后会再次核对文件版本,然后才写入
  • File versions are checked again after you confirm, before anything is written

相关条目Related entries

撤销、重做与文件历史Undo, redo & file history

类型:Type: 保存机制Saving

草稿内可以逐步撤销。已保存的修改进入文件历史,草稿撤销到头之后可以继续回放已经写盘的变更。

Step back through a draft, then further: saved changes enter the file history, and once a draft has nothing left to undo you can replay changes already on disk.

要点Notes

  • 文件历史按 Mod 隔离
  • File history is kept separately for each mod
  • 回放之前会列出受影响的文件并要求确认
  • Before a replay, the affected files are listed for you to confirm

相关条目Related entries

保留原始格式Format preservation

类型:Type: 保存机制Saving

写回时只改动修改位点。CSV 的表头、行序与注释行,以及 JSON-like 文件的原有结构,都按原样保留。

Only the edited spots are rewritten. CSV headers, row order and comment rows, and the original layout of JSON-like files, stay as they were.

要点Notes

  • 写出之后重新读取并核对结果
  • The result is read back and verified after writing
  • 来源文件缺失时,确认路径后可以重建
  • A missing source file can be rebuilt once you confirm its path

相关条目Related entries

原版资源回退Vanilla fallback

类型:Type: 资源与来源Sources

贴图与数据优先取自当前 Mod,其次是可引用的 Mod,最后由原版补全。

Sprites and data come from the current mod first, then from referenced mods, then from vanilla.

要点Notes

  • 引用来源按工作区页签的顺序组合,可以逐个开关
  • Reference sources follow the order of the workspace tabs and can be toggled one by one
  • 原版来源目录可以在设置中切换
  • The vanilla source folder can be switched in settings

相关条目Related entries

外部修改监听External change watch

类型:Type: 资源与来源Sources

持续监听 Mod 与原版目录。文件被其它工具改动后自动重读;存在未保存草稿时,外部版本会先暂存,不覆盖你的输入。

Mod and vanilla folders are watched. Files changed by other tools are reloaded automatically; with unsaved edits, the outside version is held back instead of overwriting you.

要点Notes

  • 连续的变化事件会合并成一批处理
  • Bursts of change events are handled as one batch
  • 文本编辑器中的外部差异作为待载入版本保留
  • In the text editor, outside differences are kept as a pending version

相关条目Related entries

失败可恢复Recoverable failures

类型:Type: 保存机制Saving

写入中途失败时,按逆序恢复已经执行的步骤。遇到非 UTF-8 文本,可以选择源编码完成转换。

When a write fails midway, the steps already applied are undone in reverse order. Non-UTF-8 text files can be converted by choosing their source encoding.

要点Notes

  • 恢复受阻时保留现场,可以继续恢复或明确放弃
  • If recovery is blocked, the state is kept so you can retry or explicitly give up
  • 错误提示附带原始诊断信息
  • Error messages carry the original diagnostics

相关条目Related entries

多窗口与新建 ModMulti-window & new mods

类型:Type: 工作区Workspace

规格编辑器、沉浸式编辑器、开火预览与文本编辑器各占独立窗口。也可以从零生成带 mod_info.json 的最小 Mod 骨架。

Spec editors, immersive editors, the fire preview and the text editor each get their own window. You can also scaffold a minimal mod with mod_info.json from scratch.

要点Notes

  • 重复打开同一目标时复用已有窗口
  • Opening the same target again reuses its existing window
  • Ctrl+Shift+S 保存当前 Mod 在所有窗口中的修改
  • Ctrl+Shift+S saves the current mod's edits across every window

相关条目Related entries

代码编辑器与 Java 工程Code editor & Java

类型:Type: main 分支新增,未列入 0.1.0 更新日志New on main, not in the 0.1.0 changelog

每个项目一个代码窗口,提供 Java 17 语法与语义分析: 大纲、诊断与引用。可以直接调用 JDK 编译,或交给 Gradle 构建,再把产物部署进 Mod。

One code window per project with Java 17 syntax and semantic analysis: outline, diagnostics and references. Compile with a JDK directly or build through Gradle, then deploy the output into your mod.

要点Notes

  • Gradle 可以来自项目 Wrapper、手动选择或系统 PATH
  • Gradle can come from the project wrapper, a manual pick or the system PATH
  • 引用来源中的文件以只读方式打开
  • Files from reference sources open read-only

相关条目Related entries

开始使用Getting started

  1. 01 / 获取程序Get the app

    # Windows / Node.js ^22.13.0 || >=24.0.0
    # Rust 1.99.1 / MSVC C++ build tools
    npm install
    npm.cmd run tauri -- dev
    npm.cmd run tauri -- build --no-bundle
    src-tauri\target\release\pyxis-ad-astra.exe

    在发布页或 GitHub 的 Releases 页面下载 Windows 可执行文件,下载后直接运行。

    Download the Windows executable from the Releases page on GitHub and run it.

    • 想自己编译,就克隆仓库并执行上面的命令,生成的程序位于黄色标出的路径
    • To build it yourself, clone the repository and run the commands above; the executable lands at the path shown in yellow
    • 可以先在浏览器里打开在线体验
    • Open the live demo in your browser first if you like
  2. 02 / 打开目录Open a folder

    目录选择页 / Folder selection page

    启动后先看到目录选择页。点击 "打开目录",选择 Starsector 游戏目录,再从中挑选要编辑的 Mod。

    The app starts on the folder selection page. Click "打开目录" (Open folder), choose your Starsector folder, then pick the mod you want to edit.

    • 也可以直接选择某个 Mod 的根目录
    • You can also choose a mod's root folder directly
    • "创建新 Mod" 会生成带 mod_info.json 的最小 Mod 骨架
    • "创建新 Mod" (Create new mod) scaffolds a minimal mod with mod_info.json
    • 使用原版资源与引用时,需要配置本机的 Starsector 游戏目录
    • Vanilla assets and references need your local Starsector folder to be configured
  3. 03 / 选择条目Pick an entry

    舰船表格与详情栏 / Ship table and details panel

    左侧导航按内容分类: 舰船、武器、战机联队、船体插件、装配、势力等,旁边的数字是条目数量。进入分类后,在表格里选中要编辑的一行。

    The left navigation is grouped by content: ships, weapons, fighter wings, hullmods, variants, factions and more, each with its entry count. Open a category and select the row you want to edit.

    • 右侧详情栏显示贴图与字段速览
    • The details panel on the right shows the sprite and a field summary
    • "操作" 一栏提供舰船编辑器、沉浸式编辑器和文本编辑器三个入口
    • Its "操作" (Actions) block opens the ship editor, the immersive editor or the text editor
    • 保存前需要确认的问题会列在右上角
    • Issues that need confirming before a save are listed at the top right
  4. 04 / 撤销与回退Undo & roll back

    Spec 编辑器中的保存与撤销 / Saving and undo in the spec editor

    修改之后点击 "保存" 写入文件,标题旁的状态点会显示是否已保存。改错了随时可以退回去。

    After editing, click "保存" (Save) to write the file; the dot beside the title shows whether everything is saved. Mistakes can always be walked back.

    • Ctrl+Z 撤销,Ctrl+Shift+Z 重做
    • Ctrl+Z undoes, Ctrl+Shift+Z redoes
    • Ctrl+Shift+S 保存当前 Mod 在所有窗口中的修改
    • Ctrl+Shift+S saves the current mod's edits across every window
    • 已保存的修改进入 "文件历史",确认受影响的文件后可以回放
    • Saved changes enter "文件历史" (File history) and can be replayed once you confirm the affected files

沉浸式装配 / 简化演示Immersive refit / simplified demo

完整功能请打开在线体验。

The playable refit needs scripts enabled. Open the live demo for the full editor.

页面内的简化演示。实际的沉浸式编辑器更为完善。

A simplified in-page demo. The actual immersive editor is more complete.

编辑前请备份 Mod。在线体验中的编辑结果只保留在当前页面会话中,刷新后恢复样本。

Back up your mod before editing. Edits in the live demo stay in the current page session and reset on refresh.

原生支持: 下列格式由专用编辑器直接读写,按字段解析与校验,并在保存时保留原始格式。其它文本文件可以用内置文本编辑器打开。

Native support: the formats below are read and written by dedicated editors that parse and validate each field and keep the original formatting on save. Any other text file opens in the built-in text editor.

规格与配置 (14)Specs & configs (14) 原生支持Native support

  • 舰船规格Ship hull spec.ship
  • 武器规格Weapon spec.wpn
  • 弹体与导弹Projectiles.proj
  • 战术系统Ship system.system
  • 装配Variant.variant
  • 舰船皮肤Ship skin.skin
  • 势力Faction.faction
  • Mod 信息Mod infomod_info.json
  • 战役Missionsmissions/
  • 游戏设置Game settingssettings.json
  • 船体样式Hull styleshull_styles.json
  • 引擎样式Engine stylesengine_styles.json
  • 音效与音乐Sounds & musicsounds.json
  • 界面文本UI stringsstrings.json

数据表 (14)Data tables (14) 原生支持Native support

  • 舰船Shipsship_data.csv
  • 武器Weaponsweapon_data.csv
  • 战机联队Fighter wingswing_data.csv
  • 船体插件Hullmodshull_mods.csv
  • 战术系统Ship systemsship_systems.csv
  • 描述文本Descriptionsdescriptions.csv
  • 模拟对手Sim opponentssim_opponents.csv
  • 技能Skillsskill_data.csv
  • 舰队能力Fleet abilitiesabilities.csv
  • 工业Industriesindustries.csv
  • 贸易商品Commoditiescommodities.csv
  • 特殊物品Special itemsspecial_items.csv
  • 市场条件Market conditionsmarket_conditions.csv
  • 市场类型Submarketssubmarkets.csv

开发者Developer

AnyIDElse

AnyIDElse

星界罗盘 [Pyxis ad Astra] 开发者Developer of Pyxis ad Astra

明灯已坠 [Delapsa-Lanterna]