가이드
Minecraft 스코어보드 플러그인 만드는 법
2026년 10월 18일 업데이트
화면 오른쪽의 사이드바는 많은 서버에서 가장 눈에 띄는 부분이에요. 서버 이름, 플레이어 등급, 돈, 처치 수, 접속자 수. 플러그인은 Bukkit Scoreboard API로 이걸 그려요. 어려운 부분은 플레이어마다 자기만의 줄을 주고 부드럽게 업데이트하는 거예요.
줄을 내 서버에 맞게 바꿔 보세요.
Codexe로 이걸 생성하기단계별 안내
1.줄 작성하기
제목과 위에서 아래로 각 줄, 그리고 표시할 값: "등급: Admin", "코인: 1,250", "접속자: 34". 사이드바에는 최대 15줄까지 표시돼요.
2.플레이어마다 스코어보드 주기
플레이어마다 다른 줄을 보여 주려면 플레이어별 스코어보드가 필요해요.
Bukkit.getScoreboardManager().getNewScoreboard()로 만들고, 접속할 때player.setScoreboard(...)로 지정하세요.3.사이드바 목표(objective) 만들기
dummy 목표를 등록하고 표시 위치를
DisplaySlot.SIDEBAR로 설정하세요. 각 줄은 위치를 정하는 점수를 가진 항목이에요.4.값 업데이트하기
예를 들어 1초마다 도는 반복 작업이 바뀐 줄만 업데이트해요. 줄이 깜빡이지 않도록 텍스트에는 팀 접두사와 접미사를 쓰세요.
5.플레이스홀더 추가하기
PlaceholderAPI를 쓰면
%vault_eco_balance%같은 줄로 추가 코드 없이 다른 플러그인의 값을 보여 줄 수 있어요.6.빌드하고 게임 안에서 확인하기
Codexe가 컴파일하게 하고, 테스트 서버에 접속해서 모든 줄을 확인한 다음, 값을 바꿔서 업데이트되는지 보세요.
사이드바가 작동하는 방식
- 스코어보드마다 사이드바에는 한 번에 목표 하나만 표시돼요. 그 목표의 표시 이름이 제목이에요.
- 줄은 점수가 높은 순서대로 정렬되므로, 점수는 줄 번호를 거꾸로 매긴 것에 불과해요.
- 모든 줄은 서로 다른 항목이어야 해요. 똑같은 줄 두 개를 쓰려면 서로 다른 색상 코드처럼 눈에 보이지 않는 차이가 필요해요.
- 오른쪽의 빨간 숫자는 점수의 숫자 형식이 추가된 Minecraft 1.20.3부터 숨길 수 있어요. 그 이전 버전에서는 항상 표시돼요.
- 플레이어는 스코어보드를 하나만 봐요. 다른 플러그인이 자기 스코어보드를 지정하면 마지막에 지정한 쪽이 이겨요. 사이드바는 플러그인 하나로만 쓰거나, 스코어보드를 같이 쓰는 다른 플러그인이 무엇인지 적어 주세요.
깜빡임 없이 업데이트하기
줄을 지우고 새 줄을 추가하면 깜빡여요. 일반적인 해결책은 줄마다 보이지 않는 고정 항목을 주고, 그 항목이 들어 있는 팀의 접두사와 접미사에 보이는 텍스트를 넣는 거예요. 팀을 업데이트하면 텍스트가 제자리에서 바뀌어요. 요청에 "깜빡임 없이"라고 적으면 플러그인이 이 방식으로 작성돼요.
플러그인, Skript, 데이터팩 중 무엇을 쓸까요?
| 선택지 | 할 수 있는 것 | 한계 |
|---|---|---|
| 플러그인 | 플레이어별 줄, 어떤 값이든, 애니메이션, 플레이스홀더 | Spigot, Paper 또는 그 포크가 필요 |
| SkBee를 쓰는 Skript | 스크립트로 만드는 플레이어별 사이드바 | Skript와 애드온이 필요 |
| 데이터팩 | 사망 수나 처치 수 같은 목표 하나를 사이드바에 표시 | 모두에게 같은 숫자, 플레이어별 자유 텍스트 불가 |
설명 예시
"Board라는 Paper 1.21.4 플러그인. 모든 플레이어에게 사이드바를 보여 주고, 금색 제목 아래에 등급(LuckPerms), 코인(Vault), 처치 수, 사망 수, 접속자 수, 서버 주소. 깜빡임 없이 1초마다 업데이트, 빨간 숫자 숨김. 줄, 제목, 업데이트 간격은 config.yml에, 어느 줄에서든 PlaceholderAPI 플레이스홀더 사용 가능. /board toggle로 플레이어별로 숨기고 그 선택은 저장."
질문
사이드바에는 몇 줄까지 넣을 수 있나요?
15줄까지 표시돼요. 더 긴 내용은 탭 목록, 액션 바, 보스 바 같은 다른 곳이 필요해요.
1.8에서도 작동하나요?
네, Scoreboard API는 1.8에도 있지만 줄마다 넣을 수 있는 글자 수가 더 제한돼요. 그 버전에 맞게 작성되도록 버전을 적어 주세요.
스코어보드가 사라지는 이유는 무엇인가요?
보통 다른 플러그인이 내 플러그인 다음에 플레이어에게 자기 스코어보드를 지정해서 그래요. 다른 사이드바를 없애거나, 플러그인 하나가 모든 걸 보여 주게 하세요.
내 사이드바 만들기
이 프롬프트는 바로 보낼 수 있는 상태로 열려요:
“Board라는 Paper 1.21.4 사이드바 스코어보드 플러그인: 플레이어별 사이드바에 금색 제목, LuckPerms 등급, Vault 코인, 처치 수, 사망 수, 접속자 수, 서버 주소. 깜빡임 없이 1초마다 업데이트, 빨간 숫자 숨김, 줄과 간격은 config.yml에, PlaceholderAPI 지원, /board toggle은 플레이어별로 저장.”
Codexe로 이걸 생성하기