占位机型待办清单（TODO）

本模组目前共有 12 款机型使用的是「占位图形」——它们的机型逻辑、真实参数、涂装切换都已完整接入并编译进 .grf， 但飞机像素精灵图暂借用了相近机型的占位图（因为每款机型需要 5 个飞行状态 × 8 帧的手绘像素精灵，属于美术资产）。

本文档记录这 12 款机型的真实参数、当前占位图形来源，以及把它替换成真实像素图的具体任务。

说明：本仓库是上游 RvP93/WorldAirlinersSet 的中文翻译分支。这些占位机型是本地新增内容， 上游并不包含，因此「替换真实图形」属于本分支的后续美术工作。

占位机制如何工作

每款占位机型的 .pnml 里，#define IMAGEFILE 指向的是 donor 机型目录的 PNG（而非本目录）。 NML 编译时直接读取 donor 的真实精灵表，因此能正常编译、在游戏里显示——只是机身外形是 donor 的样子。

替换真实图形时，只需：

1. 在本机型目录下绘制真实的精灵 PNG（保持与 donor 相同的精灵布局坐标）；
2. 把该 .pnml 里所有 #define IMAGEFILE "src/gfx/<donor>/.../*.png" 改为指向本目录的 PNG；
3. 重新编译 bin/WorldAirlinersSet.grf，逻辑零改动。

待办清单（12 款）

#	机型	中文名	引入年*	座级	航程	速度(km/h)	成本	当前占位图形来源	替换优先级
1	COMAC C909	中国商飞 C909	2015	90	600	850	65	Embraer/E190/E190STD	🔴 高（外形差异大）
2	COMAC C919	中国商飞 C919	2023	158	1020	839	73	Airbus/A320/A320-200	🔴 高（国产旗舰）
3	Airbus A220-300	空客 A220-300	2016	145	1090	870	92	Airbus/A320/A320neo	🔴 高（真实是 CSeries，外形最不像）
4	Airbus A319neo	空客 A319neo	2017	160	1200	839	95	Airbus/A320/A320neo	🟡 中
5	Airbus A321neo	空客 A321neo	2016	220	1400	839	108	Airbus/A320/A320neo	🟡 中
6	Boeing 737 MAX 9	波音 737 MAX 9	2018	178	1250	839	106	Boeing/B737/B737MAX8	🟢 低（与 MAX 8 接近）
7	Boeing 737 MAX 10	波音 737 MAX 10	2021	230	1300	839	112	Boeing/B737/B737MAX9	🟢 低
8	Boeing 787-10	波音 787-10	2018	330	2400	902	230	Boeing/B787/B787-9	🟢 低
9	Airbus A330-900neo	空客 A330-900neo	2018	300	2600	871	190	Airbus/A330/A330-300	🟢 低
10	Airbus A350-1000	空客 A350-1000	2018	366	2950	905	235	Airbus/A350/A350-900	🟢 低
11	Boeing 777X	波音 777X	2020	426	3400	896	305	Boeing/B777/B777-300ER	🟡 中（折叠翼尖特征明显）
12	Embraer E195-E2	巴航工 E195-E2	2019	146	1050	890	44	Embraer/E195/E195LR	🟡 中（E2 是小翼后掠新造型）

* 引入年为 get_plane_year(year) = year - 2 计算后的实际可购买年份。

各机型详情与替换步骤

1. COMAC C909（原 ARJ21）

• 源文件：src/gfx/COMAC/C909/C909.pnml
• 占位来源：src/gfx/Embraer/E190/E190STD/*.png（支线喷气机外形，与 C909 量级接近，但发动机/尾翼不同）
• 建议涂装：国航、东航、南航、海航、厦航（已接入）
• 替换任务：绘制 5 状态 × 8 帧的 C909 真实侧视像素图，放到 src/gfx/COMAC/C909/，改 IMAGEFILE 指向。

2. COMAC C919

• 源文件：src/gfx/COMAC/C919/C919.pnml
• 占位来源：src/gfx/Airbus/A320/A320-200/*.png（窄体客机外形，C919 整体轮廓类似，但机头/翼型不同）
• 建议涂装：国航、东航、南航、海航、厦航（已接入）
• 替换任务：绘制 C919 真实像素图放入 src/gfx/COMAC/C919/。

3. Airbus A220-300

• 源文件：src/gfx/Airbus/A220/A220-300/A220-300.pnml
• 占位来源：src/gfx/Airbus/A320/A320neo/*.png（外形差异最大——A220 是 CSeries，机身更短粗、小翼独特）
• 替换优先级最高，最该优先换图。

4–12. 其余机型

• 源自对应 donor 目录（见上表「当前占位图形来源」列）。
• 这些机型与 donor 多为同系列加长/衍生（如 MAX 10←MAX 9、787-10←787-9），外形接近，替换优先级较低； 其中 Boeing 777X（折叠翼尖）和 Embraer E195-E2（新后掠小翼）的建议优先于同系列加长机型。

如何贡献真实图形

1. 在对应机型目录下绘制精灵表 PNG，保持与 donor 相同的精灵布局（可用 donor 的 PNG 作为坐标参考）。
2. 修改该 .pnml 的 #define IMAGEFILE 指向本目录。
3. 本地重新编译（见 从源码构建），确认游戏内显示正确。
4. 提交 PR / 推送到本分支，更新本文档对应行的替换状态。

自动化脚本

• tools/add_aircraft.py：克隆 donor 机型生成占位机型 .pnml（如上面的 12 款中的后 10 款）。
• tools/gen_aircraft_md.py：从 WAS.pnml 自动提取全部机型，生成 机队图鉴 与涂装预览图。