Monster Hunter: World – Iceborne ภาษาไทย

โปรเจกต์แปลภาษาไทยสำหรับ Monster Hunter: World – Iceborne (PC) พร้อม pipeline สำหรับแปลงไฟล์ GMD ↔ CSV, ตรวจคุณภาพคำแปล, repack กลับเข้าเกม, คลังศัพท์กลาง และชุดฟอนต์ที่รองรับอักษรไทย

โปรเจกต์นี้เป็นผลงานของแฟนเกม ไม่มีความเกี่ยวข้องหรือได้รับการรับรองจาก CAPCOM กรุณาสำรองไฟล์และเซฟเกมก่อนติดตั้งม็อด

สิ่งที่รวมอยู่ในโปรเจกต์

• ชุดภาษาไทยพร้อมติดตั้งใน GitHub Releases
• ฟอนต์ไทย Kanit และ TH Sarabun ใน GitHub Releases
• เครื่องมือแปลและตรวจ QA ใน Tools
• คลังศัพท์ EN→TH และโปรไฟล์น้ำเสียงตัวละครใน Tools/glossary
• agent/skill definitions สำหรับ Codex และ Claude
• MHW Font Util (Compiled) สำหรับแปลง .ttf/.otf เป็น .gfd และถอด .gfd กลับเป็น .ttf/.otf

ติดตั้งม็อดภาษาไทย

1. ปิดเกมและสำรองโฟลเดอร์ nativePC เดิม หากมีม็อดอื่นติดตั้งอยู่
2. ดาวน์โหลดไฟล์ ZIP ทั้ง 3 ไฟล์จาก Release V1.0
3. แตกไฟล์ MHW_ThaiLanguagePack_ModBySubMaRk_V1.0.zip
4. เลือกฟอนต์เพียงหนึ่งชุด:
   • MHW_GGKanit_Font.zip
   • MHW_THSarabun_Font.zip
5. คัดลอกโฟลเดอร์ nativePC จากชุดภาษาและชุดฟอนต์ไปวางที่โฟลเดอร์เกม แล้วอนุญาตให้ merge โฟลเดอร์

ตำแหน่งเกม Steam ปกติ:

C:\Program Files (x86)\Steam\steamapps\common\Monster Hunter World

ม็อดชุดนี้แทนไฟล์ข้อความภาษาอังกฤษ (*_eng.gmd) ดังนั้นให้เลือกภาษา ข้อความในเกมเป็น English หากข้อความไทยไม่แสดง

อย่าติดตั้งฟอนต์ Kanit และ TH Sarabun พร้อมกัน เพราะทั้งสองชุดเขียนทับไฟล์ .gfd ชุดเดียวกัน

MHW Font Util (Compiled)

ไฟล์พร้อมใช้สำหรับ Windows อยู่ที่:

MHW Font Util Complied/mhw-font-util.exe

ชื่อโฟลเดอร์ Complied ถูกคงไว้ตามโครงสร้างปัจจุบัน ส่วนชื่อเครื่องมือใน เอกสารนี้ใช้ MHW Font Util (Compiled)

เครื่องมือต้นฉบับพัฒนาโดย Fexty12573/mhw-font-util ภายใต้ MIT License รองรับเฉพาะ outline font และไม่รองรับ texture-based font

แปลง TTF/OTF เป็น GFD

PowerShell:

& ".\MHW Font Util Complied\mhw-font-util.exe" ".\MyFont.ttf"
& ".\MHW Font Util Complied\mhw-font-util.exe" ".\MyFont.otf"

Command Prompt หรือไฟล์ .bat:

"MHW Font Util Complied\mhw-font-util.exe" "MyFont.ttf"
"MHW Font Util Complied\mhw-font-util.exe" "MyFont.otf"

โปรแกรมจะสร้าง MyFont.gfd ไว้ข้างไฟล์ต้นฉบับ

ถอด GFD กลับเป็น TTF/OTF

PowerShell:

& ".\MHW Font Util Complied\mhw-font-util.exe" ".\font_world_Arabic.gfd"

Command Prompt หรือไฟล์ .bat:

"MHW Font Util Complied\mhw-font-util.exe" "font_world_Arabic.gfd"

โปรแกรมตรวจ signature ภายในแล้วสร้าง .ttf หรือ .otf ด้วยชื่อเดิมไว้ข้าง ไฟล์ .gfd

สามารถลากไฟล์ .gfd, .ttf หรือ .otf ไปวางบน mhw-font-util.exe โดยตรงได้เช่นกัน

