PlaceholderAPI: 플레이스홀더
PlaceholderAPI 설치, 확장 로드, 유용한 플레이스홀더 목록, 값 대신 플레이스홀더 자체가 표시될 때 디버깅하는 방법을 다뤄요.
업데이트 2026년 8월 13일
PlaceholderAPI는 플레이스홀더 라이브러리예요. 한 플러그인이 다른 플러그인의 데이터를 표시할 수 있게 해줘요. 채팅에 잔액, 스코어보드에 지역, 플레이어 목록에 클랜을 표시하는 식이죠.
설치
카탈로그에서 플러그인을 설치한 다음, 필요한 데이터 소스에 맞는 확장을 설치하세요:
papi ecloud download Vault
papi ecloud download Player
papi ecloud download Server
papi reload
확장은 데이터 소스마다 하나씩, 한 번에 하나씩 설치하세요.
유용한 플레이스홀더
| 플레이스홀더 | 의미 |
|---|---|
%player_name% | 닉네임 |
%player_ping% | 핑 |
%player_world% | 월드 |
%server_online% | 접속 중인 플레이어 수 |
%server_tps_1% | 최근 1분간의 TPS |
%vault_eco_balance_formatted% | 잔액 |
%luckperms_prefix% | 그룹 접두사 |
%worldguard_region_name% | 플레이어가 서 있는 지역 |
테스트
papi parse me %vault_eco_balance%
이 명령은 실제로 무엇이 치환되는지 보여줘요. %vault_eco_balance%라는 텍스트가 그대로 보인다면 다음을 의미해요:
- 확장이 설치되지 않았어요;
- 데이터 소스가 없어요(경제 플러그인 없음);
- 플레이스홀더를 넣은 플러그인이 PlaceholderAPI를 지원하지 않아요.
마지막 경우가 가장 흔한 원인이에요. 자체 플레이스홀더가 있더라도 외부 플레이스홀더를 지원하지 않는 플러그인이 많거든요.
성능
플레이스홀더는 갱신될 때마다 계산돼요. 값이 열 개인 스코어보드를 매 틱마다 갱신하면 플레이어 한 명당 초당 200회 계산이 일어나요: 스코어보드.
Minecraft 호스팅오프라인일 때도 서버가 실행돼요서버 만들기
