DInput8 चेन लोडिंग मानक
More actions
Enshrouded के कई मॉड लोडर और DLL मॉड गेम की `dinput8.dll` बनना चाहते हैं, लेकिन इस नाम की केवल एक फ़ाइल हो सकती है। यह नाम रखने वाला लोडर गेम की EXE के पास `dinput8-chain.ini` में सूचीबद्ध दूसरी DLL शुरू करता है। EMF, Kiln, ShroudForge, XHL-Core और Auto Loot Plus इस फ़ाइल को पढ़ते हैं। यह पृष्ठ नियम दर्ज करता है ताकि हर लोडर फ़ाइल को एक ही तरह पढ़े और खिलाड़ी की सूची उस लोडर के साथ काम करे जो `dinput8.dll` रखता है।
यह पृष्ठ CC0 के अंतर्गत सार्वजनिक डोमेन में है। इसे अपने प्रोजेक्ट के दस्तावेज़ों में कॉपी और संशोधित किया जा सकता है, श्रेय देना आवश्यक नहीं है। कई लोडरों द्वारा सहमत बदलाव EMF के रिपॉज़िटरी में pull request के रूप में स्वागत योग्य हैं।
आगे दिए गए must और should शब्द इस विनिर्देश का पालन करने वाले लोडर के व्यवहार को बताते हैं।
फ़ाइल
; my mods [Chain] mods\mymod\mymod.dll autolootplus.dll [EMF] creative.dll
- स्थान: `dinput8-chain.ini` गेम की EXE (`enshrouded.exe` या `enshrouded_server.exe`) वाले फ़ोल्डर में।
- एन्कोडिंग: लोडर को BOM के साथ या बिना UTF-8 और BOM वाले UTF-16 LE को पढ़ना चाहिए। अमान्य UTF-8 बाइट होने पर सिस्टम का ANSI code page भी पढ़ना चाहिए। फ़ाइल लिखने वाला टूल मिली हुई एन्कोडिंग और line endings बनाए रखे।
- पंक्तियाँ: खाली पंक्तियाँ छोड़ दी जाती हैं। `;`, `#` या `//` से शुरू पंक्ति टिप्पणी है। DLL पंक्ति के आगे `; ` लगाने से वह बंद होती है। नाम के बाद space या tab के बाद टिप्पणी हो सकती है और नाम double quotes में लिखा जा सकता है।
- Sections: नाम case-insensitive हैं। `[Chain]` साझा सूची है। अन्य section किसी टूल का होता है, जैसे `[EMF]` या `[Kiln]`, और बाकी लोडर उसे अनदेखा करते हैं। किसी section से पहले की पंक्तियाँ `[Chain]` में आती हैं। पुराने फ़ाइलों में section नहीं भी हो सकते।
- `key=value`: value अगर `.dll` बताता है तो यह DLL entry है। दूसरी keys लिखने वाले टूल की settings हैं और अन्य लोडर उन्हें अनदेखा करते हैं।
DLL
- पथ EXE वाले फ़ोल्डर से relative होते हैं। `/` को `\` पढ़ा जाता है। Absolute paths, drive letters, UNC paths (`\\server\...`) और किसी भी `..` हिस्से को अस्वीकार करना चाहिए। Chain फ़ाइल गेम फ़ोल्डर से बाहर नहीं जा सकती।
- केवल `.dll` फ़ाइलें। दूसरी फ़ाइल बताने वाली पंक्ति छोड़ी जाती है और रिपोर्ट की जाती है।
- `dinput8.dll` को स्वयं कभी शुरू न करें और अपने लोडर की दूसरी copy शुरू न करें। EMF अपनी फ़ाइल को दूसरे नाम से भी पहचानता है और उस copy को नहीं चलाता।
- हर DLL केवल एक बार। `[Chain]` और टूल के अपने section में या एक section में दोहराई गई DLL अपने पहले स्थान पर ही शुरू होती है।
- क्रम: DLL पंक्तियों के ऊपर से नीचे तक शुरू होती हैं। `[Chain]` और लोडर का अपना section फ़ाइल में जिस क्रम में हैं उसी क्रम में लिया जाता है।
- समय: अपने `DllMain` से या तुरंत बाद, गेम कोड चलने से पहले `LoadLibrary` उपयोग करें। यही वह समय है जब chained DLL खुद `dinput8.dll` होती तो शुरू होती।
- अधिकतम 256 entries गिनी जाती हैं। बाकी रिपोर्ट होकर छोड़ दी जाती हैं।
- विफलता: गायब DLL या लोड न हो सकने वाली DLL छोड़कर रिपोर्ट की जाती है। इसमें Windows error 126 और `DllMain` विफल होने पर 1114 शामिल है। गेम चलता रहता है।
रिपोर्टिंग
लोडर को हर chained DLL के लिए एक पंक्ति log करनी चाहिए: शुरू हुई, बंद या अस्वीकृत होने या पहले से लोड होने के कारण छोड़ी गई, या Windows error number के साथ विफल हुई। EMF इन्हें `emf\chain_status.txt` में तालिका के रूप में भी लिखता है ताकि खिलाड़ी इसे साझा कर सकें।
किसी दूसरे टूल की dinput8.dll को स्थानांतरित करना
दूसरे टूल की `dinput8.dll` मिलने पर installer को उसका नाम बदलना चाहिए, उसे कभी मिटाना नहीं चाहिए, नया नाम अपने `dinput8-chain.ini` section में लिखना चाहिए और uninstall पर उसे वापस रखना चाहिए। EMF टूल पहचानने पर `<tool>.dll` नाम देता है। अन्यथा DLL की version जानकारी या `dinput8-previous.dll` उपयोग करता है और बदलाव `emf\moved.txt` में दर्ज करता है।
Exports
गेम `dinput8.dll` रखने वाले लोडर पर `DirectInput8Create` बुलाता है। लोडर को यह call Windows की अपनी `dinput8.dll` (`%SystemRoot%\System32\dinput8.dll`) तक भेजना चाहिए। Chained DLL को DirectInput calls नहीं मिलते। `DirectInput8Create` में काम करने वाले मॉड को वह काम `DllMain` या उसके शुरू किए thread में ले जाना चाहिए।
कौन इसका पालन करता है
| टूल | `[Chain]` पढ़ता है | अपना section |
|---|---|---|
| EMF | हाँ, section से पहले की पंक्तियाँ भी | `[EMF]`, installer द्वारा बदली DLL के लिए |
| ShroudForge | हाँ, हर entry `mods\<folder>\` में होनी चाहिए और बाकी report होते हैं | |
| Kiln | हाँ, पुराने EMF installer द्वारा बदली DLL के लिए `[EMF]` भी | नहीं, इसकी सूची `kiln\chain.ini` में है। Quotes और नाम के बाद टिप्पणी की सुविधा नियोजित है। |
| XHL-Core, Auto Loot Plus | हाँ |
अगर आपका टूल यह फ़ाइल पढ़ता है या अलग तरह से पढ़ता है तो बताएं, हम तालिका अपडेट करेंगे।
स्रोत
dinput8-chain.ini के लिए EMF की साझा विशिष्टता। मूल विनिर्देश CC0 के अंतर्गत सार्वजनिक डोमेन में है।