Gem TD — Browser Prototype

เกม Tower Defense แบบ maze เล่นบน browser ได้แรงบันดาลใจจากแมพ [BK's] Gem TD (Warcraft III, by Bryvx) ตัวเลขของ gem, สูตร special และ wave ทั้ง 50 เลเวลดึงมาจากไฟล์แมพ [BK's] Gem TD v7.9.w3x โดยตรง

สถานะ: prototype มีระบบหลักครบ แต่ยังไม่ได้ปรับ balance และยังไม่มี slate, damage test, race mode, extra chance และมินิเกมพนัน

วิธีเล่น

1. แต่ละรอบให้คลิกช่องว่างบนบอร์ดเพื่อวาง gem แบบสุ่ม 5 เม็ด ระบบจะไม่ให้วางในจุดที่ทำให้ทางเดินถูกปิด
2. เลือก gem 1 เม็ดจาก 5 เม็ดนั้น แล้วกดอย่างใดอย่างหนึ่ง:
   • Keep: เก็บไว้
   • Combine: รวม gem ชนิดเดียวกัน 2 เม็ดเพื่อขึ้นคุณภาพ 1 ขั้น หรือ 4 เม็ดเพื่อขึ้น 2 ขั้น
   • Special: ถ้ามีวัตถุดิบครบตามสูตร จะสร้าง special tower (ดูสูตรได้ในแผง "Special recipes")
3. Gem ที่เหลือจะกลายเป็นหินที่ใช้ทำ maze จากนั้น wave จะเริ่ม ครีปมา 10 ตัวและต้องเดินผ่านจุด S → 1 → 2 → 3 → 4 → 5 → M (Mine)
4. ใช้ทองที่ได้ไปเพิ่ม Gem quality ที่ Mine เพื่อให้สุ่มได้ gem คุณภาพสูงขึ้น หรืออัปเกรด special tower
5. คำสั่งเสริมที่มีในแมพต้นฉบับ:
   • Keep ↓ (Downgrade): เก็บ gem คุณภาพ Flawed ถึง Perfect โดยลดลง 1 ขั้น เหมาะกับตอนที่สูตร special ต้องใช้คุณภาพต่ำกว่า
   • Remove rock: คลิกหินแล้วกด Remove (หรือกด R) ฟรีและใช้ได้ตลอดเวลา
   • Slate: หินแผ่นแบนฝังพื้นที่ครีปเดินทับได้ จึงไม่ขวาง maze วิธีสร้างคือในช่วงเลือก gem ให้เลือก gem ระดับ Normal ที่มี gem Flawed คู่อยู่ใน 5 เม็ดของรอบนั้น แล้วกด Create slate มี slate พื้นฐาน 8 แบบ (Air, Slow, Hold, Opal Vein, Poison, Spell, Range, Damage) และเอา slate 2 แผ่นมารวมเป็น slate พิเศษได้ (Ancient, Wraith, Elder, Viper) แต่ละแผ่น Teleport ได้ 1 ครั้ง ดูสูตรได้ในหน้า Info แท็บ Slates
   • Swap (200g): tower ระดับสูงบางตัว เช่น Black Opal, Gold, Fire Star และ Lucky China Jade สลับที่กับ gem อื่นหรือหินได้ ครั้งเดียวต่อ tower และได้สิทธิ์ใหม่เมื่ออัปเกรด

Versus ออนไลน์ 2 คน

1. คนแรกกด Host game แล้วจะได้รหัสห้อง 5 ตัวอักษร จากนั้นส่งรหัสหรือกด Copy invite link แล้วส่งลิงก์ (?room=CODE) ให้เพื่อน
2. เพื่อนกรอกรหัสแล้วกด Join หรือเปิดลิงก์ เมื่อเชื่อมต่อได้แล้วเกมจะเริ่มใหม่ทั้งสองฝั่งพร้อมกัน
3. ทั้งสองคนได้ gem ลำดับเดียวกัน (ใช้ seed เดียวกัน) แต่เล่นบนบอร์ดของตัวเอง และเห็นบอร์ดของอีกฝ่ายเป็นภาพเล็กในแผงด้านข้าง
4. wave ของแต่ละเลเวลจะเริ่มเมื่อทั้งสองคนเลือก gem เสร็จแล้ว ใครอยู่รอดนานกว่าชนะ ถ้ารอดทั้งคู่จะเทียบเลเวล, lives และ kills ตามลำดับ
5. ระหว่างแข่งจะปิดการ pause และการเร่งความเร็ว เฉพาะ host ที่เปลี่ยนความยากหรือ restart ได้ ถ้าอีกฝ่ายหลุด จะเล่นต่อคนเดียวได้

