制作一艘基本舰船

本节将引导您制作游戏可加载的第一艘舰船，并简单解析 .ship 船体定义和 data/hulls/ship_data.csv 文件。

本节预期阅读时间：~15 分钟。

本节预期操作时间：~20 分钟。

学习目标

完成后，您将能够：

• 准备一张尺寸合规的舰船贴图，并为它命名、归位；
• 使用舰船编辑器设置碰撞圈、护盾范围、碰撞箱、槽位与引擎；
• 在 ship_data.csv 中登记舰船数据，让船体被游戏加载；
• 从控制台生成船体，并在战斗与装配界面验证制作结果。

前置知识

• [C1-S1] 的 MOD 根目录与贴图、数据目录；
• [C1-S1] 的全局 ID 命名规则与 GearIn_ 前缀。

获取贴图

制作舰船首先需要一张贴图。

编者并不擅长画图，但刚好也能展示获取贴图对于绝大多数人来说都不是一件困难的事情。

这里以一艘 锤头 与 斗士 的简单拼接为例，在使用 Photoshop 拼接之后做了一些简单画笔涂抹和颜色修正，耗时共计 16 秒，但最终效果已经勉强能看。

完成品如下，若您需要 (连斗士的引擎都没擦，也许您看不上) 可以随意取用：

命名并将贴图放入正确的位置

对舰船进行命名时，请有意避开已经存在的舰船名，以便于您 MOD 的交流和推广。另外，若您希望制作一个整体的势力 MOD，建议提前想好一整套命名风格，来体现它的统一。一味追求高端、玄奥、霸气、神秘的名字可能会令其他用户感到不适。

您需要为舰船命名，想好它的中文名称和英文名称。在本例中，这一艘舰船将被命名为 工匠-级 (Artizan)。

然后为它分配 ID，格式为：前缀名+舰船名。在本例中，舰船的 ID 是 GearIn_artizan。

将贴图命名为与舰船 ID 相同。在本例中，贴图文件名为 GearIn_artizan.png，它在 .ship 中由 spriteName 字段指向：graphics/ships/GearIn_artizan.png。

最后放入对应贴图文件夹 (graphics/ships)：

制作舰船文件

打开此前您下载的舰船编辑器，选择游戏目录。

开始制作

制作过程中记得多保存，以防闪退。

制作舰船文件的流程十分明确：导入贴图，然后从按键 C 开始一路向下。

设置碰撞圈

首先按 C 设置质量中心和碰撞圈 (俗称 黄圈)：

除非有极特殊的要求，否则质量中心一般设为贴图中心。

设置护盾范围

然后按 S 设置护盾中心和护盾范围 (俗称 蓝圈)：

除非有极特殊的要求，否则护盾中心一般和质量中心重合。

设置碰撞箱

然后按 B 设置碰撞箱。设置碰撞箱时，可以按空格键切换是否对称设置：

设置槽位

然后按 W 设置槽位。使用 Shift + 鼠标等拖拽、切换槽位的位置和朝向。可以按空格键切换是否对称设置。详细可用操作见编辑器的右下角。

在设置完毕所有槽位后，可以按 T 对每一个槽位的具体属性进行设置。

每一个非隐藏槽位的坐标都必须为整数，否则武器会糊。

槽位形态速查表

槽位大小速查表

槽位类型速查表

槽位其它数据速查表

设置引擎

然后跳过中间的部分，按 E 设置引擎。使用 Shift + 鼠标等拖拽、切换引擎的位置和朝向。可以按空格键切换是否对称设置。详细可用操作见编辑器的右下角。

在设置完毕所有引擎后，可以按 T 对每一个引擎的具体属性进行设置。

引擎应当被设置在像素最边缘。引擎可以适当拉长一些，过短往往会导致视觉效果不佳。

引擎风格速查表

设置甲板？

工匠-级 驱逐舰并不是一艘航母，所以它没有甲板。航母与战机的甲板设置见 [C1-S3]。

设置最终属性

按下 P，然后按下 T，设置最终属性。

舰船分级速查表

舰船风格速查表

对于 hullId 和 hullName 两项：hullId 是船体注册的主键，必须与 ship_data.csv 的 id 列一致，不一致时 CSV 行不会应用到该船体；hullName 会被覆盖而无实质作用，但编者建议您全部填写。

按 V 保存。

