Archivos PBS

¿Qué son los PBS?

Los archivos PBS (Pokémon Battle System) son archivos de texto que contienen toda la información de datos del juego: Pokémon, movimientos, habilidades, objetos, entrenadores, encuentros, etc. Son la forma principal de modificar el contenido del juego sin tocar el código Ruby.

Ubicación

Los archivos PBS se encuentran en la carpeta:

PBS/

Dentro del directorio raíz del proyecto. Al compilar el juego, estos archivos se convierten en datos binarios utilizados internamente.

Lista de archivos PBS

Formato de los PBS

Los PBS utilizan un formato de texto plano basado en secciones. Ejemplo de una entrada de Pokémon:

[PIKACHU]
Name = Pikachu
Types = ELECTRIC
BaseStats = 35,55,40,90,50,50
GenderRatio = Female50Percent
GrowthRate = Medium
BaseEXP = 112
EVs = SPEED,2
CatchRate = 190
Happiness = 70
Abilities = STATIC
HiddenAbilities = LIGHTNINGROD
Moves = 1,TAILWHIP,1,THUNDERSHOCK,4,GROWL,...
EggMoves = BESTOW,BIDE,CHARGE,...
EggGroups = Field,Fairy
HatchSteps = 2560
Height = 0.4
Weight = 6.0
Color = Yellow
Shape = 8
Habitat = Forest
Category = Ratón
Pokedex = Cuando varios de estos Pokémon se juntan...

Archivos adicionales y parciales

Cada PBS admite archivos adicionales junto al original, con el mismo nombre base más un sufijo: _algo. Sirven para no tocar el archivo original y mantener tus cambios separados (por ejemplo, en su propio commit o carpeta de mods).

PBS/pokemon.txt              <- archivo base
PBS/pokemon_custom.txt       <- adicional
PBS/pokemon_AAA.txt          <- adicional
PBS/pokemon_custom_001.txt   <- adicional
PBS/pokemon_custom_002.txt   <- adicional

El sufijo puede ser cualquier texto. Los archivos se cargan en orden alfabético (sin distinguir mayúsculas/minúsculas) por nombre completo, y el archivo base (sin sufijo) siempre carga primero. En el ejemplo de arriba el orden real es: pokemon.txt → pokemon_AAA.txt → pokemon_custom.txt → pokemon_custom_001.txt → pokemon_custom_002.txt.

Añadir o redefinir una sección

Una sección con un ID nuevo en un archivo adicional añade una entrada nueva. Una sección con un ID que ya existe la redefine: solo hace falta escribir los campos que cambian, el resto se hereda tal cual del archivo cargado antes. No hace falta repetir el Pokémon entero.

# PBS/pokemon.txt (original, completo)
[BULBASAUR]
Types = GRASS,POISON
BaseStats = 45,49,49,65,65,45
Abilities = OVERGROW
Moves = 1,TACKLE,3,GROWL,...
Evolutions = IVYSAUR,Level,16
(...resto de campos)

# PBS/pokemon_custom.txt (adicional, parcial)
[BULBASAUR]
BaseStats = 50,50,50,50,50,50
Evolutions = IVYSAUR,Level,12

Tras compilar, Bulbasaur queda con BaseStats y Evolutions nuevos, y Types, Abilities, Moves, etc. exactamente como en el original.

Formato JSON

Cualquier PBS (el original o uno adicional) se puede escribir en JSON en vez de texto plano, con el mismo nombre base y en la misma carpeta PBS/. Si existen los dos para el mismo archivo (p. ej. pokemon_custom.txt y pokemon_custom.json), gana el .txt y el .json se ignora — la regla es por archivo, no global: podés mezclar .txt y .json libremente entre el original y los adicionales.

La estructura general es un objeto raíz donde cada key es el ID de sección (el mismo que irías entre corchetes en el .txt) y el valor es un objeto con los campos:

{
  "PIKACHU": {
    "Name": "Pikachu",
    "Types": ["ELECTRIC"],
    "BaseStats": {
      "HP": 35, "ATTACK": 55, "DEFENSE": 40,
      "SPECIAL_ATTACK": 50, "SPECIAL_DEFENSE": 50, "SPEED": 90
    },
    "GenderRatio": "Female50Percent",
    "GrowthRate": "Medium",
    "BaseEXP": 112,
    "EVs": { "SPEED": 2 },
    "CatchRate": 190,
    "Happiness": 70,
    "Abilities": ["STATIC"],
    "HiddenAbilities": ["LIGHTNINGROD"],
    "Moves": [
      { "level": 1, "move": "TAILWHIP" },
      { "level": 1, "move": "THUNDERSHOCK" },
      { "level": 4, "move": "GROWL" }
    ],
    "EggMoves": ["BESTOW", "BIDE", "CHARGE"],
    "EggGroups": ["Field", "Fairy"],
    "HatchSteps": 2560,
    "Height": 0.4,
    "Weight": 6.0,
    "Color": "Yellow",
    "Shape": 8,
    "Habitat": "Forest",
    "Category": "Ratón",
    "Pokedex": "Cuando varios de estos Pokémon se juntan..."
  }
}

Dos comodidades solo disponibles en JSON, pensadas para no errar el orden de un campo posicional:

• BaseStats / EVs se pueden dar como objeto { "HP": ..., "ATTACK": ..., "DEFENSE": ..., "SPECIAL_ATTACK": ..., "SPECIAL_DEFENSE": ..., "SPEED": ... } en vez del array posicional del .txt (donde Speed va en 4ª posición, no al final). Las 6 keys son obligatorias.
• Moves (nivel de subida) y Evolutions se pueden dar como array de objetos nombrados ({"level": 1, "move": "TACKLE"}, {"species": "IVYSAUR", "method": "Level", "parameter": 16}) en vez de un array plano donde hay que recordar qué posición es cada campo.

Un archivo adicional parcial en JSON se ve así (equivalente al ejemplo de Bulbasaur de la sección anterior):

{
  "BULBASAUR": {
    "BaseStats": {
      "HP": 50, "ATTACK": 50, "DEFENSE": 50,
      "SPECIAL_ATTACK": 50, "SPECIAL_DEFENSE": 50, "SPEED": 50
    },
    "Evolutions": [
      { "species": "IVYSAUR", "method": "Level", "parameter": 12 }
    ]
  }
}

Solo se escriben los campos que cambian — el resto se hereda igual que en .txt.

Dynamic PBS

La Base de Sky incluye el plugin Dynamic PBS que permite modificar datos de PBS en tiempo real durante el juego sin necesidad de recompilar:

• Cambiar stats, tipos, habilidades de Pokémon existentes
• Modificar propiedades de movimientos
• Útil para eventos especiales, pruebas o cambios dinámicos

Compilar los PBS

Para que los cambios en los PBS tomen efecto:

1. Editar el archivo PBS correspondiente con un editor de texto
2. Abrir el juego en modo Debug
3. El juego detecta cambios y recompila automáticamente
4. Los datos actualizados se guardan en la carpeta Data/

Artículos relacionados

• Pokémon
• Movimientos
• Configuración
• Plugins — Dynamic PBS