Minecraft 플러그인 FancyHolograms

🔌 FancyHolograms 소개

FancyHolograms는 Paper 및 Folia 서버용 Minecraft 플러그인으로, 게임의 표시 엔티티(text/item/block displays)와 패킷 처리를 사용해 설정 가능한 현대적인 홀로그램을 만듭니다. 이 프로젝트는 MIT 라이선스로 배포되며 FancyMcPlugins / FancyInnovations 생태계에서 유지 관리됩니다.

🎯 목적

이 플러그인은 서버 운영자가 읽기 쉽고 장식적인 홀로그램을 월드에 배치할 수 있게 해 줍니다. 텍스트 줄, 아이템 시각 요소, 블록 시각 요소를 지원하며, 고급 서식과 배치 옵션을 제공합니다. 장식, 안내 표지판, NPC 이름표, 상점 연출 등 시각적으로 풍부하고 성능이 좋은 떠 있는 표시가 필요한 서버를 대상으로 하며, Paper 및 Paper 기반 서버 소프트웨어에서 동작하도록 설계되었습니다.

⚙️ 기능

• 홀로그램 유형: text, item, block displays.
• 위치, 회전, 스케일을 완전히 제어 가능.
• MiniMessage 지원 텍스트 서식(지원되는 범위에서 색상, 그라데이션, 형식).
• 텍스트 정렬, 배경색, 그림자 옵션.
• 카메라를 향하는 동작을 위한 billboard 모드(fixed, center, horizontal, vertical).
• PlaceholderAPI 및 MiniPlaceholders를 통한 플레이스홀더 연동.
• FancyNpcs와의 연동으로 NPC 연결 홀로그램 지원.
• 명령어 기반 생성과 게임 내 편집.

🧩 대상 사용자

• Paper 또는 Folia를 운영하며 장식용 또는 정보용 떠 있는 표시가 필요한 서버 소유자와 관리자.
• 홀로그램을 라벨, 안내, 상점 표시 등에 사용하는 Survival, SMP, 미니게임, RPG 서버.
• PlaceholderAPI 또는 FancyNpcs를 사용하면서 통합된 홀로그램 콘텐츠를 원하는 서버.

🏗️ 사용 예시

• MiniMessage 서식을 사용해 스폰 지역에 여러 줄 정보 홀로그램을 만들기.
• 상점 상자 위에 item-display 홀로그램을 붙여 상품 미리보기를 보여주기.
• FancyNpcs 연동을 사용해 NPC의 동적 이름표나 상태 텍스트를 표시하기.

⌨️ 명령어

참고: 위의 생성/편집 예시는 공식 문서 예시에서 가져온 것입니다. 소스 문서 참조에서 명시적으로 문서화된 것은 version 명령 노드뿐입니다.

🔐 권한

⚙️ 설치

📥 설정

• 공식 배포(Modrinth / 공식 릴리스)에서 공식 플러그인 아티팩트를 다운로드합니다.
• 플러그인 .jar 파일을 서버의 plugins/ 디렉터리에 넣습니다.
• 서버를 재시작하고 콘솔 로그에서 플러그인이 정상적으로 로드되었는지 확인합니다.
• /fancyholograms version으로 설치된 버전을 확인합니다.

📦 의존성

• 확인된 연동: PlaceholderAPI(선택 사항), MiniPlaceholders(선택 사항), FancyNpcs(선택 사항). 이는 필수 핵심 의존성이 아니라 연동 항목으로 표시됩니다.

🧾 설정

• 이 플러그인은 명령어 기반 생성과 편집을 제공합니다. 서버 운영자는 사용 가능한 설정 옵션과 영구 파일에 대해 공식 문서를 참고해야 합니다.

🧠 기술 참고

• 지원 서버 소프트웨어: Paper 및 Folia(Paper 포크 포함).
• 렌더링에 Minecraft 표시 엔티티(text/item/block displays)와 패킷을 사용합니다.
• MIT 라이선스.

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

Paper 계열 서버에서 장식, 정보 표시, NPC 라벨용으로 MiniMessage와 PlaceholderAPI 연동이 포함된 현대적인 표시 엔티티 기반 홀로그램이 필요하다면, FancyHolograms는 설정 가능하고 유지 관리되는 솔루션을 제공합니다.