dconstruct

पूर्ण डिसअसेंबली और डीकंपाइलेशन एनिमेशन

dconstruct The Last of Us Part II में उपयोग किए जाने वाले DC-Script फ़ाइलों के लिए एक रिवर्स इंजीनियरिंग उपकरण है। इसमें एक डिसअसेंबलर और एक डीकंपाइलर शामिल है।

यह .asm फ़ाइलें आउटपुट करता है जिनमें डिसअसेंबल संरचनाएँ और बाइटकोड होते हैं, साथ ही .dcpl (DC स्यूडो भाषा) फ़ाइलें जिनमें C-जैसा स्यूडो कोड होता है।

आप कमांड लाइन के माध्यम से फ़ाइलों में संपादन भी कर सकते हैं, जिसमें बिना अधिक प्रयास के पूरी संरचनाओं को बदलना शामिल है। इससे .bin फ़ाइलों के अंदर कुछ मान बदलने वाले मॉड बनाना बेहद आसान हो जाता है।

मुख्य विशेषताएं

गति के लिए अनुकूलित। फ़ाइलों को डिसअसेंबल और डीकंपाइल करना बहुत तेज़ है।

[]= ``` - ``: जिस संरचना को आप संपादित करना चाहते हैं उसका मेमोरी पता (हेक्साडेसिमल में, `0x` से शुरू)। इसे आप जिस फ़ाइल को संपादित करना चाहते हैं उसके डिसअसेंबल किए गए संस्करण से कॉपी-पेस्ट करना सबसे आसान है। - ``: संरचना के अंदर सदस्य चर का इंडेक्स। उस संख्या के समतुल्य जो आप सदस्य के बाईं ओर देख सकते हैं। - ``: उस सदस्य को निर्दिष्ट करने का नया मान। समान आकार का होना चाहिए। (ints और floats का आकार 4 है, sids/structs का आकार 8 है)। प्रोग्राम यह जाँच नहीं करेगा कि संरचनाएँ एक ही प्रकार की हैं।

यह आपके इनपुट फ़ाइल के समान निर्देशिका में `my_bin_file.bin.asm` नामक एक फ़ाइल आउटपुट करेगा। फिर आप उस फ़ाइल को टेक्स्ट/कोड एडिटर का उपयोग करके खोल सकते हैं। मैं VSCode जैसे किसी एडिटर की सलाह दूंगा जो उन्नत खोज सुविधाएँ प्रदान करता है और बड़ी फ़ाइलों को संभालने में अच्छा है। मानक Windows नोटपैड की अनुशंसा नहीं की जाती है। किसी फ़ाइल को डीकंपाइल करने के लिए, कमांड चलाते समय `--decompile` फ़्लैग जोड़ें। # कमांड लाइन आर्गुमेंट्स - `-i` - इनपुट फ़ाइल या फ़ोल्डर। यदि इनपुट पथ को पहले आर्गुमेंट के रूप में पास किया जा रहा है तो इसे छोड़ा जा सकता है। - `-o` - आउटपुट पथ। यदि आपका इनपुट पथ एक फ़ोल्डर है, तो यह कोई फ़ाइल नहीं हो सकता। यदि कोई आउटपुट निर्दिष्ट नहीं है, तो .txt फ़ाइल इनपुट फ़ाइल के बगल में रखी जाएगी। यदि इनपुट एक फ़ोल्डर है और कोई आउटपुट निर्दिष्ट नहीं है, तो प्रोग्राम वर्तमान कार्यशील निर्देशिका में एक "output" निर्देशिका बनाएगा और सभी फ़ाइलों को वहाँ रखेगा। - सिडबेस को एक्सीक्यूटेबल के बगल में स्थित `sidbase.bin` से लोड किया जाता है। - `--no_decompile` - .dcpl फ़ाइल में डीकंपाइल्ड स्यूडो कोड को उत्सर्जित न करें। फ़ाइल .asm फ़ाइल के बगल में रखी जाएगी। डिफ़ॉल्ट रूप से यह false है। - `--no_optimize` - dcpl कोड को ऑप्टिमाइज़ और साफ़ न करें। इसमें फ़ंक्शन कॉल को इनलाइन करना, अप्रयुक्त चर हटाना, संगत for लूप को foreach लूप में बदलना, और कुछ if-else श्रृंखलाओं को match एक्सप्रेशन में बदलना शामिल है। - `--pascal_case` - dcpl आउटपुट में गेम के फ़ंक्शन नामों को पास्कल केस में बदलें, उदा. get-boolean -> GetBoolean। - `--graphs` - सभी डीकंपाइल किए गए फ़ंक्शनों के लिए कंट्रोल फ्लो ग्राफ़ वाली .svg फ़ाइलें उत्सर्जित करें। प्रत्येक .bin फ़ाइल के लिए उसके सभी ग्राफ़ वाला अपना फ़ोल्डर बनता है। यह डीकंपाइलेशन की गति को **काफी** धीमा कर देता है, इसलिए एक साथ बड़ी संख्या में फ़ाइलों को डीकंपाइल करते समय इसकी अनुशंसा नहीं की जाती है। - `--emit_once` - एक ही संरचना को डिसअसेंबली में दो बार उत्सर्जित होने से रोकता है। यदि कोई संरचना कई बार दिखाई देती है, तो केवल पहली बार ही पूरी तरह उत्सर्जित की जाएगी, और अन्य सभी अवसरों को `ALREADY_EMITTED` टैग से बदल दिया जाएगा। इससे फ़ाइल का आकार काफी कम हो सकता है। - `-e` - एक संपादन करें। नीचे दिए गए अनुभाग में अधिक जानकारी। - `--edit_file` - एक संपादन फ़ाइल प्रदान करें। एक संपादन फ़ाइल में प्रति पंक्ति एक संपादन होता है। यह `-e` फ़्लैग के समान सिंटैक्स का उपयोग करता है। # डिस्सेम्बलर क्या है? एक [डिस्सेम्बलर](https://en.wikipedia.org/wiki/Disassembler) एक उपकरण है जो बाइनरी निर्देशों (उर्फ [बाइटकोड](https://en.wikipedia.org/wiki/Bytecode) या [मशीन कोड](https://en.wikipedia.org/wiki/Machine_code)) को पढ़ता है और प्रत्येक को एक मानव-पठनीय संस्करण में अनुवादित करता है जिसे [मनेमोनिक](https://en.wikipedia.org/wiki/Assembly_language#Mnemonics) कहा जाता है। डिस्सेम्बलर आमतौर पर इन निर्देशों के अर्थ के बारे में अधिक व्याख्या करने का प्रयास नहीं करते हैं और केवल उन्हें 1-1 रूप में उनके पठनीय संस्करणों में बदल देते हैं। उदाहरण के लिए, निर्देश:```arm 15 00 00 00 4A 01 01 00 43 31 01 00 1C 00 00 01

