文档
PPL 的使用说明与扩展开发规范。扩展格式 .pplx 的完整定义在这里。
规范
.pplx 扩展规范
包结构、清单字段、加载顺序与打包方式。写扩展前先读这一页。
阅读规范 →源码参考实现
解析、校对与排序都在 crates/ppl-core/src/extensions.rs，带单元测试。
快速开始
- 装好启动器。从 Releases下载对应平台的安装包，装到当前用户目录即可，不需要管理员权限。
- 指一下游戏目录。在「库」页选择已安装的《铁锈战争》，或让 PPL 下载一份。 扩展会装进游戏的
ppl/extensions/，不碰 Steam 自己的文件。 - 导入扩展。在「扩展」页点「导入扩展」，选一个
.pplx文件。 导入后会立刻出现在列表里，用右侧开关启用或停用。
运行时尚未接入。目前启动器能安装、启停、检查依赖并算好加载顺序， 但游戏进程还不会真正应用扩展。状态在扩展页顶部也写着——宁可少一个功能， 也不给一个装完没反应的按钮。
几个概念
| 概念 | 是什么 | 放在哪 |
|---|---|---|
| 扩展 | 一个 .pplx 包，改游戏行为的最小单位 | <游戏>/ppl/extensions/ |
| 作战预设 | 一套 Mod 组合，切换时只重建 mods/units 链接 | <PPL 数据根>/loadouts/ |
| 加载计划 | 按依赖与偏好算出的扩展加载顺序 | 启动时算，不落盘 |
遇到问题
扩展页会把「缺依赖 / 成环 / API 版本过高 / 包损坏」都列出来，先看那里。 如果问题在规范本身或解析器上，去Issues 反馈， 附上扩展的描述符（ppl-extension.json）通常就能定位。