Plugin Minecraft DecentHolograms

🔌 Giới thiệu về Decent Holograms

Decent Holograms là một Minecraft plugin cung cấp hologram bay có thể cấu hình (văn bản nhiều dòng và hiển thị biểu tượng) cho các máy chủ Spigot/Bukkit. Nó tập trung vào cách trình bày linh hoạt và tích hợp cho nhà phát triển, đồng thời cung cấp public API và các điểm tích hợp cho những plugin khác.

🎯 Mục đích

Plugin này giải quyết nhu cầu hiển thị thông tin cố định trong thế giới (nhãn, bảng xếp hạng, hướng dẫn, hiển thị trạng thái) dưới dạng văn bản bay hoặc các biểu tượng nhỏ. Nó dành cho quản trị viên máy chủ và nhà phát triển plugin cần hologram có thể tùy chỉnh, có thể điều khiển bằng script mà không cần thêm các phụ thuộc bắt buộc.

⚙️ Tính năng

• Tạo hologram bay nhiều dòng (các dòng văn bản luôn hướng về người chơi).
• Hỗ trợ PlaceholderAPI để thay thế văn bản động.
• Public developer API cho tích hợp plugin và công cụ tùy chỉnh.
• Hỗ trợ biểu tượng (hiển thị nhỏ của entity/item có xoay và nhấp nhô).
• Thiết kế nhẹ, không có phụ thuộc bên ngoài bắt buộc.
• Telemetry sử dụng qua bStats (được báo cáo bởi kho lưu trữ của dự án).
• Các giới hạn Minecraft được tác giả ghi rõ (văn bản luôn hướng về người chơi; không thể thay đổi kích thước/phông chữ của văn bản; một số biểu tượng entity có thể phát ra âm thanh).

🧩 Dành cho ai

• Chủ và quản trị viên server cần nhãn trong thế giới, bảng thông tin hoặc văn bản trang trí.
• Nhà phát triển plugin muốn tích hợp hologram qua API.
• Các server Survival, SMP và minigame sử dụng placeholders cho hiển thị động.

🏗️ Ví dụ sử dụng

• Hiển thị bảng xếp hạng động bằng cách dùng placeholders để cho biết người chơi top.
• Đặt biển thông tin ở spawn và tự động cập nhật.
• Dùng API để tạo hologram từ các plugin khác hoặc script tùy chỉnh.

⚙️ Cài đặt

📥 Thiết lập

• Tải file JAR chính thức của plugin từ trang phân phối của dự án.
• Đặt file JAR vào thư mục plugins/ của server bạn (server tương thích Spigot/Bukkit).
• Khởi động lại server và kiểm tra console để xác nhận plugin đã được tải.

📦 Phụ thuộc

• Không có phụ thuộc bắt buộc. PlaceholderAPI được hỗ trợ cho placeholders động (tùy chọn).

🧠 Ghi chú kỹ thuật

• Mã nguồn và các bản phát hành được duy trì trong kho lưu trữ công khai của dự án.
• Được cấp phép theo GPL-3.0 như đã công bố trong kho lưu trữ.
• Dự án cung cấp developer API và hướng dẫn để xây dựng plugin từ mã nguồn.
• Plugin được kiểm tra trên nhiều phiên bản Minecraft (xem trang phân phối chính thức để biết chính xác các phiên bản đã kiểm tra).

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

Nếu bạn cần văn bản trong thế giới có thể cấu hình và điều khiển bằng script, hoặc hiển thị biểu tượng nhỏ với hỗ trợ placeholders và API để tích hợp, Decent Holograms cung cấp một giải pháp được duy trì và ít phụ thuộc cho các server Spigot/Bukkit.