คู่มือการใช้งาน

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

1. กด เข้าสู่ระบบด้วย Google ที่มุมขวาบน
2. กรอก ชื่อ Xbox ในหน้าโปรไฟล์ แล้วกดบันทึก
3. ไปที่แท็บ ส่งงานใหม่ เลือกหมวดหมู่ ตั้งชื่อ แนบไฟล์ แล้วกด ส่งงาน
4. ดูสถานะในแท็บ งานของฉัน — แอดมินจะตรวจและรวมแพ็คให้
5. เมื่อแพ็คใหม่ขึ้นเซิร์ฟ เข้าเกม ของจะอยู่ในกระเป๋า

ชื่อ Xbox และบัญชี

• ชื่อ Xbox ต้องตรงกับในเกม (ไม่สนตัวพิมพ์เล็ก/ใหญ่) ระบบใช้ชื่อนี้แจกของเข้ากระเป๋า และให้เมนูตู้เสื้อผ้าแสดงเฉพาะของของคุณ
• 1 คนใช้ได้ 1 บัญชี และชื่อ Xbox หนึ่งชื่อผูกได้บัญชีเดียว ถ้ามีคนเอาชื่อคุณไปใช้ ติดต่อแอดมิน
• หลังมีงานที่อนุมัติแล้ว จะเปลี่ยนชื่อ Xbox เองไม่ได้ — ต้องให้แอดมินเปลี่ยน เพื่อไม่ให้ของไปเข้าผิดคน
• LINE ID และ Discord ไม่บังคับ แต่ช่วยให้แอดมินติดต่อได้เวลางานต้องแก้

เตรียมไฟล์

เว็บรับไฟล์ที่ออกมาจาก Blockbench ได้ตรงๆ

• รูปสกิน (.png) — 64×64 ปกติ หรือ HD 128 / 256 / 512 / 1024 ให้เป็นสี่เหลี่ยมจัตุรัส ระบบเก็บพิกเซลตามต้นฉบับ
• โมเดล (.geo.json) — Blockbench: File → Export → Export Bedrock Geometry
• อนิเมชัน (.animation.json) — Blockbench แท็บ Animate: Animation → Export Animations
• หรือส่ง .bbmodel ไฟล์เดียว — มีทั้งโมเดลและอนิเมชันในตัว ไม่ต้องแยกไฟล์
• เท็กซ์เจอร์ (.png) — ขนาดควรตรงกับ texture_width / texture_height ในโมเดล และเป็นเลขยกกำลัง 2 (16, 32, 64, 128…)
• ไอคอน (.png) — ไม่บังคับ แนะนำ 16×16 หรือ 32×32 ถ้าไม่ใส่ระบบใช้รูปสกิน/เท็กซ์เจอร์แทน

หัว

ใส่ในช่องหมวก จึงใส่คู่กับชุดได้พร้อมกัน ระบบใช้เฉพาะส่วนหัวจากรูปสกิน

• แนบรูปสกินที่วาดหัวไว้ (ส่วนอื่นเว้นว่างได้)
• มีผมหรือหู 3D ให้แนบโมเดลเพิ่ม bone ที่ชื่อ head จะติดกับหัวผู้เล่นให้เอง
• มีอนิเมชัน (เช่น หูกระดิก) ให้แนบไฟล์อนิเมชัน จะเล่นเองตลอดเวลาที่สวมใส่

ชุด / หน้าตาผู้เล่น

เปลี่ยนลำตัว แขน และขา ใส่ในช่องเสื้อ

• แบบแขน — Steve (กว้าง 4 พิกเซล) หรือ Alex (3 พิกเซล) เลือกให้ตรงกับที่วาด ไม่งั้นลายแขนจะเหลื่อม
• รวมหัวด้วย — ติ๊กถ้าเป็นชุดเต็มตัว ชุดแบบนี้ใส่คู่กับหัวแยกไม่ได้เพราะหัวจะซ้อนกัน
• เอว S — ทำให้ลำตัวคอดแบบ 3D ใช้ลายจากรูปสกินเดิม ต้องแนบโมเดลผู้เล่นที่มีเมชเอว S เลือก "ตามโมเดลที่ส่งมา" เพื่อใช้ทรงตามต้นฉบับ หรือเลือกคอดเพิ่ม
• หน้าอก 3D — เล็ก / กลาง / ใหญ่ ใช้ลายเสื้อจากรูปสกินเดิม
• หน้าอกฟิสิกส์ — นุ่ม / ปกติ / เด้งมาก ใช้ได้เมื่อเปิดหน้าอก 3D

โมเดลสวมใส่

หมวก ปีก หาง กระเป๋า แว่น — ติดกับตัวผู้เล่น

• ใส่ในช่องเกราะ — เลือกช่อง (หมวก/เสื้อ/กางเกง/รองเท้า) และส่วนที่ให้ติด ช่องหนึ่งใส่ได้ชิ้นเดียว ถ้าเลือกช่องเสื้อ จะใส่พร้อมชุดไม่ได้
• ประกอบติดตัว — ไม่กินช่องเกราะ ใส่พร้อมชุดได้ เปิด/ปิดผ่านเมนูตู้เสื้อผ้า เหมาะกับปีก หาง กระเป๋า
• ตั้งชื่อ bone ในโมเดลเป็น head, body, rightArm, leftArm, rightLeg, leftLeg เพื่อให้ขยับตามส่วนนั้นของผู้เล่น

