Previous: الإصدار السابق

الإنجليزية

يوفر morehead العديد من خيارات التكوين التي يمكن تعديلها في ملف تكوين bepinex (BepInEx/config/Mhz.REPOMoreHead.cfg):

إعدادات واجهة المستخدم

يسمح لك ضبط هذه القيم بإعادة تحديد موضع أزرار الرأس الأخرى إذا تعارضت مع عناصر mod ui الأخرى.

وضع القائمة السوداء

عند تمكين وضع القائمة السوداء:

• تحول + انقر على أزرار الديكور لإضافة/إزالة العناصر من القائمة السوداء
• الاستخدام التحول + مسح الكل لمسح القائمة السوداء بأكملها في وقت واحد
• ⚠ ️ جميع التغييرات في القائمة السوداء تدخل حيز التنفيذ بعد إعادة تشغيل اللعبة

لن تظهر الزخارف المدرجة في القائمة السوداء في قائمة الزخارف الخاصة بك، وهي مفيدة لإخفاء العناصر التي لا تريد استخدامها.

💡 يوصى بأن يقوم لاعب واحد بإدارة القائمة السوداء ومشاركتها عبر رمز التعديل أو BepInEx/config/MoreHeadBlacklist.json الملف لضمان مزامنة المظهر في متعدد اللاعبين.
💡 قبل المشاركة، تأكد من تعطيل وضع القائمة السوداء (مسح قيمة التكوين) لمنع التغييرات غير المقصودة من اللاعبين الآخرين.

قطع السجل

قم بتمكين هذا الخيار لرؤية سجلات أكثر تفصيلاً حول عملية تحميل النموذج، وهو مفيد لاستكشاف الأخطاء وإصلاحها.

مواقع الملفات

ملاحظة: [Unity.persistentDataPath] عادةً ما يقرر:

• النوافذ: ج: /Users/[YourName]/AppData/LocalLow/semiwork/Repo/
• لينكس: ~/.config/unity3d/semiwork/Repo/
• ماك: ~/مكتبة/دعم التطبيق/نصف العمل/إعادة الإعمار/

أوصاف الملف

• MoreHeadConfig.json: يخزن حالة تمكين/تعطيل كل ديكور (وضع الزي واحد-للتوافق الخلفي)
• MoreHeadOutfits.json: يخزن ما يصل إلى 5 تكوينات ديكور مختلفة يمكنك التبديل بين استخدام مفاتيح ui أو الوظيفة f1-f5
• Mhz.REPOMoreHead.cfg: يحتوي على إعدادات لمواقع زر UI، وتبديل وضع القائمة السوداء، وخيارات التسجيل
• MoreHeadBlacklist.json: يحتوي على قائمة بأسماء الديكور التي يجب إخفاؤها من قائمة ui (يتطلب تمكين وضع القائمة السوداء)
• ملفات الديكور. hhh: حزم الأصول التي تحتوي على نماذج ثلاثية الأبعاد للديكور ، يمكن وضعها في أي من الموقعين

اللغة الصينية

