Conectar Mapas

Las conexiones de mapa permiten que el jugador se desplace de un mapa a otro de forma fluida, sin transición ni pantalla de carga. Cuando dos mapas están conectados, al caminar hacia el borde de uno se aparece automáticamente en el otro. Esto se configura en el archivo PBS map_connections.txt.

Formato del archivo PBS

El archivo map_connections.txt se encuentra en la carpeta PBS/. Cada línea define una conexión entre dos mapas con el siguiente formato:

MapID,Borde,Offset,MapID,Borde,Offset

Donde:

MapID: El ID numérico del mapa (debe coincidir con el ID en RPG Maker XP).
Borde: El borde del mapa por el que se conecta (North, South, East, West).
Offset: El desplazamiento horizontal o vertical (en tiles) entre ambos mapas.

Valores de borde (Edge)

Valor	Descripción
`North`	Borde superior del mapa.
`South`	Borde inferior del mapa.
`East`	Borde derecho del mapa.
`West`	Borde izquierdo del mapa.

Cómo funcionan las conexiones

Una conexión enlaza un borde de un mapa con el borde opuesto de otro mapa. Por ejemplo, si el jugador camina hacia el sur del Mapa A, aparecerá en el borde norte del Mapa B. Por eso, los bordes siempre deben ser opuestos:

Borde del Mapa A	Borde del Mapa B
`North`	`South`
`South`	`North`
`East`	`West`
`West`	`East`

Entendiendo el Offset

El offset (desplazamiento) controla la alineación entre los dos mapas conectados. Indica cuántos tiles se desplaza el segundo mapa respecto al primero a lo largo del borde de conexión.

Conexiones Norte-Sur

Para conexiones Norte/South, el offset es horizontal:

Offset = 0: Los bordes izquierdos de ambos mapas están alineados.
Offset positivo: El segundo mapa se desplaza hacia la derecha.
Offset negativo: El segundo mapa se desplaza hacia la izquierda.

Conexiones Este-Oeste

Para conexiones East/West, el offset es vertical:

Offset = 0: Los bordes superiores de ambos mapas están alineados.
Offset positivo: El segundo mapa se desplaza hacia abajo.
Offset negativo: El segundo mapa se desplaza hacia arriba.

Diagrama visual del offset

Ejemplo de conexión Sur-Norte con Offset = 3:

  Mapa A (20 tiles de ancho)
  ┌────────────────────┐
  │                    │
  │      Mapa A        │
  │                    │
  └────────────────────┘
     ↕ Conexión Sur-Norte
     └──→ Offset = 3 (desplazado 3 tiles a la derecha)
        ┌──────────────────────────┐
        │                          │
        │         Mapa B           │
        │                          │
        └──────────────────────────┘

Ejemplos de conexiones

Conexión simple Norte-Sur

Pueblo Paleta (mapa 002) conectado al sur con Ruta 1 (mapa 010), alineados en el borde izquierdo:

002,South,0,010,North,0

Conexión Este-Oeste

Ruta 1 (mapa 010) conectado al este con Ruta 2 (mapa 011), alineados arriba:

010,East,0,011,West,0

Conexión con offset

Ciudad Verde (mapa 003) conectado al norte con Ruta 2 (mapa 011), con el mapa de la Ruta 2 desplazado 5 tiles a la derecha:

003,North,0,011,South,5

Múltiples conexiones

Un archivo típico de map_connections.txt puede tener muchas conexiones:

# Pueblo Paleta y alrededores
002,South,0,010,North,0
002,North,0,003,South,0
# Ruta 1 y conexiones
010,East,0,011,West,0
010,North,0,003,South,5
# Ciudad Verde
003,West,0,012,East,0
003,East,2,013,West,0

Configurar conexiones visualmente

Pokémon Essentials incluye un editor visual para conexiones de mapa accesible desde el menú de Debug:

Abre el juego y accede al menú de Debug (presionando F9 en modo debug).
Ve a "Editar conexiones de mapa".
Selecciona los dos mapas a conectar.
Arrastra los mapas para posicionarlos correctamente.
Guarda los cambios. Esto actualizará automáticamente el archivo map_connections.txt.

Consejos para alinear mapas

Medidas consistentes: Asegúrate de que los mapas que se conectan tengan bordes compatibles. Si una ruta tiene 20 tiles de ancho y la ciudad a la que conecta tiene 30, necesitarás un offset para centrarla.
Usa el editor visual: Es mucho más intuitivo que editar el PBS a mano, especialmente para offsets complicados.
Tiles de borde: Recuerda que las primeras filas/columnas del borde de un mapa son visibles al estar en el mapa conectado. Diseña los bordes de tus mapas teniendo esto en cuenta.
Conexiones encadenadas: Puedes conectar múltiples mapas en cadena (A→B→C). No necesitas conectar A con C directamente si B está en medio.
Sin conexiones circulares: Evita crear bucles de conexiones donde puedas volver al mapa original caminando en una sola dirección. Esto puede causar problemas visuales.
Verificar con el juego: Siempre prueba tus conexiones en el juego para asegurarte de que los mapas se alinean correctamente y no hay tiles fuera de lugar.

Notas importantes

Las conexiones solo funcionan entre mapas exteriores (Outdoor = true en los metadatos de mapa).
Los mapas interiores deben usar transferencias de mapa en lugar de conexiones.
Cada conexión es bidireccional: solo necesitas definirla una vez.
Las líneas que comienzan con # son comentarios y son ignoradas por el compilador.
Si dos mapas conectados tienen climas diferentes, el cambio de clima ocurrirá al cruzar el borde.