Minecraft 플러그인 ajLeaderboards

ajLeaderboards와 확인된 서버에 대한 정보

🔌 ajLeaderboards 소개

ajLeaderboards는 숫자 값을 반환하는 모든 PlaceholderAPI 플레이스홀더로부터 리더보드를 만들 수 있는 Minecraft 플러그인입니다. 플레이스홀더가 보고하는 값을 수집하고 순위를 매기며, 홀로그램, 내장 표지판, NPC, 갑옷 거치대, 플레이어 머리로 결과를 표시할 수 있습니다.

🎯 목적

이 플러그인은 별도의 커스텀 연동 없이도 유연하고 플러그인 간 호환되는 리더보드를 만들 수 있는 문제를 해결합니다. 숫자 PlaceholderAPI 플레이스홀더를 제공하는 어떤 플러그인이든 추적할 수 있으며, 월드 내 표시로 보여 주거나 다른 표시 플러그인을 위한 플레이스홀더로 노출할 수 있습니다.

⚙️ 기능

  • 숫자 PlaceholderAPI 플레이스홀더를 리더보드 항목으로 추적합니다.
  • 다양한 표시 옵션: 홀로그램, 내장 표지판, NPC, 갑옷 거치대, 플레이어 머리.
  • 자동 초기화가 있는 시간 제한 리더보드(매시간, 매일, 매월 등)와 전체 기간 통계 보존.
  • 추적 중인 플레이스홀더도 함께 동기화되어 있어야 하는 서버 간 동기화용 MySQL 지원.
  • Vault 연동을 통한 플레이어 prefix/suffix의 선택적 표시.
  • 리더보드 항목과 함께 추가 플레이스홀더 텍스트를 보여 주는 "Extra" 플레이스홀더.
  • Folia 지원 및 일반적인 표시 플러그인(예: 홀로그램 및 NPC 시스템)과의 호환성.
  • bStats를 통한 익명 사용 통계 수집(bStats 설정에서 비활성화 가능).

🧩 대상

  • 밸런스, 통계, 커스텀 지표에 대한 동적 리더보드를 원하는 Survival 및 SMP 서버.
  • 이미 PlaceholderAPI를 사용 중이며 월드 안에 순위를 표시하고 싶은 서버(홀로그램, 표지판, NPC).
  • 시간 제한 리더보드(매일/매시간/매월)와 선택적 MySQL 동기화가 필요한 관리자.

🏗️ 사용 예시

  • 경제 플러그인 플레이스홀더와 홀로그램 플러그인을 사용해 최고 경제 잔액을 표시합니다.
  • NPC나 표지판에 최다 킬 수나 커스텀 미니게임 점수를 표시합니다.
  • 이벤트 우승자를 위한 매시간 또는 매일 리더보드를 실행하면서 전체 기간 기록은 유지합니다.

⌨️ 명령어

명령어설명권한접근
/ajLeaderboards add숫자 값을 반환하는 PlaceholderAPI 플레이스홀더 추적을 시작합니다.ajleaderboards.use관리자
/ajLeaderboards list [board] [type]설정된 리더보드 또는 특정 보드의 세부 정보를 나열합니다.ajleaderboards.use관리자

(참고: 명령어 이름은 플러그인에 문서화되어 있습니다. 서버 운영자는 전체 명령어 목록과 문법은 플러그인 위키를 확인해야 합니다.)

🔐 권한

권한설명기본값
ajleaderboards.use리더보드를 설정하고 관리하는 데 필요합니다.미지정
ajleaderboards.dontupdate.<board>지정된 보드의 업데이트 대상에 플레이어가 추가되는 것을 방지합니다.미지정

⚙️ 설치

📥 설정

  • 공식 플러그인 JAR를 다운로드해 서버의 plugins/ 폴더에 넣습니다.
  • 서버를 시작하기 전에 PlaceholderAPI가 설치되어 있는지 확인하세요. 이 플러그인은 추적된 값을 읽기 위해 PlaceholderAPI가 필요합니다.
  • 서버를 시작하거나 재시작한 뒤 콘솔에서 플러그인이 로드되었는지 확인합니다.

📦 의존성

  • PlaceholderAPI (필수)
  • Vault (선택; prefix/suffix 표시용)
  • Citizens (선택; NPC 기반 리더보드 표시용)
  • DecentHolograms 또는 다른 홀로그램 플러그인 (선택; 홀로그램 표시용)

🧠 기술 참고

  • 이 플러그인은 시간 제한 리더보드(매시간/매일/매월)를 지원하며, 추적 중인 플레이스홀더 값도 동기화되어 있을 때 MySQL로 리더보드를 동기화할 수 있습니다.
  • Folia 지원이 제공됩니다.
  • 플러그인은 익명 메트릭을 bStats로 전송하며, 이는 bStats 설정에서 비활성화할 수 있습니다.

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

이미 PlaceholderAPI를 사용 중이고, 표시 방식에 구애받지 않고 순위가 매겨진 숫자 데이터(경제, 통계, 커스텀 지표)를 월드 안이나 플레이스홀더로 쉽게 노출하고 싶다면, ajLeaderboards는 시간 제한 리더보드, 다양한 표시 옵션, 선택적 MySQL 동기화를 제공하며 플러그인별 맞춤 연동이 필요하지 않습니다.

ajLeaderboards 플러그인 서버

플러그인 ajLeaderboards 페이지에는 모니터링에서 이 플러그인을 확인한 서버, 사용 중인 플랫폼과 버전이 표시됩니다.

플러그인은 명령어, 경제, 보호, 접근 권한, 미니게임, 연동 및 기타 메커니즘을 추가할 수 있습니다. ajLeaderboards의 실제 역할은 서버별 설정에 따라 다릅니다.

데이터는 서버의 기술 응답에서 자동으로 생성됩니다. 서버가 플러그인 목록을 비공개로 설정한 경우, ajLeaderboards을 사용하더라도 이 섹션에 표시되지 않을 수 있습니다.

ajLeaderboards을 사용하는 서버 목록을 통해 프로젝트를 비교하거나, 지원 버전을 확인하거나, 공개 서버에서의 플러그인 사용 사례를 찾을 수 있습니다.