Minecraft 플러그인 Citizens

🔌 Citizens 소개

Citizens는 서버 측 NPC를 만들고 관리할 수 있는 완전한 시스템을 제공하는 Minecraft 플러그인입니다. 플레이어형, 몹, 상점 주인, 경비병, 동상 등 다양한 NPC 유형을 지원하며, 다른 플러그인과 커스텀 코드가 동작, trait, 연동을 추가할 수 있도록 API도 제공합니다.

🎯 목적

Citizens는 서버에서 영구적이고 설정 가능한 비플레이어 캐릭터가 필요한 문제를 해결합니다. NPC는 상호작용 가능한 상점 주인, 스크립트로 동작하는 연기자, 웨이포인트를 따라가는 경비병, 정보 안내소, 장식용 동상처럼 활용할 수 있습니다. 이 플러그인은 서버 운영자가 게임플레이 기능을 만들 때도, 개발자가 Citizens API로 기능을 확장할 때도 사용됩니다.

⚙️ 기능

• 게임 내 명령어로 NPC를 생성하고 제거할 수 있습니다.
• 다양한 NPC 유형(플레이어, 몹 기반, 주민 등)을 지원합니다.
• NPC에 명령어나 스크립트 동작을 할당할 수 있습니다(클릭/실행 트리거, 명령 연결).
• 이동하는 NPC를 위한 웨이포인트와 순찰 동작.
• NPC의 행동과 외형을 커스터마이즈하는 traits와 편집기.
• 템플릿과 영구 저장으로 재시작 후에도 NPC가 유지됩니다.
• 애드온, traits, 연동을 위한 개발자 API.

🧩 대상

• 상점, 안내, 장식용 인터랙티브 NPC를 원하는 서버 운영자.
• 연동이나 미니게임을 만들기 위해 NPC API가 필요한 플러그인 개발자.
• 장식용 또는 기능성 비플레이어 캐릭터가 필요한 커뮤니티 서버.

🏗️ 사용 예시

• Survival 서버에서 NPC 상점 주인을 사용해 경제 플러그인 없이 아이템을 교환합니다.
• RPG 서버에서 NPC에 스크립트를 넣어 퀘스트와 대화를 제공합니다.
• 관리자가 마을 주변의 웨이포인트를 따라 순찰하는 경비 NPC를 배치합니다.
• 개발자가 미니게임 상호작용을 위해 NPC에 커스텀 traits를 추가합니다.

⌨️ 명령어

(참고: /npc에는 특정 기능별로 더 세분화된 많은 하위 명령어와 권한 노드가 있습니다. 전체 명령어 목록은 플러그인 문서를 참고하세요.)

🔐 권한

(특정 명령어와 traits를 위한 추가 권한 노드가 많습니다. 플러그인의 권한 문서에 자세히 나와 있습니다.)

⚙️ 설치

📥 설정

• 프로젝트의 공식 배포본(플러그인 카탈로그 또는 프로젝트 다운로드)에서 Citizens 공식 JAR을 다운로드합니다.
• Spigot 또는 Paper 호환 서버의 plugins/ 디렉터리에 JAR을 넣습니다.
• 서버를 재시작하고 콘솔을 확인해 Citizens가 로드되었고 데이터 디렉터리를 생성했는지 확인합니다.

📦 의존성

• 기본적으로 필수 외부 의존성은 없습니다. Citizens는 보통 선택적 애드온(서드파티 애드온 또는 다른 플러그인)으로 확장되지만, 기본 동작에는 필수 사항이 없습니다.

🧠 기술 노트

• Citizens는 개발자용 API를 제공하여 다른 플러그인이 traits를 만들고, NPC와 상호작용하고, NPC 이벤트를 훅할 수 있게 합니다.
• 이 플러그인은 NPC 데이터를 영구적으로 저장하므로 재시작 후에도 NPC가 유지되며, 런타임 커스터마이즈를 위한 traits/편집기를 지원합니다.
• 공식 문서와 커뮤니티 위키에서 명령어, 권한, traits, 편집기, 연동 지점을 다룹니다.

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

지속 가능하고 스크립트 가능한 NPC와, 비플레이어 캐릭터를 게임플레이나 서버 시스템에 통합할 API가 필요하다면, Citizens는 서버 관리자와 플러그인 개발자 모두에게 필요한 핵심 NPC 관리, 영구 저장, 확장 지점을 제공합니다.