Plugin Minecraft EssentialsGeoIP

🔌 Giới thiệu về EssentialsX GeoIP

EssentialsX GeoIP là một module dành cho bộ plugin EssentialsX, thực hiện tra cứu GeoIP cục bộ bằng cơ sở dữ liệu MaxMind GeoLite2. Nó tích hợp với EssentialsX để hiển thị vị trí ước chừng của người chơi (ví dụ trong /whois và tùy chọn hiển thị cho staff khi người chơi tham gia).

🎯 Mục đích

Module này cung cấp cho staff máy chủ thông tin địa lý ước chừng lấy từ IP của người chơi để hỗ trợ kiểm duyệt, ghi log và nhận biết vị trí cơ bản. Các lượt tra cứu được thực hiện cục bộ bằng cơ sở dữ liệu GeoLite2 thay vì gửi truy vấn đến dịch vụ bên thứ ba cho mỗi yêu cầu.

⚙️ Tính năng

• Sử dụng cơ sở dữ liệu MaxMind GeoLite2 để tra cứu vị trí từ IP.
• Tích hợp với đầu ra /whois của EssentialsX để hiển thị vị trí ước chừng.
• Tùy chọn: hiển thị vị trí ước chừng của người chơi cho staff khi họ tham gia.
• Cập nhật cơ sở dữ liệu tự động: module tải xuống và làm mới cơ sở dữ liệu GeoLite2 theo lịch định kỳ (mặc định được cấu hình cập nhật mỗi 30 ngày).
• Các node permission để kiểm soát ai có thể xem hoặc ẩn kết quả GeoIP.

🧩 Dành cho ai

Module này dành cho quản trị viên máy chủ và đội ngũ kiểm duyệt đang chạy EssentialsX và muốn có dữ liệu địa lý ước chừng cho mục đích kiểm duyệt hoặc ghi log trên các máy chủ Bukkit/Spigot/Paper.

🏗️ Ví dụ sử dụng

• Hiển thị cho staff quốc gia hoặc thành phố ước chừng khi kiểm tra người chơi bằng /whois.
• Ghi lại khu vực xuất phát ước chừng của các kết nối đáng ngờ để hỗ trợ kiểm duyệt.
• Ẩn hiển thị vị trí cho người chơi đã chọn không tham gia thông qua permission.

🔐 Quyền hạn

⚙️ Cài đặt

📥 Thiết lập

• Cài đặt plugin chính EssentialsX (module GeoIP yêu cầu module lõi EssentialsX tương ứng).
• Tải file JAR của module EssentialsX GeoIP và đặt nó vào thư mục plugins/ của máy chủ.
• Khởi động máy chủ một lần để tạo file plugins/EssentialsGeoIP/config.yml.
• Đăng ký quyền truy cập cơ sở dữ liệu GeoLite2 của MaxMind, tạo license key, rồi thêm license key đó vào thiết lập license-key trong plugins/EssentialsGeoIP/config.yml.
• Khởi động lại máy chủ. Module sẽ tải xuống cơ sở dữ liệu GeoLite2 bằng khóa đã cung cấp và tự động giữ cho nó được cập nhật.

📦 Phụ thuộc

• EssentialsX (module chính) — cần một phiên bản tương thích của plugin lõi EssentialsX.

🧠 Ghi chú kỹ thuật

• Module yêu cầu đồng ý và tuân thủ EULA của MaxMind GeoLite2; cơ sở dữ liệu chỉ mang tính ước chừng và không được dùng để xác định vị trí chính xác của người chơi.
• Hành vi tải xuống/cập nhật cơ sở dữ liệu là một phần của module và được cấu hình cập nhật hàng tháng; bạn phải cung cấp một license key MaxMind hợp lệ để cập nhật tự động.
• Chỉ hiển thị dữ liệu ở nơi lõi EssentialsX cung cấp /whois hoặc thông báo khi tham gia; bản thân module không thay thế chức năng của EssentialsX.

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

Nếu bạn chạy EssentialsX và cần tra cứu vị trí ước chừng nhẹ, cục bộ để phục vụ kiểm duyệt hoặc ghi log (đồng thời tuân thủ điều khoản giấy phép của MaxMind), EssentialsX GeoIP cung cấp một giải pháp GeoLite2 tích hợp và tự động cập nhật.