ข้อความ error ของ SMAPI และความหมาย

เมื่อ SMAPI โหลดมอดไม่ได้ จะเขียนชื่อมอดไว้ในหัวข้อ Skipped mods ของ log ตามด้วยคำว่า because และเหตุผล หน้านี้รวมเหตุผลทั้งหมดที่ SMAPI ใช้ ถ้าอยากให้ระบบอ่านให้อัตโนมัติ ใช้ Log Analyzer

เหตุผลที่มอดถูกข้าม (Skipped mods)

เกี่ยวกับ dependency

ข้อความ	ความหมาย	วิธีแก้
it requires mods which aren't installed (...)	ขาดมอดที่ต้องใช้ ชื่อหรือ UniqueID อยู่ในวงเล็บ	ติดตั้งมอดที่ระบุ
it needs newer versions of some mods: ...	มอดที่ต้องใช้เก่ากว่า MinimumVersion	อัปเดตมอดที่ระบุ
it needs the '...' mod, which couldn't be loaded.	dependency ถูกข้ามด้วยเหตุผลอื่น	ดูเหตุผลของมอดนั้นในรายการเดียวกันแล้วแก้ก่อน
its dependencies have a circular reference: ...	มอดอ้างอิงกันเป็นวงกลม	แก้ Dependencies ให้ไม่วน ตรวจได้ด้วย Dependency Checker

เกี่ยวกับเวอร์ชัน

ข้อความ	ความหมาย	วิธีแก้
it needs SMAPI X or later.	SMAPI ที่ติดตั้งเก่ากว่าที่มอดต้องการ	อัปเดต SMAPI จาก smapi.io
it needs Stardew Valley X or later.	เกมเก่ากว่าที่มอดต้องการ	อัปเดตเกม
it's no longer compatible.	SMAPI รู้ว่ามอดเวอร์ชันนี้ใช้กับเกมหรือ SMAPI ปัจจุบันไม่ได้	หาเวอร์ชันใหม่ของมอด หรือนำออก
it's obsolete: ...	มอดไม่จำเป็นแล้ว เช่น ฟีเจอร์ถูกรวมเข้าเกมหรือ SMAPI แล้ว	นำมอดออก

เกี่ยวกับไฟล์ของมอด

ข้อความ	ความหมาย	วิธีแก้
you have multiple copies of this mod installed.	มีมอดเดียวกันหลายโฟลเดอร์ (UniqueID ซ้ำ)	ลบโฟลเดอร์ที่ระบุ แล้วติดตั้งใหม่ชุดเดียว
its DLL '...' doesn't exist.	ไม่พบไฟล์ตาม EntryDll	ดาวน์โหลดมอดใหม่ หรือ build โปรเจกต์ให้ได้ไฟล์ .dll
its manifest ... หรือข้อความที่ขึ้นต้นด้วย its	manifest.json ผิดรูปแบบ	ตรวจด้วย Manifest Validator ดูกฎทั้งหมดที่ อ้างอิง manifest.json
disabled by dot convention	ชื่อโฟลเดอร์ขึ้นต้นด้วยจุด จึงถูกปิดไว้	ลบจุดหน้าชื่อโฟลเดอร์ถ้าต้องการใช้

หัวข้อเตือนใน log

หลังโหลดมอดเสร็จ SMAPI อาจเขียนหัวข้อเหล่านี้ใน log พร้อมรายชื่อมอด

หัวข้อ	ความหมาย
Broken mods	มอดที่ SMAPI รู้ว่าเสียหรือไม่รองรับ
Changed save serializer	มอดเปลี่ยนวิธีบันทึกเซฟ ถ้าถอดออกอาจทำให้เซฟเปิดไม่ได้ สำรองเซฟก่อนเสมอ
Patched game code	มอดใช้ Harmony แก้โค้ดของเกม เป็นเรื่องปกติของมอดหลายตัว แต่ถ้าเจอบั๊กแปลกอาจเกี่ยวข้อง
Patched game code without Harmony fix	มอดแก้โค้ดเกมในแบบที่มีโอกาสทำให้เกิดปัญหามากกว่าปกติ
Bypassed safety checks	มอดข้ามระบบป้องกันของ SMAPI
Direct console access	มอดเข้าถึงหน้าต่าง console โดยตรง
No update keys	มอดไม่มี UpdateKeys SMAPI จึงตรวจหาเวอร์ชันใหม่ไม่ได้

ระดับของข้อความใน log

ระดับ	ใช้เมื่อ
TRACE	รายละเอียดเชิงเทคนิค เขียนลงไฟล์ log แต่ปกติไม่แสดงใน console
DEBUG	ข้อมูลสำหรับนักพัฒนา
INFO	ข้อมูลทั่วไป
WARN	มีบางอย่างผิดปกติ แต่ยังทำงานต่อได้
ERROR	เกิดข้อผิดพลาด บางส่วนของมอดหรือเกมทำงานไม่ได้
ALERT	เรื่องสำคัญที่ผู้เล่นควรเห็น เช่น มี SMAPI เวอร์ชันใหม่

อ่านวิธีไล่หาสาเหตุทีละขั้นได้ในบท Debug ด้วย SMAPI log