Add mod documentation in seven languages

This commit is contained in:
cthangover committed 2026-10-29 09:25:48 +01:00
1 parent 2d6ae622fa
commit 804cb1d8f7
17 files changed
+297 -10

No files matched your search

+41
View File
@@ -0,0 +1,41 @@
# Characters Editor — edita los personajes de un mod en un formulario
El Characters Editor edita los personajes de un mod mientras el juego está en marcha: el nombre en todos los idiomas del mod, el retrato, el sprite de paseo para los mapas RPG, las cifras de combate, la probabilidad de reclutamiento y las acciones de combate. **Guardar** escribe los archivos del mod y el juego usa el cambio al instante.
Se abre desde la caja de herramientas (el martillo de la barra) como **Personajes**.
## Una edición y su resultado en el juego
En RPG Plus, el héroe de la aldea es el personaje `rpg_hero` del mod `rpg_demo_game`. Elige ese mod arriba, selecciona **Héroe**, escribe un nombre nuevo en inglés y pulsa **Guardar** (Ctrl+S):
![La ventana Personajes sobre rpg_demo_game: la lista Aldric · rpg_hero, Limo · rpg_slime, Lobo · rpg_wolf; el formulario de rpg_hero con la clave del nombre rpg_demo/character/hero, texto (en) Aldric y los otros seis idiomas sin cambios, Retrato characters/village/hero con su imagen, Charset (RPG) vacío, Nivel 1, Salud 24, Ataque 6, Defensa 0, Puntos de acción 1, Experiencia 0, Probabilidad de reclutar 0. La línea de estado: «Guardado: 0 archivo(s), 1 texto(s) en el mod rpg_demo_game; el juego releyó sus datos».](assets/editor-saved.jpg)
Solo cambió la línea en inglés del `locale/en.properties` del mod. El miembro del grupo en el panel de personajes justo después:
![El panel de acciones del personaje: el miembro del grupo ahora se llama Aldric (rpg_hero, HP 42/42, AP 1, ATK 12, DEF 4) con Ataque básico, Defensa y Golpe poderoso.](assets/panel-after.jpg)
El panel muestra HP 42 y ATK 12 aunque el archivo dice 24 y 6: en RPG Plus la clase y los atributos del héroe (Stats Engine con Classic RPG Rules) calculan las cifras de combate y las escriben sobre los valores del archivo. En un juego sin atributos se usan los números del archivo.
## El formulario
- **Id** — el id del personaje; por él lo encuentran escenarios, grupos, combates y mapas.
- **Nombre** — la clave de traducción y una línea por idioma del mod.
- **Retrato** — la imagen en tarjetas y paneles; **…** abre una cuadrícula para elegir una.
- **Charset (RPG)** — el sprite de paseo en los mapas RPG (3 fotogramas × 4 orientaciones). El editor de mapas RPG ofrece los personajes con su charset para colocarlos.
- **Nivel**, **Salud**, **Ataque**, **Defensa**, **Puntos de acción**, **Experiencia** — las cifras de combate del personaje.
- **Probabilidad de reclutar** — de 0 a 100: la probabilidad de capturar al personaje tras vencerlo (ver Recruiting).
- **Comportamiento** y **Acciones** — cómo pelea el personaje y qué acciones de combate tiene.
- **Campos de otros mods** — los campos que otros mods describen para los personajes en sus esquemas (por ejemplo la clase, los atributos y los rasgos de Stats Engine) aparecen en su propia sección.
- **Otros campos** — el resto del JSON del personaje, editado como JSON y conservado tal cual.
La barra: **Nueva** (Ctrl+N), **Copia** (Ctrl+D), **Borrar**, **Deshacer**/**Rehacer** (Ctrl+Z / Ctrl+Y), **Guardar** — solo se escriben los archivos cambiados; los textos van a los archivos de localización del mod.
## Qué personajes se pueden editar
La lista contiene los personajes de los archivos del mod seleccionado; solo se ofrecen los mods instalados como carpetas. Los personajes de otros mods no están en la lista y sus archivos nunca se escriben. Para cambiar uno de ellos, incluye el mismo id en tu propio mod con una dependencia del dueño, o añade campos con un parche.
## Si algo sale mal
1. **Cambiar salud o ataque no tiene efecto.** El juego calcula las cifras a partir de los atributos, como hace RPG Plus con su grupo.
2. **El personaje no está en la pestaña Personajes del editor de mapas RPG.** La pestaña lista personajes con estadísticas de combate; cualquier sprite se puede colocar desde la pestaña Appearance.
3. **La lista de mods está vacía.** Los mods empaquetados no se pueden editar.