ZNPCs: wtyczka do tworzenia NPC w Minecraft
Zależności: Typ serwera: Paper lub Spigot 1.8.8–1.21.4 Wersja Minecraft: 1.8.8–1.21.4 Wymagane wtyczki: PlaceholderAPI (opcjonalnie, do…
Zależności: Typ serwera: Paper lub Spigot 1.8.8–1.21.4 Wersja Minecraft: 1.8.8–1.21.4 Wymagane wtyczki: PlaceholderAPI (opcjonalnie, do zmiennych w hologramach) Pobierz: SpigotMC / GitHub Jeśli potrzebujesz prostych NPC
Zależności:
Typ serwera: Paper lub Spigot 1.8.8–1.21.4
Wersja Minecraft: 1.8.8–1.21.4
Wymagane wtyczki: PlaceholderAPI (opcjonalnie, do zmiennych w hologramach)
Pobierz: SpigotMC / GitHub
Jeśli potrzebujesz prostych NPC do lobby lub dekoracji, Citizens może okazać się zbyt rozbudowane. ZNPCs rozwiązuje to samo zadanie prościej: to jeden plik .jar bez sterty zależności, który pozwala umieszczać postacie z własnym skinem, tekstem i reakcją na kliknięcie.
Główne możliwości
Każdy NPC ma unikalny identyfikator liczbowy. Można stworzyć zwykłego gracza ze skinem na podstawie nicku lub adresu URL, albo umieścić moba w rodzaju ZOMBIE czy SKELETON.
Gdy gracz kliknie na NPC, wtyczka wykonuje zadane akcje. Może to być wiadomość, komenda w imieniu gracza lub konsoli, a nawet wysłanie gracza na inny serwer przez BungeeCord. Jeśli akcji jest kilka, wykonają się po kolei. Można też ustawić cooldown (opóźnienie) dla każdej akcji.
Tekst nad głową (Lines)
Nad NPC można dodać tekst za pomocą komendy lines. Wtyczka obsługuje kody kolorów, a jeśli zainstalowane jest PlaceholderAPI, to również zmienne, takie jak %player_name% czy %server_online%. Wysokość tekstu można też zmienić komendą height.
Trasy (Paths)
NPC nie musi koniecznie stać w miejscu. Aby nauczyć go chodzić, należy włączyć tryb nagrywania (/znpcs path create <nazwa>) i samodzielnie przejść żądaną trasę. Po zakończeniu trzeba wpisać /znpcs path exit. Następnie tę trasę przypisuje się konkretnemu NPC (/znpcs path set <id> <nazwa>), a on zaczyna po niej w nieskończoność kursować.
Ważny niuans: ruch jest bardzo prosty. ZNPCs nie korzysta z waniliowego wyszukiwania ścieżki (Pathfinder), więc postacie nie będą omijać przeszkód ani reagować na innych graczy.
Wyposażenie i wygląd
Postacie można ubrać w zbroję i dać im przedmioty do rąk. Wystarczy wziąć potrzebną rzecz i wpisać /znpcs equip <id> <slot> (dostępne sloty: HAND, OFFHAND, HELMET, CHESTPLATE, LEGGINGS, BOOTS).
Istnieje też możliwość skonfigurowania zachowania NPC za pomocą komendy toggle: zmusić go, by patrzył na pobliskich graczy (look), odzwierciedlał skin gracza, który na niego patrzy (mirror), albo dodać podświetlenie (glow) w wybranym kolorze.
Komendy
Te komendy wymagają uprawnień administratora (znpcs.admin).
Komenda | Opis | Uprawnienie |
| Tworzy NPC na twoich współrzędnych | znpcs.admin |
| Usuwa NPC | znpcs.admin |
| Wyświetla listę NPC i ich ID | znpcs.admin |
| Teleportuje NPC do ciebie | znpcs.admin |
| Teleportuje ciebie do NPC | znpcs.admin |
| Zmienia typ istniejącego NPC | znpcs.admin |
| Zmienia skin postaci | znpcs.admin |
| Daje przedmiot z twojej ręki NPC | znpcs.admin |
| Zmienia tekst nad NPC | znpcs.admin |
| Zmienia wysokość tekstu (domyślnie 1) | znpcs.admin |
| Dodaje akcję przy kliknięciu | znpcs.admin |
| Pokazuje listę akcji NPC (wraz z ich ID) | znpcs.admin |
| Usuwa akcję na podstawie jej ID | znpcs.admin |
| Ustawia opóźnienie na wykonanie akcji | znpcs.admin |
| Nagrywa nową trasę | znpcs.admin |
| Wychodzi z trybu nagrywania trasy | znpcs.admin |
| Przypisuje trasę do NPC | znpcs.admin |
| Włącza/wyłącza opcje (look, holo, mirror) | znpcs.admin |
| Dodaje efekt świecenia w wybranym kolorze | znpcs.admin |
Typy akcji dla action add:
CMD (wykonuje komendę w imieniu gracza)
CONSOLE (wykonuje komendę z konsoli)
CHAT (gracz pisze wiadomość na czacie)
MESSAGE (wysyła wiadomość do gracza)
SERVER (przerzuca na inny serwer przez BungeeCord)
Uprawnienia
Tutaj wszystko jest maksymalnie proste. Niemal do wszystkiego potrzebny jest tylko jeden węzeł:
Węzeł | Co daje |
znpcs.admin | Pełny dostęp do wszystkich komend |
Konfiguracja
config.json
Parametr | Wartość | Opis |
| 500 | Maksymalna liczba punktów (kroków), które można zapisać dla jednej trasy NPC. Jeśli trasa jest zbyt długa, nagrywanie zatrzyma się automatycznie po osiągnięciu tego limitu. |
| "DEFAULT" | Algorytm generowania wewnętrznych nazw dla NPC. Wartość domyślna zapewnia poprawne powiązanie ID. |
| TRUE | Automatycznie wyrównuje NPC dokładnie do środka bloku podczas jego tworzenia. Zapobiega przesunięciu modelu do krawędzi bloku. |
| "-" | Symbol, którego wtyczka używa do zastępowania spacji w tekście komend lub przy generowaniu identyfikatorów. |
| 600 | Interwał automatycznego zapisywania utworzonych postaci do pliku npcs.json (600 sekund = 10 minut). Chroni przed utratą danych przy nagłym padzie serwera. |
| TRUE | Aktywacja trybu debugowania. Wtyczka zacznie wypisywać szczegółowe informacje techniczne i logi błędów w konsoli serwera. Zaleca się wyłączenie (false) na stabilnych serwerach dla czystości konsoli. |
| 0.3 | Odległość między wierszami hologramu (tekstu) nad głową NPC. Mniejsza wartość sprawia, że tekst jest bardziej zbity. |
| 32 | Promień (w blokach), w którego granicach serwer zaczyna wysyłać graczowi pakiety do renderowania modelu NPC. Zmniejszenie wartości oszczędza zasoby serwera i klienta. |
| FALSE | Obsługa dynamicznej zmiany kolorów (przejścia RGB) dla tekstu hologramów. Włączenie może tworzyć dodatkowe obciążenie dla klienta. |
npcs.json
Wszystkie utworzone NPC są zapisywane w pliku npcs.json. Wtyczka generuje go automatycznie, więc lepiej nie edytować go ręcznie. Jedynym usprawiedliwieniem, by zaglądać do tego pliku, jest sytuacja, gdy trzeba przenieść skonfigurowane NPC na inny serwer.
conversations.json
Wszystkie dialogi są przechowywane tutaj.
paths
Folder, w którym przechowywane są wszystkie nagrane trasy.
data.json
Tutaj przechowywane są wszystkie szczegółowe informacje o utworzonych NPC.
Integracje
Jeśli na serwerze zainstalowane jest PlaceholderAPI, ZNPCs wykryje je automatycznie, bez specjalnych rozszerzeń. Przyda się to na przykład wtedy, gdy chcesz wyświetlić nad NPC dynamiczny licznik graczy online.
Kompatybilność
Oryginalne ZNPCs działa poprawnie tylko do wersji 1.21.1. Na nowsze serwery (1.21.1 i wyższe) trzeba instalować fork ZNPC Plus.
Ponadto wtyczka nie uruchomi się na Folii ze względu na specyfikę jej działania z encjami.
Kiedy warto używać ZNPCs
Jeśli musisz postawić na spawnie NPC, który po prostu otworzy menu, wyda zestaw startowy albo przerzuci graczy na inne serwery minigier, ZNPCs to świetny wybór. Robi dokładnie to, co obiecuje, i nie obciąża serwera niepotrzebną funkcjonalnością.
Ale jeśli planujesz robić rozbudowane dialogi lub złożone questy, potrzebujesz ekosystemu Citizens + Denizen. ZNPCs nie jest do tego przeznaczone.
Instalacja
Typowa instalacja zajmuje około 5 minut. Procedura jest taka sama; różni się tylko loader i odpowiedni build.
- 1Stop your Minecraft server.
- 2Drop the plugin .jar into the server /plugins folder.
- 3Start the server once so the plugin generates its config files.
- 4Edit /plugins/<name>/config.yml as needed, then run /reload confirm or restart.
