الصفحة الرئيسية>المتعلقة بالبرمجة>شفرة المصدر الأخرى
تنزيل

قائد تعديل الصناعة

مرحبًا بك في مورد التعديل الرسمي لقائد لعبة الصناعة.

حالة دعم التعديل

COI متاح حاليًا على Steam وهو في مرحلة الوصول المبكر. في حين أن التعديل ممكن ، إلا أنه لم يتم دعمه رسميًا بعد. نحن نعمل باستمرار على تحسين دعم التعديل والوثائق.

الأسئلة والقضايا

لاحظ أن دعم وزارة الدفاع تجريبي وقد يكون واجهات برمجة التطبيقات قد يكون له تغييرات في كسر. إذا كنت تواجه مشكلات ، فعليك دائمًا فحص السجلات في %APPDATA%/Captain of Industry/Logs ، فهي تحتوي على الكثير من المعلومات المفيدة. إذا كنت ترغب في مناقشة موضوعات التعديل مع المجتمع و Devs ، تفضل بزيارة Discord Channel #Modding-Dev-General (ستحتاج إلى تعيين دور Mod creation في قناة #pick-your-roles-here ). يمكنك أيضًا تقديم مشكلات هنا على Github ، ولكن قد يتأخر وقت الاستجابة من فريقنا.

المتطلبات الأساسية

من أجل بدء تعديل COI ، ستحتاج إلى:

  1. كابتن الصناعة على Steam وتثبيت اللعبة.
  2. لديك .NET Framework 4.7.1 مثبت.
  3. (اختياري) لديك Unity 2022.3.5f1 مثبت (مطلوب فقط لإنشاء الأصول).

ابدء

  1. حدد موقع ملفات لعبة COI عبر انقر بزر الماوس الأيمن على عنوان اللعبة في عميل Steam -> Properties... -> Local Files -> Browse .
  2. انسخ مسار جذر اللعبة إلى الحافظة الخاصة بك (على سبيل المثال C:/Steam/steamapps/common/Captain of Industry ).
  3. قم بإنشاء متغير بيئي جديد يسمى COI_ROOT وضبط قيمته على مسار جذر اللعبة المنصوص عليه أعلاه. على Windows ، استخدم أداة Edit environmental variables ، فقط افتح قائمة START واكتب Edit env ويجب رؤيتها.
  4. شوكة/تنزيل هذا الريبو.
  5. قم بترجمة ExampleMod في تكوين Release الموجود في src/ExampleMod/ExampleMod.sln . نوصي باستخدام Visual Studio ولكن لا تتردد في استخدام أي أدوات أخرى ، مثل أمر dotnet build Console. في Visual Studio ، يجب أن ترى جميع التجميعات التابعة مرتبطة بشكل صحيح. إذا لم يكن الأمر كذلك ، وكنت ترى الكثير من الأخطاء ، تحقق من متغير COI_ROOT البيئي ، حاول إعادة التشغيل.
  6. حدد موقع ExampleMod.dll في /bin/Release/net471 .
  7. ابحث عن مجلد ملفات بيانات COI (حيث يتم حفظ أو لقطات الشاشة). بشكل افتراضي ، يكون في %APPDATA%/Captain of Industry .
  8. فتح أو إنشاء Mods الدليل. داخله ، قم بإنشاء دليل جديد له نفس اسم Mod DLL ، في حالتنا ، يتم ExampleMod . انسخ ExampleMod.dll المترجمة هناك ، بحيث يكون في %APPDATA%/Captain of Industry/Mods/ExampleMod/ExampleMod.dll . لاحظ أن اسم الدليل واسم DLL يجب أن يتطابقوا.
  9. قم بتشغيل اللعبة وفي الإعدادات Miscellaneous يمكّن دعم وزارة الدفاع وإعادة تشغيل اللعبة بحيث يسري الإعداد.
  10. قم بتشغيل لعبة جديدة ولاحظ أن ExampleMod يتم تحميله عن طريق تحديد موقع عقدة جديدة في شجرة البحث (مفتوح باستخدام مفتاح G ). في حالة وجود أي أخطاء ، فحص السجلات في %APPDATA%/Captain of Industry/Logs Directory.
  11. تهانينا ، أنت الآن تدير وزارة الدفاع الخاصة بك في قائد الصناعة!

خلق الأصول

يمكن إنشاء أصول مثل الرموز أو النماذج ثلاثية الأبعاد باستخدام محرر الوحدة. نستخدم حاليًا Unity 2022.3.5f1 ويوصى باستخدام نفس الإصدار لتجنب عدم التوافق.

إعداد الوحدة

