Plugin Minecraft PlaceholderAPI

🔌 Giới thiệu về PlaceholderAPI

PlaceholderAPI là một plugin Minecraft cung cấp một hệ thống placeholder tập trung và một hệ sinh thái mở rộng (eCloud). Nó cho phép các plugin khác đọc và thay thế hàng nghìn placeholder động (dữ liệu người chơi, giá trị kinh tế, giá trị riêng của plugin, v.v.) mà không cần tích hợp trực tiếp hay phụ thuộc chặt chẽ.

🎯 Mục đích

Plugin này giải quyết sự khó khăn khi tích hợp giữa các plugin bằng cách cung cấp một API placeholder duy nhất, có thể mở rộng. Tác giả plugin phát hành các "expansions" cung cấp placeholder có tên; quản trị viên máy chủ cài các expansions đó để các plugin hiển thị dữ liệu máy chủ (scoreboard, chat, holograms, GUI) có thể hiển thị dữ liệu trực tiếp bằng cú pháp nhất quán.

⚙️ Tính năng

• API phân tích placeholder cốt lõi để các plugin khác có thể hook vào.
• Hệ thống expansions: expansions đóng gói riêng hoặc expansions đi kèm trong plugin.
• eCloud (đám mây expansions) để tìm và tải các expansions đã được xác minh ngay trong game.
• Các lệnh quản lý khi đang chạy để liệt kê, đăng ký, hủy đăng ký và tải lại expansions.
• Các lệnh debug/parse để đánh giá placeholder cho một người chơi hoặc phát kết quả, hữu ích khi khắc phục sự cố.
• Các tiện ích như lệnh dump để chia sẻ expansions đã cài và trạng thái plugin khi cần hỗ trợ.

🧩 Dành cho ai

• Quản trị viên máy chủ cần văn bản động thống nhất trên nhiều plugin (scoreboard, tablist, holograms, GUI).
• Nhà phát triển plugin muốn hiển thị hoặc sử dụng placeholders mà không bắt buộc phụ thuộc chặt chẽ.
• Các máy chủ Survival, minigame và network kết hợp nhiều plugin và cần cú pháp placeholder nhất quán.

🏗️ Ví dụ sử dụng

• Một máy chủ cài expansion Vault để các placeholder kinh tế như số dư người chơi có thể dùng trong plugin scoreboard và chat.
• Một quản trị viên tải expansion dành riêng cho plugin từ eCloud để plugin hologram có thể hiển thị dữ liệu mục tiêu trực tiếp.
• Một nhà phát triển hiển thị dữ liệu plugin thông qua PlaceholderExpansion để các máy chủ khác có thể hiển thị dữ liệu đó mà không phụ thuộc trực tiếp vào plugin.

⌨️ Lệnh

(Lưu ý: các lệnh trên được tài liệu hóa trong tài liệu tham khảo lệnh chính thức của PlaceholderAPI. Các permission node cho từng lệnh không được liệt kê trong tài liệu tham khảo đó.)

⚙️ Cài đặt

📥 Thiết lập

• Tải file jar PlaceholderAPI chính thức và đặt nó vào thư mục plugins/ của máy chủ.
• Khởi động hoặc khởi động lại máy chủ và xác nhận PlaceholderAPI được nạp trong console.
• Cài expansions bằng cách thả các file jar expansion vào plugins/PlaceholderAPI/expansions/ hoặc dùng các lệnh eCloud trong game (đối với expansions đã được xác minh).

📦 Phụ thuộc

• Bản thân PlaceholderAPI không cần một plugin phụ thuộc chung để hoạt động. Một số placeholder do expansions cung cấp phụ thuộc vào các plugin khác (ví dụ, một expansion hiển thị giá trị kinh tế sẽ cần plugin kinh tế tương ứng). Các yêu cầu này phụ thuộc vào expansion cụ thể.

🧠 Ghi chú kỹ thuật

• PlaceholderAPI được cung cấp cho các máy chủ dựa trên Spigot và cũng thường được dùng trên Paper. Nó cung cấp API để nhà phát triển plugin đăng ký PlaceholderExpansions.
• Expansions có thể được phân phối dưới dạng file jar độc lập hoặc đi kèm trong plugin khác; các expansions độc lập thường được cài vào plugins/PlaceholderAPI/expansions/.
• Tính năng eCloud cho phép khám phá và tải xuống các expansions đã được xác minh ngay trong game; máy chủ phải cho phép HTTPS ra ngoài để các lượt tải eCloud hoạt động.
• Plugin bao gồm các lệnh debug và parsing để giúp quản trị viên kiểm tra rằng placeholders được resolve đúng.

🤝 Khi nào plugin này hữu ích

Nếu máy chủ của bạn dùng nhiều plugin cần hiển thị dữ liệu động, liên kết chéo giữa các plugin (chat, tab, holograms, scoreboards hoặc GUI), PlaceholderAPI rất hữu ích vì nó tập trung việc resolve placeholder và cho phép bạn thêm hỗ trợ cho các plugin khác thông qua các expansions mô-đun mà không cần sửa từng plugin tiêu thụ.