عن المشروع

Shatterfish هو مشروع مفتوح المصدر مصمم لتوسيع Shattered Pixel Dungeon (SPD) بقدرات أتمتة وتحليل متقدمة، على غرار محرك الشطرنج Stockfish. يعمل المشروع كفرع مشتق (downstream fork) من SPD، حيث يحافظ على التوافق مع إضافة أربعة مكونات أساسية: نظام تشغيل لعبة بدون واجهة (headless game harness) لتشغيل جولات سريعة وقابلة للتكرار؛ و'دماغ' ذكاء اصطناعي رمزي يلعب باستخدام حالة اللعبة الملحوظة فقط؛ ومنصة اختبار إحصائية لتقييم التغييرات عبر مقارنات SPRT؛ وتراكب داخل اللعبة يتيح للمستخدمين مشاهدة البوت أو إيقافه مؤقتاً أو التحكم مكانه أثناء اللعب الفعلي. يفرض المشروع بصرامة 'تكافؤ المعلومات' — حيث لا يمكن للبوت استخدام سوى ما يمكن للاعب البشري رؤيته على الشاشة، مثل المرئيات المعروضة، والسجلات، ومدخلات اليوميات. ولا يمكنه الوصول إلى حالة اللعبة المخفية مثل بذور RNG أو هويات العناصر غير المحددة. يتم فرض قيد العدالة هذا من خلال واجهة Observer واحدة، مع إجراء اختبارات تسريب ترافق كل تغيير. تم بناء المشروع باستخدام JDK 21، ولا يتطلب Android SDK أو Xcode. تم تنظيم قاعدة الكود تحت وحدات shatterfish (api, harness, codex, brain, rig, overlay)، مع توثيق مفصل يتضمن تثبيت الإصدار المرجعي (v3.3.8)، وتعليمات البناء، ومنهجية التطوير (BMAD Method). جميع المساهمات مرخصة بموجب GPL-3.0-or-later، بما يتوافق مع ترخيص SPD. ويخلي المشروع مسؤوليته صراحة من أي ارتباط بالمؤلفين الأصليين لـ SPD.