Efectos de Movimientos

Los efectos de los movimientos en Pokémon Essentials v21.1 están controlados por el sistema de FunctionCode. Cada movimiento tiene asignado un FunctionCode en el archivo PBS moves.txt, y su comportamiento está definido por una clase Ruby que hereda de Battle::Move.

Jerarquía de clases Battle::Move

Todos los efectos de movimientos se basan en la clase Battle::Move. La estructura de herencia es:

Battle::Move                         # Clase base de todos los movimientos
├── Battle::Move::None               # Movimiento genérico sin efecto extra (solo daño)
├── Battle::Move::PoisonTarget       # Envenenar al objetivo
├── Battle::Move::BurnTarget         # Quemar al objetivo
├── Battle::Move::ParalyzeTarget     # Paralizar al objetivo
├── Battle::Move::SleepTarget        # Dormir al objetivo
├── Battle::Move::FreezeTarget       # Congelar al objetivo
├── Battle::Move::ConfuseTarget      # Confundir al objetivo
├── Battle::Move::FlinchTarget       # Hacer retroceder al objetivo
├── Battle::Move::RaiseUserAttack1   # Subir Ataque del usuario +1
├── Battle::Move::ProtectUser        # Proteger al usuario
└── ... (cientos de clases más)

El sistema de FunctionCode

Cada FunctionCode del PBS (como PoisonTarget, RaiseUserAttack2, etc.) corresponde a una clase Ruby ubicada en los scripts del juego. El motor busca la clase correspondiente en el módulo Battle::Move.

Por ejemplo, si un movimiento tiene FunctionCode = BurnTarget, el motor buscará y utilizará la clase Battle::Move::BurnTarget.

Ubicación de los scripts

Los efectos de movimientos se encuentran organizados en varios archivos dentro de la sección de scripts:

• Battle_Move — Clase base Battle::Move con todos los métodos generales.
• Battle_Move_[XXX] — Archivos que contienen los efectos específicos, organizados por grupos.

Métodos principales de Battle::Move

Al crear o modificar un efecto de movimiento, estos son los métodos más importantes que puedes sobrescribir:

pbMoveFailed?(user, targets)

Se ejecuta antes de que el movimiento se realice. Si retorna true, el movimiento falla y no causa ningún efecto.

def pbMoveFailed?(user, targets)
  if user.hp <= user.totalhp / 2
    @battle.pbDisplay(_INTL("¡{1} no tiene suficiente energía!", user.pbThis))
    return true
  end
  return false
end

pbCalcDamage(user, target, numTargets)

Calcula el daño que el movimiento inflige. Normalmente no necesitas sobrescribir este método directamente, ya que la clase base se encarga del cálculo estándar de daño. Se usa para movimientos con fórmulas de daño especiales.

pbBaseDamage(baseDmg, user, target)

Permite modificar la potencia base del movimiento según condiciones. Útil para movimientos cuya potencia varía.

def pbBaseDamage(baseDmg, user, target)
  # Duplicar potencia si el objetivo tiene un problema de estado
  if target.pbHasAnyStatus?
    baseDmg *= 2
  end
  return baseDmg
end

pbAdditionalEffect(user, target)

Se ejecuta después de causar daño. Define los efectos secundarios del movimiento (quemar, paralizar, bajar stats, etc.). Solo se ejecuta si el movimiento acierta y la tirada de EffectChance tiene éxito.

def pbAdditionalEffect(user, target)
  return if target.damageState.substitute
  target.pbBurn(user) if target.pbCanBurn?(user, false, self)
end

pbEffectGeneral(user)

Se usa para efectos que no dependen de un objetivo, como cambiar el clima, subir stats del usuario, o curar PS. Se ejecuta después del uso del movimiento.

def pbEffectGeneral(user)
  @battle.pbStartWeatherAbility(:Sun, 5, user)
  @battle.pbDisplay(_INTL("¡La luz solar se volvió intensa!"))
end

pbEffectAgainstTarget(user, target)

Se ejecuta por cada objetivo del movimiento. Ideal para efectos que dependen del objetivo pero no son efectos secundarios con probabilidad.

def pbEffectAgainstTarget(user, target)
  target.pbLowerStatStage(:DEFENSE, 1, user)
end

Otros métodos útiles

Crear un efecto personalizado paso a paso

Vamos a crear un movimiento personalizado llamado "Puño Volcánico" — un movimiento físico de tipo Fuego que quema al objetivo y sube el Ataque del usuario en 1 nivel.

Paso 1: Definir el movimiento en el PBS

Añade esta entrada al archivo PBS/moves.txt:

[VOLCANICPUNCH]
Name = Puño Volcánico
Type = FIRE
Category = Physical
Power = 85
Accuracy = 100
TotalPP = 10
Target = NearOther
FunctionCode = VolcanicPunch
Flags = Contact,CanProtect,CanMirrorMove,Punch,ThawsUser
EffectChance = 30
Description = Un puñetazo envuelto en lava. Puede quemar y sube el Ataque del usuario.

Paso 2: Crear la clase del efecto

Crea un nuevo script (o añade a un script existente de efectos de movimientos) con la siguiente clase:

class Battle::Move::VolcanicPunch < Battle::Move
  # Efecto adicional: quemar al objetivo (con probabilidad de EffectChance)
  def pbAdditionalEffect(user, target)
    return if target.damageState.substitute
    if target.pbCanBurn?(user, false, self)
      target.pbBurn(user)
    end
  end

  # Efecto que siempre ocurre: subir Ataque del usuario
  def pbEffectWhenDealingDamage(user, target)
    if user.pbCanRaiseStatStage?(:ATTACK, user, self)
      user.pbRaiseStatStage(:ATTACK, 1, user)
    end
  end
end

Paso 3: Compilar

Guarda los cambios, abre el juego en modo Debug y compila los datos (Debug > Compilar datos). El nuevo movimiento estará disponible.

Tabla de FunctionCodes comunes

A continuación se listan los FunctionCodes más utilizados, organizados por categoría:

Problemas de estado

Cambios de estadísticas

Clima y terreno

Curación y daño especial

Protección y defensa

Golpes múltiples