Minecraft 플러그인 Plan

🔌 Plan | Player Analytics 소개

Plan은 서버와 플레이어 활동을 수집하고 시각화하는 Minecraft 플러그인입니다. 내장 웹서버를 실행해 온라인 활동, 플레이어 기반 통계, 과거 추세 같은 지표를 보여 주며 관리자가 서버 사용량을 파악하도록 돕습니다.

🎯 목적

Plan의 핵심 목적은 Minecraft 서버를 위한 셀프 호스팅 분석을 제공하는 것입니다. 웹 대시보드와 API를 통해 플레이어의 접속 여부, 시간에 따른 활동, 서버 전반의 지표를 추적할 수 있습니다. 플레이어 행동과 서버 성능 추세를 확인해야 하는 서버 소유자와 관리자를 위해 설계되었습니다.

⚙️ 기능

• 플레이어와 서버 통계를 볼 수 있는 내장 웹 대시보드.
• 온라인 활동과 플레이어 기반 지표를 과거 기록과 함께 수집.
• 여러 서버 플랫폼을 지원하는 하나의 JAR(지원되는 플랫폼용 단일 배포).
• 연동과 확장을 위한 API 및 Javadocs 제공.
• 언급된 저장소/백엔드에는 MySQL 및 SQLite 지원이 포함됩니다(데이터 저장용).
• 공식 릴리스와 개발(DEV) 빌드 산출물이 게시되고 유지됩니다.

🧩 대상

• 셀프 호스팅 분석 솔루션을 원하는 서버 소유자와 관리자.
• 플레이어 활동의 과거 추적과 웹 기반 보고가 필요한 소규모~대규모 서버.
• 분석 데이터를 내보내거나 처리하기 위한 API 또는 연동 지점을 원하는 운영자.

🏗️ 사용 예시

• 일별 및 월별 플레이어 온라인 추세를 확인해 서버 활동을 평가.
• 대시보드에서 개별 플레이어의 활동 기록(플레이 시간과 세션 패턴) 조회.
• Plan의 API 또는 Javadocs를 외부 도구에 연동해 보고서를 자동화.

⚙️ 설치

📥 설정

• 플랫폼에 맞는 공식 플러그인 JAR를 다운로드해 서버 plugins/ 디렉터리에 넣으세요.
• 서버를 재시작하고 콘솔/로그를 확인해 Plan이 정상적으로 로드되었고 웹서버가 시작되었는지 확인하세요.
• 첫 실행 후 Plan 설정에서 구성한 호스트/포트로 웹 대시보드에 접속하세요.

📦 의존성

• 기본적으로 필수 외부 플러그인 의존성은 없습니다. (특정 선택적 연동이나 어댑터는 프로젝트 문서에 안내되어 있습니다.)

🧠 기술 메모

• 공식 자료에 따르면 Plan은 단일 배포 방식으로 여러 서버 플랫폼(Spigot, Paper, Fabric, Sponge, BungeeCord, Velocity, Folia 포함)을 지원합니다.
• 프로젝트는 연동용 API 문서와 Javadocs를 제공합니다.
• LGPL-3.0 계열 라이선스로 배포됩니다.
• 릴리스는 정기적으로 공개되며, 테스트 및 CI 산출물용 개발 빌드도 사용할 수 있습니다.

🤝 이 플러그인이 유용한 경우

플레이어 활동과 서버 지표를 웹에서 확인할 수 있는 셀프 호스팅 개요가 필요하고, 연동용 API도 사용할 수 있어야 한다면 Plan은 관리자와 기술 사용자에게 적합한 크로스 플랫폼 분석 솔루션입니다.