إعداد وحدة لمرة واحدة مطلوبة لأدوات MAFI للعمل بشكل صحيح.

  1. قم بتنزيل وتثبيت Unity 2022.3.5f1 من https://unity3d.com/unity/qa/lts-releases.
  2. حدد موقع مشهد الاختبار في src/ExampleMod.Unity . لا تفتحه بعد.
  3. قم بإنشاء رابط دليل يسمى UnityRootSymlink في srcExampleMod.UnityLibrary الذي يشير إلى مجلد تثبيت الوحدة (على سبيل المثال C:Program FilesUnityHubEditor2022.3.5f1 ). يمكن القيام بذلك عن طريق استدعاء الأمر mklink /D <target> <srouce> في نافذة وحدة التحكم مع Proviliges المسؤول. على سبيل المثال: mklink /D "C:CaptainOfIndustryModdingsrcExampleMod.UnityLibraryUnityRootSymlink" "C:Program FilesUnity" . عندما تنتقل إلى UnityRootSymlink يجب أن ترى دليل Editor واحد فيه.
  4. قم بإنشاء روابط صلبة لـ DLLs الضرورية من تثبيت Steam الخاص بك عن طريق تشغيل src/ExampleMod.Unity/Assets/DLLs/create_dll_hardlinks.bat . ستحتاج إلى تشغيله تحت امتيازات المسؤول (انقر بزر الماوس الأيمن ، تشغيل كمسؤول).
    • إنها ممارسة جيدة أن ننظر إلى أي رمز تقوم بتشغيله تحت امتيازات المسؤول ، لذلك لا تتردد في فحص ملف الدُفعات أولاً.
    • بدلاً من ذلك ، يمكنك أيضًا نسخ DLLs المعنية بهذا الدليل ولكن الرابط الصعب أفضل لأن أي تحديث للملفات الأصلية سينتشر.
  5. افتح مشهد الاختبار من src/ExampleMod.Unity/Assets/ExampleModScene.unity في محرر الوحدة. يمكن القيام بذلك عبر Unity Hub عن طريق اختيار Open project from disk في علامة التبويب Projects . تأكد من تحديد إصدار الوحدة الصحيح إذا كنت قد تم تثبيتها متعددة.
  6. تحقق من أنه يمكنك رؤية MaFi في القائمة العليا على محرر الوحدة. إذا لم يكن الأمر كذلك ، لم يتم تحميل DLLs المرتبطة بشكل صحيح ولن تتمكن من إنشاء أصول.
  7. افتح ExampleModScene بواسطة النقر المزدوج عليه في جزء Proejct (إنه ضمن دليل Assets ).
  8. (اختياري) نوصي أيضًا بتغيير الإعدادات التالية في محرر الوحدة ( Edit -> Preferences ).
    • External tools -> External script editor -> Open by file extension . سيوقف هذا تجديد ملفات المشروع ووضع المسارات المطلقة بدلاً من النسبية.
    • General -> Disable Editor Analytics (إذا كنت تستطيع وتريد).

إنشاء أصول أيقونة

يتبع الخطوات التالية كيفية حزم الرموز ، على سبيل المثال للمنتجات الجديدة.

  1. نوصي بتنظيم الأصول في الدلائل. ضمن دليل Assets ، قم بإنشاء دليل <mod name>/<icons categor> ، في حالتنا التي تكون ExampleMod/ProductIcons .
  2. استيراد الصور كملفات PNG أو JPG إلى الدليل الذي تم إنشاؤه حديثًا.
  3. قم بتكوين القوام المستوردة حديثًا لنوع Sprite (2D and UI) وتطبيق التغيير.
  4. قم بتعيين القوام المستوردة حديثًا لأي حزمة أصول من القائمة المنسدلة في أسفل علامة التبويب المفتش. يمكنك إنشاء حزمة جديدة تسمى asdf أو اختيار أي واحد موجود.
  5. لاستخدام أيقونة في وزارة الدفاع الخاصة بك (على سبيل المثال كرمز للمنتج) ، ما عليك سوى النقر بزر الماوس الأيمن على نسيج وحدد Copy Path . يمكن استخدام هذا المسار لتحميل مسبق في اللعبة.
  6. اتبع الخطوات تحت حزم أصول التغليف لتجميع الأصول التي تم إنشاؤها.

ملاحظة: على عكس النماذج ثلاثية الأبعاد ، لا تحتاج القوام إلى إنشاء prefab .

