ปลั๊กอิน Minecraft PlaceholderAPI

🔌 เกี่ยวกับ PlaceholderAPI

PlaceholderAPI เป็นปลั๊กอิน Minecraft ที่มอบระบบ placeholder แบบรวมศูนย์และระบบนิเวศของส่วนขยาย (eCloud) มันช่วยให้ปลั๊กอินอื่น ๆ อ่านและแทนที่ placeholder แบบไดนามิกนับพันรายการ (ข้อมูลผู้เล่น ค่าทางเศรษฐกิจ ค่าที่เฉพาะเจาะจงกับปลั๊กอิน ฯลฯ) ได้โดยไม่ต้องผสานการทำงานโดยตรงหรือพึ่งพาแบบแนบแน่น

🎯 จุดประสงค์

ปลั๊กอินนี้ช่วยลดความยุ่งยากในการเชื่อมต่อระหว่างปลั๊กอินด้วยการมอบ API สำหรับ placeholder เพียงชุดเดียวที่ขยายต่อได้ ผู้พัฒนาปลั๊กอินจะเผยแพร่ "expansions" ที่ให้ placeholder แบบมีชื่อ; ผู้ดูแลเซิร์ฟเวอร์จะติดตั้ง expansions เหล่านี้เพื่อให้ปลั๊กอินฝั่งเซิร์ฟเวอร์ (scoreboards, chat, holograms, GUI) แสดงข้อมูลสดได้ด้วยไวยากรณ์ที่สอดคล้องกัน

⚙️ ฟีเจอร์

• API หลักสำหรับการแยกวิเคราะห์ placeholder เพื่อให้ปลั๊กอินอื่นเชื่อมต่อได้
• ระบบ expansions: expansions แบบแพ็กแยกหรือ expansions ที่ถูกรวมอยู่ในปลั๊กอิน
• eCloud (cloud ของ expansions) สำหรับค้นหาและดาวน์โหลด expansions ที่ได้รับการยืนยันในเกม
• คำสั่งจัดการระหว่างรันไทม์สำหรับแสดงรายการ ลงทะเบียน ยกเลิกการลงทะเบียน และโหลด expansions ใหม่
• คำสั่ง debug/parse สำหรับประเมิน placeholder ของผู้เล่นหรือกระจายผลลัพธ์ ซึ่งมีประโยชน์ต่อการแก้ไขปัญหา
• เครื่องมืออย่างคำสั่ง dump สำหรับแชร์ expansions ที่ติดตั้งและสถานะปลั๊กอินเมื่อขอความช่วยเหลือ

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

• ผู้ดูแลเซิร์ฟเวอร์ที่ต้องการข้อความแบบไดนามิกที่เป็นหนึ่งเดียวในหลายปลั๊กอิน (scoreboards, tablists, holograms, GUI)
• ผู้พัฒนาปลั๊กอินที่ต้องการเปิดเผยหรือใช้ placeholders โดยไม่บังคับพึ่งพาแบบแนบแน่น
• เซิร์ฟเวอร์ Survival, minigame และ network ที่รวมปลั๊กอินจำนวนมากและต้องใช้ไวยากรณ์ placeholder ที่สอดคล้องกัน

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

• เซิร์ฟเวอร์ติดตั้ง Vault expansion เพื่อให้ placeholder ทางเศรษฐกิจ เช่น ยอดเงินของผู้เล่น สามารถใช้ในปลั๊กอิน scoreboard และ chat ได้
• ผู้ดูแลดาวน์โหลด expansion เฉพาะปลั๊กอินจาก eCloud เพื่อให้ปลั๊กอิน hologram แสดงข้อมูลเป้าหมายแบบสดได้
• ผู้พัฒนาเปิดเผยข้อมูลปลั๊กอินผ่าน PlaceholderExpansion เพื่อให้เซิร์ฟเวอร์อื่นแสดงข้อมูลนั้นได้โดยไม่ต้องพึ่งพาปลั๊กอินโดยตรง

⌨️ คำสั่ง

(หมายเหตุ: คำสั่งข้างต้นมีเอกสารอ้างอิงอยู่ในคำสั่งอย่างเป็นทางการของ PlaceholderAPI ส่วน permission nodes สำหรับคำสั่งแต่ละรายการไม่ได้ระบุไว้ในเอกสารอ้างอิงดังกล่าว)

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

📥 การตั้งค่า

• ดาวน์โหลดไฟล์ jar อย่างเป็นทางการของ PlaceholderAPI แล้ววางไว้ในไดเรกทอรี plugins/ ของเซิร์ฟเวอร์
• เริ่มหรือรีสตาร์ตเซิร์ฟเวอร์และตรวจสอบในคอนโซลว่า PlaceholderAPI โหลดแล้ว
• ติดตั้ง expansions โดยวางไฟล์ jar ของ expansion ลงใน plugins/PlaceholderAPI/expansions/ หรือใช้คำสั่ง eCloud ในเกม (สำหรับ expansions ที่ได้รับการยืนยัน)

📦 การพึ่งพา

• ตัว PlaceholderAPI เองไม่จำเป็นต้องมีปลั๊กอินพึ่งพาทั่วไปเพื่อใช้งานได้ ส่วน placeholder บางรายการที่มาจาก expansions จะพึ่งพาปลั๊กอินอื่น (เช่น expansion ที่แสดงค่าทางเศรษฐกิจจะต้องใช้ปลั๊กอินเศรษฐกิจที่เกี่ยวข้อง) ข้อกำหนดเหล่านี้ขึ้นอยู่กับ expansion เฉพาะนั้น

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

• PlaceholderAPI มีให้สำหรับเซิร์ฟเวอร์ที่ใช้ Spigot และมักใช้งานบน Paper ด้วยเช่นกัน มันเปิด API ให้ผู้พัฒนาปลั๊กอินลงทะเบียน PlaceholderExpansions
• expansions สามารถแจกจ่ายเป็นไฟล์ jar แบบแยกเดี่ยวหรือรวมอยู่ในปลั๊กอินอื่นได้; expansions แบบแยกเดี่ยวมักติดตั้งไว้ใน plugins/PlaceholderAPI/expansions/
• ฟีเจอร์ eCloud อนุญาตให้ค้นหาและดาวน์โหลด expansions ที่ได้รับการยืนยันในเกมได้; เซิร์ฟเวอร์ต้องอนุญาต HTTPS ขาออกเพื่อให้การดาวน์โหลดจาก eCloud ทำงานได้
• ปลั๊กอินมีคำสั่ง debug และ parsing เพื่อช่วยผู้ดูแลตรวจสอบว่า placeholder ถูกประมวลผลอย่างถูกต้อง

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

หากเซิร์ฟเวอร์ของคุณใช้ปลั๊กอินหลายตัวที่ต้องแสดงข้อมูลแบบไดนามิกข้ามปลั๊กอิน (chat, tab, holograms, scoreboards หรือ GUI) PlaceholderAPI จะมีประโยชน์เพราะมันรวมการแก้ placeholder ไว้ศูนย์กลาง และให้คุณเพิ่มการรองรับปลั๊กอินอื่นผ่าน expansions แบบโมดูลาร์โดยไม่ต้องแก้ไขปลั๊กอินผู้ใช้แต่ละตัว