หน้าแรก>การเขียนโปรแกรมที่เกี่ยวข้อง>ซอร์สโค้ดอื่น ๆ
ดาวน์โหลด

กัปตันของการดัดแปลงอุตสาหกรรม

ยินดีต้อนรับสู่ทรัพยากรการดัดแปลงอย่างเป็นทางการสำหรับกัปตันของเกมอุตสาหกรรม

สถานะของการสนับสนุนการดัดแปลง

ปัจจุบัน COI มีให้บริการบน Steam และอยู่ในระยะเริ่มต้น ในขณะที่การดัดแปลงเป็นไปได้ แต่ก็ยังไม่ได้รับการสนับสนุนอย่างเป็นทางการ เรากำลังทำงานอย่างต่อเนื่องเพื่อปรับปรุงการสนับสนุนและเอกสารประกอบ

คำถามปัญหา

โปรดทราบว่าการสนับสนุน MOD เป็นการทดลองและ API อาจมีการเปลี่ยนแปลง หากคุณมีปัญหาให้ตรวจสอบบันทึกใน %APPDATA%/Captain of Industry/Logs พวกเขามีข้อมูลที่เป็นประโยชน์มากมาย หากคุณต้องการหารือเกี่ยวกับหัวข้อการดัดแปลงกับชุมชนและ devs โปรดไปที่ Discord Channel #Modding-Dev-General ของเรา (คุณจะต้องกำหนดบทบาท Mod creation ของตัวเองในช่องทาง #pick-your-roles-here ) นอกจากนี้คุณยังสามารถยื่นปัญหาได้ที่นี่ใน GitHub แต่เวลาตอบสนองจากทีมงานของเราอาจล่าช้า

ข้อกำหนดเบื้องต้น

ในการเริ่ม Modding COI คุณจะต้อง:

  1. Captain of Industry ของตัวเองบน 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 มีประโยชน์เพียงเปิดเมนูเริ่มและพิมพ์ Edit env และคุณควรดู
  4. ส้อม/ดาวน์โหลด repo นี้
  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 เปิดใช้งานการสนับสนุน MOD และรีสตาร์ทเกมเพื่อให้การตั้งค่ามีผล
  10. เปิดตัวเกมใหม่และสังเกตว่า ExampleMod นั้นโหลดโดยการค้นหาโหนดใหม่ในแผนผังวิจัย (เปิดโดยใช้คีย์ G ) ในกรณีที่มีข้อผิดพลาดใด ๆ ให้ตรวจสอบบันทึกใน %APPDATA%/Captain of Industry/Logs
  11. ขอแสดงความยินดีตอนนี้คุณกำลังใช้งาน MOD ของคุณใน Captain of Industry!

การสร้างสินทรัพย์