您已经完成了制作一艘船最麻烦的部分了。

制作舰船数据

舰船数据的格式是 CSV。打开 ship_data.csv，这个文件里即为舰船数据，且编者在里面留下了一些数据标本以供您参考。

CSV 基础：CSV 的第一行是标签，从第二行开始则会被当做数据读取。但是，如果某一行的最前方有一个 # 符号，则这一行会被忽略。

在默认情况下，CSV 以 英文逗号 对数据进行分割。因此如果数据本身包括 英文逗号，则需要 英文引号 包络。

最为简单的做法自然是复制粘贴。您可以在原版寻找各类舰船的数据，将其复制粘贴到本文件。而在本例，选择 锤头-级 驱逐舰的数据，将其复制，然后修改：

name,id,designation,tech/manufacturer,system id,fleet pts,hitpoints,armor rating,max flux,8/6/5/4%,flux dissipation,ordnance points,fighter bays,max speed,acceleration,deceleration,max turn rate,turn acceleration,mass,shield type,defense id,shield arc,shield upkeep,shield efficiency,phase cost,phase upkeep,min crew,max crew,cargo,fuel,fuel/ly,range,max burn,base value,cr %/day,CR to deploy,peak CR sec,CR loss/sec,supplies/rec,supplies/mo,c/s,c/f,f/s,f/f,crew/s,crew/f,hints,tags,logistics n/a reason,codex variant id,rarity,breakProb,minPieces,maxPieces,travel drive,number
#Lasher,lasher,Frigate,Low Tech,ammofeed,5,1750,300,2100,1750,140,55,,120,110,90,60,90,200,FRONT,,210,0.4,1,,,25,50,40,25,1,25,10,9000,8,10,240,0.25,4,4,,,,,,,,"lowtech_bp, merc, ind",,,,0.4,2,2,,204
#Hammerhead,hammerhead,Destroyer,Midline,ammofeed,10,5000,500,4200,4167,250,95,,90,60,40,30,60,400,FRONT,,300,0.4,0.8,,,50,100,100,60,2,30,9,40000,5,12,360,0.25,10,10,,,,,,,,"midline_bp, merc, ind",,,,0.5,2,3,,300
#Eagle,eagle,Cruiser,Midline,maneuveringjets,14,8000,1000,11000,14000,700,155,,60,40,30,15,20,1200,FRONT,,270,0.4,0.8,,,150,250,150,100,3,33,8,100000,3,12,480,0.25,20,20,,,,,,,,"rare_bp, merc, ind",,,,0.5,2,3,,401
#Conquest,conquest,Battlecruiser,Midline,maneuveringjets,24,12000,1200,20000,30000,1200,315,,45,20,15,6,4,2500,OMNI,,90,0.4,1.4,,,400,500,300,300,10,30,8,300000,3,15,600,0.25,40,40,,,,,,,,"rare_bp, merc",,,,0.5,2,4,,503
工匠,GearIn_artizan,驱逐舰,未知,ammofeed,10,5000,500,3800,4167,200,95,,80,60,40,30,60,400,FRONT,,300,0.4,0.8,,,50,100,100,60,2,30,9,40000,5,12,360,0.25,10,10,,,,,,,,GearIn_bp,,,,0.5,2,3,,300

一艘船最重要的特征是要有趣。

在本例中，工匠-级 驱逐舰将 锤头-级 的中实弹替换为中通用，可以安装强力的导弹武器。编者对于歼灭者的表现十分感兴趣，因此将它的幅能容量、幅能耗散与速度都设为略低于 锤头-级，来让这艘船更需要依赖它的导弹优势。

将新船的 tag 中的内容修改为 前缀名_bp，在本例中为 GearIn_bp。日后将会有用。除非它是您不希望大量出现的舰船 —— 在这种情况下，您可以将 tag 中的内容清空。

ship_data.csv 数据列速查表

不在本表上的数据要么是游戏不读取的无用列 (如 8/6/5/4%、c/s、c/f、f/s、f/f、crew/s、crew/f、number、range)，要么是对于当前阶段而言过于深入的进阶列 (如 logistics n/a reason、codex variant id)。对于这些列，编者建议您照抄原版样本的值即可。

ship_data.csv Hints 速查表

不在本表上的数据均为无意义 Hints(如 TRANSPORT) 或不重要 Hints(如 WEAPONS_FRONT_TO_BACK)。