बाइटकोड में सभी संख्याएँ [हेक्साडेसिमल](https://en.wikipedia.org/wiki/hexadecimal) में लिखी जाती हैं। प्रत्येक पंक्ति में पहला कॉलम `opcode` या निष्पादित किए जाने वाले निर्देश के प्रकार को दर्शाता है। अगला कॉलम गंतव्य रजिस्टर है, जहाँ संक्रिया का परिणाम संग्रहीत किया जाएगा। अंतिम दो कॉलम प्रचालक 1 और 2 हैं, जो या तो रजिस्टर हैं या शाब्दिक संख्याएँ हैं जिन पर संक्रिया की जाएगी। सभी निर्देश सभी 4 बाइट्स का उपयोग नहीं करते, उदाहरण के लिए, पहले `LookupPointer` निर्देश को केवल एक प्रचालक की आवश्यकता होती है। dconstruct डिसअसेंबलर कुछ अतिरिक्त जानकारी भी जोड़ता है जिसका उद्देश्य निर्देशों को पढ़ना थोड़ा आसान बनाना है। यह कोड में शाखाओं को ट्रेस करना आसान बनाने के लिए लेबल (जैसे `L_0`) भी सम्मिलित करता है।```arm 15 00 00 00 LookupPointer r0, 0 r0 = ST[0] -> <is-player-abby?> 4A 01 01 00 LoadStaticU64Imm r1, 1 r1 = ST[1] -> <player> 43 31 01 00 Move r49, r1 r49 = player 1C 00 00 01 CallFf r0, r0, 1 r0 = is-player-abby?(player) 2F 0D 00 00 BranchIfNot r0, 0xD IF NOT r0 => L_0

इससे, यह बताना लगभग असंभव है कि कोड क्या कर रहा है। ## Disassembled code with labels & symbol table```arm sqrt-sign = script-lambda [0x9A8D8] { [1 args] 0000 0x09A928 43 00 31 00 Move r0, r49 r0 = arg_0 0001 0x09A930 15 01 00 00 LookupPointer r1, 0 r1 = ST[0] -> <absf> 0002 0x09A938 43 02 00 00 Move r2, r0 r2 = arg_0 0003 0x09A940 43 31 02 00 Move r49, r2 r49 = arg_0 0004 0x09A948 1B 01 01 01 Call r1, r1, 1 r1 = absf(arg_0) 0005 0x09A950 43 02 00 00 Move r2, r0 r2 = arg_0 0006 0x09A958 40 03 01 00 LoadStaticFloatImm r3, 1 r3 = ST[1] -> <0.000000> 0007 0x09A960 24 02 02 03 FGreaterThanEqual r2, r2, r3 r2 = r2 >= r3 0008 0x09A968 2F 0B 02 00 BranchIfNot r2, 0xB IF NOT r2 => L_0 0009 0x09A970 40 02 02 00 LoadStaticFloatImm r2, 2 r2 = ST[2] -> <1.000000> 000A 0x09A978 2D 0C 00 00 Branch 0xC GOTO => L_1 L_0: 000B 0x09A980 40 02 03 00 LoadStaticFloatImm r2, 3 r2 = ST[3] -> <-1.000000> L_1: 000C 0x09A988 43 03 02 00 Move r3, r2 r3 = -1.000000 000D 0x09A990 15 04 04 00 LookupPointer r4, 4 r4 = ST[4] -> <sqrt> 000E 0x09A998 43 05 01 00 Move r5, r1 r5 = RET_absf 000F 0x09A9A0 43 31 05 00 Move r49, r5 r49 = RET_absf 0010 0x09A9A8 1C 04 04 01 CallFf r4, r4, 1 r4 = sqrt(RET_absf) 0011 0x09A9B0 07 03 03 04 FMul r3, r3, r4 -1.000000 = -1.000000 * RET_sqrt 0012 0x09A9B8 43 01 03 00 Move r1, r3 r1 = -1.000000 0013 0x09A9C0 00 01 01 00 Return r1 Return SYMBOL TABLE: 0000 0x09A9C8 function: absf 0001 0x09A9D0 float: 0.000000 0002 0x09A9D8 float: 1.000000 0003 0x09A9E0 float: -1.000000 0004 0x09A9E8 function: sqrt }

To replace the first member variable (index 0) with the float value 0.5, the edit command would be: `-e 0x11C28[0]=0.5` The structure we want to edit is at `0x11C28`, and we want the first member variable (the 0 to the left of the float). We then put the new value after the `=`, 0.5 in this case. If the edit was successfull, the program will show a message indicating that the value was changed from `0.7->0.5`. For an edit file, simply drop the `-e` and put one edit per line: ### edit_file.txt 0x11C28[0]=0.5 0x11C28[1]=0.2 ... ## Types of Member Variables Structures can have different types of member variables: - `float` - दशमलव बिंदु के साथ दशमलव मान निर्दिष्ट करें (जैसे, 0.5). - `int` - बिना दशमलव बिंदु के पूर्णांक मान निर्दिष्ट करें (जैसे, 42). - `sid` (स्ट्रिंग पहचानकर्ता) - (नीचे और जानकारी) - `string` - वर्तमान में प्रतिस्थापन के लिए समर्थित नहीं है - `structure` - पॉइंटर को प्रतिस्थापित करके (नीचे और जानकारी) ### Replacing sid by name lookup: `-e 0xABC[5]=ellie` This looks for the value "ellie" in the current sidbase. If it doesn't exist, a warning is issued and no edit is applied. If the value is found, the actual hash value (a large number) will replace the current value at the member variable. ### Replacing sid by direct manual hash override: `-e 0xABC[5]=#XXXXXXXXXXXXXXXX` The # indicates a raw hash value, which will be applied directly without a lookup. ### Replacing member structures If a structure contains another structure as a member, you can replace the entire member structure by assigning it the address of another structure. For example, suppose you have the following:```c++ [4] weapon-gameplay-def [0x0C523] { ... [7] firearm-gameplay-def [0x11C28] { ... } }

या CTRL+SHIFT+P के साथ कमांड पैलेट खोलें और "Install extension via VSIX" टाइप करें और .vsix फाइल चुनें। इसके बाद, आपका .dcpl कोड कुछ इस तरह दिखना चाहिए: ![dcpl_code](https://assets.kitploit.com/production/public/readmes/13048/8b4ab26ab7952a91a015d1376d3101bcad17c65602ed9c2b5c1587cb1d1a9f3c.png) # ज्ञात समस्याएँ डीकंपाइलर वर्तमान में 100% पूर्ण नहीं है और इसलिए एक "प्रायोगिक" स्थिति में है। यदि आपको डीकंपाइलेशन के दौरान चेतावनियाँ मिलती हैं, तो चिंता न करें क्योंकि ये फ़ंक्शन वर्तमान में समर्थित नहीं हैं, लेकिन उम्मीद है कि भविष्य में होंगे। इनके साथ, वर्तमान में और भी ज्ञात समस्याएँ हैं: - भारी शॉर्ट-सर्किटिंग वाले एकल-अभिव्यक्ति फ़ंक्शन (विशेष रूप से स्ट्रक्ट के अंदर वाले) अभी तक लागू नहीं किए गए हैं। मैंने इनके लिए एल्गोरिदम पर काम शुरू कर दिया है, लेकिन मुझे नहीं पता कि इसे पूरा होने में कितना समय लगेगा, हालाँकि यह प्राथमिकताओं की सूची में ऊपर है। - कुछ प्रकार गलत हैं, विशेष रूप से तर्क प्रकार। - if/else कथनों में खाली if ब्लॉक अजीब इंडेंटेशन का कारण बन सकते हैं। यह फिर से हमेशा मेरी गलती नहीं है, क्योंकि कुछ ऐसी शाखाएँ हैं जो वास्तव में कोई वास्तविक कार्य नहीं करती हैं, जिनका पता लगाना मुश्किल है। इनके साथ, कुछ ऐसी समस्याएँ हैं जो शायद ठीक नहीं होंगी: - जब यह ज्ञात नहीं होता कि कोई फ़ंक्शन void है या नहीं, तो कचरा वापस करना। - बहुत सारा अनावश्यक कोड। # नियोजित सुविधाएँ - एक पूर्ण Racket और Python आउटपुट प्रारूप। # विशेष धन्यवाद - **icemesh** – DC-फ़ाइलों के लिए अंतर्निहित [संरचनाएँ](https://github.com/icemesh/dc/tree/main/t2) और [उनके डिस्सेम्बलर](https://github.com/icemesh/t2-dc-disasm) प्रदान करने के लिए, जो काफी हद तक प्रेरणा के रूप में कार्य करते थे। - **Specilizer** – उनके DC-Tool के लिए, जो इस प्रोग्राम के लिए भी प्रेरणा थी। - **uxh** – स्क्रिप्टिंग ज्ञान के लिए। - **bigdragon** और **Wedge** बीटा परीक्षण के लिए। - संपूर्ण मॉडिंग Discord समुदाय – मित्रवत और सहायक होने के लिए। ## सहायता मेरे सभी उपकरण और मॉड हमेशा 100% मुफ्त रहेंगे, लेकिन इस तरह के कार्यक्रमों में बहुत मेहनत लगती है। यदि आप मेरा समर्थन करना चाहते हैं, तो आप मेरे Ko-fi पर जा सकते हैं: [![Ko-fi](https://img.shields.io/badge/Donate-Ko--fi-ff5f5f.svg)](https://ko-fi.com/deepquantum) ## लाइसेंस इस मॉड का उपयोग करके आप जो फ़ाइलें बनाते हैं, वे पूरी तरह से आपकी हैं और आप उनके साथ जो चाहें करने के लिए स्वतंत्र हैं। क्रेडिट की सराहना की जाएगी लेकिन कड़ाई से आवश्यक नहीं है। यह प्रोग्राम स्वयं [क्रिएटिव कॉमन्स एट्रिब्यूशन-नॉनकमर्शियल-नोडेरिवेटिव्स 4.0 इंटरनेशनल लाइसेंस](https://creativecommons.org/licenses/by-nc-nd/4.0/) के तहत लाइसेंस प्राप्त है। इसका मतलब है कि आप क्रेडिट देने पर दूसरों के साथ प्रोग्राम साझा कर सकते हैं, लेकिन वर्तमान में आप इसे संशोधित नहीं कर सकते और न ही इसका मुद्रीकरण कर सकते हैं।

dconstruct

सबसे लोकप्रिय

उपयोग कैसे करें

डीकंपाइलर क्या है?

उदाहरण

sqrt-sign() फ़ंक्शन

मूल बाइट्स```arm

नियंत्रण प्रवाह ग्राफ

अंतिम छद्म कोड```rust

बाद में```c

बाद में```c#

बाद में```scala

संपादन

संपादनों के लिए सिंटैक्स

उदाहरण

DCPL भाषा VS Code एक्सटेंशन