ปลั๊กอิน Minecraft BlueMap

🔌 เกี่ยวกับ BlueMap

BlueMap คือเครื่องมือทำแผนที่ Minecraft ที่อ่านไฟล์โลกของเซิร์ฟเวอร์และสร้างโมเดล 3 มิติพร้อมตัวดูเว็บแบบโต้ตอบได้ มันสามารถทำงานเป็นปลั๊กอินหรือม็อดของเซิร์ฟเวอร์ (ปลั๊กอิน Spigot/Paper หรือ Sponge, ม็อด Fabric/Forge) หรือเป็นตัวเรนเดอร์แบบ command-line แบบแยกเดี่ยว เมื่อติดตั้งบนเซิร์ฟเวอร์ที่กำลังทำงานอยู่ BlueMap จะเรนเดอร์แบบอะซิงโครนัส จึงไม่บล็อกเธรดหลักของเซิร์ฟเวอร์

🎯 จุดประสงค์

BlueMap มอบมุมมองโลก Minecraft แบบสามมิติที่เข้าถึงได้ผ่านเบราว์เซอร์ เพื่อให้ผู้ดูแลและผู้เล่นสำรวจภูมิประเทศ ค้นหาสิ่งก่อสร้าง และตรวจสอบสิ่งปลูกสร้างได้โดยไม่ต้องเข้าเซิร์ฟเวอร์ เหมาะสำหรับผู้ดูแลเซิร์ฟเวอร์ที่ต้องการแผนที่ภาพที่อัปเดตอยู่เสมอเพื่อใช้ในการดูแลระบบ การนำทาง หรือการแสดงผลงานของชุมชน

⚙️ ฟีเจอร์

• สร้างโมเดล 3 มิติของพื้นผิวโลกและแสดงผ่านตัวดูเว็บบนเบราว์เซอร์
• ทำงานเป็นปลั๊กอิน/ม็อด (Spigot/Paper, Sponge, Fabric, Forge) หรือเป็นเครื่องมือ CLI แบบแยกเดี่ยว
• เรนเดอร์แบบอะซิงโครนัสเพื่อหลีกเลี่ยงการบล็อกเธรดหลักของ Minecraft server
• รองรับ resource pack และ data pack เพื่อปรับแต่ง texture, block model และสี biome ที่ใช้ในการเรนเดอร์
• รองรับแบ็กเอนด์การจัดเก็บหลายแบบและการจัดการแผนที่ผ่านคำสั่ง (load, unload, list, delete ฯลฯ)
• รองรับ marker และ API ให้ปลั๊กอินภายนอกเพิ่มหรือจัดการ marker บนแผนที่ได้
• คำสั่ง reload ระหว่างทำงานและควบคุมการเรนเดอร์ (reload, เริ่ม/หยุดเรนเดอร์, update/purge แผนที่, freeze/unfreeze แผนที่)

🧩 เหมาะกับใคร

• เซิร์ฟเวอร์ Survival และ SMP ที่ต้องการแผนที่ 3 มิติแบบสาธารณะหรือสำหรับแอดมิน
• เซิร์ฟเวอร์ Creative หรือ showcase ที่ต้องการพรีวิวสิ่งก่อสร้างที่เข้าถึงได้จากเบราว์เซอร์
• ผู้ดูแลเซิร์ฟเวอร์ที่ต้องการเครื่องมือตรวจสอบระยะไกลและการนำทางบนแผนที่

🏗️ ตัวอย่างการใช้งาน

• ให้ผู้เล่นเข้าถึงแผนที่ 3 มิติของโลกที่โฮสต์แบบสาธารณะ เพื่อช่วยในการนำทางและโชว์ผลงานสร้าง
• แอดมินค้นหาและตรวจสอบฐานหรือ claim ของผู้เล่นจากตัวดูเว็บก่อนจะเข้าไปดูในเกม
• ปลั๊กอินใช้ API ของ BlueMap เพื่อแสดง marker แบบไดนามิกสำหรับอีเวนต์ ร้านค้า หรือจุดเทเลพอร์ต

⌨️ คำสั่ง

(คำสั่งทั้งหมดข้างต้นมีเอกสารอธิบายโดยโปรเจกต์แล้ว; โหนดสิทธิ์ที่แน่นอนมีอยู่ในเอกสารของโปรเจกต์และไม่ได้ย้ำไว้ที่นี่)

⚙️ การติดตั้ง

📥 การตั้งค่า

• ดาวน์โหลด BlueMap JAR ที่เหมาะกับแพลตฟอร์มของคุณ (JAR แบบปลั๊กอินสำหรับ Spigot/Paper/Sponge, JAR แบบม็อดสำหรับ Fabric/Forge หรือชุดแจกจ่าย CLI แบบแยกเดี่ยว)
• วาง JAR ลงในโฟลเดอร์ plugins/ ของเซิร์ฟเวอร์ (สำหรับ Spigot/Paper/Sponge) หรือโฟลเดอร์ mods/ (สำหรับ Fabric/Forge) หรือใช้ไฟล์จากชุดแจกจ่าย CLI สำหรับการเรนเดอร์แบบแยกเดี่ยว
• เริ่มต้นหรือรีสตาร์ตเซิร์ฟเวอร์ ตรวจสอบคอนโซลเซิร์ฟเวอร์เพื่อยืนยันว่า BlueMap และเว็บเซิร์ฟเวอร์ที่ฝังอยู่เริ่มทำงานสำเร็จแล้ว

📦 สิ่งที่ต้องมี

• ไม่จำเป็นต้องมีปลั๊กอินภายนอกแบบบังคับสำหรับการเรนเดอร์แผนที่หลัก มีอินทิเกรชันและแอดออนเสริมให้ใช้งานได้ โปรดดูเอกสารของโปรเจกต์สำหรับข้อมูลแอดออนจากภายนอก

🧠 หมายเหตุทางเทคนิค

• BlueMap แจกจ่ายในรูปแบบปลั๊กอินเซิร์ฟเวอร์ ม็อด และเครื่องมือ CLI ให้เลือกไฟล์ที่ตรงกับการตั้งค่าของคุณ
• การเรนเดอร์ทำงานแบบอะซิงโครนัสเพื่อหลีกเลี่ยงการบล็อกเธรดหลักของเซิร์ฟเวอร์
• สามารถวาง resource pack และ data pack ไว้ในไดเรกทอรีแพ็กที่ตั้งค่าไว้เพื่อเปลี่ยนหน้าตาของแผนที่
• โปรเจกต์มีที่เก็บซอร์สสาธารณะและบิลด์สำหรับรีลีส การตั้งค่าเป็นแบบไฟล์และสามารถโหลดใหม่ได้ระหว่าง runtime

🤝 ปลั๊กอินนี้เหมาะเมื่อใด

หากคุณต้องการมุมมองโลก Minecraft แบบสามมิติที่เปิดผ่านเบราว์เซอร์สำหรับการนำทาง การตรวจสอบสิ่งก่อสร้าง หรือการแสดงต่อชุมชน BlueMap จะมอบการเรนเดอร์อัตโนมัติ การควบคุมระหว่าง runtime และ API สำหรับ marker และการเชื่อมต่อระบบต่าง ๆ โดยไม่จำเป็นให้ผู้เล่นเข้าเซิร์ฟเวอร์