
معركة التكنولوجيا: بداية صقر الهلال الهندسة العكسية
هندسة عكسية لـ BattleTech: The Crescent Hawk's Inception (1988، MS-DOS؛ نُشرت بواسطة Infocom، المحرك من Westwood Associates) — وإعادة إنشاء قيد التطوير بـ Godot 4 / C# لها.
اقرأ هذا القسم قبل أن تثق بأي شيء آخر في هذا المستودع. المشروع هو جهدان بمستويين مختلفين جدًا من النضج، وكلمة "phase" في مكان آخر في الوثائق تعني الكود المكتوب، وليس السلوك المُثبت.
ينتج هذا المشروع قطعتين في الوقت نفسه، والثانية تستند إلى الأولى:
(1) الهندسة العكسية الموثّقة. تفكيك reko/، ومواصفات docs/، ومحاكي
Spice86 مع أدوات MCP الخاصة بـ BattleTech، وأدوات Python. هذا هو عمل الهندسة العكسية الحقيقي:
صيغ الملفات، ونص القصة، وخريطة الذاكرة، وجزء كبير من منطق المحرك موثّقة و
مُتحقَّق منها مقابل مخرجات المفكّك وآثار المحاكي الحيّة. إنها قطعة بحد
ذاتها، وهي أيضًا المواصفة لـ (2).
(2) إعادة الإنشاء (BattleTechCHI/). برنامج Godot 4 C# يُشتق من (1): يقرأ
ملفات البيانات الأصلية (.BLD، .MTP، .ANM، حفظات GAME*) ويعيد تنفيذ سلوك المحرك
كما هو موثّق في (1). إنه مُخلص للبيانات، وليس مُخلصًا للسلوك، ولم
يُتحقَّق منه من البداية إلى النهاية مقابل الأصل.
يعملان بالتوازي، لكن اتجاه الاعتماد ثابت:
(2) لا يمكن أن يكون مخلصًا إلا بقدر ما يكون (1) مكتملًا ومُتحقَّقًا منه. حيث يقول (1) مُستنتَج أو مفتوح، يكون (2) تخمينًا.
لهذا السبب تضع خارطة الطريق سدّ فجوات الهندسة العكسية (المسار 1) والتحقق التفاضلي لـ (2) مقابل المحاكي (المسار 3) قبل عمل الميزات. إعادة الإنشاء لا تكون جيدة إلا بقدر جودة الهندسة العكسية التي تستند إليها.
إذا كنت تبحث عن نقل مطابق بالبت، فهو غير موجود بعد. إذا كنت تبحث عن بيئة هندسة عكسية بمساعدة الأدوات بالإضافة إلى إعادة بناء مدفوعة بالبيانات تعمل على الأصول الأصلية، فهذا ما هو موجود هنا.
المفتاح: ✅ صحيح / منجز · ⚠️ جزئي، تقريبي، أو بفجوات صامتة · ❓ غير معروف / غير مُتحقَّق منه · ❌ غائب
| النظام | يقرأ الملفات الأصلية وقت التشغيل | السلوك يطابق الأصل | التحقق |
|---|---|---|---|
| فك تشفير BLD + النص المشفّر | ✅ BldLoader.cs | ✅ (نص) | ✅ رحلة ذهاب وإياب BLD↔JSON متطابقة بايتًا (tools/bld) |
| مفسّر أكواد BLD (28 خانة 0xE4–0xFF) | ✅ | ⚠️ جزئي | ❓ لم يُلعب من البداية إلى النهاية؛ أحجام المعاملات ثابتة (EB/EC/F6/F7 و ED: 4 بايتات idx/thresh/LE-target، match→jump)؛ جميع الخانات معالجة (لا إسقاط صامت) |
إرسال Fn1CD3 (47 حالة) | ✅ | ⚠️ جزئي | ❓ مُنفّذ من التفكيك؛ عدة حالات تقريبية؛ خطأ معروف: 0x23 هو إعداد قتال الساحة/الغرفة (1CD3:1062 → fn0FDC_0629(8))، وليس تهيئة لعبة جديدة — فـ NewGameInit في إعادة البناء سيمحو جولة إذا أطلقها نزال في الساحة؛ ED UnitCheckLoop يستهلك 2 بايتات بدلًا من 4 ويتخطى فحص المهارة + القفز |
| ترويسة/بلاطات خريطة MTP | ✅ MapLoader.cs / LocalMapView.cs | ✅ (البنية) | ⚠️ التخطيط مفكوك، لم يُقارن إطارًا بإطار |
| رسوم ANM المتحركة (XOR-delta RLE) | ✅ وقت التشغيل، PNG احتياطي | ⚠️ | ❓؛ المستودع لا يحتوي على جداول رسوم ANM (Assets/Animations/ فارغ) |
| بلاطات ICN/CMP | ❌ (محوّلة مسبقًا) | — | TileManager يحمّل BMP؛ Assets/Tilesets/ فارغ |
ملفات الحفظ GAME1–6 (4096 بايت) | ✅ محلّل SaveManager.cs | ❓ | ❌ رحلة الذهاب والإياب لم تُتحقق مقابل ملفات الحفظ الأصلية |
حالة القصة (b0057، الخصائص) | ✅ (قراءات) | ❓ المعنى مُستنتج | ❓ الدلالات غير مؤكدة أثناء اللعب |
| القتال (الإصابة، الضرر، الذكاء الاصطناعي، الحرارة، الذخيرة، الضباب) | — (منطق خاص) | ❌ تقريبي | ❌ RNG/الصيغ لم تُقارن مقابل الأصل |
| منفذ العرض / تخطيط الشاشة | — | ⚠️ تقريبي | ❓ لم يُحدد هيكل منفذ عرض مرجعي |
| الصوت / الموسيقى | ❌ | ❌ | ❌ الصيغة غير مفكوكة |
| ربط المحفزات Map→BLD | ✅ مفكوك | ✅ ([0x5460]:0x4602 + جداول مواضع المباني → قائمة أسماء MTP؛ docs/formats/map-bld-triggers.md) | ⚠️ المداخل تم التحقق منها يدويًا على MAP1 فقط حتى الآن |
.BLD الحقيقية وتفسيرها (الحوارات، القوائم، المتاجر، العديد من حالات
الإرسال) — مع ثغرات صامتة في الأكواد غير المنفّذة..MTP الحقيقية، وقراءة/كتابة تخطيط الحفظ الحقيقي ذي 4096 بايت.| المجال | الحالة | الوثيقة المرجعية |
|---|---|---|
| صيغة BLD، التشفير، الأكواد | 🟢 متين | docs/formats/bld-bytecode.md |
| نص القصة (جميع الـ 26 BLD) | 🟢 مُستخرج | docs/story/STORY_TEXT.txt |
| خريطة الذاكرة (أكثر من 100 عنوان، مقاطع) | 🟢 متين | docs/formats/memory-map.md |
| خريطة العالم / الخرائط المحلية | 🟢 متين | docs/world-map.md |
| نموذج القتال | 🟡 ~90%، بعضه مُستنتج | docs/combat-system.md |
| الاقتصاد / المتاجر / المخزون | 🟡 تدفق الواجهة لوحظ مباشرة الآن | docs/story/story-system.md |
| صيغة ANM | 🟢 موثّقة | docs/formats/anm-format.md |
| تجريد منفذ العرض | 🔴 غير مكتمل | docs/engine/viewport.md |
| الصوت | 🔴 0% | — |
هذه هي العوائق الحقيقية؛ خارطة الطريق في §6 مرهونة بها.
docs/combat-system.md)19EF / 1000 موجودة في reko/gencode/ (23 ملفًا من مولّد الشيفرة القديم Spice86، مستبعدة من الترجمة) إضافةً إلى إعادة توليد حديثة في reko/gencode-current/؛ خريطة الدوال في docs/engine/segments-19ef-1000.md. (docs/UNVERIFIED_DISCOVERIES.md §7)b0057 (0/1/2) والمتغيرات المجاورة b0055/b0056/b0058 مثبّتة على الشيفرة (fn1631_11AB)؛ دلالات مصفوفة D30C مُخطّطة إلى حد كبير (التدريب/الغزو، الخائن، الزي الرسمي، المرآب، متجر الفيديو، الكوخ، رايات الحلبة — docs/story/story-system.md §17.5/§17.11). معرّفات الخصائص 0x1C–0x23 غير مُخطّطة. (§5)0x32C6) + جدول الترجمة ([0x5460]:0x4602) غير مفكّكينdocs/formats/map-bld-triggers.md)؛ المداخل تم التحقق منها يدويًا على MAP1 حتى الآن (Citadel (34,10)، ComStar (51,10)). (docs/context.md)0x246C مُخطّطة جزئيًا فقط؛ دلالات push/pop غير معروفة. (docs/engine/viewport.md)0x32C6 للحركةprop < per-scene gate t0150؛ جميع قارئات 0x32C6 مُعدّدة (إصابة +1، بوابات 0xFF، مسح إيجاد المسار) — لا توجد تكلفة حركة لكل تضاريس (إنقاص MP هو تكاليف خطوات ثابتة). (§2)GAME*.D323)، توقف سقف الثروة، نمو الممتلكات — الآلية مفكّكة + مُتحقَّق منها حيًّا 2026-10-14 (docs/economy.md)؛ عزل الرسوم/النبضة + جداول مصدر كتلة المالية لا تزال مفتوحة. (docs/story/story-system.md)tools/bld/opcode_coverage.py)، فقط 0xE7 غير مُصدَر؛ صُحّحت أحجام المعاملات (EB/EC/F6/F7 و ED). (فرع default في BldInterpreter.cs)BTTLTECH←fn0800_4621، القتال/المحلي MAP15←fn135D_055A via 1F3D:0814 — docs/formats/file-formats.md)؛ صياغة المقطع 2A02 مقابل مكان آخر أُلغيت.