إنشاء الأصول النموذجية ثلاثية الأبعاد

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

  1. تحديد كيان تخطيط في MOD الخاص بك مع التخطيط المطلوب المحدد باستخدام ASCII (انظر ExampleMachineData.cs ).
  2. قم بتعيين مسار ما قبل المسبق إلى "TODO" نظرًا لعدم وجود مسبق حتى الآن.
  3. تجميع ونشر وزارة الدفاع.
  4. قم بتشغيل لعبة مع الجهاز الذي تم إنشاؤه حديثًا و Run Console Command generate_layout_entity_mesh_template متبوعًا بمعرف الكيان الخاص بك. سيؤدي ذلك إلى إنشاء ملف OBJ في %APPDATA%/Captain of Industry/Misc/GeneratedMeshTemplates الذي يمثل مربعًا محيطًا ثلاثي الأبعاد من تصميم الكيان الجديد الخاص بك مع مواقع المنافذ الدقيقة.
  5. إذا لم يكن لديك نموذج ثلاثي الأبعاد ، فقم بتحميل نموذج القالب الذي تم إنشاؤه حديثًا إلى محرر ثلاثي الأبعاد من اختيارك وإنشاء نموذج ثلاثي الأبعاد يناسبه. إذا كان لديك بالفعل طراز ثلاثي الأبعاد ، فيمكنك مقارنته بالقالب الذي تم إنشاؤه وتحرير تخطيط ASCII وفقًا لذلك.
  6. عند اكتمال النموذج ثلاثي الأبعاد ، تصدير FBX أو OBJ واتبع الخطوات التالية.

الخطوات التالية وصف كيفية حزم نموذج ثلاثي الأبعاد.

  1. نوصي بتنظيم الأصول في الدلائل. ضمن دليل Assets ، قم بإنشاء <mod name>/<model name> ، في حالتنا التي تم ExampleMod/ExampleModel .
  2. استيراد ملفات النماذج ثلاثية الأبعاد (OBJ ، FBX ، إلخ) والقوام (PNG ، JPG ، إلخ) إلى دليل النموذج. يمكنك ببساطة استخدام السحب والإفلات. يوصى بإنشاء مجلد منفصل لكل أصل.
  3. اسحب النموذج ثلاثي الأبعاد من جزء المشروع إلى مشهد الوحدة. أعد تعيين موضعها وتناوبه إلى جميع الأصفار باستخدام المفتش (يمكنك استخدام قائمة DOTS الثلاثة بجوار التحويل) وجعلها تبدو كما تريد (إضافة مواد ، إلخ). ملاحظة: من المهم أن يكون للأصول الخاصة بك موضع ودوران. إذا كنت بحاجة إلى إعادة وضعه ، فقم بتغيير النموذج ثلاثي الأبعاد أو إنشاء كائن طفل يمكن نقله.
  4. قم بإنشاء مسبق عن طريق سحب كائن الجذر وإسقاطه إلى جزء المشروع. هذا سيجعل ملف .prefab جديد. في مثالنا أنشأنا مسبقًا في دليل <mod name> .
  5. قم بتعيين prefab تم إنشاؤه حديثًا لأي حزمة أصول من القائمة المنسدلة في أسفل علامة تبويب المفتش. يمكنك إنشاء حزمة مؤقتة جديدة تسمى asdf أو اختيار أي واحد موجود.
  6. لاستخدام prefabs في وزارة الدفاع الخاصة بك ، ما عليك سوى النقر بزر الماوس الأيمن فوق أي مسار مسار وحدد Copy Path . يمكن استخدام هذا المسار لتحميل مسبق في اللعبة.
  7. اتبع الخطوات تحت حزم أصول التغليف لتجميع الأصول التي تم إنشاؤها.

حزم الأصول التغليف

بمجرد أن تصبح أصولك جاهزة ، اتبع هذه الخطوات لتعبئةها باستخدام وزارة الدفاع الخاصة بك. يتم نشر Mods في دليل يحمل نفس اسم Mod DLL ، في حالتنا لدينا ExampleMod/ExampleMod.dll . الآن يمكننا إضافة حزم الأصول إلى نفس الدليل.

  1. تأكد من حفظ كل شيء في الوحدة (استخدم Ctrl+S ).
  2. بناء حزم الأصول عن طريق النقر بزر الماوس الأيمن في أي مكان في جزء المشروع (على أي ملف أو مساحة فارغة) واختر [MaFi] Build asset bundles . بعد الانتهاء من المعالجة ، يمكن العثور على ملفات حزمة الأصول في دليل src/ExampleMod.Unity/AssetBundles .
  3. نسخ محتويات src/ExampleMod.Unity/AssetBundles إلى مجلد AssetBundles بجوار MOD DLL ، على سبيل المثال %APPDATA%/Captain of Industry/Mods/ExampleMod/AssetBundles .
  4. (اختياري) إذا كنت تريد أن تجعله أنيقًا ، فأنت بحاجة فقط إلى حزم الأصول فقط (الملفات بتنسيق YourPrefabName_xxxx ، بدون امتداد) وملف mafi_bundles.manifest . يمكن AssetBundles جميع .manifest الأخرى.

إذا قمت بأي تغييرات على prefabs الخاصة بك ، فما عليك سوى إعادة بناء حزم الأصول والنسخ ، استخدم الملفات الجديدة من دليل AssetBundles .

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل