ゲームキャラクター開発

異なるキャラクタークラスが独自の能力を使って戦う、ゲームキャラクター開発システムを構築しましょう。継承、インターフェース、トレイト、そしてカプセル化がゲームの文脈でどのように連携するかを示すために、経験値とレベルアップシステムを備えたキャラクターの階層構造を作成します。

コードは以下の6つのファイルに分けて構成します：

• Ability.php — 2つのメソッド getName(): string と use(Character $target): string を持つ Ability インターフェースを定義します。この規約により、具体的な効果に関わらず、すべての能力を一貫して使用できるようになります。
• CombatLogger.php — logAction(string $action): string メソッドを提供する CombatLogger トレイトを作成します。このメソッドは、アクション文字列の先頭に "[COMBAT] " を付けて返す必要があります。キャラクターはこのトレイトを使用して、戦闘メッセージを統一された形式で出力します。
• Character.php — AbilityとCombatLoggerのファイルを取り込みます。CombatLogger トレイトを使用する抽象クラス Character を作成します。name (string, public readonly) にはコンストラクタのプロパティ昇格を使用します。health (int, 初期値 100)、level (int, 初期値 1)、experience (int, 初期値 0) のプライベートプロパティを含めます。以下を実装してください：
  • getHealth(): int および getLevel(): int — プライベートプロパティのゲッター
  • takeDamage(int $amount): void — 体力を減らしますが、0未満にはなりません
  • heal(int $amount): void — 体力を増やしますが、100を超えません
  • gainExperience(int $xp): string — XPを加算します。経験値が100以上に達した場合はレベルアップし（XPを0にリセット、レベルを上げ、HPを20回復）、"[name] leveled up to [level]!" を返します。それ以外の場合は "[name] gained [xp] XP" を返します。
  • isAlive(): bool — 体力が0より大きい場合に true を返します
  • abstract getSpecialAbility(): Ability — 各キャラクタータイプが独自の能力を提供します
  • attack(Character $target): string — ターゲットに10のダメージを与え、logAction() を使用して "[COMBAT] [name] attacks [target name] for 10 damage" を返します
• Warrior.php — Characterファイルを取り込みます。Character を継承した Warrior クラスを作成します。getSpecialAbility() を実装し、Ability を実装する匿名クラスを返します：
  • getName() は "Shield Bash" を返します
  • use() は25のダメージを与え、"[COMBAT] Shield Bash hits [target name] for 25 damage!" を返します（トレイトの logAction() を使用してください）
• Mage.php — Characterファイルを取り込みます。Character を継承した Mage クラスを作成します。getSpecialAbility() を実装し、Ability を実装する匿名クラスを返します：
  • getName() は "Fireball" を返します
  • use() は35のダメージを与え、"[COMBAT] Fireball engulfs [target name] for 35 damage!" を返します
• main.php — WarriorとMageのファイルを取り込みます。キャラクターデータ (JSON) と戦闘アクションのシーケンス (JSON) の2つの入力を受け取ります。

  キャラクターのJSON形式：

  [{"type": "warrior", "name": "Thorin"}, {"type": "mage", "name": "Gandalf"}]

  アクションのJSON形式：

  [{"action": "attack", "attacker": 0, "target": 1}, {"action": "special", "attacker": 1, "target": 0}, {"action": "xp", "character": 0, "amount": 100}, {"action": "status", "character": 0}]

  すべてのキャラクターを作成し、配列（インデックス 0, 1 など）に保存します。各アクションを処理します：

  • "attack" — attackerインデックスのキャラクターがターゲットを攻撃します。結果を出力します。
  • "special" — キャラクターがターゲットに対して特殊能力を使用します。結果を出力します。
  • "xp" — キャラクターが経験値を獲得します。結果を出力します。
  • "heal" — キャラクターが指定された量だけ回復します。"[name] healed to [health] HP" と出力します。
  • "status" — "[name] - Level [level], HP: [health], Alive: [Yes/No]" と出力します。

  各結果を新しい行に出力してください。

このシステムは、抽象クラスが共有のキャラクター動作を定義し、インターフェースが能力の一貫した規約を保証し、トレイトが再利用可能なロギング機能を提供し、匿名クラスが使い捨てのクラスでコードベースを散らかすことなく独自の能力実装を作成する方法を示しています。