เบื้องหลังใช้ PeerJS (WebRTC data channel) และใช้ signalling server สาธารณะของ PeerJS ไม่ต้องมี backend ของเราเอง จึงยัง deploy บน Vercel แบบ static ได้ ข้อจำกัดคือไม่มี TURN server ถ้าทั้งสองฝั่งอยู่หลัง NAT แบบเข้มงวด (เช่นเครือข่ายบริษัทบางแห่ง) อาจเชื่อมต่อไม่ได้

ปุ่มลัด: Space หยุด/เล่นต่อ · 1 2 4 เปลี่ยนความเร็ว · K Keep gem ที่เลือกอยู่ · Esc ยกเลิกการเลือก

พัฒนา

npm install
npm run dev        # http://localhost:5173
npm run build      # type-check + build ไปที่ dist/
npm run simulate -- 5 --smart --difficulty=easy   # ให้ bot เล่นแบบ headless เพื่อทดสอบ logic และ balance
npm run versus-test   # ทดสอบ logic ของ versus โดยต่อ 2 ฝั่งผ่าน channel ในหน่วยความจำ
npm run features-test # ทดสอบ Remove rock, Downgrade, Swap และ Slate
npm run render-smoke  # รัน renderer กับ canvas จำลอง เพื่อหา runtime error และค่า NaN
npm run determinism-test # seed เดียวกัน + action เดียวกัน = เกมเดียวกัน, replay, canPlace
npm run ai-test       # recorder, analyzer, tuner, การตรวจคำตอบของ LLM
npm run bot-golden -- --write=a.json / --check=a.json  # ยืนยันว่าการแก้โค้ดไม่เปลี่ยน action ของบอท

ต้องใช้ Node 18 ขึ้นไป

AI: ทดสอบ balance และจูนบอท

ผลทั้งหมดอยู่ใน sim-runs/ (ไม่อยู่ใน git) รันขนานทุก core

npm run batch -- --weights=w0 --seeds=200      # โหมด A: เล่น 200 เกม → รายงาน balance ใน sim-runs/batch/
npm run tune -- --rounds=20                    # จูนค่าน้ำหนัก (hill-climbing) → รายงานรายรอบใน sim-runs/tune/reports/
npm run tune -- --export-llm                   # สร้างคำขอให้ LLM ที่ sim-runs/tune/llm/request-rNNN.md
npm run tune -- --rounds=5 --import=answer.json  # เล่นข้อเสนอของ LLM (JSON) บน seed เดิม แล้วจูนต่อ
npm run tune -- --rounds=5 --try=my.json       # ลองค่าน้ำหนักที่ตั้งเอง

ดู AI เล่นในเบราว์เซอร์: npm run dev → Settings → AI auto-play (ใส่ id ของค่าน้ำหนักและ seed หรือโหลดไฟล์ JSON) หรือเปิดลิงก์ http://localhost:5173/?ai=w3&seed=37 ที่อยู่ในรายงาน batch ค่าน้ำหนักชุดเดียวกัน + seed เดียวกัน จะได้เกมเดียวกับใน batch ทุก action ระหว่าง AI เล่น คลิกได้แค่เลือกดู tower ปุ่มความเร็วมี 1/4/8/16x

--weights= รับ w0, smart, id ที่บันทึกไว้ใน sim-runs/weights/ หรือ path ของไฟล์ JSON (ใส่แค่ค่าที่ต้องการเปลี่ยนก็พอ) ค่าน้ำหนักทั้งหมดพร้อมขอบเขตและคำอธิบายอยู่ใน src/ai/weights.ts

Deploy บน Vercel

repo นี้มี vercel.json ตั้งค่าไว้แล้ว (framework Vite, output dist):

1. ไปที่ vercel.com → Add New Project → import repo artnonnan/gemtd
2. กด Deploy โดยไม่ต้องตั้งค่าเพิ่ม หลังจากนั้นทุกครั้งที่ push ขึ้น main ระบบจะ deploy ให้อัตโนมัติ

หรือ deploy ผ่าน CLI ด้วย npx vercel --prod

This is the beginning of the README. Read the rest at the original. Read the full README ↗