Minecraft 플러그인 NPC

🔌 NPC 소개

NPC는 Spigot 서버용 Minecraft 플러그인으로, 관리자가 단순하고 영구적인 NPC를 만들 수 있게 해 줍니다. 각 NPC는 플레이어의 스킨을 복제하거나 엔티티 기반 스킨을 사용할 수 있으며, 서버 재시작 후에도 유지되도록 디스크에 저장되고, 플레이어가 상호작용하면 설정 가능한 메시지를 표시합니다.

🎯 목적

이 플러그인은 스태프 표시, 로비 선택기, 고정 상점 NPC 또는 더 복잡한 NPC 프레임워크가 필요하지 않은 간단한 상호작용을 위해, 서버 월드에 장식용 또는 인터랙티브 NPC를 가볍게 배치할 수 있는 방법을 제공합니다.

⚙️ 기능

• 기본적으로 생성한 플레이어의 스킨을 복제하는 NPC를 만들 수 있습니다.
• 엔티티 또는 스킨 이름을 지정해 NPC의 외형을 변경할 수 있습니다.
• 위치와 스킨 데이터를 data.yml 파일에 저장하여 NPC가 서버 재시작 후에도 유지됩니다.
• 각 NPC는 클릭 시 사용자 지정 메시지를 표시할 수 있습니다.
• 게임 내 관리를 위한 기본 생성 및 삭제 명령이 있습니다.
• 플러그인은 데이터를 플러그인 폴더(NpcMain)에 저장하며 첫 실행 시 data.yml을 생성합니다.
• 작성자가 제공하는 버전은 특정 Minecraft/Spigot 릴리스를 대상으로 하며, 지원되는 서버 버전마다 별도의 jar가 제공됩니다.

🧩 대상 사용자

이 플러그인은 더 큰 NPC 프레임워크의 복잡성 없이 단순하고 영구적인 NPC가 필요한 소규모~중규모 Spigot 서버 관리자에게 적합합니다. 메시지 표시나 장식용 존재가 필요한 로비 또는 서바이벌 서버에 알맞습니다.

🏗️ 사용 예시

• 클릭하면 서버 규칙을 보여주는 NPC를 스폰 지점에 배치하기.
• 스태프 멤버의 스킨과 맞는 장식용 조형물을 만들기.
• 로비에서 이름이 있는 클릭 가능한 선택기로 NPC를 사용해 메뉴를 열기(NPC 메시지를 통해서 또는 다른 플러그인과 함께 사용).

⌨️ 명령어

(위 명령어는 플러그인의 공식 자료에 문서화되어 있습니다.)

⚙️ 설치

📥 설정

• Spigot 서버 버전에 맞는 플러그인 jar를 다운로드합니다.
• jar 파일을 서버의 plugins/ 디렉터리에 넣습니다.
• 서버를 시작하거나 재시작합니다.
• 처음 로드되면 플러그인이 플러그인 폴더(NpcMain)와 NPC 항목을 저장할 data.yml 파일을 생성합니다.

📦 의존성

• 작성자가 문서화한 필수 의존성은 없습니다.

🧾 설정

• NPC 데이터(위치, 이름, 스킨 시그니처, 메시지)는 플러그인 폴더 안의 data.yml에 저장됩니다.
• data.yml을 편집하면 NPC의 이름이나 메시지를 변경할 수 있으며, 수동 변경 사항을 불러오려면 서버 재시작이 필요합니다.

🧠 기술 참고

• 작성자는 특정 Spigot/Minecraft 버전용으로 별도 빌드를 제공합니다. 현재 저장소 빌드는 Spigot 1.18.2를 대상으로 하며, 프로젝트는 주요 서버 릴리스 간에는 버전 간 하위 호환이 없다고 설명합니다.
• 프로젝트 저장소는 MIT 라이선스로 제공됩니다.
• 저장소 및 리소스 메타데이터에 표시된 대로 이 플러그인에는 사용량 메트릭(bStats)이 포함되어 있습니다.

🤝 이 플러그인이 유용한 경우

더 큰 NPC 프레임워크를 도입하지 않고 메시지를 표시하거나 장식/스태프용 표식 역할을 하는 단순하고 영구적인 NPC가 필요하다면, 이 플러그인은 Spigot 서버를 위한 작고 버전 지정형 솔루션을 제공합니다.