Plugin Minecraft dynmap

🔌 Giới thiệu về Dynmap

Dynmap là một bộ plugin và mod của Minecraft cung cấp bản đồ web theo thời gian thực cho các máy chủ Minecraft. Nó hiển thị các ô bản đồ của những thế giới đã được tải và cung cấp giao diện bản đồ tương tác có thể hiển thị marker, khu vực, đường kẻ, vị trí người chơi trực tiếp và bong bóng chat. Dynmap hỗ trợ chạy webserver nội bộ hoặc xuất dữ liệu bản đồ để lưu trữ bên ngoài, đồng thời cung cấp nhiều backend lưu trữ.

🎯 Mục đích

Mục đích cốt lõi của Dynmap là cho quản trị viên máy chủ và người chơi một chế độ xem trực tiếp, có thể điều hướng của địa hình và hoạt động máy chủ thông qua trình duyệt. Nó giải quyết vấn đề trực quan hóa bố cục thế giới, theo dõi vị trí người chơi, công bố bản đồ máy chủ cho người dùng và tạo bản đồ có chú thích bằng marker và vùng.

⚙️ Tính năng

• Hiển thị ô bản đồ của thế giới máy chủ theo thời gian thực (nhiều kiểu xem bản đồ và chế độ render).
• Marker, khu vực và đường kẻ có thể cấu hình để chú thích bản đồ cho người chơi hoặc nhân viên.
• Theo dõi người chơi trực tiếp và tùy chọn bong bóng chat / tích hợp chat web vào game.
• Nhiều backend lưu trữ: file phẳng, MySQL/SQLite/PostgreSQL/MariaDB, và hỗ trợ AWS S3 cho lưu trữ bản đồ/web.
• Webserver tích hợp để phục vụ giao diện bản đồ; có thể tùy chỉnh để đăng tải/nạp nội dung trang web tĩnh lên lưu trữ bên ngoài.
• Bản dựng đa nền tảng: có các artifact riêng cho Spigot/Paper, Forge và Fabric.

🧩 Dành cho ai

• Chủ server và quản trị viên muốn có bản đồ có thể duyệt của thế giới (của họ).
• Các server SMP công khai và survival công bố bản đồ cho người chơi.
• Server minigame hoặc roleplay cần bản đồ có chú thích, marker spawn hoặc lớp phủ khu vực.
• Những máy chủ cần tùy chọn lưu trữ/backend linh hoạt (SQL hoặc S3) cho bản đồ lớn.

🏗️ Ví dụ sử dụng

• Render và công bố bản đồ overworld trực tiếp để người chơi xem online.
• Đánh dấu thị trấn, cửa hàng và các địa danh nổi bật bằng marker tùy chỉnh và đường viền khu vực.
• Chạy render theo lịch hoặc theo yêu cầu cho các chunk mới khám phá (render theo bán kính hoặc toàn thế giới).

⌨️ Lệnh

(Lưu ý: Dynmap cung cấp một bộ lệnh bản đồ và cấu hình lớn hơn trong tài liệu chính thức.)

🔐 Quyền

⚙️ Cài đặt

📥 Thiết lập

• Tải JAR Dynmap chính thức cho nền tảng máy chủ của bạn và đặt nó vào thư mục plugins/ (hoặc mods/ cho Forge/Fabric) trên server.
• Khởi động lại server và kiểm tra console để xác nhận Dynmap đã được tải và đã tạo các thư mục cấu hình và bản đồ.
• Cấu hình bản đồ, marker, backend lưu trữ và các tùy chọn webserver trong các tệp cấu hình Dynmap được tạo ở lần chạy đầu tiên.

📦 Phụ thuộc

• Các bản dựng Dynmap bao gồm hỗ trợ driver JDBC trên nhiều bản phân phối Spigot/Paper; các nền tảng khác có thể cần driver bổ sung hoặc mod tương thích cho backend SQL.
• Các plugin tích hợp (ví dụ WorldGuard, Towny, Citizens) được cung cấp qua các tích hợp Dynmap riêng; chúng không phải là phụ thuộc runtime bắt buộc.

🧾 Cấu hình

• Dynmap sử dụng các tệp cấu hình YAML được tạo ở lần khởi động đầu tiên. Cấu hình điều khiển bản đồ, thiết lập render, bộ marker, backend lưu trữ và hành vi của webserver.
• Các backend lưu trữ được hỗ trợ bao gồm file phẳng, MySQL, SQLite, PostgreSQL, MariaDB và lưu trữ AWS S3 tùy chọn để host dữ liệu bản đồ.

🧠 Ghi chú kỹ thuật

• Nguồn chính thức của dự án cung cấp các bản dựng riêng cho Spigot/Paper, Forge và Fabric.
• Mã nguồn Dynmap được phát hành theo giấy phép Apache-2.0.
• Dự án hỗ trợ chạy trên Java 8 khi runtime, trong khi yêu cầu build thay đổi theo mục tiêu và có thể cần JDK mới hơn cho các bản dựng hiện đại.
• Dynmap cung cấp các API đã công bố (DynmapCoreAPI và dynmap-api) được các plugin tích hợp sử dụng; đây là các giao diện ổn định cho tiện ích mở rộng của bên thứ ba.

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

Nếu bạn muốn có một bản đồ Minecraft server bền vững, có thể duyệt được (để điều hướng, theo dõi người chơi hoặc bản đồ cộng đồng), Dynmap cung cấp một giải pháp có thể cấu hình, đa nền tảng với nhiều backend lưu trữ và một bộ tính năng render cùng marker phong phú.