เซิร์ฟเวอร์ Minecraft ที่มีปลั๊กอิน FancyHolograms

## 🔌 เกี่ยวกับ FancyHolograms FancyHolograms คือปลั๊กอิน Minecraft สำหรับเซิร์ฟเวอร์ Paper และ Folia ที่ใช้ display entities ของเกม (text/item/block displays) และการจัดการ packet เพื่อสร้างโฮโลแกรมสมัยใหม่ที่ปรับแต่งได้ โปรเจกต์นี้เผยแพร่ภายใต้สัญญาอนุญาต MIT และดูแลอยู่ในระบบนิเวศ FancyMcPlugins / FancyInnovations ## 🎯 จุดประสงค์ ปลั๊กอินนี้ช่วยให้ผู้ดูแลเซิร์ฟเวอร์สามารถวางโฮโลแกรมที่อ่านง่ายและตกแต่งสวยงามในโลกได้ — ไม่ว่าจะเป็นบรรทัดข้อความ ภาพไอเทม หรือภาพบล็อก — พร้อมตัวเลือกการจัดรูปแบบและการวางตำแหน่งขั้นสูง เหมาะสำหรับเซิร์ฟเวอร์ที่ต้องการ display แบบลอยที่สวยงามและประสิทธิภาพดี (สำหรับการตกแต่ง ป้ายข้อมูล ป้ายชื่อ NPC ภาพร้านค้า ฯลฯ) และออกแบบมาให้ทำงานบน Paper และซอฟต์แวร์เซิร์ฟเวอร์ที่ต่อยอดจาก Paper ## ⚙️ คุณสมบัติ - ประเภทโฮโลแกรม: text, item และ block displays. - ควบคุมตำแหน่ง การหมุน และขนาดได้เต็มที่. - จัดรูปแบบข้อความด้วย MiniMessage (สี ไล่ระดับ และรูปแบบต่าง ๆ ที่รองรับ). - การจัดแนวข้อความ สีพื้นหลัง และตัวเลือกเงา. - โหมด billboard (fixed, center, horizontal, vertical) สำหรับพฤติกรรมหันเข้าหากล้อง. - รองรับ placeholder ผ่าน PlaceholderAPI และ MiniPlaceholders. - ผสานกับ FancyNpcs สำหรับโฮโลแกรมที่เชื่อมกับ NPC. - สร้างด้วยคำสั่งและแก้ไขโฮโลแกรมในเกมได้. ## 🧩 เหมาะสำหรับใคร - เจ้าของและแอดมินเซิร์ฟเวอร์ที่ใช้ Paper หรือ Folia และต้องการ display แบบลอยเพื่อการตกแต่งหรือข้อมูล. - เซิร์ฟเวอร์ Survival, SMP, minigame และ RPG ที่ใช้โฮโลแกรมสำหรับป้ายกำกับ คำแนะนำ หรือแสดงร้านค้า. - เซิร์ฟเวอร์ที่ใช้ PlaceholderAPI หรือ FancyNpcs และต้องการเนื้อหาโฮโลแกรมแบบผสานรวม. ## 🏗️ ตัวอย่างการใช้งาน - สร้างโฮโลแกรมข้อมูลหลายบรรทัดในพื้นที่ spawn โดยใช้การจัดรูปแบบ MiniMessage. - ติดโฮโลแกรมแบบ item-display ไว้เหนือหีบร้านค้าเพื่อดูตัวอย่างสินค้า. - ใช้การผสานกับ FancyNpcs เพื่อแสดง nameplate แบบไดนามิกหรือข้อความสถานะสำหรับ NPC. ## ⌨️ คำสั่ง | **คำสั่ง** | **คำอธิบาย** | **สิทธิ์** | **การเข้าถึง** | |---|---|---|---| | `/fancyholograms version` | แสดงเวอร์ชันปลั๊กอินปัจจุบัน. | `FancyHolograms.admin` | Admin | | `/hologram create text <name>` | สร้างโฮโลแกรมข้อความใหม่ด้วยชื่อที่กำหนด. | ไม่ระบุ | Admin | | `/hologram edit <name> addLine <text>` | เพิ่มบรรทัดข้อความใหม่ลงในโฮโลแกรมที่มีอยู่. | ไม่ระบุ | Admin | | `/hologram edit <name> setLine <index> <text>` | ตั้งข้อความของบรรทัดที่ระบุ. | ไม่ระบุ | Admin | | `/hologram edit <name> background <color>` | ตั้งค่าสีพื้นหลังของโฮโลแกรม. | ไม่ระบุ | Admin | | `/hologram moveHere <name>` | ย้ายโฮโลแกรมที่มีชื่อนั้นไปยังตำแหน่งปัจจุบันของคุณ. | ไม่ระบุ | Admin | หมายเหตุ: ตัวอย่างการสร้าง/แก้ไขข้างต้นนำมาจากตัวอย่างในเอกสารอย่างเป็นทางการ มีเพียง node คำสั่ง `version` เท่านั้นที่ถูกระบุไว้ชัดเจนในเอกสารอ้างอิงต้นทาง ## 🔐 สิทธิ์ | **สิทธิ์** | **คำอธิบาย** | **ค่าเริ่มต้น** | |---|---|---| | `FancyHolograms.admin` | สิทธิ์ผู้ดูแลทั่วไป (ใช้สำหรับคำสั่ง version ในเอกสาร). | ไม่ระบุ | ## ⚙️ การติดตั้ง ### 📥 การตั้งค่า - ดาวน์โหลดไฟล์ปลั๊กอินทางการจากแหล่งแจกจ่ายอย่างเป็นทางการ (Modrinth / รุ่นทางการ). - วางไฟล์ `.jar` ของปลั๊กอินลงในไดเรกทอรี `plugins/` ของเซิร์ฟเวอร์. - รีสตาร์ตเซิร์ฟเวอร์และตรวจสอบ log ของคอนโซลเพื่อให้แน่ใจว่าปลั๊กอินโหลดสำเร็จ. - ใช้ `/fancyholograms version` เพื่อตรวจสอบเวอร์ชันที่ติดตั้ง. ### 📦 การพึ่งพา - การผสานที่ยืนยันแล้ว: PlaceholderAPI (ไม่บังคับ), MiniPlaceholders (ไม่บังคับ), FancyNpcs (ไม่บังคับ) ซึ่งระบุเป็นการผสาน ไม่ใช่การพึ่งพาหลักที่จำเป็น. ### 🧾 การตั้งค่า - ปลั๊กอินนี้รองรับการสร้างและแก้ไขผ่านคำสั่ง ผู้ดูแลเซิร์ฟเวอร์ควรอ่านเอกสารทางการเพื่อดูตัวเลือกการตั้งค่าและไฟล์ถาวรที่มีอยู่. ## 🧠 หมายเหตุทางเทคนิค - ซอฟต์แวร์เซิร์ฟเวอร์ที่รองรับ: Paper และ Folia (รวมถึง fork ของ Paper). - ใช้ Minecraft display entities (text/item/block displays) และ packet สำหรับการเรนเดอร์. - ได้รับอนุญาตภายใต้ MIT. ## 🤝 ปลั๊กอินนี้เหมาะเมื่อใด หากคุณต้องการโฮโลแกรมสมัยใหม่ที่อิง display entities สำหรับการตกแต่ง การแสดงข้อมูล หรือป้ายชื่อ NPC บนเซิร์ฟเวอร์ตระกูล Paper — พร้อมการผสาน MiniMessage และ PlaceholderAPI — FancyHolograms ก็เป็นโซลูชันที่ปรับแต่งได้และได้รับการดูแลอยู่

ปลั๊กอิน