สร้างชุดฟอนต์สำหรับเกม

หลังได้ MyFont.gfd ให้ทำสำเนาเป็นชื่อไฟล์ที่เกมเรียกใช้ทั้ง 8 ชื่อ แล้ววาง ใต้ nativePC/ui/font/other:

font_world_Arabic.gfd
font_world_FZHeiB01_Big5_Ch.gfd
font_world_FZHeiB01_Ch.gfd
font_world_Gothic_K.gfd
font_world_Hope_K.gfd
font_world_TsukugoB.gfd
font_world_TsukugoD.gfd
font_world_TsukuminD.gfd

ตัวอย่าง PowerShell:

$fontSource = Resolve-Path ".\MyFont.gfd"
$fontOutput = ".\MyFontMod\nativePC\ui\font\other"
$fontTargets = @(
    "font_world_Arabic.gfd",
    "font_world_FZHeiB01_Big5_Ch.gfd",
    "font_world_FZHeiB01_Ch.gfd",
    "font_world_Gothic_K.gfd",
    "font_world_Hope_K.gfd",
    "font_world_TsukugoB.gfd",
    "font_world_TsukugoD.gfd",
    "font_world_TsukuminD.gfd"
)

New-Item -ItemType Directory -Force -Path $fontOutput | Out-Null
foreach ($fontTarget in $fontTargets) {
    Copy-Item -LiteralPath $fontSource -Destination (Join-Path $fontOutput $fontTarget)
}

สำหรับ Command Prompt มี helper พร้อมใช้:

"MHW Font Util Complied\make-font-pack.bat" "MyFont.gfd" "MyFontMod\nativePC\ui\font\other"

หากไม่ระบุ output script จะสร้างชุดม็อดไว้ข้างไฟล์ .gfd โดยอัตโนมัติ:

"MHW Font Util Complied\make-font-pack.bat" "MyFont.gfd"

ไฟล์ .bat จะสร้างโฟลเดอร์ปลายทางเมื่อยังไม่มี และเขียนทับเฉพาะชื่อฟอนต์ ทั้ง 8 รายการข้างต้น

ฟอนต์ต้นฉบับต้องมี glyph ภาษาไทยครบ มิฉะนั้นอักษรบางตัวจะหายหรือแสดงเป็น สี่เหลี่ยม ควรทดสอบเมนู, บทสนทนา, ตัวเลข, สัญลักษณ์ และข้อความหลายบรรทัดในเกม ทุกครั้ง

ข้อมูลไฟล์ executable

SHA-256: 00B503671310897E745A8A4E7A0A1B11F049EA873AD0D73550B0836338AE3579
Size:    267,264 bytes

ไฟล์นี้ไม่ได้ลงลายเซ็นดิจิทัล Windows อาจแสดง SmartScreen warning ผู้ใช้ที่ ไม่ต้องการรัน binary ที่ compile ไว้แล้วสามารถตรวจสอบ source และ build เองจาก repository ต้นทางได้

โครงสร้าง repository

Path	หน้าที่
csv_out	CSV ภาษาอังกฤษต้นฉบับที่ใช้เทียบความถูกต้อง
csv_translate	CSV ที่กำลังแปลและเป็น source สำหรับ repack
gmd_out	ไฟล์ GMD ต้นฉบับที่ใช้สร้าง output
gmd_repacked	ไฟล์ GMD ที่ repack แล้ว
OriginalChunk	ไฟล์ต้นฉบับที่แยกตาม game chunk
Tools	pipeline, QA, editor และ glossary tooling
Tools/glossary	คลังศัพท์กลางและ continuity ของบทสนทนา
MHW Mods Release	พื้นที่ staging ในเครื่อง (ไม่ commit; เผยแพร่ ZIP ผ่าน GitHub Releases)
MHW Font Util Complied	executable สำหรับแปลงฟอนต์ MHW
.agents, .claude, .codex	workflow definitions สำหรับ AI agents

สำหรับผู้พัฒนาและผู้แปล

ความต้องการ

• Windows 10/11
• Python 3.10 ขึ้นไป
• Node.js สำหรับ Tools/reflow_box_text.py เท่านั้น
• ไม่ต้องติดตั้ง Python package ภายนอกสำหรับ translation pipeline หลัก

รันคำสั่งทั้งหมดจาก repository root คำสั่ง python ... ด้านล่างใช้ได้เหมือนกัน ทั้ง PowerShell, Command Prompt และไฟล์ .bat

ตัวอย่างเข้า repository root ด้วย Command Prompt:

