PlaceholderAPI

PlaceholderAPI 소개

PlaceholderAPI는 여러 플러그인의 정보를 하나의 통일된 형식으로 꺼내 쓸 수 있게 해 주는 Spigot 계열 서버용 플러그인입니다. 서버를 운영하다 보면 스코어보드에 돈을 표시하고, 탭 목록에 랭크를 띄우고, 채팅 앞에 칭호를 붙이는 등 다른 플러그인이 가진 데이터를 화면 곳곳에 보여 줘야 할 때가 많습니다. PlaceholderAPI는 %이름% 형태의 "플레이스홀더"라는 공통 언어를 제공해 이런 연결을 쉽게 만들어 줍니다.

특정 플러그인의 정보는 그 플러그인이 직접 지원하거나, "확장(expansion)"을 통해 제공됩니다. 확장은 게임 안에서 PAPI Expansion Cloud로 바로 내려받을 수 있으며, 제작진에 따르면 Essentials, Factions, LuckPerms, Vault 등 다양한 플러그인을 지원하는 확장이 230개 이상 마련되어 있습니다. 많은 플러그인이 이 형식을 기본으로 지원하기 때문에, 사실상 서버 플러그인 생태계의 공용 부품처럼 쓰입니다.

제작진은 PlaceholderAPI가 200만 회 이상 다운로드되었고 5만 개가 넘는 서버에서 동시에 사용되고 있다고 소개합니다. 이 페이지의 Modrinth 배포본은 2025년에 공개되었으며 26.3 버전까지 지원합니다.

PlaceholderAPI 정보

항목	내용
종류	마인크래프트 플러그인 (플레이스홀더 연동)
제작자	funnycube
지원 버전	1.8 ~ 26.3
지원 플랫폼	Bukkit, Folia, Paper, Spigot
카테고리	유틸리티
다운로드	약 37만 회 (Modrinth 기준)
최초 공개	2025-08-15
최근 업데이트	2026-07-03
라이선스	GPL-3.0-only
배포처	Modrinth

주요 특징

• 통일된 플레이스홀더 형식 - 서로 다른 플러그인의 정보를 같은 방식으로 표시합니다.
• 확장 클라우드 - 게임 안 명령어로 필요한 확장을 검색·다운로드·업데이트합니다.
• 230개 이상의 확장 - 경제, 권한, 팩션 등 다양한 플러그인을 지원하는 확장이 있습니다.
• 설정 통합 - 확장이 제공하는 설정 항목이 config.yml 한 곳에 추가됩니다.
• 개발자 API - 자신의 플러그인에서 PlaceholderAPI 지원을 넣을 수 있는 API가 있습니다.

서버 설정과 사용 방법

config.yml에는 핵심 설정과 함께 확장 전용 설정 구역이 있습니다. 어떤 확장이 설정 항목을 제공한다면, 그 확장이 처음 로드될 때 해당 항목이 config.yml에 자동으로 추가됩니다. 명령어는 용도별로 나뉘어 있으며 대표적인 것은 다음과 같습니다.

• 파싱 - /papi parse, /papi parserel, /papi bcparse, /papi cmdparse로 플레이스홀더가 실제로 어떻게 변환되는지 확인합니다.
• eCloud - /papi ecloud list, /papi ecloud download, /papi ecloud update, /papi ecloud info 등으로 확장을 관리합니다.
• 확장 관리 - /papi list, /papi info, /papi register, /papi unregister로 설치된 확장을 확인하고 등록합니다.
• 유틸리티 - /papi reload, /papi version, /papi dump로 리로드와 버전 확인, 진단 정보 출력을 합니다.

일반적인 사용 흐름은 이렇습니다. 먼저 쓰고 싶은 플러그인의 확장을 /papi ecloud download로 받고, /papi reload로 적용한 다음, /papi parse로 원하는 값이 제대로 나오는지 시험합니다. 확인이 끝나면 스코어보드·탭·채팅 플러그인 설정에 해당 플레이스홀더를 넣으면 됩니다. 이 플러그인은 bStats로 익명 통계를 수집합니다.

확장을 많이 받아 두면 관리가 번거로워지므로, 실제로 쓰는 플러그인의 확장만 설치하는 편이 깔끔합니다.

이런 분께 추천합니다

PlaceholderAPI는 플러그인이 두세 개만 넘어가도 거의 필수에 가까운 기반 플러그인입니다.

• 스코어보드·탭 목록·채팅에 다른 플러그인 정보를 표시하고 싶은 운영자
• 설치하려는 플러그인이 PlaceholderAPI를 요구하는 경우
• 경제·권한 플러그인 데이터를 한 화면에 모아 보여 주고 싶은 분
• 자신의 플러그인에 플레이스홀더 지원을 추가하려는 개발자

다운로드 및 설치 방법

1. Paper·Spigot·Bukkit·Folia 중 하나로 서버를 준비합니다.
2. 페이지의 Modrinth에서 다운로드 버튼으로 이동해 PlaceholderAPI 파일을 받습니다.
3. .jar 파일을 서버의 plugins 폴더에 넣고 재시작합니다.
4. plugins\PlaceholderAPI 폴더의 config.yml을 확인한 뒤 필요한 확장을 eCloud로 받습니다.

플러그인은 서버 전용이므로 싱글플레이에는 쓰지 않습니다. 확장을 추가했는데 값이 표시되지 않는다면 대상 플러그인이 함께 설치되어 있는지 먼저 확인하세요.

자주 묻는 질문

PlaceholderAPI만 설치하면 바로 쓸 수 있나요?

본체만으로는 일부 기능만 동작합니다. 표시하려는 플러그인을 위한 확장을 eCloud에서 받거나, 해당 플러그인이 직접 지원해야 합니다.

플레이스홀더가 글자 그대로 출력돼요.

확장이 설치·등록되었는지 /papi list로 확인하고, /papi parse로 값이 변환되는지 시험해 보세요. 표시하는 쪽 플러그인이 PlaceholderAPI를 지원하는지도 확인이 필요합니다.

확장 업데이트는 어떻게 하나요?

/papi ecloud update 명령으로 설치된 확장을 업데이트할 수 있습니다.

Folia 서버에서도 쓸 수 있나요?

네. 지원 플랫폼 목록에 Folia가 포함되어 있습니다.

마무리

PlaceholderAPI는 서로 다른 플러그인을 하나로 이어 주는 연결 고리 역할을 하는 플러그인입니다. 확장 클라우드 덕분에 필요한 기능만 골라 붙일 수 있고, 파싱 명령으로 결과를 바로 확인할 수 있습니다. 서버에 설치해 두고 스코어보드와 채팅을 더 풍성하게 꾸며 보세요.