ZNPCs: Minecraft에서 NPC를 만드는 플러그인
의존성: 서버 유형: Paper 또는 Spigot 1.8.8–1.21.4 Minecraft 버전: 1.8.8–1.21.4 의존 플러그인: PlaceholderAPI (선택 사항, 홀로그램의 변수용) 다운로드: SpigotMC / GitHub 로비나…
의존성: 서버 유형: Paper 또는 Spigot 1.8.8–1.21.4 Minecraft 버전: 1.8.8–1.21.4 의존 플러그인: PlaceholderAPI (선택 사항, 홀로그램의 변수용) 다운로드: SpigotMC / GitHub 로비나 장식용으로 간단한 NPC가 필요하다면 Citizens는 너무 무겁게 느껴질 수 있습니다. ZNPCs는 같은 작업을 더 간단하게 해결합니다. 수많
의존성:
서버 유형: Paper 또는 Spigot 1.8.8–1.21.4
Minecraft 버전: 1.8.8–1.21.4
의존 플러그인: PlaceholderAPI (선택 사항, 홀로그램의 변수용)
다운로드: SpigotMC / GitHub
로비나 장식용으로 간단한 NPC가 필요하다면 Citizens는 너무 무겁게 느껴질 수 있습니다. ZNPCs는 같은 작업을 더 간단하게 해결합니다. 수많은 의존성 없이 하나의 .jar 파일만으로, 자신만의 스킨과 텍스트, 클릭 반응을 가진 캐릭터를 배치할 수 있습니다.
주요 기능
모든 NPC는 고유한 숫자 ID를 가집니다. 닉네임이나 URL로 스킨을 지정한 일반 플레이어를 만들거나, 좀비나 스켈레톤 같은 몹을 배치할 수 있습니다.
플레이어가 NPC를 클릭하면 플러그인이 지정된 동작을 실행합니다. 메시지, 플레이어 또는 콘솔 이름으로 실행되는 명령어, 심지어 BungeeCord를 통해 플레이어를 다른 서버로 보내는 것도 가능합니다. 동작이 여러 개라면 차례대로 실행됩니다. 각 동작에 쿨다운(지연)을 설정할 수도 있습니다.
머리 위 텍스트 (Lines)
lines 명령어로 NPC 위에 텍스트를 추가할 수 있습니다. 플러그인은 색상 코드를 지원하며, PlaceholderAPI가 설치되어 있으면 %player_name%이나 %server_online% 같은 변수도 지원합니다. height 명령어로 텍스트 높이를 변경할 수도 있습니다.
경로 (Paths)
NPC가 반드시 제자리에 서 있을 필요는 없습니다. 걷게 하려면 기록 모드를 켜고(/znpcs path create <이름>) 원하는 경로를 직접 걸어야 합니다. 완료한 후에는 /znpcs path exit를 입력해야 합니다. 그다음 이 경로를 특정 NPC에 지정하면(/znpcs path set <id> <이름>), 해당 NPC가 무한히 그 경로를 따라 이동하기 시작합니다.
중요한 점: 움직임이 매우 단순합니다. ZNPCs는 바닐라 경로 탐색(Pathfinder)을 사용하지 않으므로, 캐릭터는 장애물을 피하지 않고 다른 플레이어에게도 반응하지 않습니다.
장비 및 외형
캐릭터에게 갑옷을 입히고 손에 아이템을 쥐여줄 수 있습니다. 원하는 물건을 들고 /znpcs equip <id> <슬롯>를 입력하기만 하면 됩니다(사용 가능한 슬롯: HAND, OFFHAND, HELMET, CHESTPLATE, LEGGINGS, BOOTS).
또한 toggle 명령어로 NPC의 동작을 설정할 수 있습니다. 가까운 플레이어를 바라보게 하거나(look), 자신을 보는 플레이어의 스킨을 미러링하거나(mirror), 선택한 색상의 발광 효과를 추가할 수 있습니다(glow).
명령어
이 명령어들은 관리자 권한(znpcs.admin)이 필요합니다.
명령어 | 설명 | 권한 |
| 당신의 좌표에 NPC를 생성합니다 | znpcs.admin |
| NPC를 삭제합니다 | znpcs.admin |
| NPC 및 그 ID 목록을 출력합니다 | znpcs.admin |
| NPC를 당신에게 순간이동시킵니다 | znpcs.admin |
| 당신을 NPC에게 순간이동시킵니다 | znpcs.admin |
| 기존 NPC의 유형을 변경합니다 | znpcs.admin |
| 캐릭터의 스킨을 변경합니다 | znpcs.admin |
| 당신 손에 든 아이템을 NPC에게 줍니다 | znpcs.admin |
| NPC 위의 텍스트를 변경합니다 | znpcs.admin |
| 텍스트 높이를 변경합니다 (기본값 1) | znpcs.admin |
| 클릭 시 동작을 추가합니다 | znpcs.admin |
| NPC의 동작 목록을 표시합니다 (해당 ID 포함) | znpcs.admin |
| ID로 동작을 삭제합니다 | znpcs.admin |
| 동작 실행에 대한 지연을 설정합니다 | znpcs.admin |
| 새 경로를 기록합니다 | znpcs.admin |
| 경로 기록 모드를 종료합니다 | znpcs.admin |
| NPC에 경로를 지정합니다 | znpcs.admin |
| 옵션을 켜고/끕니다 (look, holo, mirror) | znpcs.admin |
| 선택한 색상의 발광 효과를 추가합니다 | znpcs.admin |
action add를 위한 동작 유형:
CMD (플레이어 이름으로 명령어를 실행)
CONSOLE (콘솔에서 명령어를 실행)
CHAT (플레이어가 채팅에 메시지를 작성)
MESSAGE (플레이어에게 메시지를 전송)
SERVER (BungeeCord를 통해 다른 서버로 보냄)
접근 권한
여기는 매우 간단합니다. 거의 모든 것에 단 하나의 노드만 필요합니다:
노드 | 제공 기능 |
znpcs.admin | 모든 명령어에 대한 전체 접근 권한 |
구성
config.json
매개변수 | 값 | 설명 |
| 500 | 하나의 NPC 경로에 기록할 수 있는 최대 지점(스텝) 수입니다. 경로가 너무 길면 이 한도에 도달했을 때 기록이 자동으로 중지됩니다. |
| "DEFAULT" | NPC의 내부 이름 생성 알고리즘입니다. 기본값은 올바른 ID 연결을 보장합니다. |
| TRUE | NPC 생성 시 블록 중앙에 정확히 자동 정렬합니다. 모델이 블록 가장자리로 치우치는 것을 방지합니다. |
| "-" | 플러그인이 명령어 텍스트의 공백을 대체하거나 식별자를 생성할 때 사용하는 기호입니다. |
| 600 | 생성된 캐릭터를 npcs.json 파일에 자동 저장하는 간격입니다(600초 = 10분). 서버가 갑자기 다운될 때 데이터 손실을 방지합니다. |
| TRUE | 디버그 모드 활성화입니다. 플러그인이 상세한 기술 정보와 오류 로그를 서버 콘솔에 출력하기 시작합니다. 콘솔을 깔끔하게 유지하기 위해 안정적인 서버에서는 끄는 것(false)을 권장합니다. |
| 0.3 | NPC 머리 위 홀로그램(텍스트) 줄 사이의 간격입니다. 값이 작을수록 텍스트가 더 밀집됩니다. |
| 32 | 서버가 NPC 모델을 렌더링하기 위해 플레이어에게 패킷 전송을 시작하는 반경(블록 단위)입니다. 값을 낮추면 서버와 클라이언트 자원을 절약합니다. |
| FALSE | 홀로그램 텍스트의 동적 색상 변화(RGB 그라데이션) 지원입니다. 활성화하면 클라이언트에 추가 부하가 생길 수 있습니다. |
npcs.json
생성된 모든 NPC는 npcs.json 파일에 기록됩니다. 플러그인이 자동으로 생성하므로 직접 편집하지 않는 것이 좋습니다. 이 파일을 건드릴 유일한 이유는 설정된 NPC를 다른 서버로 옮겨야 할 때입니다.
conversations.json
모든 대화가 여기에 저장됩니다.
paths
기록된 모든 경로가 저장되는 폴더입니다.
data.json
생성된 NPC에 대한 모든 상세 정보가 여기에 저장됩니다.
통합
서버에 PlaceholderAPI가 설치되어 있으면 ZNPCs가 특별한 확장 없이 자동으로 인식합니다. 예를 들어 NPC 위에 동적 온라인 카운터를 표시하고 싶을 때 유용합니다.
호환성
원본 ZNPCs는 1.21.1 버전까지만 정상적으로 작동합니다. 더 최신 서버(1.21.1 이상)에는 포크인 ZNPC Plus를 설치해야 합니다.
또한 이 플러그인은 엔티티 처리 방식의 특성 때문에 Folia에서는 작동하지 않습니다.
ZNPCs를 사용해야 할 때
단순히 메뉴를 열거나, 시작 키트를 지급하거나, 플레이어를 다른 미니게임 서버로 보내는 NPC를 스폰에 배치해야 한다면 ZNPCs가 훌륭한 선택입니다. 약속한 것을 정확히 수행하며 불필요한 기능으로 서버에 부담을 주지 않습니다.
하지만 분기형 대화나 복잡한 퀘스트를 만들 계획이라면 Citizens + Denizen 생태계가 필요합니다. ZNPCs는 그런 용도로 만들어지지 않았습니다.
설치
일반적인 설치는 약 5 분 정도 걸려요. 과정은 동일하고, Loader 와 그에 맞는 빌드만 달라요.
- 1Stop your Minecraft server.
- 2Drop the plugin .jar into the server /plugins folder.
- 3Start the server once so the plugin generates its config files.
- 4Edit /plugins/<name>/config.yml as needed, then run /reload confirm or restart.
