资源 ModResource mods

资源都放在 <version>/Resources/Textures/ 下。下表列出游戏目前会读取 Mod 图片的所有位置;不在表里的目录(如 Resources/Audio/)当前没有通用加载逻辑。 Assets live under <version>/Resources/Textures/. The table lists every place the game currently reads mod images from; other folders (e.g. Resources/Audio/) have no generic loader yet.

用途Purpose如何声明Declared by读取方Read by
新增行的图标Icons for new rowsRawIconModIconCombine
新增地板 / 平台贴图New floor / platform texturesF_StrcutDef.RawIconMapResources
替换战舰贴图Warship texture overridesShipTextureOverrides/ShipTextures.xmlModShipTextures
角色外观 / 武器Character skins / weaponsrole-customize.xmlSpineCombine
关卡 / 开局地图Level / starting mapsM_StarMapPath_Def.Path → Resources/Map/*.nsmtNsmtParser
自定义界面等Custom UI etc.Resources/AssetBundle/由你的 DLL 自行加载(见示例 Mod_UICustom),仅 PCLoaded by your own DLL (see Mod_UICustom), PC only

新增行的图标Icons for new rows

见数据 Mod → 图标。图标在配置表加载结束后统一打包;文件不存在的行不会得到图标,日志中会有该路径的读取失败记录。 See Data mods → Icons. Icons are packed once definitions finish loading; rows whose file is missing get no icon, and the failed path appears in the log.

新增地板 / 平台New floors / platforms

用 XML 新增 F_StrcutDef 的地板或平台类行时,地图贴图直接取 RawIcon 指定的 PNG;平台还会额外读取同名的 *_additive.png(例如 my_floor.png 对应 my_floor_additive.png)。这类行必须设置 RawIcon。 For new floor or platform rows in F_StrcutDef, the map texture is the PNG named by RawIcon; platforms also read a matching *_additive.png (e.g. my_floor.png → my_floor_additive.png). Such rows must set RawIcon.

替换战舰贴图Warship texture overrides

不需要程序。放置 Resources/Textures/ShipTextureOverrides/ShipTextures.xml,按战舰 ID(G_AirShip 表)替换战斗与界面中的舰体贴图。示例 Mod:mods/Mod_ShipTextures。 No program needed. Add Resources/Textures/ShipTextureOverrides/ShipTextures.xml to replace hull art in combat and UI by warship ID (G_AirShip table). Example: mods/Mod_ShipTextures.

Resources/Textures/ShipTextureOverrides/ShipTextures.xml
<?xml version="1.0" encoding="utf-8"?>
<ShipTextures>
  <Ship id="B-07" image="MyShip/BaseColor.png">
    <Secondary name="_NormalMap" image="MyShip/Normal.png" />
    <Secondary name="_ORM"       image="MyShip/ORM.png" />
    <Secondary name="_MaskTex"   image="MyShip/Emission.png" />
    <Secondary name="_ShadowMap" image="MyShip/Shadow.png" />
  </Ship>
</ShipTextures>
规则Rule说明Details
id必须是 G_AirShip 中已存在的 ID,同一文件内不能重复。可用 ID 列表见下方报告文件 AirShipIds.tsv。Must exist in G_AirShip and be unique in the file. See AirShipIds.tsv in the report folder below.
imagePNG/JPG,相对 XML 所在目录,不允许绝对路径和 ..,单张不超过 32 MiB。尺寸任意,显示时缩放到该舰的显示尺寸并居中。PNG/JPG relative to the XML; no absolute paths or ..; at most 32 MiB. Any size — scaled to the ship's display size and centred.
Secondary可选,名称区分大小写:_NormalMap(切线空间法线)、_ORM(R=AO G=粗糙度 B=金属度)、_MaskTex(发光遮罩)、_ShadowMap(四方向烘焙投影)。省略的通道用中性效果。Optional, case-sensitive: _NormalMap (tangent-space normal), _ORM (R=AO G=roughness B=metallic), _MaskTex (emission mask), _ShadowMap (4-direction baked shadow). Omitted channels use neutral values.
多个 ModSeveral mods同一 ID 以后加载的 Mod 为准。For the same ID the later-loaded mod wins.
出错时On error只跳过出错的那艘船或那个通道,保留原贴图,并写入加载报告(见排错)。Only the faulty ship or channel is skipped; the original art stays and the problem is written to the load report (see Troubleshooting).

角色外观与武器Character skins and weapons

角色是 Spine 骨骼动画。Resources/Textures/role-customize.xml 声明新的外观部件和武器贴图,游戏启动时以内置模板皮肤为基础复制出新皮肤并替换对应部件的贴图。示例 Mod:mods/Mod_CharacterCostume。 Characters are Spine skeletons. Resources/Textures/role-customize.xml declares new skin parts and weapon art; at startup the game clones a built-in template skin and swaps the matching attachments. Example: mods/Mod_CharacterCostume.

属性Attribute取值Values
ModSpineSkin@SkinTypehair · nude · adornment · helmet · top · bottoms · bag
决定以哪种内置模板皮肤为基础。Chooses the built-in template skin to clone.
PartItem@Name部件 Key,取自配置表 S_CharacterSpinePartsDef(决定 Spine 插槽与挂点)。找不到时该部件跳过并记录 ModSpineDef not found。Part key from the S_CharacterSpinePartsDef table (maps to Spine slot and attachment). Unknown keys are skipped with ModSpineDef not found. → S_CharacterSpinePartsDef
PartItem@Texture相对 Resources/Textures/ 的图片路径。Image path relative to Resources/Textures/.
ModSpineWeapon@WeaponTypegun · handGun · launcher · spear · sword · thrown
Texture_T / _RT / _S / _RB / _B武器五个朝向的贴图,依次对应 Spine 挂点后缀 _b(背面)、_9、_s(侧面)、_3、_f(正面);开火姿态的挂点使用同一张图。Weapon art for five facings, mapped in order to Spine attachment suffixes _b (back), _9, _s (side), _3, _f (front); the firing-pose attachments reuse the same image.
新皮肤以 Name 注册到骨骼数据中,还需要角色外观相关配置引用这个名字才会出现在游戏里。这部分的完整流程本站尚未在游戏中验证,请以示例 Mod 为准。 New skins are registered on the skeleton under their Name; appearance definitions must reference that name for them to appear. This end-to-end flow has not been verified in game for this site — follow the example mod.