Minecraft 플러그인 FancyNpcs

FancyNpcs와 확인된 서버에 대한 정보

🔌 FancyNpcs 소개

FancyNpcs는 packets를 사용해 NPC(비플레이어 캐릭터)를 만들고 관리하는 Minecraft 플러그인입니다. Paper와 Folia 서버를 대상으로 하며, 엔티티 기반 NPC 플러그인에 대한 packets 기반 대안을 제공합니다. 이 플러그인은 서버 측 엔티티 부담을 최소화하면서 설정 가능한 외형과 상호작용에 중점을 둡니다.

🎯 목적

FancyNpcs는 장식용 표시, 인터랙티브 키오스크, 스크립트된 상호작용에 사용할 가볍고 커스터마이징 가능한 NPC가 필요한 서버 관리자용입니다. 완전한 서버 엔티티를 생성하지 않고, 클라이언트 측 packet 렌더링과 문서화된 액션 시스템을 사용해 무거운 NPC 구현의 문제를 해결합니다.

⚙️ 기능

  • 단일 /npc 명령으로 게임 내에서 NPC를 생성, 복사, 삭제, 목록 확인할 수 있습니다.
  • 플레이어형과 몹형 NPC를 지원하며, 사용자 이름, UUID, URL, 로컬 파일로 스킨을 설정할 수 있고 slim 모델도 지원합니다.
  • 장비 슬롯: helmet, chestplate, leggings, boots, main hand, offhand 설정.
  • 설정 가능한 색상의 발광 효과와 플레이어형 NPC의 플레이어 목록 표시 여부 옵션.
  • MiniMessage, PlaceholderAPI, MiniPlaceholders를 지원하는 표시 이름.
  • 트리거와 여러 액션 유형(add, remove, list, reorder, clear)을 갖춘 상호작용용 액션 시스템.
  • 위치 및 회전 제어, 이동/텔레포트 명령, 거리 기반 "플레이어를 바라보기" 동작.
  • 사용 가능한 경우 최신 Minecraft 버전의 크기/스케일 지원.
  • 플러그인은 프로그래밍 방식의 NPC 생성 및 관리를 위한 API를 제공합니다.

🧩 대상

  • 엔티티 부하를 늘리지 않고 장식용 또는 상호작용용 NPC를 원하는 Survival 및 SMP 서버.
  • 메뉴, 상점, 안내 지점용으로 가벼운 NPC가 필요한 네트워크 또는 로비.
  • 제공되는 API로 NPC 생성을 통합하고 싶은 개발자.

🏗️ 사용 예시

  • 허브 서버가 클릭하면 정보를 보여주는 커스텀 스킨의 고정형 NPC를 만듭니다.
  • RPG 서버가 스크립트된 액션이 있는 NPC를 사용해 플레이어를 안내하거나 명령과 메시지를 실행합니다.
  • 개발자 플러그인이 FancyNpcs API를 사용해 런타임에 NPC를 등록합니다.

⌨️ 명령어

CommandDescriptionPermissionAccess
/npc helpNPC 명령어 도움말을 표시합니다.fancynpcs.command.npc.helpAdmin
/npc create (name)새 NPC를 생성합니다(위치, 월드, 타입 플래그 지원).fancynpcs.command.npc.createAdmin
/npc remove (npc)지정한 NPC를 제거합니다.fancynpcs.command.npc.removeAdmin
/npc list모든 NPC를 목록으로 표시합니다(필터 가능).fancynpcs.command.npc.listAdmin
/npc info (npc)NPC 정보를 표시합니다.fancynpcs.command.npc.infoAdmin
/npc skin (npc) (...)NPC 스킨을 변경합니다(username, url, file, mirror).fancynpcs.command.npc.skinAdmin
`/npc equipment (npc) (setclearlist)`NPC의 장비 슬롯을 설정하거나 비웁니다.
/npc teleport (npc)지정한 NPC로 텔레포트합니다.fancynpcs.command.npc.teleportAdmin
/npc action (npc) (trigger) add (actiontype)NPC의 트리거에 액션을 추가합니다.fancynpcs.command.npc.action.addAdmin

🔐 권한

PermissionDescriptionDefault
fancynpcs.command.npc.help/npc help 명령어 사용.not specified
fancynpcs.command.npc.create새 NPC 생성.not specified
fancynpcs.command.npc.remove기존 NPC 제거.not specified
fancynpcs.command.npc.list월드 전반의 NPC 목록 확인.not specified
fancynpcs.command.npc.infoNPC 상세 정보 보기.not specified
fancynpcs.command.npc.skinNPC의 스킨 변경.not specified
fancynpcs.command.npc.equipment.(sub)NPC 장비 슬롯 관리.not specified
fancynpcs.command.npc.action.addNPC 트리거에 액션 추가.not specified
fancynpcs.command.npc.teleportNPC로 텔레포트.not specified

⚙️ 설치

📥 설정

  • 지원되는 배포 페이지에서 FancyNpcs 플러그인 JAR을 다운로드합니다.
  • JAR을 서버의 plugins/ 디렉터리에 넣습니다.
  • 서버를 재시작하고 콘솔에서 플러그인이 로드되었는지 확인합니다.

📦 종속성

  • FancyNpcs는 Paper와 Folia 서버 소프트웨어용으로 제작되었으며, 실행하려면 Paper가 필요합니다. 제작자는 추가적인 외부 플러그인 종속성이 필요하지 않다고 문서화합니다.

🧾 설정

  • 이 플러그인은 대부분의 작업을 게임 내 명령어로 제공합니다. 설정 파일과 플러그인 동작은 공식 문서에 설명되어 있습니다.

🧠 기술 참고

  • 확인된 지원 서버 소프트웨어: Paper와 Folia.
  • FancyNpcs는 지속적인 서버 측 엔티티를 생성하는 대신 packets 기반 렌더링으로 클라이언트에 NPC를 표시합니다.
  • 이 프로젝트는 통합 및 프로그래밍 방식의 NPC 생성/등록을 위한 Java API를 제공합니다.
  • 제작자는 옵트아웃 가능한 익명 사용 통계를 수집합니다. 데이터 수집 세부 사항은 프로젝트 문서에 나와 있습니다.

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

서버 엔티티 부하를 낮게 유지하면서 유연한 외형과 스크립트된 상호작용을 가진 클라이언트 렌더링 NPC가 필요하다면, FancyNpcs는 게임 내 관리와 통합용 API를 갖춘 packets 기반 솔루션을 제공합니다.

FancyNpcs 플러그인 서버

플러그인 FancyNpcs 페이지에는 모니터링에서 이 플러그인을 확인한 서버, 사용 중인 플랫폼과 버전이 표시됩니다.

플러그인은 명령어, 경제, 보호, 접근 권한, 미니게임, 연동 및 기타 메커니즘을 추가할 수 있습니다. FancyNpcs의 실제 역할은 서버별 설정에 따라 다릅니다.

데이터는 서버의 기술 응답에서 자동으로 생성됩니다. 서버가 플러그인 목록을 비공개로 설정한 경우, FancyNpcs을 사용하더라도 이 섹션에 표시되지 않을 수 있습니다.

FancyNpcs을 사용하는 서버 목록을 통해 프로젝트를 비교하거나, 지원 버전을 확인하거나, 공개 서버에서의 플러그인 사용 사례를 찾을 수 있습니다.