Minecraft 서버 HolographicDisplays 플러그인

## 🔌 Holographic Displays 소개 Holographic Displays는 텍스트와 아이템을 표시할 수 있는 지속형 떠다니는 홀로그램을 제공하는 Minecraft 플러그인입니다. 이 플러그인은 홀로그램을 만들고 편집할 수 있는 게임 내 명령을 제공하며, 다른 플러그인에 홀로그램을 통합할 수 있도록 개발자용 API도 제공합니다. ## 🎯 목적 이 플러그인은 영구적인 보이는 엔티티를 만들지 않고도 월드 안에 떠다니는 정보, 라벨, 메뉴, 시각 요소를 표시해야 하는 필요를 해결합니다. 서버 관리, 꾸미기용 표시, 월드 내 메뉴, 그리고 플러그인이 고정된 위치에서 플레이어에게 데이터를 보여줘야 하는 통합에 유용합니다. ## ⚙️ 기능 - 특정 위치에 이름이 있는 홀로그램을 생성하고 제거할 수 있습니다. - 홀로그램의 텍스트 줄을 추가, 삭제, 설정, 삽입할 수 있습니다. - 떠다니는 아이템을 홀로그램 줄로 표시할 수 있습니다(떠다니는 아이템 지원). - 텍스트 파일의 줄을 홀로그램으로 읽어올 수 있습니다. - 파일 또는 URL에서 이미지를 읽어 홀로그램으로 렌더링할 수 있습니다(기호 매핑과 최대 너비 설정 가능). - 홀로그램을 정렬, 이동, 복사하고 텔레포트할 수 있습니다. - 파일을 수동으로 수정하지 않고 플러그인 설정과 저장된 홀로그램을 다시 불러올 수 있습니다. - 다른 플러그인이 홀로그램을 프로그램적으로 생성하고 관리할 수 있는 개발자용 API가 제공됩니다. ## 🧩 대상 - 월드 안의 시각적 표시를 원하는 서버 관리자(SMP, Survival, Minigame 서버). - 월드에서 플레이어에게 텍스트/아이템을 보여주기 위한 API가 필요한 플러그인 개발자. - 표지판, 메뉴, 정보 표시용으로 홀로그램을 사용하는 운영팀. ## 🏗️ 사용 예시 - 미니게임이 각 아레나 위에 홀로그램으로 현재 점수를 표시합니다. - 서버 로비가 서버 규칙과 클릭 시 텔레포트되는 아이템을 떠다니는 줄로 표시합니다. - 플러그인 통합이 고정된 위치의 홀로그램에 동적인 플레이어 통계를 표시합니다. ## ⌨️ 명령어 | **명령어** | **설명** | **권한** | **접근** | |---|---|---:|:---| | `/hd` | 메인 명령어; 플러그인 정보와 버전을 보여줍니다. | 없음(모두 사용 가능) | Player | | `/hd help` | 사용 가능한 명령어와 간단한 도움말을 보여줍니다. | 없음(모두 사용 가능) | Player | | `/hd create <hologramName> [text]` | 현재 위치에 새 홀로그램을 만듭니다. | `holographicdisplays.create` | Admin | | `/hd delete <hologram>` | 이름이 있는 홀로그램을 삭제합니다. | `holographicdisplays.delete` | Admin | | `/hd list [page]` | 기존 홀로그램과 위치를 나열합니다. | `holographicdisplays.list` | Admin | | `/hd near <radius>` | 지정 반경 내에서 주변 홀로그램을 나열합니다. | `holographicdisplays.near` | Admin | | `/hd teleport <hologram>` | 홀로그램 위치로 텔레포트합니다. | `holographicdisplays.teleport` | Admin | | `/hd align <axis> <hologram> <reference>` | 지정한 축에서 한 홀로그램을 다른 홀로그램에 맞춥니다. | `holographicdisplays.align` | Admin | | `/hd movehere <hologram>` | 홀로그램을 자신의 발 위치로 옮깁니다. | `holographicdisplays.movehere` | Admin | | `/hd edit <hologram>` | 홀로그램의 편집 옵션으로 들어갑니다. | `holographicdisplays.edit` | Admin | | `/hd addline <hologram> <text>` | 홀로그램에 텍스트 줄을 추가합니다. | `holographicdisplays.addline` | Admin | | `/hd removeline <hologram> <number>` | 홀로그램에서 번호가 지정된 줄을 제거합니다. | `holographicdisplays.removeline` | Admin | | `/hd setline <hologram> <number> <newText>` | 특정 줄의 텍스트를 변경합니다. | `holographicdisplays.setline` | Admin | | `/hd insertline <hologram> <number> <text>` | 지정한 인덱스 뒤에 줄을 삽입합니다. | `holographicdisplays.insertline` | Admin | | `/hd info <hologram>` | 줄 번호와 함께 홀로그램 내용을 출력합니다. | `holographicdisplays.info` | Admin | | `/hd copy <from> <to>` | 한 홀로그램의 내용을 다른 홀로그램으로 복사합니다. | `holographicdisplays.copy` | Admin | | `/hd readtext <hologram> <file>` | 파일의 줄을 홀로그램으로 읽어옵니다. | `holographicdisplays.readtext` | Admin | | `/hd readimage <hologram> <image> <width> [-a]` | 파일 또는 URL에서 이미지를 홀로그램에 렌더링합니다. | `holographicdisplays.readimage` | Admin | | `/hd reload` | 설정과 저장된 홀로그램을 다시 불러옵니다. | `holographicdisplays.reload` | Admin | 참고: 문서에는 각 하위 명령어마다 개별 권한이 있다고 명시되어 있습니다(예: `/hd list`에는 `holographicdisplays.list`가 필요함). 메인 `/hd` 명령어는 누구나 사용할 수 있습니다. ## 🔐 권한 | **권한** | **설명** | **기본값** | |---|---|---:| | `holographicdisplays.<subcommand>` | 각 `/hd` 하위 명령어에 대한 개별 권한(예: `holographicdisplays.list`). | 지정되지 않음 | | `holographicdisplays.update` | 설정에서 활성화된 경우 접속 시 업데이트 알림을 받습니다. | 지정되지 않음 | | `holographicdisplays.*` | 모든 holographicdisplays 권한을 부여합니다(권한 플러그인이 지원하는 경우). | 지정되지 않음 | ## ⚙️ 설치 ### 📥 설정 - 신뢰할 수 있는 카탈로그에서 공식 플러그인 JAR을 다운로드합니다. - JAR을 Bukkit/Spigot용 서버의 `plugins/` 디렉터리에 넣습니다. - 서버를 재시작하고 콘솔에서 플러그인이 로드되었는지 확인합니다. ### 📦 의존성 - 공식 문서 요약에는 필수 의존성이 나열되어 있지 않습니다. 설치할 때 다운로드 페이지에서 선택적 통합이 있는지 확인하세요. ### 🧾 설정 - 이 플러그인은 설정 파일과 저장된 홀로그램을 지원합니다. 파일을 편집한 뒤에는 제공된 재로드 명령어로 변경 사항을 적용하세요. - 이미지 렌더링과 기호 매핑은 플러그인 설정에서 구성할 수 있습니다. ## 🧠 기술 참고 - 공식 문서에는 Minecraft 1.13+에서의 재료 이름 변경과 이미지/아이콘 처리에 대한 업그레이드 가이드가 포함되어 있습니다. - 플러그인 통합을 위한 개발자 API가 문서화되어 있습니다. ## 🤝 이 플러그인이 유용한 경우 정보, 메뉴, 또는 플러그인 통합을 위해 지속적이고 편집 가능한 월드 내 표시가 필요하다면, Holographic Displays는 이름이 있는 홀로그램, 파일/이미지 가져오기, 그리고 다른 플러그인이 홀로그램을 안정적으로 생성하고 업데이트할 수 있는 API를 제공합니다.

플러그인