mod_map_base/docs/es.md

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.

• 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.

Viajar cambia el juego a la escena del lugar:

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:

{
  "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

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.