Phase 5 — Combat System (Core Combat & March Engine)

تعتبر من أهم مراحل المشروع، حيث سيتم فيها تأسيس المحرك الأساسي للقتال (Combat Engine) ونظام حركة الجيوش (March System) بشكل احترافي وقابل للتوسع مستقبلًا.

المطلوب في هذه المرحلة ليس مجرد تنفيذ هجوم بسيط، وإنما بناء Core Systems مستقرة وقابلة لدعم التوسعات القادمة مثل PvP الكامل، التحالفات، والأنظمة المتقدمة بدون الحاجة لإعادة بناء الكود لاحقًا.

الأهداف الأساسية للمرحلة:

• تأسيس Combat Engine مستقل

• تأسيس March System مستقل

• دعم NPC Combat كبداية (PvE First)

• تجهيز Battle Reports

• تجهيز Loot System

• دعم UTC Server Timing

• دعم الأنظمة بشكل Server Authoritative بالكامل

• تصميم الأنظمة بأسلوب Data-Driven

المطلوب تنفيذه داخل المرحلة (In Scope):

1. نظام الإحداثيات (Coordinate System)

• تأسيس نظام X / Y للقرى ومعسكرات الـ NPC

• احتساب وقت الحركة حسب المسافة وسرعة القوات

2. نظام حركة الجيوش (March System)

• إرسال الجيش

• وقت الحركة

• الوصول

• العودة

• حالات الحركة (status)

• الاعتماد الكامل على UTC Time

3. هيكلة بيانات الجيوش بشكل Data-Driven

لكل نوع قوات:

• attack

• defense

• speed

• carry_capacity

• training_time

مع دعم مستقبلي لأنواع:

• Infantry

• Archer

• Cavalry

4. Combat Engine

• حساب القتال ضد NPC Camps

• حساب الخسائر

• حساب الغنائم (Loot)

• الاعتماد على Carry Capacity

5. Battle Reports & Combat Logs

• إنشاء تقارير معارك منظمة

• حفظ Combat Logs تفصيلية لكل معركة

• تصميم النظام بشكل قابل للتوسع لاحقًا

6. Recovery / Fail-Safe System

• حماية النظام في حال Restart للسيرفر

• استكمال المعارك والحركات عند عودة السيرفر

• منع ضياع الجيوش أو تعليق الحالات

7. دعم server_id

إضافة server_id في الجداول الأساسية لتجهيز النظام لدعم تعدد السيرفرات مستقبلًا.

8. مباني المرحلة

إضافة المباني المرتبطة بالقتال:

• Wall

• Hospital

• Archer Camp

الأشياء المستبعدة من المرحلة الحالية (Out of Scope):

• PvP الكامل بين اللاعبين

• Rally System

• Reinforce System

• Scout System

• Visual World Map

• Alliance Combat

• Buffs / Research Effects

• Protected Resources المتقدم

ملاحظات مهمة:

• الهدف الأساسي هو الاستقرار وصحة الحسابات وقابلية التوسع

• الأولوية لبناء Core Systems نظيفة وقوية

• سيتم تقسيم التنفيذ داخليًا إلى Milestones للاختبار التدريجي

• جميع الأنظمة يجب أن تكون قابلة للتوسع للمراحل القادمة بدون Refactoring كبير