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

جزء من قسم البرمجة كائنية التوجه في رحلة PHP على Coddy. الدرس 90 من 91.

التحدي

سهل

لنَبْنِ نظامًا لـ تطوير شخصيات اللعبة حيث تتبارى فئات مختلفة من الشخصيات باستخدام قدرات فريدة. ستنشئ تسلسلًا هرميًا للشخصيات مع نظام للخبرة ورفع المستوى، موضحًا كيفية عمل الوراثة والواجهات والسمات والتغليف معًا في سياق لعبة.

ستنظّم التعليمات البرمجية عبر ستة ملفات:

Ability.php: عرّف واجهة Ability باستخدام طريقتين: getName(): string وuse(Character $target): string. يضمن هذا العقد إمكانية استخدام جميع القدرات بطريقة متسقة بغض النظر عن تأثيراتها المحددة.
CombatLogger.php: أنشئ سمة CombatLogger التي توفر طريقة logAction(string $action): string. يجب أن تعيد هذه الطريقة سلسلة الإجراء مسبوقة بـ "[COMBAT] ". ستستخدم الشخصيات هذه السمة لتنسيق رسائل القتال بطريقة متسقة.
Character.php: أدرج ملفَي Ability وCombatLogger. أنشئ فئة مجردة Character تستخدم سمة CombatLogger. استخدم ترقية المُنشئ للخاصية name (من النوع string، وpublic readonly). ضمّن خصائص خاصة لـ health (من النوع int، تبدأ بقيمة 100)، وlevel (من النوع int، تبدأ بقيمة 1)، وexperience (من النوع int، تبدأ بقيمة 0). نفّذ ما يلي:
- getHealth(): int وgetLevel(): int: دالتا getter للخصائص الخاصة
- takeDamage(int $amount): void: تقلل الصحة، لكن لا تجعلها أقل من 0
- heal(int $amount): void: تزيد الصحة، لكن لا تجعلها أعلى من 100
- gainExperience(int $xp): string: تضيف XP؛ إذا وصلت الخبرة إلى 100 أو أكثر، فارفع المستوى (أعد ضبط XP إلى 0، وزِد المستوى، وعالج 20 من نقاط الصحة)، ثم أعد "[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() لإعادة فئة مجهولة تطبق 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": تهاجم الشخصية الموجودة عند فهرس attacker الهدف؛ اطبع النتيجة
- "special": تستخدم الشخصية قدرتها الخاصة على الهدف؛ اطبع النتيجة
- "xp": تكتسب الشخصية خبرة؛ اطبع النتيجة
- "heal": تعالج الشخصية المقدار المحدد؛ اطبع "[name] healed to [health] HP"
- "status": اطبع "[name] - Level [level], HP: [health], Alive: [Yes/No]"
اطبع كل نتيجة في سطر جديد.

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

جرّب بنفسك

<?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]"

?>