Minecraft 플러그인 spark

🔌 spark 소개

spark는 Minecraft 서버, 클라이언트, 프록시 소프트웨어를 위한 성능 프로파일러입니다. CPU 활동을 검사하고, 기본적인 메모리 스냅샷과 heap dump를 수집하며, 서버 상태 메트릭(TPS, tick 시간, CPU/메모리/디스크 사용량)을 보고하는 도구를 제공합니다. 이 프로젝트는 오픈 소스이며, 최소한의 설정으로 읽기 쉬운 프로파일링 결과를 생성하도록 설계되었습니다.

🎯 목적

spark의 핵심 목적은 샘플 기반 CPU 프로필, 메모리 요약, heap dump, 지속적인 상태 메트릭을 생성하여 성능 저하(렉, 낮은 tick 속도, 높은 CPU 사용량, 과도한 메모리 점유)의 원인을 서버 관리자와 개발자가 진단할 수 있도록 돕는 것입니다.

⚙️ 기능

• 두 가지 엔진을 사용하는 CPU 프로파일링(통계적 샘플링): Java ThreadMXBean 기반 엔진과 선택 가능한 native/async-profiler 엔진(native 엔진은 Linux 및 macOS에서 사용 가능).
• heap 요약과 외부 분석을 위한 전체 HPROF heap dump 생성 기능을 포함한 메모리 검사.
• 서버 상태 보고: TPS 측정, tick 지속 시간 통계, CPU 및 메모리 사용량, 디스크 사용량 모니터링.
• 프로젝트의 viewer 구성 요소에서 보도록 설계된 읽기 쉬운 프로파일 출력.
• 최소한의 설정으로 운영 서버에서도 사용할 수 있도록 한 경량 설계.

🧩 대상

• Survival, SMP, 미니게임, 또는 proxy 기반 네트워크에서 성능 문제를 해결하는 서버 관리자와 운영자.
• 코드 경로와 메모리 사용량에 대한 정확한 프로파일링 데이터가 필요한 플러그인 및 모드 개발자.
• 단순한 TPS 수치보다 더 깊은 진단이 필요한 Fabric/Forge/Spigot/Paper/Proxy 환경을 운영하는 사람들.

🏗️ 사용 예시

• 짧은 CPU 프로필을 캡처하여 렉이 심해질 때 어떤 플러그인, 모드, 또는 서버 작업이 CPU를 가장 많이 사용하는지 확인합니다.
• heap 요약 또는 heap dump를 통해 과도한 인스턴스 수나 메모리 누수를 검사합니다.
• TPS와 tick 시간을 지속적으로 모니터링하여 성능 저하를 서버 이벤트나 외부 부하와 연관 지어 봅니다.

⚙️ 설치

📥 설정

• 플랫폼에 맞는 플러그인/모드 jar를 다운로드합니다.
• 대상 플랫폼의 서버 plugins/(또는 mods/plugins) 폴더에 jar를 넣습니다.
• 서버를 다시 시작하고 콘솔/로그를 확인하여 플러그인/모드가 로드되었는지 확인합니다.

(이것들은 Bukkit/Spigot/Paper 계열 플러그인 및 기타 지원 플랫폼에 대한 표준 설치 단계입니다.)

🧠 기술 참고

• 이 프로젝트는 플랫폼별 구성 요소(Bukkit/Paper, Fabric, Forge, 프록시 빌드 등)를 제공합니다.
• native async-profiler 엔진은 Linux와 macOS에서만 사용할 수 있으며, Java 기반 프로파일러는 어떤 JVM에서도 실행되지만 다른 샘플링 방식을 사용합니다.
• spark는 표준 JVM 도구를 사용한 외부 분석을 위해 HPROF heap dump를 생성할 수 있습니다.
• 이 프로젝트는 GNU GPLv3 라이선스로 배포됩니다.

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

Minecraft 서버나 프록시에서 렉 또는 메모리 문제의 근본 원인을 찾기 위해 구체적이고 샘플 기반의 프로파일링과 메모리 검사가 필요하다면, spark는 올바른 디버깅과 튜닝 결정을 내리는 데 필요한 프로파일링, heap 검사, 상태 메트릭을 제공합니다.