Plugin Minecraft NPC

🔌 O NPC

NPC to wtyczka do Minecrafta dla serwerów Spigot, która pozwala administratorom tworzyć proste, trwałe NPC. Każdy NPC może sklonować skina gracza lub używać skina opartego na encji, jest zapisywany na dysku, dzięki czemu przetrwa restarty serwera, i wyświetla konfigurowalną wiadomość, gdy gracz wchodzi z nim w interakcję.

🎯 Cel

Wtyczka zapewnia lekki sposób umieszczania dekoracyjnych lub interaktywnych NPC w świecie serwera — jako oznaczenia dla administracji, selektory lobby, statycznych handlarzy lub inne proste interakcje, w których nie są potrzebne rozbudowane frameworki NPC.

⚙️ Funkcje

• Tworzenie NPC, które domyślnie kopiują skina gracza tworzącego.
• Opcja wskazania encji lub nazwy skina, aby zmienić wygląd NPC.
• NPC pozostają po restartach serwera dzięki zapisywaniu lokalizacji i danych skina do pliku data.yml.
• Każdy NPC może wyświetlać własną wiadomość po kliknięciu.
• Podstawowe komendy tworzenia i usuwania do administracji w grze.
• Wtyczka przechowuje dane w folderze wtyczki (NpcMain) i tworzy data.yml przy pierwszym uruchomieniu.
• Wersje udostępniane przez autora są przeznaczone dla konkretnych wydań Minecraft/Spigot (osobny jar dla każdej obsługiwanej wersji serwera).

🧩 Dla kogo

Ta wtyczka jest przeznaczona dla administratorów małych i średnich serwerów Spigot, którzy potrzebują prostych, trwałych NPC bez złożoności większych frameworków NPC. Nadaje się do serwerów lobby lub survival, które wymagają statycznych NPC do komunikatów lub efektu kosmetycznego.

🏗️ Przykładowe zastosowania

• Umieszczenie NPC na spawnie, który po kliknięciu pokazuje zasady serwera.
• Stworzenie kosmetycznego posągu zgodnego ze skinem członka administracji.
• Używanie NPC jako nazwanych, klikalnych selektorów w lobby do otwierania menu (przez wiadomość NPC lub w połączeniu z innymi wtyczkami).

⌨️ Komendy

(Powyższe komendy są opisane w oficjalnych materiałach wtyczki.)

⚙️ Instalacja

📥 Konfiguracja

• Pobierz jar wtyczki odpowiedni dla wersji twojego serwera Spigot.
• Wgraj jar do katalogu plugins/ na serwerze.
• Uruchom lub zrestartuj serwer.
• Przy pierwszym uruchomieniu wtyczka utworzy folder wtyczki (NpcMain) oraz plik data.yml do przechowywania wpisów NPC.

📦 Zależności

• Autor nie dokumentuje wymaganych zależności.

🧾 Konfiguracja

• Dane NPC (pozycje, nazwy, sygnatury skina, wiadomości) są przechowywane w data.yml wewnątrz folderu wtyczki.
• Edycja data.yml pozwala zmienić nazwę lub wiadomość NPC; do wczytania ręcznych zmian wymagany jest restart serwera.

🧠 Uwagi techniczne

• Autor publikuje osobne buildy dla konkretnych wersji Spigot/Minecraft; bieżący build repozytorium jest przeznaczony dla Spigot 1.18.2, a projekt zaznacza, że wersje nie są wstecznie kompatybilne między dużymi wydaniami serwera.
• Repozytorium projektu jest objęte licencją MIT.
• Wtyczka zawiera metryki użycia (bStats), jak wskazują metadane repozytorium i zasobu.

🤝 Kiedy ta wtyczka się przydaje

Jeśli potrzebujesz prostych, trwałych NPC, które wyświetlają wiadomości lub służą jako kosmetyczne/administracyjne znaczniki bez wdrażania większego frameworka NPC, ta wtyczka oferuje małe, dopasowane do wersji rozwiązanie dla serwerów Spigot.