mod_characters_editor/docs/zh.md

# Characters Editor — 用表单编辑模组的角色

Characters Editor 在游戏运行时编辑模组的角色：各种语言的名称、立绘、RPG 地图的行走图、战斗数值、招募几率和战斗行动。**保存**会写入模组的文件，游戏立刻使用这一变化。

它从工具箱（工具栏上的锤子）打开，叫**角色**。

## 一次编辑及其在游戏中的结果

RPG Plus 里村庄的英雄是模组 `rpg_demo_game` 的角色 `rpg_hero`。顶部选择该模组，选**英雄**，输入新的英文名称，按**保存**（Ctrl+S）：

![rpg_demo_game 上的「角色」窗口：列表中有 Aldric · rpg_hero、史莱姆 · rpg_slime、狼 · rpg_wolf；rpg_hero 的表单，名称键 rpg_demo/character/hero，文本 (en) Aldric，其余六种语言未变，立绘 characters/village/hero 及其图片，行走图（RPG）为空，等级 1，生命 24，攻击 6，防御 0，行动点 1，经验 0，招募几率 0。状态行：「已保存：模组 rpg_demo_game 中 0 个文件、1 条文本；游戏已重新读取数据」。](assets/editor-saved.jpg)

只有模组 `locale/en.properties` 的英文一行变了。紧接着角色面板上的队伍成员：

![角色行动面板：队伍成员现在叫 Aldric（rpg_hero，HP 42/42，AP 1，ATK 12，DEF 4），带普通攻击、防御和强力一击。](assets/panel-after.jpg)

面板显示 HP 42 和 ATK 12，而文件里写的是 24 和 6：在 RPG Plus 中，英雄的职业和属性（Stats Engine 与 Classic RPG Rules）会计算战斗数值并覆盖文件里的值。在没有属性的游戏里用的就是文件里的数字。

## 表单

- **Id** —— 角色的 id；剧本、队伍、战斗和地图都靠它找到角色。
- **名称** —— 翻译键和模组每种语言的一行文字。
- **立绘** —— 卡片和面板上的图片；**…** 打开网格挑选。
- **行走图（RPG）** —— 角色在 RPG 地图上的行走图（3 帧 × 4 朝向）。RPG 地图编辑器会把带行走图的角色列为可放置对象。
- **等级**、**生命**、**攻击**、**防御**、**行动点**、**经验** —— 角色的战斗数值。
- **招募几率** —— 0 到 100：击败后收编该角色的几率（见 Recruiting）。
- **行为**和**行动** —— 角色怎么打，以及有哪些战斗行动。
- **其他模组的字段** —— 其他模组在各自模式中为角色描述的字段（例如 Stats Engine 的职业、属性和特性），会在单独区域出现。
- **其他字段** —— 角色 JSON 的其余部分，按 JSON 编辑并原样保留。

工具栏：**新建**（Ctrl+N）、**复制**（Ctrl+D）、**删除**、**撤销**/**重做**（Ctrl+Z / Ctrl+Y）、**保存** —— 只写改动的文件；文字进入模组的本地化文件。

## 哪些角色可以编辑

列表里是所选模组自己文件中的角色；只提供以文件夹安装的模组。其他模组的角色不在列表里，它们的文件也绝不会被写入。想改这样的角色，可以在自己的模组里带上相同的 id 并声明对属主的依赖，或者用补丁添加字段。

## 出问题了怎么办

1. **改了生命或攻击没有效果。** 游戏会从属性推算数值，RPG Plus 对自己的队伍就是这样做的。
2. **角色不在 RPG 地图编辑器的「角色」标签页。** 该标签页列出带战斗属性的角色；任何行走图都可以从 Appearance 标签页放置。
3. **模组列表是空的。** 打包模组不能编辑。