تطوير شخصيات الألعاب

جزء من قسم Object Oriented Programming في رحلة PHP على Coddy — الدرس 90 من 91.

التحدي

سهل

لنقم ببناء نظام تطوير شخصيات الألعاب (Game Character Development) حيث تتقاتل فئات شخصيات مختلفة باستخدام قدرات فريدة. ستقوم بإنشاء تسلسل هرمي للشخصيات مع نظام خبرة ومستويات، مما يوضح كيف تعمل الوراثة (inheritance)، والواجهات (interfaces)، والسمات (traits)، والتغليف (encapsulation) معاً في سياق اللعبة.

ستقوم بتنظيم الكود الخاص بك عبر ستة ملفات:

Ability.php — قم بتعريف واجهة Ability مع طريقتين (methods): getName(): string و use(Character $target): string. يضمن هذا العقد إمكانية استخدام جميع القدرات بشكل متسق بغض النظر عن تأثيراتها المحددة.
CombatLogger.php — أنشئ سمة (trait) باسم CombatLogger توفر طريقة logAction(string $action): string. يجب أن تعيد هذه الطريقة سلسلة الإجراء مسبوقة بـ "[COMBAT] ". ستستخدم الشخصيات هذه السمة لتنسيق رسائل القتال الخاصة بها بشكل متسق.
Character.php — قم بتضمين ملفات Ability و CombatLogger. أنشئ فئة مجردة (abstract class) باسم Character تستخدم سمة CombatLogger. استخدم ترقية المنشئ (constructor promotion) لـ name (string، public readonly). قم بتضمين خصائص خاصة (private) لـ health (int، تبدأ بـ 100)، و level (int، يبدأ بـ 1)، و experience (int، تبدأ بـ 0). قم بتنفيذ ما يلي:
- getHealth(): int و getLevel(): int — دوال جلب (getters) للخصائص الخاصة.
- takeDamage(int $amount): void — يقلل الصحة ولكن ليس أقل من 0 أبداً.
- heal(int $amount): void — يزيد الصحة ولكن ليس أكثر من 100 أبداً.
- gainExperience(int $xp): string — يضيف نقاط الخبرة (XP)؛ إذا وصلت الخبرة إلى 100 أو أكثر، يرتفع المستوى (إعادة تعيين XP إلى 0، زيادة المستوى، استعادة 20 HP)، وإرجاع "[name] leveled up to [level]!"؛ خلاف ذلك إرجاع "[name] gained [xp] XP".
- isAlive(): bool — يعيد true إذا كانت الصحة أكبر من 0.
- abstract getSpecialAbility(): Ability — يوفر كل نوع شخصية قدرته الفريدة.
- attack(Character $target): string — يلحق 10 ضرر بالهدف، ويستخدم logAction() لإرجاع "[COMBAT] [name] attacks [target name] for 10 damage".
Warrior.php — قم بتضمين ملف Character. أنشئ فئة Warrior ترث من Character. قم بتنفيذ getSpecialAbility() لتعيد فئة مجهولة (anonymous class) تنفذ واجهة Ability:
- getName() تعيد "Shield Bash".
- use() تلحق 25 ضرر وتعيد "[COMBAT] Shield Bash hits [target name] for 25 damage!" (استخدم logAction() الخاصة بالسمة).
Mage.php — قم بتضمين ملف Character. أنشئ فئة Mage ترث من Character. قم بتنفيذ getSpecialAbility() لتعيد فئة مجهولة تنفذ واجهة Ability:
- getName() تعيد "Fireball".
- use() تلحق 35 ضرر وتعيد "[COMBAT] Fireball engulfs [target name] for 35 damage!".
main.php — قم بتضمين ملفات Warrior و Mage. ستتلقى مدخلين: بيانات الشخصية (JSON) وتسلسل من إجراءات القتال (JSON).
تنسيق 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" — الشخصية في فهرس المهاجم تهاجم الهدف؛ اطبع النتيجة.
- "special" — الشخصية تستخدم قدرتها الخاصة على الهدف؛ اطبع النتيجة.
- "xp" — الشخصية تكتسب خبرة؛ اطبع النتيجة.
- "heal" — الشخصية تشفى بالمقدار المحدد؛ اطبع "[name] healed to [health] HP".
- "status" — اطبع "[name] - Level [level], HP: [health], Alive: [Yes/No]".
اطبع كل نتيجة في سطر جديد.

يوضح هذا النظام كيف تحدد الفئات المجردة سلوك الشخصية المشترك، وتضمن الواجهات اتباع القدرات لعقد متسق، وتوفر السمات وظائف تسجيل (logging) قابلة لإعادة الاستخدام، وتنشئ الفئات المجهولة تطبيقات فريدة للقدرات دون ازدحام الكود الخاص بك بفئات تستخدم لمرة واحدة.

جرّب بنفسك

<?php
require_once 'Warrior.php';
require_once 'Mage.php';

// قراءة المدخلات
$charactersJson = trim(fgets(STDIN));
$actionsJson = trim(fgets(STDIN));

// تحليل مدخلات JSON
$charactersData = (array)json_decode($charactersJson, true);
$actionsData = (array)json_decode($actionsJson, true);

// TODO: إنشاء مصفوفة لتخزين كائنات الشخصيات
$characters = [];

// TODO: التكرار عبر $charactersData وإنشاء كائنات Warrior أو Mage
// بناءً على حقل "type"، وتخزينها في مصفوفة $characters

// TODO: معالجة كل إجراء في $actionsData
// التعامل مع أنواع الإجراءات التالية:
// - "attack": الشخصية في فهرس المهاجم تهاجم الهدف؛ طباعة النتيجة
// - "special": الشخصية تستخدم getSpecialAbility()->use() على الهدف؛ طباعة النتيجة
// - "xp": الشخصية تكتسب خبرة؛ طباعة النتيجة
// - "heal": الشخصية تتعافى؛ طباعة "[name] healed to [health] HP"
// - "status": طباعة "[name] - Level [level], HP: [health], Alive: [Yes/No]"

?>