Serwery Minecraft z pluginem HolographicDisplays

## 🔌 O Holographic Displays Holographic Displays to wtyczka do Minecrafta, która zapewnia trwałe, unoszące się hologramy mogące wyświetlać tekst i przedmioty. Wtyczka udostępnia komendy w grze do tworzenia i edytowania hologramów oraz oferuje API dla deweloperów do integrowania hologramów z innymi wtyczkami. ## 🎯 Cel Wtyczka rozwiązuje potrzebę wyświetlania unoszących się informacji, etykiet, menu i elementów wizualnych w świecie bez tworzenia trwałych, widocznych encji. Przydaje się do administracji serwera, dekoracyjnych wyświetlaczy, menu w świecie oraz integracji, w których wtyczki muszą prezentować dane graczom w stałych lokalizacjach. ## ⚙️ Funkcje - Tworzenie i usuwanie hologramów z nazwą w określonych lokalizacjach. - Dodawanie, usuwanie, ustawianie i wstawianie linii tekstu w hologramach. - Wyświetlanie unoszących się przedmiotów jako linii hologramu (obsługa floating items). - Wczytywanie linii z pliku tekstowego do hologramu. - Odczytywanie i renderowanie obrazów do hologramu z pliku lub URL (z konfigurowalnym mapowaniem symboli i maksymalną szerokością). - Wyrównywanie, przenoszenie, kopiowanie i teleportowanie do hologramów. - Przeładowywanie konfiguracji wtyczki i zapisanych hologramów bez ręcznej edycji plików. - Dostępne API dla deweloperów, aby inne wtyczki mogły tworzyć i zarządzać hologramami programowo. ## 🧩 Dla kogo - Administratorów serwerów, którzy chcą wizualnych wyświetlaczy w świecie (serwery SMP, Survival, Minigame). - Twórców wtyczek, którzy potrzebują API do prezentowania graczom tekstu/przedmiotów w świecie. - Zespoły staffu używające hologramów do znaków, menu lub wyświetlaczy informacyjnych. ## 🏗️ Przykładowe zastosowania - Minigra pokazuje aktualne wyniki nad każdą areną za pomocą hologramów. - Lobby serwera wyświetla zasady serwera i przedmioty do teleportacji po kliknięciu jako unoszące się linie. - Integracja wtyczki publikuje dynamiczne statystyki gracza na hologramie w stałej lokalizacji. ## ⌨️ Komendy | **Komenda** | **Opis** | **Uprawnienie** | **Dostęp** | |---|---|---:|:---| | `/hd` | Główna komenda; pokazuje informacje o wtyczce i wersję. | brak (dostępna dla wszystkich) | Gracz | | `/hd help` | Pokazuje dostępne komendy i krótką pomoc. | brak (dostępna dla wszystkich) | Gracz | | `/hd create <hologramName> [text]` | Tworzy nowy hologram w twojej lokalizacji. | `holographicdisplays.create` | Admin | | `/hd delete <hologram>` | Usuwa hologram z nazwą. | `holographicdisplays.delete` | Admin | | `/hd list [page]` | Wyświetla istniejące hologramy i lokalizacje. | `holographicdisplays.list` | Admin | | `/hd near <radius>` | Wyświetla hologramy w pobliżu w określonym promieniu. | `holographicdisplays.near` | Admin | | `/hd teleport <hologram>` | Teleportuje do lokalizacji hologramu. | `holographicdisplays.teleport` | Admin | | `/hd align <axis> <hologram> <reference>` | Wyrównuje jeden hologram do drugiego na wskazanej osi. | `holographicdisplays.align` | Admin | | `/hd movehere <hologram>` | Przenosi hologram na twoją pozycję. | `holographicdisplays.movehere` | Admin | | `/hd edit <hologram>` | Otwiera opcje edycji hologramu. | `holographicdisplays.edit` | Admin | | `/hd addline <hologram> <text>` | Dodaje linię tekstu do hologramu. | `holographicdisplays.addline` | Admin | | `/hd removeline <hologram> <number>` | Usuwa numerowaną linię z hologramu. | `holographicdisplays.removeline` | Admin | | `/hd setline <hologram> <number> <newText>` | Zmienia tekst określonej linii. | `holographicdisplays.setline` | Admin | | `/hd insertline <hologram> <number> <text>` | Wstawia linię po podanym indeksie. | `holographicdisplays.insertline` | Admin | | `/hd info <hologram>` | Wyświetla zawartość hologramu z numerami linii. | `holographicdisplays.info` | Admin | | `/hd copy <from> <to>` | Kopiuje zawartość jednego hologramu do drugiego. | `holographicdisplays.copy` | Admin | | `/hd readtext <hologram> <file>` | Wczytuje linie z pliku do hologramu. | `holographicdisplays.readtext` | Admin | | `/hd readimage <hologram> <image> <width> [-a]` | Renderuje obraz do hologramu z pliku lub URL. | `holographicdisplays.readimage` | Admin | | `/hd reload` | Przeładowuje konfigurację i zapisane hologramy. | `holographicdisplays.reload` | Admin | Uwaga: dokumentacja podaje, że każda podkomenda ma indywidualne uprawnienie (na przykład `/hd list` wymaga `holographicdisplays.list`). Główna komenda `/hd` jest dostępna dla wszystkich. ## 🔐 Uprawnienia | **Uprawnienie** | **Opis** | **Domyślne** | |---|---|---:| | `holographicdisplays.<subcommand>` | Indywidualne uprawnienie dla każdej podkomendy `/hd` (przykład: `holographicdisplays.list`). | nie określono | | `holographicdisplays.update` | Otrzymuj powiadomienia o aktualizacji po wejściu, jeśli włączono to w konfiguracji. | nie określono | | `holographicdisplays.*` | Przyznaje wszystkie uprawnienia holographicdisplays (jeśli obsługuje to wtyczka uprawnień). | nie określono | ## ⚙️ Instalacja ### 📥 Konfiguracja - Pobierz oficjalny plik JAR wtyczki z zaufanego katalogu. - Umieść plik JAR w katalogu `plugins/` serwera dla Bukkit/Spigot. - Uruchom ponownie serwer i sprawdź konsolę, aby potwierdzić, że wtyczka została załadowana. ### 📦 Zależności - W oficjalnym skrócie dokumentacji nie podano wymaganych zależności; przy instalacji sprawdź stronę pobierania pod kątem opcjonalnych integracji. ### 🧾 Konfiguracja - Wtyczka obsługuje pliki konfiguracyjne i zapisane hologramy; użyj dostarczonej komendy przeładowania, aby zastosować zmiany po edycji plików. - Renderowanie obrazów i mapowanie symboli można skonfigurować w ustawieniach wtyczki. ## 🧠 Uwagi techniczne - Oficjalna dokumentacja zawiera poradnik aktualizacji dla Minecraft 1.13+ dotyczący zmian nazw materiałów oraz obsługi obrazów/ikon. - Udokumentowano API dla deweloperów do integracji z wtyczkami. ## 🤝 Kiedy ta wtyczka jest przydatna Jeśli potrzebujesz trwałych, edytowalnych wyświetlaczy w świecie do informacji, menu lub integracji z wtyczkami, Holographic Displays oferuje hologramy z nazwą, import plików/obrazów oraz API, dzięki któremu inne wtyczki mogą niezawodnie tworzyć i aktualizować hologramy.

Pluginy