PlaceholderAPI — Minecraft에서 동적 데이터를 치환하는 플러그인

PlaceholderAPI — Minecraft에서 동적 데이터를 치환하는 플러그인

• 이 문서를 테스트하고 작성한 Minecraft 버전: 26.1.2

• 지원 버전 범위: 1.8.x – 26.1.x

PlaceholderAPI(줄여서 PAPI)는 텍스트 안의 특수 마커를 동적인 값으로 치환해주는 Minecraft 서버 플러그인입니다. 이 자체로는 아무것도 출력하지 않습니다. 문자열에서 %player_name% 형태의 마커를 찾아 플레이어 이름, 잔액, 랭크, 서버 접속자 수 같은 실제 값으로 바꿔주는 엔진입니다. 데이터 자체는 개별 모듈(확장 기능)이 제공하며, PAPI는 치환만 수행합니다. 덕분에 채팅, 스코어보드, 탭리스트, 메뉴 플러그인들이 각자의 문법 없이 동일한 형식으로 값을 읽을 수 있습니다.

플레이스홀더 형식

플레이스홀더는 퍼센트 기호(%) 두 개 사이에 작성합니다: %<розширення>_<параметр>%. 밑줄 앞부분은 확장 기능 이름이고, 그 뒤는 구체적인 매개변수입니다. 예를 들어 %player_name%은(는) 플레이어 이름을 반환하고, %server_online%은(는) 접속 중인 플레이어 수를 반환합니다.

치환은 이를 호출하는 수신 측 플러그인이 있을 때만 작동합니다. 플러그인이 PAPI를 지원하지 않으면 해당 플러그인 메시지의 마커는 일반 텍스트로 그대로 남습니다. 개별 플레이스홀더는 파싱 명령으로 확인할 수 있습니다:

/papi parse me %player_name%

응답으로 마커 텍스트 자체가 반환되고 값이 반환되지 않는다면, 해당 확장 기능이 없거나 소스 플러그인이 비활성화된 것입니다.

확장 기능과 eCloud

PlaceholderAPI는 기본 설치 상태로는 플레이스홀더를 하나도 포함하지 않으며, 모든 것은 확장 기능에서 제공됩니다. 일부는 소스 플러그인에 내장되어 서버 시작 시 자동으로 등록되고, 나머지는 확장 기능 클라우드(eCloud)에 개별 jar 파일로 있으며 /plugins/PlaceholderAPI/expansions/ 폴더에 설치합니다.

필요한 확장 기능은 게임 내에서 바로 다운로드할 수 있습니다:

/papi ecloud download <розширення>

/papi reload

이 명령으로는 검증된 확장 기능만 다운로드되며, 이는 악성 코드로부터 보호하기 위한 장치입니다. 검증되지 않은 확장 기능은 수동으로 설치해야 합니다. 사이트에서 jar 파일을 내려받아 확장 기능 폴더에 넣으면 됩니다.

명령어

모든 명령어는 /papi(으)로 시작합니다. 기본적으로는 운영자만 사용할 수 있으며, 개별 권한은 placeholderapi.* 노드를 통해 부여됩니다.

설정

config.yml에서 편집할 가치가 있는 것은 몇 가지 매개변수뿐입니다:

파일의 나머지 값들은 내부용(확장 기능 보호, Adventure 컴포넌트에서의 치환 모드, 디버그)이며 기본값을 그대로 두는 것이 좋습니다.

결론

PlaceholderAPI는 수백 개의 플러그인이 이해하는 단일 데이터 치환 형식을 제공합니다. 플러그인마다 개별적으로 연동을 구현하는 대신 플레이스홀더가 담긴 한 줄이면 충분합니다. 채팅, 탭리스트, 스코어보드, 메뉴를 동적 데이터로 운영하는 Minecraft 서버 관리자에게 필요하며, 싱글 플레이에서는 활용도가 없습니다.