# ชุดเริ่มต้นคู่มือ Unity ภาษาไทย — หน๊ด หนวด translator

ใช้กับ Python 3.10 ขึ้นไป ไม่ต้องติดตั้งแพ็กเกจเพิ่ม สคริปต์ไม่แก้ไฟล์เกม
ตัวอย่างนี้ไม่มี asset เกม ฟอนต์ ตัวแปล AI หรือ universal packer

1. คัดลอกไฟล์ต้นฉบับที่จำเป็นจากเกมของตนเองไปยัง 01_Original_Backup โดยปิดเกมก่อน อย่านำไฟล์ที่ลงม็อดแล้วเป็นต้นฉบับ
2. เก็บ snapshot โดยเขียนรายงานไว้ด้านนอกโฟลเดอร์ที่อ่าน:
   python tools/snapshot.py 01_Original_Backup --out baseline.json
3. ลองตรวจ CSV ตัวอย่าง:
   python tools/validate_csv.py translation.example.csv --report csv-check.json
4. ทำซ้ำหลังแก้ไฟล์ในโฟลเดอร์ staging โดยใช้ชื่อรายงานใหม่:
   python tools/snapshot.py 04_Packed_Mod --out output.json --compare baseline.json

snapshot เปรียบเทียบไฟล์ตาม relative path ของสอง root จึงต้องจัดโครงสร้างต้นฉบับและ staging ให้เทียบกันได้
สคริปต์ไม่เขียนทับรายงานเก่า ไม่ตาม symlink และไม่พิสูจน์ว่าเกมโหลดได้
CSV validator ตรวจ schema/key, simple placeholders, printf บางรูปแบบ, แท็ก TMP ที่ระบุ และ newline แบบอนุรักษนิยม
Smart Strings ซ้อน/ไวยากรณ์เฉพาะเกม/line-break ที่ตั้งใจแก้/ฟอนต์ PUA ต้องมีตัวตรวจเฉพาะและคนทบทวนเพิ่ม
context และชื่อ ExampleGame เป็นข้อมูลสาธิต ไม่ใช่ selector ของเกมจริง

โครงสร้างงานที่แนะนำ:
01_Original_Backup/       ต้นฉบับที่ไม่แก้ไข
02_Translation_Workspace/ CSV และอภิธานศัพท์
03_Font_and_UI/           ฟอนต์ mapping และภาพทดสอบ
04_Packed_Mod/            ผลแพ็กแต่ละ revision
05_Scripts_and_Tools/     สคริปต์ manifest และรายงาน
06_Releases/              ชุดติดตั้งที่ผ่านการทดสอบแล้ว
07_Image_Resources/       ภาพคู่มือและสกรีนช็อต

ขั้นตอน packer / font / catalog ต้องจัดทำตามเกมและ build จริง อ่านคู่มือ Unity ฉบับเต็มในพรีวิวประกอบ
ห้ามลบทรัพยากรเกมเพื่อถอนม็อด ให้คืนสำรองที่ถูกต้องหรือใช้ Verify ของร้านค้า
