mod_characters_editor/docs/ko.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. **모드 목록이 비어 있습니다.** 압축된 모드는 편집할 수 없습니다.