ปลั๊กอิน Minecraft TitleManager

🔌 เกี่ยวกับ TitleManager

TitleManager คือปลั๊กอิน Minecraft ที่จัดการองค์ประกอบการแสดงผลที่ผู้เล่นเห็น: titles และ subtitles แบบเคลื่อนไหวตรงกลางหน้าจอ, actionbar, header และ footer ของ tab-list แบบเคลื่อนไหว และ sidebar scoreboard ที่ปรับแต่งได้ มันทำหน้าที่เป็นชั้นการนำเสนอสำหรับเซิร์ฟเวอร์ที่ต้องการข้อความตอนเข้าเซิร์ฟเวอร์, ประกาศ และการแสดง tab/scoreboard แบบสดที่ดูเรียบร้อยขึ้น

🎯 จุดประสงค์

ปลั๊กอินนี้รวมฟีเจอร์การแสดงผล (titles, actionbar, tab-list, sidebars) ไว้ที่เดียว เพื่อให้เจ้าของเซิร์ฟเวอร์สามารถแสดงข้อมูลที่สอดคล้อง มีอนิเมชัน และใช้ placeholder ให้ผู้เล่นได้โดยไม่ต้องเขียนโค้ดเอง เหมาะสำหรับผู้ดูแลเซิร์ฟเวอร์ที่ต้องการจัดการข้อความ join/welcome, ประกาศหมุนเวียน และ UI TAB/scoreboard แบบไดนามิก

⚙️ ฟีเจอร์

• titles และ actionbar สำหรับ join และ first join ที่ปรับแต่งได้ พร้อมตัวเลือกเวลาและรูปแบบต่าง ๆ
• header และ footer ของ tab-list แบบเคลื่อนไหวและรองรับ gradient พร้อม placeholder สำหรับจำนวนผู้เล่นออนไลน์ เวลาโลก/เซิร์ฟเวอร์ และค่าดynamicอื่น ๆ
• sidebar scoreboard ที่ปรับแต่งได้ สูงสุด 15 บรรทัดแบบเคลื่อนไหว รองรับโดยระบบ scoreboard ของเซิร์ฟเวอร์
• broadcast และประกาศตามกำหนดเวลาที่ส่งออกเป็น titles หรือ actionbar
• เอ็นจินอนิเมชันพร้อมไฟล์อนิเมชันที่นำกลับมาใช้ได้และพรีวิว (animation playground มีอยู่ในเอกสารทางการ)
• การผสาน placeholder (placeholder ที่มีใน TitleManager และรองรับระบบ placeholder ภายนอกเมื่อมี)
• transactional reloads: การรีโหลดคอนฟิกจะถูกนำไปใช้อย่างปลอดภัยและสามารถย้อนกลับได้หาก config ใหม่ไม่ถูกต้อง
• API ขนาดเล็กสำหรับนักพัฒนาเพื่อการผสานแบบเลือกใช้และการใช้งานระหว่างปลั๊กอิน

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

• เซิร์ฟเวอร์ Survival และ SMP ที่ต้องการ UI สำหรับ join/announcement ที่ดูเรียบร้อยขึ้น
• เซิร์ฟเวอร์ที่ใช้ placeholder และการผสานกับภายนอก (สำหรับค่าที่เปลี่ยนแปลงได้ในส่วนแสดงผล)
• ผู้ดูแลที่ต้องการการแสดง tab และ scoreboard แบบเคลื่อนไหวโดยไม่ต้องเขียนปลั๊กอินเอง
• นักพัฒนาที่ต้องการผสานฟีเจอร์การนำเสนอเข้าไปในปลั๊กอินอื่นผ่าน API ที่มีให้

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

• แสดง title ต้อนรับและ actionbar แบบเคลื่อนไหวเมื่อผู้เล่นเข้าเซิร์ฟเวอร์ พร้อมข้อความต่างกันใน first join
• ทำให้รายชื่อผู้เล่นใน tab มีชีวิตชีวาโดยแสดงเวลาเซิร์ฟเวอร์ จำนวนผู้เล่นออนไลน์ และ header/footer แบบ gradient
• สลับ titles หรือ actionbar ประกาศแบบเคลื่อนไหวตามตารางเวลาเพื่อสื่อสารเรื่องอีเวนต์หรือกฎ
• ใช้ sidebar scoreboard เพื่อแสดง leaderboard, สถิติ หรือข้อมูลเซิร์ฟเวอร์แบบไดนามิก

⌨️ คำสั่ง

หมายเหตุ: คำสั่งข้างต้นมีการอธิบายไว้ในเอกสารของโปรเจกต์ ส่วน permission nodes เฉพาะไม่ได้ระบุไว้ในแหล่งที่ใช้ที่นี่ และควรตรวจสอบในเอกสารของปลั๊กอินเพื่อดู node และค่าเริ่มต้นที่แน่ชัด

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

📥 การตั้งค่า

• ดาวน์โหลดไฟล์ JAR ของปลั๊กอินจาก release ของโปรเจกต์หรือหน้าทรัพยากรของปลั๊กอิน
• วาง JAR ลงในไดเรกทอรี plugins/ ของเซิร์ฟเวอร์
• รีสตาร์ทเซิร์ฟเวอร์
• แก้ไขไฟล์ config ที่สร้างขึ้นใน plugins/TitleManager/ เพื่อปรับแต่ง titles, animations และการตั้งค่า player-list
• ใช้ /tm reload เพื่อใช้การเปลี่ยนแปลงคอนฟิก; ปลั๊กอินจะทำ reload แบบ transactional เพื่อหลีกเลี่ยงการนำ config ที่เสียหายไปใช้

📦 การพึ่งพา

• PlaceholderAPI (การผสานแบบเลือกใช้สำหรับ placeholder ภายนอก)
• Vault (เลือกใช้ได้, ใช้สำหรับค่า placeholder เมื่อมี)
• BungeeCord (พฤติกรรมที่คำนึงถึงการผสานเมื่อใช้ใน proxy setups)

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

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

• เป้าหมาย runtime อย่างเป็นทางการรวม Minecraft 1.8 ถึง 1.21.x (เอกสารของโปรเจกต์อ้างถึงการรองรับแบบชัดเจนถึง 1.21.11) พฤติกรรมจะแตกต่างตามเวอร์ชันเซิร์ฟเวอร์: Minecraft เวอร์ชันใหม่ใช้ Bukkit/Paper API แบบ modern ขณะที่เวอร์ชันเก่าพึ่งพาโมดูลความเข้ากันได้แยกตามเวอร์ชัน
• TitleManager มี API ขนาดเล็กสำหรับ Bukkit เพื่อการผสานแบบเลือกใช้ และมีเอกสาร API ที่สร้างอัตโนมัติ
• มีคำสั่ง safe reload และ diagnostics เพื่อช่วยแก้ปัญหาคอนฟิกและ runtime

🤝 เมื่อใดปลั๊กอินนี้มีประโยชน์

หากคุณต้องการการควบคุมการนำเสนอแบบรวมศูนย์ มีอนิเมชัน และใช้ placeholder (titles, actionbar, tab-list และ sidebars) ที่จัดการจากคอนฟิกแทนการเขียนโค้ดเฉพาะ TitleManager ก็มีปลั๊กอินและ API ที่มีเอกสารรองรับเพื่อส่งมอบ UI เหล่านี้อย่างสม่ำเสมอในสภาพแวดล้อมเซิร์ฟเวอร์ของคุณ.