عن المشروع

Soulstruct هي مكتبة ومجموعة أدوات بلغة Python لفحص وتعديل ملفات البيانات من ألعاب FromSoftware، مع تركيز أساسي على Dark Souls. وهي موجهة للمعدّلين الذين يرغبون في الوصول البرمجي أو عبر واجهة رسومية إلى بيانات اللعبة بدلاً من التحرير الثنائي الخام. يُشار إلى الألعاب المدعومة باختصارات: DS1PTDE (Dark Souls: Prepare to Die Edition)، DS1R (Dark Souls Remastered)، DS2 (Dark Souls II)، BB (Bloodborne)، DS3 (Dark Souls III)، SEK (Sekiro: Shadows Die Twice) و ER (Elden Ring). يختلف الدعم حسب نوع البيانات، لذا لا تنطبق كل ميزة على كل عنوان. القدرات الرئيسية الموصوفة في ملف README: - تطبيق رسومي موحد لتعديل الخرائط والأحداث والمعاملات والنصوص والذكاء الاصطناعي ونصوص الحوار في Dark Souls (كلا الإصدارين) وBloodborne. يتم استيراد بيانات اللعبة كمشروع، وتحريرها في النافذة أو في Python، وتصديرها مرة أخرى إلى ملفات جاهزة للعبة. يتضمن تتبع كيانات الخرائط، والتنقل بين أنواع البيانات، وتمييز الصياغة لنصوص الأحداث والذكاء الاصطناعي. الألعاب المدعومة لسير عمل الواجهة الرسومية: DS1PTDE، DS1R، BB. - يمكن ترجمة نصوص الأحداث (EMEVD) وآلات الحالة EzState (ESD) من وإلى لغات صالحة قائمة على Python مع ميزات برمجة عالية المستوى. المدعومة: DS1PTDE، DS1R، DS2 (ESD فقط)، BB، DS3. - يمكن تحميل بيانات الخرائط (MSB)، ومعاملات اللعبة (GameParam)، ومعاملات الإضاءة (DrawParam)، وبيانات النصوص (FMG) إلى هياكل Python، وتحريرها وإعادة تجميعها. المدعومة: DS1PTDE، DS1R، BB (الخرائط ومعاملات اللعبة والنصوص فقط)، DS3 (الخرائط والنصوص فقط). - يمكن فك ترجمة نصوص الذكاء الاصطناعي وتحريرها وإعادة ترجمتها. المدعومة: DS1PTDE (بدون فك ترجمة)، DS1R. - يمكن فك ضغط أرشيفات BND وإعادة تجميعها، مع معالجة تلقائية لضغط DCX. المدعومة: جميع الألعاب المدرجة. يشير المشروع إلى مكتبات ذات صلة: soulstruct-havok لفئات Havok وأدوات تغطي تصادم الخرائط، وتصادم الشخصيات، والرسوم المتحركة، والدمى؛ وsoulstruct-vanilla لنصوص الأحداث الأصلية وملفات أخرى؛ وsoulstruct-gui لواجهة رسومية تغطي الخرائط والأحداث والمعاملات والإضاءة والنصوص والذكاء الاصطناعي ونصوص الحوار بالإضافة إلى أدوات وقت التشغيل؛ وFirelink، وهو إطار تعديل بلغة C++ يُشار إليه بأنه أسرع بكثير للفئات الأساسية مثل FLVERs وBinders، مع تطبيقات ربط بالذاكرة وفئة MSB لـ Elden Ring. يربط ملف README أيضًا بقناة YouTube تحتوي على دروس تعليمية وصفحة Patreon للدعم. لا تتضمن النصوص المقدمة ترخيصًا أو تعليمات تثبيت أو تفاصيل إصدار.