EssentialsX GeoIP는 MaxMind GeoLite2 데이터베이스를 사용해 로컬 GeoIP 조회를 수행하는 EssentialsX 플러그인 모음용 모듈입니다. EssentialsX와 연동되어 플레이어의 대략적인 위치를 표시합니다(예: /whois에서, 그리고 선택적으로 플레이어가 접속할 때 스태프에게 표시).

🎯 목적

이 모듈은 플레이어 IP에서 추정한 대략적인 지리 정보를 서버 스태프에게 제공하여 모더레이션, 로그 기록, 기본적인 위치 파악을 돕습니다. 조회는 각 요청마다 외부 조회 서비스를 호출하는 대신 GeoLite2 데이터베이스를 사용해 로컬에서 수행됩니다.

⚙️ 기능

IP-위치 조회에 MaxMind GeoLite2 데이터베이스를 사용합니다.
EssentialsX의 /whois 출력과 연동되어 대략적인 위치를 보여줍니다.
선택 사항: 플레이어가 접속할 때 스태프에게 해당 플레이어의 대략적인 위치를 표시합니다.
데이터베이스 자동 업데이트: 모듈이 GeoLite2 데이터베이스를 정기적으로 다운로드하고 새로 고칩니다(기본값으로 30일마다 업데이트하도록 설정됨).
GeoIP 결과를 누가 볼 수 있거나 숨길 수 있는지 제어하는 권한 노드가 있습니다.

🧩 대상

이 모듈은 EssentialsX를 사용하는 서버 관리자와 모더레이션 팀을 대상으로 하며, Bukkit/Spigot/Paper 서버에서 모더레이션 또는 로그 기록을 위해 대략적인 지리 데이터가 필요한 경우에 적합합니다.

🏗️ 사용 예시

/whois로 플레이어를 확인할 때 스태프에게 대략적인 국가 또는 도시를 보여주기.
수상한 접속의 대략적인 원산지 지역을 기록해 모더레이션을 돕기.
권한을 통해 비공개를 선택한 플레이어의 위치 표시를 숨기기.

🔐 권한

권한	설명	기본값
`essentials.geoip.show`	사용자가 플레이어의 대략적인 위치를 볼 수 있게 합니다(예: 로그인 시 또는 `/whois` 사용 시).	지정되지 않음
`essentials.geoip.hide`	GeoIP 기능이 플레이어의 위치를 표시하지 못하게 합니다.	지정되지 않음

⚙️ 설치

📥 설정

EssentialsX 메인 플러그인을 설치합니다(GeoIP 모듈에는 일치하는 EssentialsX 코어 모듈이 필요합니다).
EssentialsX GeoIP 모듈 JAR를 다운로드하여 서버의 plugins/ 디렉터리에 넣습니다.
서버를 한 번 시작해 plugins/EssentialsGeoIP/config.yml 파일을 생성합니다.
MaxMind의 GeoLite2 데이터베이스 사용 권한을 등록하고 라이선스 키를 생성한 뒤, 그 키를 plugins/EssentialsGeoIP/config.yml의 license-key 설정에 추가합니다.
서버를 재시작합니다. 모듈이 제공된 키를 사용해 GeoLite2 데이터베이스를 다운로드하고 자동으로 최신 상태를 유지합니다.

📦 의존성

EssentialsX(메인 모듈) — 일치하는 버전의 EssentialsX 코어 플러그인이 필요합니다.

🧠 기술 노트

이 모듈은 MaxMind GeoLite2 EULA에 동의하고 이를 준수해야 합니다. 데이터베이스는 대략적인 정보만 제공하며, 정확한 플레이어 위치를 파악하는 데 사용해서는 안 됩니다.
데이터베이스 다운로드/업데이트 동작은 모듈의 일부이며 월간 일정으로 업데이트되도록 설정되어 있습니다. 자동 업데이트를 위해서는 유효한 MaxMind 라이선스 키를 제공해야 합니다.
데이터는 EssentialsX 코어가 /whois 또는 접속 알림을 제공하는 곳에서만 표시됩니다. 모듈 자체가 EssentialsX 기능을 대체하지는 않습니다.