Add mod documentation in seven languages

docs/es.md

@@ -0,0 +1,82 @@
+# World Map Engine — viajar entre lugares sobre un mapa dibujado
+
+World Map Engine muestra una imagen a pantalla completa del mundo del juego con lugares marcados en ella. El jugador abre el mapa, elige un lugar y viaja hasta allí: el juego cambia a la escena de ese lugar. Los escenarios pueden abrir, cerrar, ocultar y volver a mostrar lugares a medida que avanza la historia, y el juego guarda esos cambios.
+
+Lo usa Cthangover. No es lo mismo que los mapas de tiles de RPG World: un mapa del mundo es una sola imagen con zonas en las que hacer clic, y viajar cambia la escena; un mapa de tiles es una cuadrícula por la que el héroe camina casilla a casilla.
+
+## El mapa en el juego
+
+Se abre con el icono del mapa en la barra de herramientas.
+
+![El mapa del mundo de Cthangover: un valle con dos pueblos entre montañas y ríos; las etiquetas "Villa" y "Town entrance" marcan los dos lugares, las zonas rayadas muestran dónde están; una leyenda abajo a la izquierda (estás aquí, disponible, cerrado) y una pista abajo.](assets/world-map.jpg)
+
+- **Lugares**: zonas dibujadas sobre la imagen; el rayado las delata. Algunos lugares tienen además un emblema redondo con un icono.
+- **La leyenda**: verde — donde estás ahora, dorado — disponible, gris — cerrado.
+- **Haz clic en un lugar** para ver su ficha: estado, descripción y el botón **Viajar**. **Esc** o **×** cierran el mapa.
+
+![La entrada del pueblo (Town entrance) seleccionada: su zona contorneada en dorado, y la ficha a la derecha — Available, "The northern entrance to the town", Transition, Travel.](assets/zone-selected.jpg)
+
+**Viajar** cambia el juego a la escena del lugar:
+
+![Tras viajar: la escena de la entrada del pueblo con su primera línea y dos respuestas.](assets/after-travel.jpg)
+
+Un lugar está cerrado —la ficha dice «El camino todavía no está abierto.» y no ofrece Viajar— cuando un escenario lo cerró, cuando no tiene escena o cuando su escena no existe en el juego al que se juega.
+
+## Añadir un mapa del mundo a un juego
+
+Un juego necesita dos cosas en sus mods:
+
+1. **La imagen** — un fondo llamado `map` (por ejemplo `backgrounds/map.png`).
+2. **Los lugares** — archivos JSON en una carpeta `map/`. Todas las posiciones son fracciones del ancho y el alto de la imagen, de 0 a 1, así el mapa funciona a cualquier tamaño.
+
+Esta es la entrada del pueblo de Cthangover, abreviada:
+
+```json
+{
+  "Items": [
+    {
+      "ID": "town_entry",
+      "points": [[0.7099, 0.2493], [0.7334, 0.2630], [0.7348, 0.2906], [0.7091, 0.3429], [0.6974, 0.3264]],
+      "title": "",
+      "scene": "town_entry",
+      "description": "mapzone/town_entry/info",
+      "locked": false,
+      "hidden": false
+    },
+    {
+      "ID": "town_entry_label",
+      "points": [],
+      "title": "mapzone/town_entry",
+      "label_pos": [0.7246, 0.2163]
+    }
+  ]
+}
+```
+
+- `points` — el contorno de la zona en la que se puede hacer clic.
+- `scene` — la escena lógica a la que cambia Viajar.
+- `title`, `description` — claves de traducción; el título es el nombre del lugar en su ficha y emblema.
+- `image` e `image_pos` — un icono y su posición, para mostrar un emblema redondo en el lugar.
+- `label_pos` — un nombre suelto sobre el mapa. Una zona con solo un título y una posición de etiqueta (como `town_entry_label`) es un nombre, no un lugar: no se puede pulsar.
+- `locked` — cerrado al empezar; `hidden` — no se muestra al empezar.
+
+Cthangover guarda los nombres de sus lugares en zonas de etiqueta aparte y deja vacío el `title` de los lugares; por eso la ficha de arriba no lleva nombre arriba.
+
+El mapa del mundo también se puede dibujar y editar en el editor de mapas de Editor Tools.
+
+## Cambiar los lugares desde un escenario
+
+```scenario
+action map.open_zone zone_id=town_entry
+action map.close_zone zone_id=town_entry
+action map.show_zone zone_id=town_entry
+action map.hide_zone zone_id=town_entry
+```
+
+El cambio se guarda en la partida y sigue ahí tras cargar; una partida nueva arranca con los valores del JSON.
+
+## Si algo falla
+
+1. **«Mapa no disponible».** Ningún mod del juego tiene un fondo llamado `map`.
+2. **No se puede entrar en un lugar.** Su `scene` está vacía o mal escrita, o un escenario lo cerró.
+3. **Un lugar está fuera de sitio.** Las posiciones son fracciones de la imagen (0–1), no píxeles.