يوفر MoreHead العديد من خيارات التكوين التي يمكن تعديلها في ملف تكوين BepInEx (BepInEx/config/Mhz.REPOMoreHead.cfg）：

إعدادات واجهة المستخدم

يمكن أن يؤدي ضبط هذه القيم إلى إعادة وضع زر MoreHead لتجنب التعارض مع عناصر واجهة المستخدم للوحدات الأخرى.

وضع القائمة السوداء

بعد تمكين وضع القائمة السوداء:

• تحول + انقر زر مستحضرات التجميل لإضافة/إزالة عناصر القائمة السوداء
• استخدم التحول + مسح الكل يمكن مسح جميع إدخالات القائمة السوداء دفعة واحدة
• ⚠ ️ تحتاج جميع العمليات المتعلقة بالقائمة السوداء إلى إعادة تشغيل اللعبة قبل أن تصبح سارية المفعول

مستحضرات التجميل المدرجة في القائمة السوداء لن تظهر في قائمة الديكور الخاصة بك، وهو أمر مفيد لإخفاء العناصر التي لا تريد استخدامها.

💡 يوصى بأن يحتفظ لاعب واحد بالقائمة السوداء ، عن طريق مشاركة رمز الوحدة أو إرسالها مباشرة BepInEx/config/MoreHeadBlacklist.json ملفات لضمان مزامنة المظهر أثناء الألعاب متعددة اللاعبين.
💡 يرجى التأكد من إيقاف تشغيل وضع القائمة السوداء (مسح سلسلة عنصر التكوين) قبل المشاركة لتجنب عدم مزامنة البيانات بسبب لمسها عن طريق الخطأ من قبل اللاعبين الآخرين.

التسجيل

قم بتمكين هذا الخيار لعرض سجل أكثر تفصيلاً لعملية تحميل النموذج ، مما يساعد في استكشاف الأخطاء وإصلاحها.

موقع الملف

ملاحظة: [Unity.persistentDataPath] عادة ما يتوافق مع:

• النوافذ: C:/Users/[اسم المستخدم الخاص بك]/AppData/LocalLow/semiwork/Repo/
• لينكس: ~/.config/unity3d/semiwork/Repo/
• ماك: ~/مكتبة/دعم التطبيق/نصف العمل/إعادة الإعمار/

وصف الوثائق

• MoreHeadConfig.json: تخزين حالة تمكين/تعطيل لكل ديكور (وضع تجهيز واحد-للتوافق الخلفي)
• MoreHeadOutfits.json: تخزين ما يصل إلى 5 تكوينات ديكور مختلفة ، والتي يمكن تبديلها من خلال واجهة المستخدم أو مفاتيح الوظيفة F1-F5
• Mhz.REPOMoreHead.cfg: يحتوي على إعدادات لموضع زر واجهة المستخدم ومفتاح وضع القائمة السوداء وخيارات السجل
• MoreHeadBlacklist.json: يحتوي على قائمة بأسماء الديكور التي يجب إخفاؤها في قائمة واجهة المستخدم (يتطلب تمكين وضع القائمة السوداء)
• ملف decor.hhh: حزمة أصول تحتوي على نموذج ثلاثي الأبعاد مزخرف ، يمكن وضعها في أي مكان

برنامج تعليمي باللغة الإنجليزية

1. إقامة وحدة (2022.3 * موصى به ، اللعبة تستخدم خط أنابيب العرض المدمج ، يرجى الانتباه إلى مواد النموذج المقابلة) ، الاستيراد MoreHead-Asset-Pack_v1.3.unitypackage.

   📥 تحميل حزمة الوحدة

2. استيراد نموذجك و سحب الصورة الرمزية للاعب الجاهزة في المشهد.

   تأكد من أن نموذجك متوافق مع الوحدة ومزورًا بشكل صحيح إذا كان متحركًا.

3. ابحث عن الأجزاء التالية في الصورة الرمزية للاعبحيث سيتم وضع النماذج:

   الاسم	وصف	علامة
   زخرفة الرأس (لا تتحرك)	جزء الرأس الذي يرفع عند التحدث	رأس
   زخرفة الرقبة (لا تتحرك)	منطقة الذقن/الصدر	الرقبة
   ديكور الجسم (لا تتحرك)	جسم	جسم
   زخرفة الورك (لا تتحرك)	منطقة الورك/الجزء السفلي من الجسم	الورك
   زخرفة ذراع l (لا تتحرك)	الذراع اليسرى	الذراع اليسرى
   R-الذراع الديكور (لا تتحرك)	الذراع اليمنى	اليمين
   زخرفة l-الساق (لا تتحرك)	الساق اليسرى	الساق اليسرى
   R-الساق الديكور (لا تتحرك)	الساق اليمنى	الساق اليمنى
   زخرفة العالم (لا تتحرك)	يتبع موضع الحرف ولكن يحافظ على الاتجاه الأفقي

   ⚠ ️ هذه المناصب هي مراجع مرساة. لا تعدل الإحداثيات، وإلا سيتم عدم محاذاة نموذجك داخل اللعبة.
   💡 هذا العالم العلامة مفيدة للزينة التي يجب أن تحافظ على اتجاهها الأفقي بغض النظر عن حركة الشخصية.
   💡 يمكن عرض العلامات المتعلقة بالأطراف (اليسرى، اليمنى، الساق اليسرى، الساق اليمنى) معًا داخل اللعبة تحت العلامة الرئيسية "الأطراف".

4. إنشاء كائن فارغ تحت الجزء الهدف (يشار إليه باسم أ) وتسميته.

   سيتم عرض هذا الاسم داخل اللعبة كاسم الديكور الخاص بك.

5. ضع نموذجك داخل a وضبطه إلى موضع مناسب.

6. اسحب أ إلى المشروع نافذة لإنشاء جاهزة.

   ⚠ ️ ملاحظة: يرجى تجنب إضافة مكونات المصادم إلى نماذج الديكور لأنها قد تؤثر على فيزياء الشخصيات، مما يتسبب في مشكلات الدوران أو الحركات غير المستقرة. لتفاعلات التصادم، فكر في تقنيات بديلة.

7. تشغيل أدوات → رأس الديكورات بناةاسحب جاهزًا (أو أكثر، يتم دعم تصدير الدفعات) إلى لوحة البرنامج النصي، وحدد الجزء المقابل من الخطوة 3، ثم انقر إضافة نموذج إلى القائمة.

   تأكد من تحديد جزء الجسم الصحيح (الرأس/الرقبة/الجسم/الورك، وما إلى ذلك) الذي يطابق المكان الذي وضعت فيه الديكور الخاص بك.

8. انقر بناء جميع حزمة الأصولثم حدد موقع [اسم الديكور الخاص بك].hhh ملف في حزم الأصول المجلد.

   فقط . ححح ملف مطلوب للتثبيت. يمكن تجاهل الملفات الأخرى التي تم إنشاؤها.

9. تحريك ملف إلى BepInEx\plugins (ستقوم اللعبة بتحميل جميع ملفات. hhh في مجلد المكونات الإضافية. إذا لم تكن متأكدًا من مكان وضعها ، فيمكنك وضعها فيه \ MoreHead\ الديكورات من أجل تنظيم أفضل).

   ⚠ ️ للرؤية متعددة اللاعبين: يجب أن يكون لديك أنت وأصدقائك نفس الشيء تم تثبيت الملف لرؤية الديكورات الصحيحة.
   ⚠ ️ لا تعبئة MoreHead.dll الملف في التعديل الخاص بك، فقط . ححح الملف وهذا التعديل مطلوبة للاستمتاع بالزخارف.

10. ابدأ اللعبة واستمتع!

    اضغط على esc داخل اللعبة وابحث عن "MoreHead" في أسفل اليسار للوصول إلى الديكور الجديد الخاص بك.

دروس صينية

1. نشر Unity(الإصدار الموصى به 2022.3*، تستخدم اللعبة خط أنابيب العرض المدمج، يرجى الانتباه إلى مادة النموذج المقابلة)، الاستيراد MoreHead-Asset-Pack_v1.3.unitypackage。

   📥 تحميل unitypage

2. استيراد النموذج ووضع سحب الجسم الجاهز إلى المشهد。

   تأكد من أن نموذجك متوافق مع Unity إذا كانت هناك رسوم متحركة تحتاج إلى ربط العظام بشكل صحيح.

3. العثور الصورة الرمزية للاعب تتوافق الأجزاء التالية في الموضع الذي سيتم فيه وضع النموذج：

   الاسم	الوصف	التسميات
   زخرفة الرأس (لا تتحرك)	رفع الرأس عند التحدث	رأس
   زخرفة الرقبة (لا تتحرك)	الذقن/الصدر	الرقبة
   ديكور الجسم (لا تتحرك)	الجسم	جسم
   زخرفة الورك (لا تتحرك)	الوركين/الجسم السفلي	الورك
   زخرفة ذراع l (لا تتحرك)	الذراع اليسرى	الذراع اليسرى
   R-الذراع الديكور (لا تتحرك)	الذراع اليمنى	اليمين
   زخرفة l-الساق (لا تتحرك)	الساق اليسرى	الساق اليسرى
   R-الساق الديكور (لا تتحرك)	الساق اليمنى	الساق اليمنى
   زخرفة العالم (لا تتحرك)	اتبع موضع الشخصية للتحرك ولكن الحفاظ على الاتجاه الأفقي

   ⚠ ️ هذه المواقع هي مراجع مرساة الإحداثيات. لا تعديل الإحداثيات ، وإلا فإن نموذجك سيكون في غير محاذاة أثناء اللعبة.
   💡 العالم العلامات مناسبة للزخارف التي تحتاج إلى الحفاظ على اتجاهها الأفقي ، بغض النظر عن كيفية تحرك الشخصية.
   💡 يمكن عرض العلامات المتعلقة بالأطراف (leftarm، rightarm، leftleg، rightleg) بشكل موحد في اللعبة من خلال العلامة الرئيسية "LIMBS".

4. قم بإنشاء كائن فارغ (يسمى A) أسفل الموقع الهدف وقم بتسميته。

   سيظهر هذا الاسم كاسم الزخرفة الخاص بك في اللعبة.

5. ضع النموذج في A وضبطه إلى الموضع المناسب。

6. اسحب A إلىالمشروعنافذة ، إنشاء جسم مسبق。

   ⚠ ️ نصيحة: لا تضيف مكونات جسم الاصطدام إلى نموذج الزخرفة. قد يؤثر الاصطدام على السلوك المادي للشخصية ، مما يؤدي إلى دوران غير طبيعي أو حركة غير مستقرة. لتفاعل الاصطدام ، فكر في استخدام تقنيات أخرى.

7. تشغيلالأدوات → رأس الديكورات بناة، اسحب الجسم المسبق (أو أكثر، يتم دعم تصدير الدُفعة)، وحدد الجزء المقابل في الخطوة 3، ثمإضافة نموذج إلى القائمة。

   تأكد من اختيار أجزاء الجسم الصحيحة (الرأس/الرقبة/الجسم/الوركين، إلخ) التي تتطابق مع المكان الذي تضع فيه الزخرفة.

8. انقربناء جميع حزمة الأصول، ثم فيحزم الأصولتم العثور عليها في المجلد[اسم الزخرفة الخاصة بك].hhhالوثائق.

   تحتاج فقط عند التثبيتالملفات، يمكن تجاهل الملفات الأخرى التي تم إنشاؤها.

9. 将نقل الملف إلىBepInEx\plugins(سيؤدي بدء تشغيل اللعبة إلى تحميل جميع ملفات. hhh ضمن الإضافات. إذا كنت لا تعرف أين تضعها، فيمكنك وضعها\ MoreHead\ الديكوراتسهلة الإدارة).

   ⚠ ️ رؤية متعددة اللاعبين: يجب عليك أنت وأصدقائك تثبيت نفس. حححالملفات لرؤية الزخرفة الصحيحة لبعضها البعض.
   ⚠ ️ لا تعبئهMoreHead.dllالملفات إلى مود الخاص بك، فقط. حححيمكنك اللعب بالملحقات باستخدام الملفات وهذا التعديل.

10. بدء اللعبة والتمتع بالديكور!

    اضغط على ESC في اللعبة وابحث عن "MoreHead" في الزاوية اليسرى السفلية للوصول إلى ديكورك الجديد.

الوثائق الإنجليزية

بدءًا من الإصدار 1.2.4، يوفر morehead apis عامة للتمديد. تسمح هذه الواجهات للمطورين بتحميل موارد حزمة الأصول برمجيًا، وحقن البرامج النصية المخصصة، وتعزيز وظائف الديكور.

أبيس العام

تتوفر الواجهات العامة التالية في مدير ديكور الرأس الفئة:

أساليب التكامل

هناك طريقتان رئيسيتان للاستفادة من واجهة برمجة تطبيقات morehead للحصول على وظيفة موسعة:

1. تضمين حزم الأصول كموارد

يمكنك تضمين حزمة الأصول الخاصة بك () الملفات مباشرة في dll الخاص بك كموارد مضمنة:

1. إنشاء حزم الأصول وفقًا للإجراءات القياسية الموضحة في قسم "كيفية إضافة النماذج"
2. في الاستوديو البصري (أو ide المفضل لديك):
   • أضف الملفات إلى مشروعك
   • قم بتعيين "إجراء البناء" الخاص بهم إلى "مورد مضمن"
3. في رمز تهيئة المكون الإضافي الخاص بك:

   //قم بتحميل جميع موارد. hhh المدمجة من تجميع التجميع الخاص بك Assembly=Assembly.GetExecutingAssembly (); Morehead.headdecorationmanager.loadeexternalassetbundlesfromassembly(assembly)؛ MoreHead.HeadDecorationManager.RecreateUI ();
   

ملاحظة: تضمين الموارد في dll الخاص بك ليس إلزاميًا. يمكنك أيضًا استخدام الطرق القياسية لـ morehead لتحميل المحلي . ححح الملفات واستخدم ببساطة dll الخاص بك لحقن البرنامج النصي وتنفيذ الوظيفة.

2. حقن البرنامج النصي البرمجي

يمكنك كتابة البرامج النصية التي تصل إلى الديكورات وتعديلها ، بغض النظر عما إذا كانت قد تم تحميلها من dll أو مصادر أخرى:

1. استخدم واجهة برمجة التطبيقات المقدمة للوصول إلى أجهزة الديكور الجاهزة
2. إضافة مكونات/برامج نصية مخصصة لتعزيز الوظائف
3. تنفيذ منطقك الخاص لسلوك الديكور

مثال التنفيذ

باستخدام بيبينيكس؛ باستخدام bepinex.logg؛ باستخدام system.reflection؛ استخدام محرك الوحدة؛ استخدام system.collections.generic؛ مساحة الاسم mycustomdecorations {[BepInPlugin("com.yourname.customdecorations","custome decorations mod","1.0.0 ")] [bepindependenty("Mhz.REPOMoreHead",bepindependenty.dependencyflags.harddependency)] class public customdecorationsplugin: BaseUnityPlugin {public static CustomDecorationsPlugin Instance {get; private set;} private manuallogsource_Logger; private const string TARGET_MODEL_NAME="Cigar";// اسم النموذج الهدف void private awake () {Instance = this;_Logger=Logger; _logger.LogInfo("تم تحميل تعديل الديكورات المخصصة")؛ //قم بتحميل الديكورات وقم بإعداد معالجات loaddecorations (); } private void LoadDecorations () {try {//Get current assembly assembly assembly = assembly.GetExecutingAssembly ();//تحميل جميع موارد. hhh من dll الحالي morehead.headdecorationmanager.loadexternalassetbundlesfromassembly (assembly);//إعادة إنشاء ui لعرض النماذج المحملة حديثًا morehead.headdecorationmanager.recreateui ();//العثور على نماذج محددة مطابقة لقائمة الاسم المستهدف<MoreHead.DecorationInfo>targetDecorations = MoreHead.HeadDecorationManager.FindDecorationsByPartialName(assembly، TARGET_MODEL_NAME)؛ if (targetDecorations.Count > 0) {_logger.LogInfo($"Found {targetDecorations.Count} النماذج المطابقة لـ '{TARGET_MODEL_NAME}' ");//إضافة مكون إلى كل نموذج هدف تم العثور عليه foreach(var decoration in targetDecorations) {if (decoration.Prefab! = null<SpaceKeyHandler>() == فارغ) {_logger.LogInfo($"إضافة spacekeyhandler إلى {decoration.DisplayName} "); decoration.Prefab.AddComponent<SpaceKeyHandler>(); }}}} catch(System.Exception ex) {_logger.LogError($ "decorations معالجة الخطأ: {ex.Message}");}} //class للتعامل مع سلوك الديكور الفئة العامة spacekeyhandler: MonoBehaviour {private void Awake () {//log عندما يتم تهيئة مثيل المكون. _logger.loginfo($ "spacekeyhandler تهيئة على {gameObject.name}");} private void Update () {//تحقق من مفتاح المسافة اضغط مباشرة في المكون إذا (Input.GetKeyDown(KeyCode.Space)) {// ببساطة تسجيل الرسالة عند تشغيل المثيل. _logger.loginfo($ "مفتاح المسافة الضغط عند الديكور: {gameObject.name}");}}}}}

⚠ ️ ملاحظات مهمة

لا تحتاج بالضرورة إلى إرفاق البرامج النصية بالنموذج المقابل-قم بتنفيذها حسب الحاجة للحصول على وظيفة مناسبة. على سبيل المثال، يستجيب نموذج الرمز أعلاه فقط للضغط على مفتاح المسافة عند عرض الحرف في القائمة.

لماذا يحدث هذا؟

لأنه في طريقة عرض الشخص الأول، تقوم اللعبة بتعيين الشخصية المحلية [الحفر] كائن اللعبة إلى غير نشط (SetActive (خاطئ)).

• هو الكائن الأصل الذي يحتوي على نموذج الحرف، و يتم أيضًا تركيب المزيد من الزخارف تحت هذا التسلسل الهرمي.
• متى تم تعطيله، وفقًا لميكانيكا الوحدة، جميع مكونات الكائنات الفرعية لن يكون لديهم تحديث, تصحيح تحديث وغيرها من أساليب دورة الحياة يسمى.
• كما يتم وضع نماذج الديكور المخصصة تحت [الحفر] التسلسل الهرمي ، لذلك عند إرفاق البرامج النصية مباشرة بالنموذج ، بمجرد إدخال طريقة عرض الشخص الأول ، ستكون هذه البرامج النصية لا يمكن تنفيذها بشكل طبيعي لأن الكائن الأصل معطل.
• ومع ذلك، في اللعبة واجهة القائمةنموذج الشخصية يبقى دائما نشطلذا يمكن أن تعمل البرامج النصية المرفقة بالزينة بشكل طبيعي، حيث تقوم الوحدة بتنفيذ أساليب المكونات فقط على كائنات اللعبة النشطة.

هذا الفرق في حالات التنشيط هي النقطة الرئيسية التي تفسر سبب تصرف نفس البرنامج النصي بشكل مختلف في سيناريوهات مختلفة.

ملاحظات مهمة حول مزامنة متعدد اللاعبين

على الرغم من وجهة نظر الشخص الأول لا يمكنك رؤية نموذج الديكور الخاص بك (لأن [الحفر] المحلي معطل)، لا تزال اللعبة مزامنة حالتك عبر الشبكةهذا يعني أنه طالما أنك التعامل بشكل صحيح مع منطق المزامنة متعدد اللاعبينلا يزال بإمكان اللاعبين الآخرين رؤية التغييرات والإجراءات الخاصة بنموذج الديكور الخاص بك.

لذلك، حتى لو لم يتم تنفيذ البرامج النصية المحلية بسبب تعطيل [الحفر]، فلا يزال بإمكانك تنفيذ التأثيرات التفاعلية من خلال المديرين العالميين أو آليات مزامنة الشبكة، السماح جميع اللاعبين لرؤيتهم تغييرات على نموذج الديكور الخاص بك. وهذا يخلق إمكانيات ل الديكورات التفاعلية.

النقاط التي يجب مراعاتها عند تنفيذ منطق سلوك النموذج:

1. استراتيجية تركيب البرنامج النصي -النظر في استخدام المديرين العالميين أو أنظمة الأحداث كبدائل
2. الاختلافات بين شخصية المشهد وشخصية القائمة -قد تعمل بعض البرامج النصية فقط في سياقات محددة
3. مشاكل المزامنة متعددة اللاعبين -ضمان سلوك متسق عبر عملاء الشبكة
4. حالة تنشيط المكون -لن تقوم المكونات الموجودة على كائنات اللعبة المعطلة بتنفيذ طرق التحديث/fixedupdate
5. إدارة الموارد -تهيئة الموارد وتنظيفها بشكل صحيح لتجنب تسربات الذاكرة
6. سلطة الشبكة -النظر في العمليات التي يجب تنفيذها محليا والتي تحتاج إلى مزامنة الشبكة
   
   

الوثائق الصينية

بدءًا من الإصدار 1.2.4 ، يوفر MoreHead واجهة API العامة لتوسيع الوظائف. تسمح هذه الواجهات للمطورين بتحميل موارد AssetBundle برمجيًا ، وحقن البرامج النصية المخصصة ، وتحسين وظائف الزخرفة.

الكشف عن واجهة API

وفيما يليمدير ديكور الرأسالواجهات العامة المتاحة في الفئة:

نهج متكامل

هناك طريقتان رئيسيتان لاستخدام واجهة برمجة تطبيقات MoreHead لتوسيع الوظائف:

1. تضمين AssetBundle كمورد

يمكنك وضع AssetBundle (. ححح) يتم تضمين الملفات مباشرة في DLL كمورد مضمن:

1. قم بإنشاء AssetBundle باتباع العملية القياسية في قسم "كيفية إضافة نموذج"
2. في Visual Studio (أو IDE من اختيارك):
   • 将أضف ملفات إلى مشروعك
   • قم بتعيين "عمليات البناء" الخاصة بهم إلى "الموارد المضمنة"
3. في رمز تهيئة البرنامج الإضافي الخاص بك:

   //قم بتحميل جميع موارد. hhh المضمنة من التجميع الخاص بك Assembly assembly = Assembly.GetExecutingAssembly (); Morehead.headdecorationmanager.loadeexternalassetbundlesfromassembly(assembly)؛ MoreHead.HeadDecorationManager.RecreateUI ();
   

ملاحظة: تضمين الموارد في DLL ليس ضروريًا. يمكنك أيضًا تحميل محلي باستخدام طريقة MoreHead القياسية. حححالملفات ، استخدم فقط DLL لحقن البرامج النصية وتنفيذ الوظائف.

2. حقن البرنامج النصي البرنامجي

يمكنك كتابة البرامج النصية للوصول إلى الزخارف وتعديلها ، سواء تم تحميلها من ملف DLL الخاص بك أو مصدر آخر:

1. استخدم واجهة برمجة التطبيقات المتوفرة للوصول إلى الجهاز المسبق للزينة
2. أضف مكونات/نصوص مخصصة لتحسين الوظائف
3. تنفيذ منطق سلوك الزخرفة الخاص بك

أمثلة على التنفيذ

باستخدام بيبينيكس؛ باستخدام bepinex.logg؛ باستخدام system.reflection؛ استخدام محرك الوحدة؛ استخدام system.collections.generic؛ مساحة الاسم mycustomdecorations {[BepInPlugin("com.yourname.customdecorations","自定义装البح","1.0.0 ") ] [bepindependenty("Mhz.REPOMoreHead",bepindependenty.dependentyflags.harddependenty)]class public customdecorationsplugin: BaseUnityPlugin {public static CustomDecorationsPlugin Instance {get; private set;} private manuallogsource_logger; private const string TARGET_MODEL_NAME = "Cigar雪<s>]; //اسم النموذج المستهدف private void Awake () {Instance = this;_Logger = Logger;_logger.LogInfo("تم تحميل MOD الديكور المخصص");// تحميل الزخرفة وإعداد البرنامج النصي للمعالجة LoadDecorations();} private void LoadDecorations () {try {//الحصول على التجميع الحالي assembly assembly = assembly.GetExecutingAssembly ();//تحميل جميع موارد. hhh في DLL الحالي MoreHead.HeadDecorationManager.LoadExternalAssetBundlesFromAssembly(assembly)؛ //إعادة بناء واجهة المستخدم لعرض النموذج المحمل حديثًا MoreHead.HeadDecorationManager.RecreateUI (); //ابحث عن قائمة نماذج معينة تطابق اسم الهدف<MoreHead.DecorationInfo>targetDecorations = MoreHead.HeadDecorationManager.FindDecorationsByPartialName(assembly، TARGET_MODEL_NAME)؛ if (targetDecorations.Count > 0) {_logger.LogInfo($ "{targetDecorations.Count}" {TARGET_MODEL_NAME} ");//foreach (var decoration in targetDecorations) {if (decoration.Prefab! = null & decoration.Prefab.GetComponent<SpaceKeyHandler>() == فارغ) {_logger.LogInfo($"{decoration.DisplayName} 添加 SpaceKeyHandler "); decoration.Prefab.AddComponent<SpaceKeyHandler>(); }}}} catch(System.Exception ex){_logger.LogError($"خطأ أثناء معالجة الزخرف:{ex.Message}");}}//الفئة المستخدمة لمعالجة سلوك الزخرفpublic class SpaceKeyHandler: MonoBehaviour {// تسجيل سجل عند تهيئة المكون Instance._logger.LogInfo ($"SpaceKeyHandler تهيئة على {gameObject.name});}}}} {// اكتشاف شريط المسافة مباشرة في المكون if(Input.GetKeyDown(KeyCode.Space)) {// ببساطة تسجيل الرسالة عند التشغيل Instance._logger.LogInfo ($"شريط المسافة على الزخرف:{gameObject.name}");}}

⚠ ️ ملاحظات مهمة

ليس من الضروري ربط البرنامج النصي بالنموذج المقابل ، ويمكن معالجته حسب الطلب لتحسين الوظيفة. على سبيل المثال ، يمكن استخدام نموذج التعليمات البرمجية أعلاه فقطعند عرض الشخصية في القائمةإخراج سجل الاستجابة للمسافات.

لماذا يحدث هذا؟

لأن اللعبة فيمنظور الشخص الأولسيتم تحويل الأدوار المحلية إلىتم تعيين كائن اللعبة علىحالة غير نشطة（SetActive (خاطئ)）。

• [الحفر]هو الكائن الأصل الذي يحتوي على نموذج الدور ،يتم أيضًا تثبيت النماذج الزخرفية لـ MoreHead تحت هذا المستوى。
• 当عند تعطيله، وفقًا لآلية عمل Unity،مكونات جميع الكائنات الفرعية的تحديث、تصحيح تحديثنهج دورة حياة متساويةلن يتم استدعاؤه。
• يتم أيضًا وضع نماذج الديكور المخصصة في[الحفر]تحت المستوى الهرمي ، لذلك عند تثبيت البرامج النصية مباشرة على النموذج ، بمجرد دخولك وجهة نظر الشخص الأول ، ستكون هذه البرامج النصية لأن الكائن الأصل معطللا يمكن تنفيذه بشكل صحيح。
• وفي اللعبةواجهة القائمةفي ، يتم الحفاظ على نموذج الدور دائمًاحالة التنشيط، يمكن للبرنامج النصي المثبت على الزخرفة أن يعمل بشكل صحيح في هذه المرحلة، لأن Unity سيقوم فقط بتنفيذ أساليب المكونات على كائن لعبة الحالة النشطة.

هذا النوعالاختلافات في حالة التنشيطهي النقطة الرئيسية التي تشرح سبب أداء نفس البرنامج النصي بشكل غير متسق في سيناريوهات مختلفة.

ملاحظات مهمة حول مزامنة متعددة اللاعبين

على الرغم من أنه من منظور الشخص الأوللا تشوف نموذج الديكور الخاص بك(لأنه تم تعطيل [RIG] المحلي)، لكن اللعبة ستظل فيمزامنة حالتك في الشبكة。 يعني طالما أنتالتعامل بشكل صحيح مع منطق التزامن متعدد اللاعبين، لا يزال اللاعبين الآخرين قادرين على رؤية التغييرات والحركات في نموذج الديكور الخاص بك.

لذلك ، حتى لو لم يتم تنفيذ البرنامج النصي المحلي بسبب تعطيل [RIG] ، فلا يزال بإمكانك القيام بذلك عبرالمدير العالمي أو آلية مزامنة الشبكةلتحقيق التأثير التفاعلي والسماحيمكن لجميع اللاعبين رؤيتهاالتغييرات التي تحدث في نموذج الديكور الخاص بك. وهذا يخلقديكور تفاعلييوفر إمكانيات.

تحتاج إلى الانتباه إلى النقاط التالية عند تنفيذ منطق سلوك النموذج:

1. سياسة تثبيت البرنامج النصي -فكر في استخدام طرق بديلة مثل المدير العالمي أو نظام الأحداث
2. الفرق بين أدوار المشهد وأدوار القائمة -قد تعمل بعض البرامج النصية فقط في سياق معين
3. مشكلة مزامنة متعددة اللاعبين -ضمان سلوك متسق عبر عملاء الشبكة
4. حالة تنشيط المكون -المكونات الموجودة على كائنات اللعبة المعطلة لا تنفذ طريقة Update/FixedUpdate
5. إدارة الموارد -تهيئة وتنظيف الموارد بشكل صحيح لتجنب تسرب الذاكرة
6. أذونات الشبكة -النظر في العمليات التي يجب القيام بها محليا وما يتطلب مزامنة الشبكة