شارك المقالة
لعبة الشطرنج Flutter: مشروع Chess RPS وتهيئة Stockfish

لعبة الشطرنج Flutter: مشروع Chess RPS وتهيئة Stockfish

مراجعة لعبة الشطرنج Flutter في مشروع Chess RPS، وتصحيح قواعد الحركة وتحديد مجلد التطبيق وتهيئة Stockfish وBackend للعب عبر الشبكة.

مراجعة لعبة الشطرنج Flutter في مشروع Chess RPS، وتصحيح قواعد الحركة وتحديد مجلد التطبيق وتهيئة Stockfish وBackend للعب عبر الشبكة.

رابط المشروع الصحيح ونطاقه

كان الرابط القديم يشير إلى مجلد stockfish_interpreter وحده، لكنه جزء من مستودع أكبر اسمه chess_rps. يحتوي المصدر تطبيق Flutter داخل flutter_app وخادمًا داخل backend_app وغلافًا لمحرك Stockfish. ويصف README وضع الشطرنج التقليدي ووضعًا يضيف حجر ورقة مقص، مع خصم آلي أو لعب عبر الشبكة. ابدأ من جذر المستودع لفهم هذه الأجزاء، ولا تقدم مجلد الغلاف بوصفه تطبيقًا كاملًا مستقلًا.

تشغيل تطبيق Flutter مع التبعيات المحلية

توجد في pubspec الخاص بالتطبيق تبعية path إلى ../stockfish_interpreter، لذلك تنزيل flutter_app وحده قد يترك ملفات مطلوبة خارج المجلد. نزّل المستودع كاملًا وانتقل إلى flutter_app قبل pub get. راجع توليد ملفات Riverpod وFreezed وJSON وفق تعليمات المصدر إن احتاجت النسخة إلى إعادة توليد. نجاح فتح شاشة اختيار الخصم لا يثبت أن المكتبة الأصلية لمحرك Stockfish تعمل على جهازك أو أن الخادم متاح.

تصحيح حركة الوزير والحصان

الوزير يتحرك على الصف أو العمود أو القطر، ولا ينتقل إلى أي مربع عشوائي، ولا يقفز فوق القطع الواقعة في طريقه. حركة الحصان بفارق مربعين في اتجاه ومربع واحد في الاتجاه العمودي عليه، لا ثلاثة ثم واحد كما ورد سابقًا. ويجب التحقق من حدود الرقعة والقطعة الموجودة في الوجهة. يوضح المثال أدناه هندسة هاتين الحركتين فقط؛ لا يتحقق من لون القطعة المستهدفة أو تهديد الملك أو كل قواعد مباراة كاملة.

القانونية أكبر من شكل الحركة

تحريك قطعة بالشكل الصحيح لا يجعل النقلة قانونية إذا تركت ملك اللاعب في تهديد. التبييت وترقية البيدق والأخذ بالتجاوز والتعادل ونهاية المباراة تحتاج حالات واختبارات مستقلة. لا تسجل نهاية اللعبة عند اختفاء صورة الملك من الواجهة؛ اجعل نموذج المباراة مصدر الحقيقة. وثّق كذلك اختلاف وضع RPS عن الشطرنج التقليدي، ولا تنسب قواعد الوضع الإضافي إلى قوانين FIDE القياسية.

إدارة Stockfish وطلبات التحليل

ابدأ بتهيئة المحرك ثم إرسال وضعية صحيحة وقراءة النتيجة وفق عقد الغلاف المستخدم. لا تنشئ عملية محرك جديدة في كل build، وأوقف التحليل أو ألغ أثر نتيجته عندما تتغير الوضعية أو يغلق اللاعب الصفحة. اربط كل نتيجة بالوضعية التي طلبتها، حتى لا ينفذ الخصم الآلي اقتراحًا وصل متأخرًا لمباراة أخرى. اختبر البناء والمنصة الأصلية التي يستهدفها محركك، وليس Widgets الرقعة فقط.

اللعب عبر الشبكة والتزامن

المسار المتصل يحتاج إعداد الخادم وقاعدة البيانات وعنوان API وWebSocket حسب وثائق المستودع. الخادم ينبغي أن يتحقق من اللاعب والدور والنقلة وتسلسل الأحداث؛ اختيار مربع في العميل لا يمنحه سلطة تغيير المباراة. عند إعادة الاتصال أعد مزامنة الوضعية بدل إعادة تشغيل آخر نقلة بلا تحقق. لا تنشر مفاتيح توثيق أو روابط خادم تطوير غير محمية في نسخة عامة، ولا تشغل سكربت إعداد خارجي قبل مراجعة ما يفعله في بيئتك.

اختبارات مفيدة قبل تحسين الرسومات

اختبر حركة حصان صحيحة وخاطئة، ووزيرًا على صف وعمود وقطر مع عائق وبدونه، ثم حالات الملك والتبييت على محرك القواعد الكامل. جرب انسحابًا وانقطاع شبكة ونتيجة تحليل قديمة وفتح مباراة جديدة. أوامر التشغيل أدناه تخص جزء Flutter، ولا تنفذ إعداد Backend أو ضمان دعم كل منصة. المستودع الحالي لا يحدد ترخيصًا واضحًا في خانة License؛ تحقق من شروط المصدر والمحرك والأصول قبل إعادة توزيع نسخة مشتقة.

مثال مستقل للمنطق وحدوده

الكود التالي يعزل الفكرة المذكورة لاختبارها دون تشغيل المصدر الخارجي؛ لا يرسم اللعبة ولا يهيئ كل خدماتها. وصله بطبقة العرض بعد مراجعة الحالات المشروحة أعلاه.

bool _inside(int row, int col) => row >= 0 && row < 8 && col >= 0 && col < 8;

bool knightGeometry(int fromRow, int fromCol, int toRow, int toCol) {
  if (!_inside(fromRow, fromCol) || !_inside(toRow, toCol)) return false;
  final dr = (toRow - fromRow).abs(), dc = (toCol - fromCol).abs();
  return (dr == 2 && dc == 1) || (dr == 1 && dc == 2);
}

bool queenPathClear(int fromRow, int fromCol, int toRow, int toCol,
    bool Function(int row, int col) occupied) {
  if (!_inside(fromRow, fromCol) || !_inside(toRow, toCol)) return false;
  final dr = toRow - fromRow, dc = toCol - fromCol;
  if (dr == 0 && dc == 0) return false;
  if (!(dr == 0 || dc == 0 || dr.abs() == dc.abs())) return false;
  var row = fromRow + dr.sign, col = fromCol + dc.sign;
  while (row != toRow || col != toCol) {
    if (occupied(row, col)) return false;
    row += dr.sign; col += dc.sign;
  }
  return true;
}
// Geometry only: destination ownership, turn and king safety are separate checks.

بدء مراجعة المشروع الأصلي

راجع README والحزم والأصول والمنصة قبل التشغيل. هذه أوامر مقترحة لنسخة مستقلة، ولا تعني أن بناء المستودع الخارجي قد اختبر على جميع الإصدارات.

git clone https://github.com/Anonymous747/chess_rps.git
cd chess_rps/flutter_app
flutter --version
flutter pub get
flutter analyze
flutter run

المصدر ومراجع التنفيذ

شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع