Plugin Minecraft HolographicDisplays

🔌 Giới thiệu về Holographic Displays

Holographic Displays là một plugin Minecraft cung cấp các hologram lơ lửng tồn tại lâu dài có thể hiển thị văn bản và vật phẩm. Plugin này cung cấp các lệnh trong game để tạo và chỉnh sửa hologram, đồng thời có API dành cho nhà phát triển để tích hợp hologram vào các plugin khác.

🎯 Mục đích

Plugin này giải quyết nhu cầu hiển thị thông tin, nhãn, menu và các hiệu ứng trực quan lơ lửng trong thế giới mà không cần tạo ra các thực thể nhìn thấy được tồn tại vĩnh viễn. Nó hữu ích cho quản trị máy chủ, hiển thị trang trí, menu trong thế giới và các tích hợp khi plugin cần hiển thị dữ liệu cho người chơi tại những vị trí cố định.

⚙️ Tính năng

• Tạo và xóa hologram có tên tại các vị trí cụ thể.
• Thêm, xóa, đặt và chèn các dòng văn bản cho hologram.
• Hiển thị vật phẩm lơ lửng như các dòng hologram (hỗ trợ vật phẩm lơ lửng).
• Đọc các dòng từ tệp văn bản vào hologram.
• Đọc và hiển thị hình ảnh vào hologram từ tệp hoặc URL (với ánh xạ ký tự và chiều rộng tối đa có thể cấu hình).
• Căn chỉnh, di chuyển, sao chép và dịch chuyển tới hologram.
• Tải lại cấu hình plugin và các hologram đã lưu mà không cần chỉnh sửa tệp thủ công.
• Có API dành cho nhà phát triển để các plugin khác tạo và quản lý hologram bằng lập trình.

🧩 Dành cho ai

• Quản trị viên máy chủ muốn có các hiển thị trực quan trong thế giới (SMP, Survival, máy chủ Minigame).
• Nhà phát triển plugin cần API để hiển thị văn bản/vật phẩm cho người chơi trong thế giới.
• Các nhóm staff sử dụng hologram cho biển báo, menu hoặc các màn hình thông tin.

🏗️ Ví dụ sử dụng

• Một minigame hiển thị điểm hiện tại phía trên mỗi đấu trường bằng hologram.
• Sảnh chờ của máy chủ hiển thị luật máy chủ và các vật phẩm nhấp để dịch chuyển dưới dạng các dòng lơ lửng.
• Một tích hợp plugin đưa thống kê người chơi động vào hologram tại một vị trí cố định.

⌨️ Lệnh

Lưu ý: tài liệu cho biết mỗi subcommand có một quyền riêng (ví dụ /hd list yêu cầu holographicdisplays.list). Lệnh chính /hd có thể dùng cho mọi người.

🔐 Quyền

⚙️ Cài đặt

📥 Thiết lập

• Tải JAR plugin chính thức từ một danh mục đáng tin cậy.
• Đặt JAR vào thư mục máy chủ plugins/ cho Bukkit/Spigot.
• Khởi động lại máy chủ và kiểm tra console để xác nhận plugin đã được tải.

📦 Phụ thuộc

• Tài liệu tóm tắt chính thức không liệt kê phụ thuộc bắt buộc nào; hãy kiểm tra trang tải xuống để biết các tích hợp tùy chọn khi cài đặt.

🧾 Cấu hình

• Plugin hỗ trợ các tệp cấu hình và hologram đã lưu; hãy dùng lệnh tải lại được cung cấp để áp dụng thay đổi sau khi chỉnh sửa tệp.
• Hiển thị hình ảnh và ánh xạ ký tự có thể cấu hình qua phần cấu hình của plugin.

🧠 Ghi chú kỹ thuật

• Tài liệu chính thức có hướng dẫn nâng cấp cho Minecraft 1.13+ về thay đổi tên material và xử lý hình ảnh/icon.
• API dành cho nhà phát triển đã được tài liệu hóa cho các tích hợp plugin.

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

Nếu bạn cần các hiển thị trong thế giới có thể chỉnh sửa và tồn tại lâu dài cho thông tin, menu hoặc tích hợp plugin, Holographic Displays cung cấp hologram có tên, nhập từ tệp/hình ảnh và API để các plugin khác có thể tạo và cập nhật hologram một cách đáng tin cậy.