首舰下水

当您按照您的意愿填写完毕舰船数据之后，这艘船就能被游戏读取了。目前您还没有为它添加合理的获取方式，因此您只能使用 控制台 的 Addship [您的舰船 ID] 来获取它。

控制台来自 Console Commands MOD (可在 FOSSIC 论坛下载并安装)。

Addship 接收的是装配 ID —— 游戏加载船体时会自动生成一个空的 <hullId>_Hull 装配，因此直接输入 Addship GearIn_artizan_Hull 即可。或者输入 Addship GearIn_artizan 也行，因为控制台会自动处理直接输入 舰船 ID 的情况。

在做下一步之前，强烈推荐您亲自试一下您制作的舰船。

这艘 工匠-级 驱逐舰的表现相当不错，可以利用源源不断的火箭弹进行近距离压制，不过一旦被同等重火力盯上就会陷入僵局，而且难以利用它的战术系统。

它也许还可以使用安超配置并搭载离子脉冲。总体而言，作为一艘注重于手感的驱逐舰来说还算成功，但再加上一些微调会更好。

验证方案

前置数据：已经完成本节的舰船贴图、.ship 文件和 ship_data.csv 登记，并启用 Console Commands MOD。

1. 启动游戏，确认本 MOD 已在 Mods 列表启用并进入主菜单。
2. 进入任何一个生涯存档，打开控制台执行 Addship GearIn_artizan。
3. 进入装配界面，核对幅能容量 (3800)、耗散 (200)、速度 (80) 与 CSV 一致。
4. 进入任意战斗，观察贴图、碰撞、护盾、五类机动输入、武器槽与引擎。

预期结果：

• 船体成功加载，贴图无白块或错位，碰撞边界、护盾范围、武器槽与引擎位置与编辑器设定一致；
• 战斗中机动手感符合 CSV 设定 (速度 80，机动性略低于 锤头-级)；
• 装配界面幅能容量、耗散、速度与 ship_data.csv 中的登记值一致；
• 日志中没有 GearIn_artizan 相关的错误。

故障分析

• 控制台报错找不到装配或船体：CSV 行未加载 (例如行首仍带 #)，或 .ship 的 hullId、CSV 的 id 与装配引用不一致。

  • 解决方案：将三处 ID 统一为 GearIn_artizan 并重启游戏。

• 舰船显示为白块或缺图：.ship 的 spriteName 没有指向 MOD 根目录下的实际 PNG。

  • 解决方案：核对路径大小写和扩展名后重新载入。

• 武器或引擎偏移半个像素：贴图中心、槽位坐标或引擎坐标落在不同的像素网格。

  • 解决方案：保持偶数贴图尺寸并在编辑器中重新对齐。

• 装配界面数值与 CSV 不一致：当前装配可能引用了其他船体，或 ship_data.csv 中存在重复 ID、修改尚未保存。

  • 解决方案：确认装配引用 GearIn_artizan 且 ID 唯一，保存并重启。

• 舰船加载时立即报错：从 starsector.log 中 hull ID 附近的首个异常开始，依次核对 CSV 列数、.ship 宽松 JSON 和资源路径。

  • 解决方案：修正首个错误并重启。

总结

本节完成了从一张贴图到一艘可玩舰船的完整流程：命名与归位决定 ID 和外观，.ship 决定几何与表现，ship_data.csv 决定性能与生成入口，三者构成一条完整的数据链。

作为对您 (或许是新人？) 的建议，编者必须强调的是：排错时从 CSV 的 ID 沿链逐项追到资源文件，这比凭空臆测更可靠。Java 不承认猜。

本节登记的 GearIn_artizan ID 与 GearIn_bp 标签还用于蓝图、装配和市场销售等机制。保持这些标识稳定，相关数据才能沿同一条所属关系使用它们。

建议参考项

• data/hulls/ship_data.csv：舰船数据注册表，id、性能列与 tags 的落点。
• data/config/engine_styles.json：原版引擎风格的颜色定义。
• data/config/hull_styles.json：原版舰船与护盾样式的颜色定义。
• data/shipsystems/ship_systems.csv：战术系统 ID 注册，system id 列的取值来源。
• Starsector/starsector-core/starsector.log：游戏运行日志，故障分析时定位首个异常。