Máy chủ Minecraft có plugin 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ệnh** | **Mô tả** | **Quyền** | **Truy cập** | |---|---|---:|:---| | `/hd` | Lệnh chính; hiển thị thông tin và phiên bản plugin. | none (accessible to all) | Người chơi | | `/hd help` | Hiển thị các lệnh có sẵn và trợ giúp ngắn. | none (accessible to all) | Người chơi | | `/hd create <hologramName> [text]` | Tạo hologram mới tại vị trí của bạn. | `holographicdisplays.create` | Quản trị viên | | `/hd delete <hologram>` | Xóa một hologram có tên. | `holographicdisplays.delete` | Quản trị viên | | `/hd list [page]` | Liệt kê các hologram hiện có và vị trí của chúng. | `holographicdisplays.list` | Quản trị viên | | `/hd near <radius>` | Liệt kê các hologram gần bạn trong phạm vi đó. | `holographicdisplays.near` | Quản trị viên | | `/hd teleport <hologram>` | Dịch chuyển đến vị trí hologram. | `holographicdisplays.teleport` | Quản trị viên | | `/hd align <axis> <hologram> <reference>` | Căn chỉnh một hologram với hologram khác theo trục được chỉ định. | `holographicdisplays.align` | Quản trị viên | | `/hd movehere <hologram>` | Di chuyển hologram đến vị trí chân của bạn. | `holographicdisplays.movehere` | Quản trị viên | | `/hd edit <hologram>` | Vào các tùy chọn chỉnh sửa cho hologram. | `holographicdisplays.edit` | Quản trị viên | | `/hd addline <hologram> <text>` | Thêm một dòng văn bản vào hologram. | `holographicdisplays.addline` | Quản trị viên | | `/hd removeline <hologram> <number>` | Xóa một dòng có số khỏi hologram. | `holographicdisplays.removeline` | Quản trị viên | | `/hd setline <hologram> <number> <newText>` | Đổi văn bản của một dòng cụ thể. | `holographicdisplays.setline` | Quản trị viên | | `/hd insertline <hologram> <number> <text>` | Chèn một dòng sau chỉ mục đã cho. | `holographicdisplays.insertline` | Quản trị viên | | `/hd info <hologram>` | In nội dung hologram kèm số dòng. | `holographicdisplays.info` | Quản trị viên | | `/hd copy <from> <to>` | Sao chép nội dung từ một hologram sang hologram khác. | `holographicdisplays.copy` | Quản trị viên | | `/hd readtext <hologram> <file>` | Đọc các dòng từ tệp vào hologram. | `holographicdisplays.readtext` | Quản trị viên | | `/hd readimage <hologram> <image> <width> [-a]` | Hiển thị hình ảnh vào hologram từ tệp hoặc URL. | `holographicdisplays.readimage` | Quản trị viên | | `/hd reload` | Tải lại cấu hình và các hologram đã lưu. | `holographicdisplays.reload` | Quản trị viên | 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 | **Quyền** | **Mô tả** | **Mặc định** | |---|---|---:| | `holographicdisplays.<subcommand>` | Quyền riêng cho từng subcommand của `/hd` (ví dụ: `holographicdisplays.list`). | chưa được chỉ định | | `holographicdisplays.update` | Nhận thông báo cập nhật khi đăng nhập nếu được bật trong cấu hình. | chưa được chỉ định | | `holographicdisplays.*` | Cấp tất cả quyền holographicdisplays (nếu plugin permissions hỗ trợ). | chưa được chỉ định | ## ⚙️ 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.

Plugin