Libs Disguises는 서버 측 위장 시스템을 제공하는 Minecraft 플러그인입니다. 플레이어와 엔티티가 다른 엔티티 유형처럼 보이게 할 수 있습니다(플레이어 스킨과 비표준 위장 포함). 이 플러그인은 프로그래밍 방식 제어를 위한 API를 제공하며, 명령어와 플러그인 API를 통한 폭넓은 위장 커스터마이징을 지원합니다.

🎯 목적

Libs Disguises는 관리자, 모더레이터, 플러그인 개발자가 엔티티가 다른 플레이어에게 어떻게 보이는지 바꿀 수 있게 해 서버의 시각적 정체성 문제를 해결합니다. 이 플러그인은 꾸미기 요소, 롤플레이/미니게임 메커니즘, NPC 외형, 그리고 게임플레이 메커니즘은 바꾸지 않고 엔티티의 외형만 바꿔야 하는 개발자 통합을 위해 만들어졌습니다.

⚙️ 기능

엔티티와 플레이어를 위한 서버 측 위장(다양한 엔티티 유형 지원).
위장을 프로그래밍 방식으로 생성하고 수정하는 API.
위장을 만들고 적용하기 위한 탭 자동완성 지원 명령어(명령어와 권한 노드는 공식 플러그인 자료에 문서화되어 있음).
설정 가능한 위장 속성과 옵션(API/명령어를 통해 플러그인별 및 위장별 커스터마이징 지원).
개발자를 위한 Maven/Gradle 좌표를 통해 배포 및 빌드 산출물 제공(산출물 좌표는 공식 프로젝트 자료에 포함됨).
선택형 유료 기능도 있지만, 핵심 플러그인과 주요 위장 기능은 무료로 제공됩니다.

🧩 대상 사용자

플레이어 또는 몹 꾸미기와 롤플레이 기능을 원하는 서버 관리자와 운영자.
위장을 프로그래밍 방식으로 생성하거나 수정할 API가 필요한 플러그인 개발자.
동적인 시각적 변환이나 NPC 외형이 필요한 미니게임 및 RPG 서버.

🏗️ 사용 예시

모더레이터에게 임시 플레이어 위장을 부여해, 다른 스킨으로 보이게 하면서 행동을 모니터링한다.
사용자 지정 플레이어 스킨을 사용해 NPC 상점 주인이나 퀘스트 제공자를 표현할 때 위장을 사용한다.
플레이어가 일시적으로 몹이나 아이템으로 변신해 게임플레이 효과를 내는 미니게임 메커니즘을 만든다.

⚙️ 설치

📥 설정

공식 자료에서 Libs Disguises 플러그인의 공식 JAR을 받습니다.
JAR 파일을 서버의 plugins/ 디렉터리에 넣습니다.
서버를 재시작하고 콘솔에서 플러그인이 정상적으로 로드되었는지 확인합니다.

📦 의존성

이 플러그인은 호환되는 PacketEvents 빌드가 필요합니다. 설치하는 PacketEvents 버전이 Libs Disguises 빌드와 일치하는지 확인하세요.

타사나 비공식 빌드에 의존하지 말고, 다운로드와 의존성 정보는 플러그인의 공식 배포 채널을 사용하세요.

🧠 기술 참고

공식 프로젝트 산출물과 개발자용 좌표는 Maven/Gradle 사용자를 위해 공개됩니다(프로젝트는 개발자 문서에서 저장소 좌표와 산출물 식별자를 제공합니다).
Libs Disguises의 최신 릴리스는 Minecraft 1.12보다 오래된 버전에서는 지원되지 않습니다. 서버의 Minecraft 버전에 맞는 빌드를 사용하세요.
이 프로젝트는 Java API를 제공하며(JavaDocs도 프로젝트에서 공개함), 다른 플러그인에 위장 기능을 통합하려는 개발자를 위한 것입니다.