สินทรัพย์เช่นไอคอนหรือโมเดล 3 มิติสามารถสร้างได้โดยใช้ตัวแก้ไข Unity ขณะนี้เราใช้ 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 ที่ชี้ไปที่โฟลเดอร์การติดตั้ง Unity (เช่น C:Program FilesUnityHubEditor2022.3.5f1 ) ซึ่งสามารถทำได้โดยการเรียกใช้คำสั่ง mklink /D <target> <srouce> ในหน้าต่างคอนโซลพร้อมกับผู้ดูแลระบบ ตัวอย่างเช่น: mklink /D "C:CaptainOfIndustryModdingsrcExampleMod.UnityLibraryUnityRootSymlink" "C:Program FilesUnity" เมื่อคุณนำทางไปยัง UnityRootSymlink คุณควรเห็นไดเรกทอรี Editor เดียวในนั้น
  4. สร้าง Hard-Links สำหรับ DLL ที่จำเป็นจากการติดตั้ง Steam ของคุณโดยเรียกใช้ src/ExampleMod.Unity/Assets/DLLs/create_dll_hardlinks.bat BATCH คุณจะต้องเรียกใช้ภายใต้สิทธิพิเศษของผู้ดูแลระบบ (คลิกขวาทำงานเป็นผู้ดูแลระบบ)
    • มันเป็นวิธีปฏิบัติที่ดีในการดูรหัสใด ๆ ที่คุณใช้ภายใต้สิทธิพิเศษของผู้ดูแลระบบดังนั้นอย่าลังเลที่จะตรวจสอบไฟล์แบตช์ก่อน
    • อีกทางเลือกหนึ่งคุณสามารถคัดลอก DLL ที่เป็นปัญหาไปยังไดเรกทอรีนี้ แต่ Hard Link นั้นดีกว่าเนื่องจากการอัปเดตไฟล์ต้นฉบับจะเผยแพร่
  5. เปิดฉากทดสอบจาก src/ExampleMod.Unity/Assets/ExampleModScene.unity ใน ENITY Editor สามารถทำได้ผ่าน Unity Hub โดยเลือก Open project from disk ในแท็บ Projects ตรวจสอบให้แน่ใจว่าคุณเลือกเวอร์ชัน Unity ที่เหมาะสมหากคุณติดตั้งหลายรายการ
  6. ตรวจสอบว่าคุณสามารถเห็น MaFi ในเมนูด้านบนบนตัวแก้ไข Unity หากไม่ได้มีการโหลด DLL ที่เชื่อมโยงอย่างถูกต้องและคุณจะไม่สามารถสร้างสินทรัพย์ได้
  7. เปิด ExampleModScene โดย double-clickin บนนั้นในบานหน้าต่าง Proejct (อยู่ภายใต้ไดเรกทอรี Assets )
  8. (ไม่บังคับ) เราขอแนะนำให้เปลี่ยนการตั้งค่าต่อไปนี้ใน Unity Editor ( 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. หากต้องการใช้ไอคอนใน mod ของคุณ (ตัวอย่างเช่นไอคอนผลิตภัณฑ์) เพียงคลิกขวาที่พื้นผิวและเลือก Copy Path เส้นทางนั้นสามารถใช้ในการโหลดสำเร็จรูปของคุณในเกม
  6. ทำตามขั้นตอนภายใต้การรวมกลุ่มสินทรัพย์บรรจุภัณฑ์เพื่อบรรจุสินทรัพย์ที่สร้างขึ้น

หมายเหตุ: แตกต่างจากรุ่น 3 มิติพื้นผิวไม่จำเป็นต้องสร้าง prefab

การสร้างสินทรัพย์โมเดล 3 มิติ

ขั้นตอนต่อไปนี้อธิบายถึงวิธีการสร้างเทมเพลตโมเดล 3 มิติที่เป็นประโยชน์อย่างมากในการสร้างแบบจำลอง 3 มิติของอาคาร

  1. กำหนดเอนทิตีเลย์เอาต์ใน mod ของคุณด้วยเค้าโครงที่ต้องการที่ระบุโดยใช้ ASCII (ดู ExampleMachineData.cs )
  2. ตั้งเส้นทางก่อนหน้าเป็น "TODO" เนื่องจากเรายังไม่มีสำเร็จรูป
  3. รวบรวมและปรับใช้ mod
  4. เกมเปิดตัวด้วยเครื่องที่สร้างขึ้นใหม่และเรียกใช้คำสั่งคอนโซล generate_layout_entity_mesh_template ตามด้วยรหัสเอนทิตีของคุณ สิ่งนี้จะสร้างไฟล์ OBJ ใน %APPDATA%/Captain of Industry/Misc/GeneratedMeshTemplates ซึ่งแสดงถึงกล่องขอบเขต 3 มิติของเลย์เอาต์ของเอนทิตีใหม่ของคุณด้วยตำแหน่งพอร์ตที่แน่นอน
  5. หากคุณไม่มีรุ่น 3 มิติให้โหลดโมเดลเทมเพลตที่สร้างขึ้นใหม่ไปยังตัวแก้ไข 3D ที่คุณเลือกและสร้างโมเดล 3 มิติที่เหมาะกับมัน หากคุณมีโมเดล 3 มิติอยู่แล้วคุณสามารถเปรียบเทียบกับเทมเพลตที่สร้างขึ้นและแก้ไขเค้าโครง ASCII ตามลำดับ
  6. เมื่อโมเดล 3D เสร็จสมบูรณ์ให้ส่งออก FBX หรือ OBJ และทำตามขั้นตอนถัดไป

ขั้นตอนต่อไปนี้อธิบายถึงวิธีการจัดทำโมเดล 3 มิติ

  1. เราขอแนะนำให้จัดระเบียบสินทรัพย์ในไดเรกทอรี ภายใต้ไดเรกทอรีไดเรกทอรี Assets สร้าง <mod name>/<model name> ไดเรกทอรีในกรณีของเราที่เป็น ExampleMod/ExampleModel
  2. นำเข้าไฟล์โมเดล 3 มิติ (OBJ, FBX ฯลฯ ) และพื้นผิว (PNG, JPG, ฯลฯ ) ไปยังไดเรกทอรีโมเดล คุณสามารถใช้ Drag & Drop แนะนำให้สร้างโฟลเดอร์แยกต่างหากสำหรับแต่ละสินทรัพย์
  3. ลากโมเดล 3 มิติจากบานหน้าต่างโครงการไปยังฉาก Unity รีเซ็ตตำแหน่งและการหมุนเป็นศูนย์ทั้งหมดโดยใช้ผู้ตรวจสอบ (คุณสามารถใช้เมนูสามจุดถัดจากการแปลง) และทำให้ดูตามที่คุณต้องการ (เพิ่มวัสดุ ฯลฯ ) หมายเหตุ: เป็นสิ่งสำคัญที่สินทรัพย์ของคุณมีตำแหน่งและการหมุนเป็นศูนย์ หากคุณต้องการเปลี่ยนตำแหน่งให้เปลี่ยนโมเดล 3 มิติหรือสร้างวัตถุเด็กที่สามารถเคลื่อนย้ายได้
  4. สร้าง prefab โดยการลากวัตถุรูทและวางลงในบานหน้าต่างโครงการ สิ่งนี้จะสร้างไฟล์ .prefab ใหม่ ในตัวอย่างของเราเราสร้าง prefab ในไดเรกทอรี <mod name>
  5. กำหนด prefab ที่สร้างขึ้นใหม่ให้กับชุดสินทรัพย์ใด ๆ จากเมนูแบบหล่นลงที่ด้านล่างของแท็บผู้ตรวจสอบ คุณสามารถสร้างชุดชั่วคราวใหม่ที่เรียกว่า asdf หรือเลือกชุดที่มีอยู่
  6. หากต้องการใช้ prefabs ใน mod ของคุณเพียงคลิกขวาที่ prefab และเลือก Copy Path เส้นทางนั้นสามารถใช้ในการโหลดสำเร็จรูปของคุณในเกม
  7. ทำตามขั้นตอนภายใต้การรวมกลุ่มสินทรัพย์บรรจุภัณฑ์เพื่อบรรจุสินทรัพย์ที่สร้างขึ้น

การรวมกลุ่มสินทรัพย์บรรจุภัณฑ์

เมื่อสินทรัพย์ของคุณพร้อมให้ทำตามขั้นตอนเหล่านี้เพื่อจัดทำแพ็คเกจด้วย mod ของคุณ 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 ไฟล์ .manifest อื่น ๆ ทั้งหมดสามารถลบได้เช่นเดียวกับไฟล์ AssetBundles

หากคุณทำการเปลี่ยนแปลงใด ๆ กับสำเร็จรูปของคุณเพียงสร้างกลุ่มสินทรัพย์ใหม่และคัดลอกใช้ไฟล์ใหม่จากไดเรกทอรี AssetBundles

ขยาย
ข้อมูลเพิ่มเติม
แอปที่เกี่ยวข้อง
แนะนำสำหรับคุณ
ข้อมูลที่เกี่ยวข้อง ทั้งหมด