ไอเทมถือ

ของที่แสดงเป็น 3D ในมือ ติ๊ก "ใช้เป็นอาวุธ" ถ้าต้องการตีได้และกำหนดดาเมจ

• สร้างโมเดลโดยให้ด้ามจับอยู่ใกล้จุด 0,0,0 ของ Blockbench
• ถ้าในเกมเอียงหรือลอย เปิด ขั้นสูง แล้วปรับตำแหน่ง/มุม แยกบุคคลที่ 1 (มุมมองตัวเอง) และบุคคลที่ 3 (คนอื่นเห็น)

ไอเทมกิน

กดค้างเพื่อกิน ตั้งค่าความหิวที่ฟื้น ความอิ่ม เวลากิน และกินได้แม้ไม่หิว ถ้าแนบโมเดล จะแสดงเป็น 3D ตอนถือ

โมเดลมีอนิเมชัน

โมเดลที่ขยับเองเมื่อสวมใส่หรือถือ เช่น ออร่าหมุน ปีกกระพือ

• ต้องมีไฟล์อนิเมชัน หรือ .bbmodel ที่มีอนิเมชัน
• ทุกคลิปในไฟล์จะเล่นพร้อมกันและวนซ้ำ ตั้งค่า Loop ใน Blockbench ให้เรียบร้อย
• คลิปชื่อ walk, run, sprint, move ถูกข้าม เพราะจะซ้อนกับท่าเดินของเกม

สถานะงาน

• รอตรวจ แอดมินยังไม่ได้ดู แก้ไขหรืออัปไฟล์ใหม่ได้
• อนุมัติ · อยู่ในแพ็ค จะอยู่ในแพ็คทุกครั้งที่รวม จนกว่าคุณจะถอนงาน
• ต้องแก้ไข ระบบเจอบัคในไฟล์ของคุณตอนรวมแพ็ค อ่านข้อความสีแดง แก้ไฟล์ แล้วกด "แก้ไข / อัปไฟล์ใหม่" งานจะกลับไปรอตรวจ
• ถูกปฏิเสธ ดูหมายเหตุจากแอดมิน งานนี้ไม่นับโควต้าแล้ว

โควต้าคือจำนวนงานที่ส่งได้พร้อมกันต่อหมวด (เช่น หัว 2 ชุด 2) งานที่ถอนหรือถูกปฏิเสธจะคืนโควต้า

ใช้ในเกม

1. เข้าเซิร์ฟด้วยชื่อ Xbox ที่ลงทะเบียน ของจะเข้ากระเป๋าครั้งเดียวต่อชิ้น (กระเป๋าเต็มจะตกที่เท้า)
2. คลิกขวา (หรือกดค้างบนมือถือ) ที่ไอคอน ตู้เสื้อผ้า → เลือกหมวด → เลือกชิ้นเพื่อใส่ กดซ้ำเพื่อถอด
3. ของที่ใส่อยู่จะมีเครื่องหมาย ✔ ในเมนู

แก้ปัญหา

• ไม่ได้ของ — เช็คว่าชื่อ Xbox ในโปรไฟล์ตรงกับในเกม และงานมีสถานะ "อนุมัติ" และแพ็คเวอร์ชันล่าสุดขึ้นเซิร์ฟแล้ว
• รูปเป็นสีม่วง-ดำ — หาเท็กซ์เจอร์ไม่เจอ หรือขนาดรูปไม่ตรงกับโมเดล
• โมเดลหาย/มองไม่เห็น — มักเกิดจาก bone ในอนิเมชันไม่มีในโมเดล หรือโมเดลอยู่ไกลจุด 0,0,0 มาก
• ลายแขนเหลื่อม — เลือกแบบแขน Steve/Alex ไม่ตรงกับที่วาด
• ใส่หัวแล้วชุดหลุด — สองชิ้นใช้ช่องเกราะเดียวกัน ให้หัวอยู่ช่องหมวก ชุดอยู่ช่องเสื้อ

สำหรับแอดมิน

1. หน้า หลังบ้าน → งานที่ส่ง ตรวจงาน กด อนุมัติ / ให้แก้ไข / ปฏิเสธ ใส่หมายเหตุถึงผู้ส่งได้
2. หน้า รวมแอดออน กดปุ่มเดียว ระบบรวมทุกชิ้นที่อนุมัติ ตรวจบัค แก้อัตโนมัติ และแยกชิ้นที่พังออกเอง
3. ดาวน์โหลด .mcaddon แล้วอัปขึ้นเซิร์ฟ UUID ของแพ็คคงที่ทุกครั้ง และเวอร์ชันขึ้นเอง จึงวางทับแพ็คเดิมได้เลย ของในกระเป๋าผู้เล่นไม่หาย
4. หน้า ผู้ใช้และโควต้า ตั้งโควต้ารายคน อนุมัติบัญชี ระงับบัญชี แก้ชื่อ Xbox และส่งออกรายชื่อเป็น CSV
5. ให้แท็ก /tag @s add mochi_admin ในเกม เพื่อเห็นของทุกชิ้นในเมนูตู้เสื้อผ้า

การติดตั้งเซิร์ฟเวอร์ (โดเมน, Node.js, SSL, Google Login) ดูในไฟล์ DEPLOY.md