Faire échouer une attaque

Principe

Une attaque peut échouer pour deux raisons distinctes :

• Depuis l'attaque elle-même : l'attaque vérifie ses propres conditions et décide qu'elle ne peut pas être utilisée.
• Depuis un effet externe : un effet actif sur le Pokémon empêche l'utilisation de l'attaque.

Dans les deux cas, l'échec doit impérativement être accompagné d'un message indiquant clairement la raison au joueur.

Depuis l'attaque

Certaines attaques peuvent échouer selon leurs propres règles. Par exemple, l'attaque Gravité échoue si la gravité est déjà active sur le terrain.

Pour gérer ce comportement, on override la méthode move_usable_by_user dans la classe de l'attaque.

Exemple : Gravité

# Function that tests if the user is able to use the move
# @param user [PFM::PokemonBattler] user of the move
# @param targets [Array<PFM::PokemonBattler>] expected targets
# @note Thing that prevents the move from being used should be defined by :move_prevention_user Hook
# @return [Boolean] if the procedure can continue
def move_usable_by_user(user, targets)
  return false unless super
  return show_usage_failure(user) && false if @logic.terrain_effects.has?(:gravity)

  return true
end

• L'appel à super est indispensable pour conserver les vérifications par défaut.
• show_usage_failure(user) affiche le message d'échec au joueur.
• L'expression && false garantit que la méthode retourne bien false après l'affichage du message.

Depuis un effet

Certaines attaques peuvent échouer à cause d'un effet actif sur l'utilisateur. Par exemple, l'effet Execu-Son empêche l'utilisation des attaques sonores.

Pour gérer ce comportement, on utilise la méthode on_move_prevention_user dans la classe de l'effet.

Exemple : Execu-Son

# Function called when we try to use a move as the user (returns :prevent if user fails)
# @param user [PFM::PokemonBattler]
# @param targets [Array<PFM::PokemonBattler>]
# @param move [Battle::Move]
# @return [:prevent, nil] :prevent if the move cannot continue
def on_move_prevention_user(user, targets, move)
  return if user != @pokemon
  return unless move.sound_attack?

  move.scene.display_message_and_wait(parse_text_with_pokemon(59, 1860, user))
  return :prevent
end

• Les premières lignes vérifient que l'effet concerne bien cet utilisateur et ce type d'attaque.
• Le message d'échec est affiché avant le retour :prevent.
• Le retour :prevent signale au système que l'attaque ne peut pas continuer.

Conclusion

• Utilisez move_usable_by_user si l'échec dépend de la logique propre de l'attaque.
• Utilisez on_move_prevention_user si l'échec dépend d'un effet externe actif sur le Pokémon.
• Retournez false (depuis l'attaque) ou :prevent (depuis un effet) selon le contexte.
• Affichez toujours un message clair au joueur avant de retourner l'échec.