OverwolfSpire Codex متاح الآن على Overwolf. اعرف المزيد →

حول Spire Codex

Spire Codex قاعدة بيانات شاملة للعبة Slay the Spire 2، وتُختصر عادة إلى StS2، بُنيت عبر الهندسة العكسية لملفات اللعبة. كل بطاقة وأثر ووحش وجرعة وحدث وقوة في هذا الموقع استُخرجت مباشرة من الشيفرة المصدرية للعبة وبيانات الترجمة.

بدأ المشروع من فضول حول طريقة بناء StS2، ثم كبر ليصبح API وموقعا كاملين. الهدف هو تقديم مرجع مفصل وقابل للبحث يليق بمجتمع Spire.

إذا أردت المشاركة، يمكنك فتح PR على GitHub. هذا المستودع تابع للمكان الذي يُستضاف فيه المشروع، لذا قد يمر بعض الوقت قبل دمج طلبك بالكامل. يوفر المشروع API مفتوحة مجانية الاستخدام ويمكن استضافتها ذاتيا. وإذا أردت التحدث عن المشروع، تفضل بزيارة Discord حيث أنشر التحديثات وأناقش المشروع.

شكرا جزيلا لكل من يدعم المشروع، راجع صفحة الشكر لمعرفة داعمي Ko-fi والمساهمين من المجتمع.

خلف Codex

مرحبًا! أنا Peter، تقني علّم نفسه بنفسه، وأب رائع، وزوج لطيف، ومولع دائم بالتجريب. سلكت طريقًا غير تقليدي نحو هندسة البرمجيات والتقنية، وبنيت الأشياء من الصفر بدافع الفضول والشغف وحدهما. وما كنت لأختار غير ذلك. كانت لي مشاريع عديدة (DPC، مجتمع على Discord يضم أكثر من 10 آلاف محترف في DevOps والمنصات، و Genshin News، خدمة webhook لآخر أخبار Genshin Impact) لكن Spire Codex هو أكبر مشاريعي وأكثرها مدعاة لفخري.

دعم Spire Codex

بدأ Spire Codex كمشروع شغف وُلد من حب Slay the Spire ورغبة في بناء أدوات مطورين مفيدة وسريعة لمجتمع اللاعبين.

تشغيل قواعد بيانات عالية الزيارات وبنية API سريعة يكلّف وقتًا ومصاريف خوادم حقيقية. إذا أنقذك Spire Codex من خسارة، أو ساعدك في التخطيط لجولة، أو شغّل مشروعك الخاص، ففكّر في ترك إكرامية أو الحصول على عضوية! شكرًا على دعمك سواء كان ماليًا أم لا!

ماذا يوجد هنا

كيف يعمل

Slay the Spire 2 مبنية بمحرك Godot 4، لكن كل منطق اللعبة موجود في ملف DLL بلغة C#/.NET 8. مسار معالجة البيانات:

1
استخراج PCK
GDRE Tools تستخرج ملف .pck الخاص بـGodot: الصور، رسوم Spine المتحركة، وبيانات الترجمة (~9,947 ملفا)
2
تفكيك DLL
ILSpy يفكك sts2.dll إلى ~3,300 ملف مصدري C# تحتوي على كل نماذج اللعبة
3
تحليل البيانات
17 محللا بلغة Python تستخرج بيانات منظمة من شيفرة C# المفككة + ملفات الترجمة JSON
4
تصيير Spine
مصيِّر Node.js بلا واجهة يجمع الرسوم الهيكلية المتحركة في صور PNG شخصية بحجم 512×512 (أكثر من 130 رسما)
5
API + الواجهة الأمامية
FastAPI يقدم البيانات المحللة عبر REST API بأكثر من 20 نقطة وصول، وواجهة Next.js تستهلكها

الميزات

صفحات التفاصيل
صفحات تفصيلية للبطاقات والشخصيات والآثار والوحوش والجرعات مع الإحصائيات الكاملة
بحث شامل
اضغط . في أي مكان للبحث فورا في كل الفئات
عرض النص المنسق
وسوم BBCode الخاصة باللعبة معروضة بالألوان والحركات والأيقونات المضمنة
حوارات الشخصيات
أشجار محادثات الشخصيات غير اللاعبة واقتباسات الشخصيات من ملفات ترجمة اللعبة
رسوم Spine
أكثر من 130 رسما للوحوش والشخصيات مصيَّرة من الرسوم الهيكلية المتحركة
REST API
API كاملة مع التصفية والبحث ووثائق Swagger لمشاريعك الخاصة
تتبع سجل التغييرات
فروقات على مستوى الحقول بين تحديثات اللعبة في كل الفئات
تنزيل الصور
تصفح ونزّل كل رسوم اللعبة المستخرجة حسب الفئة

التقنيات المستخدمة

الواجهة الخلفية
Python, FastAPI, Pydantic
الواجهة الأمامية
Next.js, TypeScript, Tailwind
التصيير
Node.js, Playwright, spine-webgl
البنية التحتية
Docker, Forgejo CI

هذا المشروع لأغراض تعليمية. كل بيانات اللعبة ملك لشركة Mega Crit Games. لا يجوز استخدامه لإعادة تجميع اللعبة أو إعادة توزيعها.