Plugin Minecraft skript-placeholders

🔌 Giới thiệu về skript-placeholders

skript-placeholders là một addon cho plugin Skript, cung cấp tích hợp placeholder: nó cho phép bạn đăng ký các placeholder từ Skript và xuất chúng sang PlaceholderAPI và MVdWPlaceholderAPI để các plugin khác có thể truy vấn biến Skript.

🎯 Mục đích

Plugin này giải quyết vấn đề chia sẻ các giá trị động do Skript quản lý (biến, dữ liệu được tính toán) với các plugin khác hỗ trợ placeholder. Điều này hữu ích khi bạn muốn trạng thái do Skript điều khiển hoặc các giá trị tùy chỉnh xuất hiện trong scoreboard, định dạng chat, boss bar, tab list, hoặc bất kỳ plugin nào đọc placeholder của PlaceholderAPI / MVdWPlaceholderAPI.

⚙️ Tính năng

• Đăng ký và xuất các placeholder từ Skript sang PlaceholderAPI.
• Hỗ trợ MVdWPlaceholderAPI tùy chọn (cần một plugin tương thích MVdW để MVdWPlaceholderAPI hoạt động).
• Lấy giá trị placeholder từ Skript ngay trong script (xem wiki của dự án để biết ví dụ).
• Bản fork/tiếp nối của dự án Ersatz, được cập nhật để hoạt động với hệ thống PlaceholderExpansion của PlaceholderAPI.

🧩 Dành cho ai

• Chủ server và admin dùng Skript để triển khai logic tùy chỉnh và cần các giá trị đó có sẵn cho plugin khác.
• Các server sử dụng PlaceholderAPI hoặc MVdWPlaceholderAPI và các tùy chỉnh dựa trên Skript.

🏗️ Ví dụ sử dụng

• Xuất một biến Skript chứa chỉ số của người chơi để plugin scoreboard có thể hiển thị qua placeholder.
• Tạo các placeholder tùy chỉnh trong Skript được các plugin chat/tab/bossbar hỗ trợ PlaceholderAPI sử dụng.

⚙️ Cài đặt

📥 Thiết lập

• Tải file JAR của plugin và đặt nó vào thư mục plugins/ của server.
• Đảm bảo Skript (phiên bản 2.7.3 trở lên) đã được cài đặt và có mặt.
• Cài PlaceholderAPI hoặc MVdWPlaceholderAPI tùy theo hệ thống placeholder bạn định dùng.
• Khởi động hoặc khởi động lại server và kiểm tra console để xác nhận addon đã được tải đúng.

📦 Phụ thuộc

• Skript (yêu cầu phiên bản 2.7.3 trở lên)
• PlaceholderAPI hoặc MVdWPlaceholderAPI (phải cài một trong hai để xuất placeholder)

🧠 Ghi chú kỹ thuật

• Addon này là một bản fork của dự án Ersatz và đã được cập nhật để dùng hệ thống PlaceholderExpansion của PlaceholderAPI.
• Tác giả plugin liệt kê một số phiên bản Minecraft đã được kiểm thử trên trang dự án.

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

Nếu bạn quản lý một server phụ thuộc vào Skript cho các cơ chế tùy chỉnh và cần các giá trị do script quản lý đó có thể được truy cập bởi các plugin khác thông qua một hệ thống placeholder thống nhất, skript-placeholders cung cấp một cầu nối đơn giản đến PlaceholderAPI và MVdWPlaceholderAPI.