Plugin Minecraft BlueMap

🔌 Giới thiệu về BlueMap

BlueMap là một công cụ bản đồ Minecraft, đọc các tệp thế giới của server và tạo mô hình 3D cùng một trình xem web tương tác. Nó có thể chạy như một plugin hoặc mod của server (plugin Spigot/Paper hoặc Sponge, mod Fabric/Forge) hoặc như một trình render command-line độc lập. Khi được cài trên một server đang chạy, BlueMap render theo kiểu bất đồng bộ nên không chặn luồng chính của server.

🎯 Mục đích

BlueMap cung cấp một bản thể hiện thế giới Minecraft dạng ba chiều, truy cập được qua trình duyệt, để quản trị viên và người chơi có thể khám phá địa hình, tìm công trình và xem các build mà không cần vào server. Công cụ này hướng tới các quản trị viên server cần một bản đồ trực quan, luôn cập nhật để phục vụ quản lý, điều hướng hoặc trưng bày cộng đồng.

⚙️ Tính năng

• Tạo mô hình 3D của bề mặt thế giới và hiển thị chúng trong trình xem web chạy trên trình duyệt.
• Chạy như plugin/mod (Spigot/Paper, Sponge, Fabric, Forge) hoặc như một công cụ CLI độc lập.
• Render bất đồng bộ để tránh chặn luồng server chính của Minecraft.
• Hỗ trợ resource pack và data pack để tùy chỉnh texture, mô hình block và màu biome dùng trong quá trình render.
• Hỗ trợ nhiều backend lưu trữ và quản lý map bằng lệnh (load, unload, list, delete, v.v.).
• Hỗ trợ marker và API để plugin bên thứ ba có thể thêm hoặc quản lý marker trên map.
• Các lệnh reload lúc runtime và điều khiển render (reload, bắt đầu/dừng render, update/purge map, freeze/unfreeze map).

🧩 Dành cho ai

• Các server Survival và SMP muốn có một bản đồ 3D công khai hoặc dành cho admin.
• Các server Creative hoặc showcase cần bản xem trước build có thể mở bằng trình duyệt.
• Quản trị viên server cần công cụ kiểm tra từ xa và điều hướng dựa trên map.

🏗️ Ví dụ sử dụng

• Cung cấp cho người chơi một bản đồ 3D của thế giới được host công khai để hỗ trợ điều hướng và trưng bày build.
• Một admin tìm và xem các base hoặc claim do người chơi xây dựng từ web viewer trước khi ghé vào trong game.
• Một plugin dùng API của BlueMap để hiển thị marker động cho sự kiện, cửa hàng hoặc vị trí dịch chuyển.

⌨️ Lệnh

(Tất cả lệnh ở trên đều được dự án tài liệu hóa; các permission node chính xác có trong tài liệu của dự án và không được lặp lại ở đây.)

⚙️ Cài đặt

📥 Thiết lập

• Tải xuống file BlueMap JAR phù hợp với nền tảng của bạn (plugin JAR cho Spigot/Paper/Sponge, mod JAR cho Fabric/Forge hoặc bản phân phối CLI độc lập).
• Đặt file JAR vào thư mục plugins/ của server (cho Spigot/Paper/Sponge) hoặc thư mục mods/ (cho Fabric/Forge), hoặc dùng các file phân phối CLI cho việc render độc lập.
• Khởi động hoặc khởi động lại server. Theo dõi console của server để xác nhận BlueMap và web server tích hợp đã khởi động thành công.

📦 Phụ thuộc

• Không cần phụ thuộc plugin bên ngoài bắt buộc cho chức năng render bản đồ cốt lõi. Có các tích hợp và addon tùy chọn; hãy xem tài liệu dự án để biết thông tin về addon bên thứ ba.

🧠 Ghi chú kỹ thuật

• BlueMap được phân phối dưới dạng plugin server, mod và công cụ CLI; hãy chọn gói phù hợp với thiết lập của bạn.
• Việc render được thực hiện bất đồng bộ để tránh chặn luồng server chính.
• Resource pack và data pack có thể được đặt trong thư mục pack đã cấu hình để thay đổi giao diện bản đồ.
• Dự án có kho mã nguồn công khai và các bản phát hành; cấu hình dựa trên file và có thể được tải lại trong lúc chạy.

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

Nếu bạn cần một chế độ xem ba chiều của thế giới Minecraft có thể mở bằng trình duyệt để điều hướng, xem lại công trình hoặc hiển thị cho cộng đồng, BlueMap cung cấp render tự động, điều khiển lúc runtime và API cho marker cùng các tích hợp mà không yêu cầu người chơi phải vào server.