Metadatos de Mapa

Los metadatos de mapa definen las propiedades de cada mapa del juego. Se configuran en el archivo PBS map_metadata.txt, ubicado en la carpeta PBS/ del proyecto. Cada entrada describe características como el clima, la posición en el mapa regional, si se permite la bicicleta, entre otros.

Formato del archivo PBS

El archivo map_metadata.txt contiene una entrada por cada mapa. Cada entrada comienza con el número de ID del mapa entre corchetes, seguido de sus propiedades en líneas separadas con el formato Propiedad = Valor.

[001]
Name = Ciudad Paleta
Outdoor = true
ShowArea = true
Bicycle = true
HealingSpot = 001,8,10
Weather = None
MapPosition = 0,12,14

Tabla de propiedades

A continuación se listan todas las propiedades disponibles para los metadatos de mapa:

Propiedad	Tipo	Descripción
`Name`	Texto	Nombre visible del mapa. Se muestra al entrar si `ShowArea` está activado.
`Outdoor`	Booleano	Si es `true`, el mapa se considera exterior. Afecta al clima, ciclo día/noche, y movimientos como Vuelo y Teletransporte.
`ShowArea`	Booleano	Si es `true`, se muestra el nombre del mapa al entrar en él.
`Bicycle`	Booleano	Si es `true`, se permite usar la bicicleta en este mapa.
`BicycleAlways`	Booleano	Si es `true`, el jugador debe usar la bicicleta obligatoriamente en este mapa (como la Pista Ciclista).
`HealingSpot`	MapaID, X, Y	Coordenadas del punto de curación. Al visitar un Centro Pokémon en este mapa, el jugador reaparecerá aquí al ser derrotado. Formato: `mapID,x,y`.
`Weather`	Clima, Probabilidad	Clima predeterminado del mapa y probabilidad de que ocurra (0-100). Ejemplo: `Rain,100`.
`MapPosition`	Región, X, Y	Posición del mapa en el mapa regional. Formato: `regiónID,x,y`. Necesario para que Vuelo funcione.
`DiveMap`	ID de Mapa	ID del mapa al que se accede al usar Buceo en este mapa.
`DarkMap`	Booleano	Si es `true`, el mapa está oscuro y requiere Flash para iluminarlo.
`SafariMap`	Booleano	Si es `true`, este mapa forma parte de la Zona Safari.
`SnapEdges`	Booleano	Si es `true`, la cámara no se desplaza más allá de los bordes del mapa.
`Dungeon`	Booleano	Si es `true`, el mapa es una mazmorra con generación aleatoria.
`BattleBack`	Texto	Nombre del fondo de batalla usado en este mapa. Corresponde al nombre del archivo gráfico en `Graphics/Battlebacks/`.
`WildBattleBGM`	Texto	Música de fondo para combates salvajes en este mapa.
`TrainerBattleBGM`	Texto	Música de fondo para combates contra entrenadores en este mapa.
`WildVictoryBGM`	Texto	Música de victoria para combates salvajes en este mapa.
`TrainerVictoryBGM`	Texto	Música de victoria para combates contra entrenadores en este mapa.
`WildCaptureME`	Texto	Efecto musical al capturar un Pokémon salvaje en este mapa.
`MapSize`	Ancho, Cuadros	Tamaño del mapa en el mapa regional. Formato: `ancho,cuadros_que_ocupa`. Usado para mapas que ocupan más de una casilla en el mapa regional.
`Environment`	Entorno	Entorno visual del mapa. Afecta al fondo de batalla y a ciertos efectos visuales. Ver tabla de valores abajo.

Valores de Environment

El campo Environment determina el entorno visual del mapa y afecta al fondo de batalla predeterminado. Los valores disponibles son:

Valor	Descripción
`None`	Sin entorno específico (por defecto).
`Grass`	Hierba normal.
`TallGrass`	Hierba alta.
`MovingWater`	Agua en movimiento (ríos, mar).
`StillWater`	Agua estática (lagos, estanques).
`Puddle`	Charcos.
`Underwater`	Bajo el agua (al usar Buceo).
`Cave`	Cueva.
`Rock`	Zona rocosa.
`Sand`	Desierto o arena.
`Forest`	Bosque.
`ForestGrass`	Hierba dentro de un bosque.
`Snow`	Zona nevada.
`Ice`	Zona de hielo.
`Volcano`	Volcán.
`Graveyard`	Cementerio.
`Sky`	Cielo.
`Space`	Espacio.
`UltraSpace`	Ultraespacio.

Ejemplos PBS por tipo de mapa

A continuación se muestran ejemplos de configuración para distintos tipos de mapa:

Ciudad (Pueblo o Ciudad)

[002]
Name = Pueblo Primavera
Outdoor = true
ShowArea = true
Bicycle = true
HealingSpot = 002,10,14
MapPosition = 0,5,11
Environment = Grass

Ruta

[010]
Name = Ruta 1
Outdoor = true
ShowArea = true
Bicycle = true
MapPosition = 0,5,10
Environment = Grass
WildBattleBGM = Battle wild.ogg

Cueva

[025]
Name = Cueva Oscura
Outdoor = false
DarkMap = true
ShowArea = true
Bicycle = false
Environment = Cave
BattleBack = cave
WildBattleBGM = Battle cave.ogg

Interior (Edificio)

[050]
Name = Centro Pokémon de Ciudad Paleta
Outdoor = false
ShowArea = false
Bicycle = false
SnapEdges = true

Zona Safari

[060]
Name = Zona Safari - Área 1
Outdoor = true
ShowArea = true
Bicycle = false
SafariMap = true
Environment = Grass
MapPosition = 0,18,6

Mapa con clima

[035]
Name = Ruta 15
Outdoor = true
ShowArea = true
Bicycle = true
Weather = Rain,100
MapPosition = 0,20,8
Environment = Grass

Notas importantes

El ID entre corchetes debe coincidir con el ID del mapa en RPG Maker XP.
Las propiedades Outdoor, ShowArea, Bicycle, DarkMap, SafariMap, SnapEdges y Dungeon son booleanas: solo acepta true o false.
HealingSpot es fundamental para definir dónde reaparece el jugador tras perder un combate.
MapPosition es indispensable para que el mapa aparezca correctamente en el mapa regional y para que Vuelo funcione.
Si no se especifica Environment, se usará None y el fondo de batalla se determinará según los terrain tags del tile donde se encuentre el jugador.
Los archivos de música referenciados en WildBattleBGM, TrainerBattleBGM, etc., deben existir en la carpeta Audio/BGM/.