cd /d "D:\path\to\mhw-thai-project"

แปลง GMD ต้นฉบับเป็น CSV

python Tools/gmd_to_csv.py ".\gmd_out\common\text\animal_names_eng.gmd" ".\csv_out\common\text\animal_names_eng.csv"

หากไม่ระบุ output โปรแกรมจะสร้าง .csv ไว้ข้างไฟล์ .gmd ต้นฉบับ โดยใช้ UTF-8 BOM, CRLF และ ; เป็น delimiter

ดูสถานะการแปล

python Tools/mhw_status.py

ดึง batch ถัดไป

python Tools/next_batch.py --phase 1

Phase ที่รองรับ:

1. common/text/cm_* — UI, เมนู, ไอเทม และคำศัพท์
2. quest/** — บทสนทนาเควสต์
3. event/** — คัตซีนและอีเวนต์
4. npc/** — บทสนทนา NPC
5. ไฟล์ที่เหลือ

กำหนดไฟล์โดยตรงได้ด้วย:

python Tools/next_batch.py --file common/text/animal_names_eng.csv

คำสั่งจะสร้าง Tools/current_batch.json ชั่วคราวและพิมพ์ rows สำหรับแปล จากนั้นบันทึกผลที่ผ่านการทบทวนเป็น Tools/answer.json ในรูปแบบ:

[
  {"key": "ROW_KEY", "th": "ข้อความภาษาไทย"}
]

ตรวจและนำคำแปลไปใช้

python Tools/precheck_batch.py
python Tools/apply_batch.py
python Tools/qa_check.py --phase 1

ห้ามข้าม precheck_batch.py เพราะใช้ตรวจ key ที่ขาด/เกิน, game-control tags, placeholder และความยาวบรรทัดก่อนแก้ CSV จริง

คลังศัพท์

Tools/glossary/index.json เป็น manifest ของคลังศัพท์ทั้งหมด โปรดใช้รูปสะกด canonical จาก category catalog และอ่าน Tools/glossary/continuity.md ก่อนแปล บทสนทนา

ตรวจคลังศัพท์ด้วย:

python -B -m unittest Tools/test_glossary_catalog.py
python Tools/glossary_catalog_check.py

คำสั่ง glossary_catalog_check.py จะสร้าง QA reports ใหม่ใน Tools/glossary; reports เหล่านี้ไม่ใช่ source of truth

ตรวจว่า GMD round-trip ได้โดยไม่เปลี่ยนข้อมูล

python Tools/gmd_repack.py --gmd gmd_out --trans csv_translate --out gmd_repacked --verify

--verify เป็น dry-run และไม่สร้างไฟล์ output

Repack คำแปลเป็น GMD

python Tools/gmd_repack.py --gmd gmd_out --trans csv_translate --out gmd_repacked

คัดลอกเนื้อหาจาก gmd_repacked ไปไว้ใต้ MHW Mods Release/ThaiLanguagePack/nativePC ก่อนสร้าง ZIP รุ่นใหม่ โฟลเดอร์ staging นี้ ถูกละเว้นจาก Git และไฟล์ ZIP จะเผยแพร่ผ่าน GitHub Releases

ตรวจความสดของไฟล์ build/deploy ด้วย:

python Tools/check_deploy_freshness.py --live "C:\Program Files (x86)\Steam\steamapps\common\Monster Hunter World\nativePC"

ระวัง: python Tools/init_translate_tree.py --force จะสร้าง csv_translate ใหม่จาก csv_out และ reset Tools/progress.json ใช้เฉพาะ เมื่อตั้งใจเริ่ม translation tree ใหม่เท่านั้น

การให้เครดิตและสิทธิ์ใช้งาน

• Monster Hunter: World และ Monster Hunter World: Iceborne เป็นทรัพย์สินของ CAPCOM
• MHW Font Util พัฒนาโดย Fexty12573 และเผยแพร่ภายใต้ MIT License ดูสำเนา license ที่ MHW Font Util Complied/LICENSE.txt
• ฟอนต์แต่ละชุดเป็นสิทธิ์ของเจ้าของฟอนต์เดิม โปรดตรวจสอบเงื่อนไขของฟอนต์ก่อน ดัดแปลงหรือแจกจ่าย
• repository นี้ยังไม่ได้กำหนด license รวมสำหรับคำแปลและไฟล์ส่วนอื่นอย่าง ชัดเจน การมี source อยู่บน GitHub ไม่ได้หมายความว่าอนุญาตให้นำไปใช้ต่อทุก รูปแบบโดยอัตโนมัติ