โทเค็นความเข้ากันได้ของ Cross-Mod (CMCT)

โทเค็นความเข้ากันได้ข้ามม็อดจะเพิ่มโทเค็น Content Patcher พิเศษเฉพาะบางรายการ ซึ่งช่วยให้คุณ (หากคุณเป็นผู้สร้างม็อด) เข้าถึงค่าคอนฟิก การแปล และโทเค็นแบบไดนามิกจากม็อดอื่นๆ รวมถึงม็อดที่ไม่ได้สร้างขึ้นสำหรับ Content Patcher โดยเฉพาะ โทเค็นเหล่านี้มีประโยชน์หากคุณไม่มีวิธีอื่นใดที่จะรับรองความเข้ากันได้อย่างสมบูรณ์แบบระหว่างม็อดของคุณและม็อดของพวกเขา หากคุณต้องการเปลี่ยนแปลงสิ่งต่างๆ ตามค่าใดๆ ที่กล่าวมาข้างต้น

การติดตั้ง

• ติดตั้ง SMAPI เวอร์ชันล่าสุด.
• แตกไฟล์ mod ลงใน Stardew Valley/Mods
• รันเกมโดยใช้ SMAPI
  

การใช้งานสำหรับผู้เล่น
ม็อดนี้ไม่ได้ทำอะไรเลย การติดตั้งม็อดนี้ในฐานะผู้ใช้จะไม่มีประโยชน์ใดๆ หากม็อดอื่นที่คุณใช้อยู่ไม่จำเป็นต้องใช้ม็อดนี้

การใช้งานสำหรับผู้สร้าง Mod Patcher เนื้อหา
Mod นี้เพิ่มโทเค็นสี่รายการ:

• Spiderbuttons.CMCT/การกำหนดค่า
• Spiderbuttons.CMCT/การแปล
• Spiderbuttons.CMCT/ไดนามิก
• Spiderbuttons.CMCT/สินทรัพย์
  

โทเค็นเหล่านี้แต่ละตัวจะช่วยให้คุณรับค่า config, สตริงการแปล, ค่าโทเค็นแบบไดนามิก หรือคีย์สินทรัพย์ภายในได้ตามลำดับ ทั้งสี่ตัวนี้ จำเป็นต้อง อาร์กิวเมนต์อินพุต อาร์กิวเมนต์อินพุตแรกจะเป็น UniqueID ของม็อดที่คุณกำลังพยายามดึงค่ามาเสมอ อาร์กิวเมนต์อินพุตที่สองจะขึ้นอยู่กับโทเค็นที่ต้องการ:

• Config: ชื่อของค่า config ที่ต้องการค้นหา หากค่า config ซ้อนกัน คุณต้องระบุเส้นทาง config แบบเต็มตามโครงสร้าง JSON
• การแปล: ปุ่ม i18n ของการแปลที่คุณต้องการ มันจะดึงคำแปลสำหรับภาษาที่เลือกไว้ในขณะนั้นเสมอ
• ไดนามิก: ชื่อของโทเค็นไดนามิก
• สินทรัพย์: เส้นทางของสินทรัพย์จาก mod อื่นที่สัมพันธ์กับ ของพวกเขา ไฟล์ manifest.json
  

หากคุณใช้โทเค็นใดๆ เหล่านี้ คุณ ต้อง ตั้งค่า mod อื่นเป็น dependency ถ้าคุณไม่ทำ อาจ ใช้งานได้ แต่อาจเกิดข้อผิดพลาดแปลกๆ ขึ้นได้ นี่คือตัวอย่างสี่ตัวอย่างสำหรับแต่ละโทเค็น โดยใช้ ค้นหาอะไรก็ได้, หมวกหนูเลซี่, และ หนังสือเสริมของบัตตัน เพื่อการสาธิต:

• {{Spiderbuttons.CMCT/Config: Pathoschild.LookupAnything, Controls.ToggleSearch}}
• {{Spiderbuttons.CMCT/การแปล: ichortower.HatMouseLacey, houseDisplayName}}
• {{Spiderbuttons.CMCT/Dynamic: ichortower.HatMouseLacey, Lacey}}
• {{Spiderbuttons.CMCT/สินทรัพย์: Spiderbuttons.ButtonsExtraBooks, สินทรัพย์/Books/sheet.png}}
  

ข้อจำกัด
ในปัจจุบัน มีสองสิ่งหลักที่ฉันคิดว่าเป็นข้อจำกัด:

• การแปลที่รับโทเค็นเป็นอินพุต (เช่น ค่า i18n ที่มี {{โทเค็น}} ของตัวเองอยู่ภายใน i18n เอง) จะทำงานไม่ถูกต้องและจะดึงเฉพาะสตริงตัวอักษรที่มีโทเค็นอยู่ในวงเล็บเท่านั้น
• โทเค็นแบบไดนามิกจะถูกเริ่มต้นเฉพาะเมื่อโหลดบันทึกเท่านั้น ไม่ใช่เมื่อเปิดเกม ซึ่งอาจสำคัญหรือไม่สำคัญกับคุณเลยก็ได้
  

นอกจากนี้ยังควรกล่าวถึงด้วยว่าคุณควรใช้โทเค็นแบบไดนามิก ประหยัดที่สุดเท่าที่จะเป็นไปได้โดยไม่ต้องลงรายละเอียดเชิงเทคนิคเกี่ยวกับวิธีการทำงานของ Content Patcher มากนัก เนื่องจากวิธีที่ผมต้องติดตั้งโทเค็น พวกเขามักจะส่งสัญญาณว่าควรเผยแพร่การเปลี่ยนแปลง แม้ว่าโทเค็นแบบไดนามิกที่ตรวจสอบจากม็อดอื่นจะไม่เปลี่ยนแปลงก็ตาม เรื่องนี้ไม่เลวร้ายนักหากโทเค็นของคุณอัปเดต OnDayStart เหมือนกับที่โทเค็นทำตามค่าเริ่มต้น แต่อาจมีค่าใช้จ่ายสูงหากคุณอัปเดต OnTimeChange หรือ OnLocationChange!

รหัสต้นฉบับ