
BattleTech: The Crescent Hawk's Inception रिवर्स इंजीनियरिंग
BattleTech: The Crescent Hawk's Inception (1988, MS-DOS; प्रकाशक Infocom, इंजन Westwood Associates द्वारा) का रिवर्स इंजीनियरिंग — और इसका एक प्रगतिरत Godot 4 / C# पुनर्निर्माण।
इस रेपो में किसी भी अन्य चीज़ पर भरोसा करने से पहले यह अनुभाग पढ़ें। यह परियोजना दो प्रयासों का संग्रह है जिनकी परिपक्वता बहुत भिन्न है, और दस्तावेज़ों में अन्यत्र "phase" शब्द का अर्थ लिखा गया कोड है, न कि सिद्ध व्यवहार।
यह परियोजना एक साथ दो आर्टिफैक्ट्स उत्पन्न करती है, और दूसरा पहले पर आधारित है:
(1) प्रलेखित रिवर्स इंजीनियरिंग। reko/ डीकंपाइलेशन, docs/ विनिर्देश, BattleTech-विशिष्ट MCP टूल्स के साथ Spice86 एमुलेटर, और Python टूलिंग। यह वास्तविक RE कार्य है: फ़ाइल फ़ॉर्मेट, कहानी पाठ, मेमोरी मैप, और इंजन लॉजिक का एक बड़ा भाग प्रलेखित है और डीकंपाइलर आउटपुट तथा लाइव एमुलेटर ट्रेस के विरुद्ध क्रॉस-चेक किया गया है। यह अपने आप में एक डिलीवरेबल है, और यह (2) के लिए विनिर्देश भी है।
(2) पुनर्निर्माण (BattleTechCHI/). एक Godot 4 C# प्रोग्राम जो (1) से व्युत्पन्न होता है: यह मूल डेटा फ़ाइलें (.BLD, .MTP, .ANM, GAME* सेव) पढ़ता है और इंजन व्यवहार को (1) द्वारा प्रलेखित रूप में पुनः कार्यान्वित करता है। यह डेटा-निष्ठ है, व्यवहार-निष्ठ नहीं, और मूल के विरुद्ध कभी भी एंड-टू-एंड सत्यापित नहीं किया गया है।
वे समानांतर रूप से चलते हैं, लेकिन निर्भरता की दिशा निश्चित है:
(2) केवल उतना ही निष्ठ हो सकता है जितना (1) पूर्ण और सत्यापित है। जहाँ (1) अनुमानित या खुला कहता है, वहाँ (2) एक अनुमान है।
इसी कारण रोडमैप RE अंतरालों को बंद करने (ट्रैक 1) और (2) के एमुलेटर के विरुद्ध विभेदक सत्यापन (ट्रैक 3) को फ़ीचर कार्य से पहले रखता है। एक पुनर्निर्माण उतना ही अच्छा होता है जितना अच्छा वह रिवर्स इंजीनियरिंग जिस पर वह आधारित है।
यदि आप बिट-सटीक पोर्ट की तलाश में हैं, तो वह अभी तक मौजूद नहीं है। यदि आप टूल-सहायित RE वातावरण के साथ-साथ एक डेटा-चालित पुनर्निर्माण की तलाश में हैं जो मूल एसेट्स पर चलता है, तो यही यहाँ उपलब्ध है।
संकेत: ✅ सत्य / पूर्ण · ⚠️ आंशिक, अनुमानित, या मौन अंतरालों के साथ · ❓ अज्ञात / असत्यापित · ❌ अनुपस्थित
| सिस्टम | रनटाइम पर मूल फ़ाइलें पढ़ता है | व्यवहार मूल से मेल खाता है | सत्यापन |
|---|---|---|---|
| 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 4 के बजाय 2 बाइट्स खाता है और स्किल चेक + जंप छोड़ देता है |
| MTP मैप हेडर/टाइल्स | ✅ MapLoader.cs / LocalMapView.cs | ✅ (संरचना) | ⚠️ लेआउट डिकोड किया गया, फ्रेम-दर-फ्रेम डिफ नहीं किया गया |
| ANM एनिमेशन (XOR-डेल्टा RLE) | ✅ रनटाइम, PNG फ़ॉलबैक | ⚠️ | ❓; रेपो में कोई ANM स्प्राइटशीट नहीं (Assets/Animations/ खाली) |
| ICN/CMP टाइल्स | ❌ (पूर्व-रूपांतरित) | — | TileManager BMP लोड करता है; Assets/Tilesets/ खाली |
सेव फ़ाइलें GAME1–6 (4096 B) | ✅ पार्सर SaveManager.cs | ❓ | ❌ राउंड-ट्रिप मूल सेव के विरुद्ध सत्यापित नहीं |
स्टोरी स्टेट (b0057, props) | ✅ (पढ़ता है) | ❓ अर्थ अनुमानित | ❓ खेल में सेमांटिक्स की पुष्टि नहीं हुई |
| कॉम्बैट (टू-हिट, डैमेज, AI, हीट, अमो, फॉग) | — (स्वयं का लॉजिक) | ❌ अनुमानित | ❌ RNG/फ़ॉर्मूले मूल के विरुद्ध कभी डिफ नहीं किए गए |
| व्यूपोर्ट / स्क्रीन लेआउट | — | ⚠️ अनुमानित | ❓ कोई कैनोनिकल व्यूपोर्ट स्ट्रक्चर नहीं मिला |
| ध्वनि / संगीत | ❌ | ❌ | ❌ फ़ॉर्मेट अनडिकोडेड |
| मैप→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 |
| अर्थव्यवस्था / दुकानें / स्टॉक | 🟡 UI फ़्लो अब लाइव देखा गया | docs/story/story-system.md |
| ANM फ़ॉर्मेट | 🟢 प्रलेखित | docs/formats/anm-format.md |
| व्यूपोर्ट एब्स्ट्रैक्शन | 🔴 अपूर्ण | docs/engine/viewport.md |
| ध्वनि | 🔴 0% | — |
ये वास्तविक अवरोधक हैं; §6 में रोडमैप इन पर निर्भर है।