Citizens
Tworzenie NPC (postaci niezależnych) z wyglądem graczy, dialogami, ścieżkami ruchu i integracja z questami. Podstawa serwerów RPG.
O pluginie Citizens
Citizens to plugin do tworzenia i zarządzania NPC (Non-Player Characters) na serwerze Minecraft. NPC wyglądają jak prawdziwi gracze (z dowolnym skinem), ale sa kontrolowane przez serwer. Mogą stać w miejscu, chodzić wyznaczonymi ścieżkami, prowadzić dialogi, handlować z graczami i pelnic funkcje questowe. Citizens jest fundamentem serwerów RPG i MMO. NPC mogą mieć różne typy: handlarz (sprzedaje/kupuje przedmioty), strażnik (atakuje wrogi moby), przewodnik (prowadzi gracza trasa) czy questgiver (wydaje zadania).
Plugin jest modularny. Podstawowy Citizens daje tworzenie NPC i ścieżki ruchu. Denizen (osobny plugin) dodaje zaawansowane skrypty, dialogi i mechaniki questowe. Citizens wspiera tez integracje z Sentinel (NPC jako straznik/wojownik) i BetonQuest (system questów).
Citizens to jeden z kluczowych pluginów RPG, który powinienes rozważyć na swoim serwerze Minecraft. Wspiera wersje 1.8.8 - 1.21.x i działa na Spigot, Paper, Purpur.
Funkcje Citizens
Poniżej lista głównych funkcji, które Citizens dodaje do Twojego serwera. Każda z nich można skonfigurować w pliku konfiguracyjnym pluginu.
- NPC z dowolnym skinem
- Ścieżki ruchu (waypoints)
- Integracja z Denizen (dialogi)
- Różne typy NPC (handlarz, strażnik)
- Sentinel (NPC bojowe)
- Obsługa ponad 20 typów bytów
Komendy Citizens
Citizens rejestruje 6 komend (pokazujemy najważniejsze). Pelna lista dostępna jest w oficjalnej dokumentacji. Pamiętaj, ze każda komendę możesz zablokować lub odlokowac przez system uprawnień (np. LuckPerms).
| Komenda | Opis | Uprawnienie |
|---|---|---|
/npc create [nazwa] | Tworzy nowe NPC | citizens.npc.create |
/npc skin [nick] | Ustawia skin NPC z konta gracza | citizens.npc.skin |
/npc select | Zaznacza NPC (kliknij prawym) | citizens.npc.select |
/npc remove | Usuwa zaznaczone NPC | citizens.npc.remove |
/npc tphere | Teleportuje NPC do Ciebie | citizens.npc.tphere |
/npc lookclose | NPC patrzy na najbliższego gracza | citizens.npc.lookclose |
Uprawnienia (permissions)
System uprawnień pozwala kontrolować, kto może używać poszczególnych funkcji Citizens. Uprawnienia nadajesz przez plugin rang, np. LuckPerms (/lp group [grupa] permission set [node] true). Kolumna "Domyślnie OP" oznacza, czy operatorzy serwera maja to uprawnienie bez konfiguracji.
Konfiguracja Citizens
Po pierwszym uruchomieniu Citizens wygeneruje plik konfiguracyjny w folderze plugins/Citizens/. Poniżej najważniejsze opcje z komentarzami. Pełna lista ustawień jest w oficjalnej dokumentacji.
# config.yml Citizens
npc:
default:
look-close:
enabled: false # Domyślnie NPC nie patrzy na graczy
range: 5 # Zasięg patrzenia
pathfinding:
enabled: true
attack-range: 1.75 # Zasięg ataku strażnikow
max-npcs-per-player: 10 # Limit NPC per gracz
Po zmianie konfiguracji zapisz plik i użyj komendy przeładowania pluginu (np. /reload lub dedykowanej komendy pluginu). Jeśli plugin nie pobiera zmian po przeładowaniu, zrestartuj serwer komenda /stop.
Jak zainstalować Citizens
Pobierz Citizens z oficjalnego CI. Wrzuć .jar do plugins/, zrestartuj serwer. Twórz NPC komenda /npc create [nazwa]. Dla dialogów i questów zainstaluj Denizen lub BetonQuest.
- Pobierz Citizens z oficjalnej strony. Upewnij się, ze pobierasz wersje kompatybilna z Twoja wersja Minecraft (1.8.8 - 1.21.x).
-
Skopiuj pobrany plik
.jardo folderuplugins/w katalogu Twojego serwera. -
Zrestartuj serwer komenda
/stopi uruchom go ponownie. Nie używaj/reloadprzy pierwszej instalacji. - Sprawdź konsole serwera. Jeśli Citizens załadował się poprawnie, zobaczysz komunikat z wersja pluginu. Jeśli pojawił się błąd, sprawdź czy masz zainstalowane wszystkie zaleznosciow.
-
Skonfiguruj plugin edytujac plik
plugins/Citizens/config.yml(lub odpowiednik). Po zmianach użyj komendy przeladowania.
Alternatywy dla Citizens
Citizens nie jest jedynym pluginem w swojej kategorii. Poniżej znajdziesz alternatywy, które warto rozważyć, jeśli szukasz czegoś innego lub Citizens nie spełnia Twoich oczekiwan.
FancyNPCs
Lżejsza alternatywa z minimalistycznym podejściem do tworzenia NPC.
ZNPCsPlus
Nowoczesny plugin NPC z obsługa pakietów, bez ProtocolLib.
Często zadawane pytania o Citizens
Jak zainstalować Citizens?
Pobierz Citizens z oficjalnego CI. Wrzuć .jar do plugins/, zrestartuj serwer. Twórz NPC komenda /npc create [nazwa]. Dla dialogów i questów zainstaluj Denizen lub BetonQuest. Szczegolowa instrukcja z zależnościami i konfiguracja znajduje się w sekcji instalacja powyżej.
Na jakich silnikach serwerowych działa Citizens?
Citizens działa na: Spigot, Paper, Purpur. Rekomendujemy Paper jako silnik - większości serwerów daje najlepsza równowagę miedzy wydajnością a kompatybilnością z pluginami. Więcej o silnikach serwerowych przeczytasz w naszym porównaniu.
Czy Citizens jest darmowy?
Citizens jest dostępny na oficjalnej stronie. Sprawdź szczegóły licencji na stronie pobierania.
Citizens nie działa - co robić?
Sprawdź plik logs/latest.log w katalogu serwera. Najczęstsze przyczyny błędów: (1) brakujaca zależność, (2) niekompatybilna wersja Minecraft (sprawdź czy masz 1.8.8 - 1.21.x), (3) błąd w pliku config.yml (sprawdź format YAML), (4) konflikt z innym pluginem o tej samej funkcji.
Czy mogę używać Citizens na serwerze Bedrock?
Nie. Citizens to plugin Java Edition i działa na serwerach Spigot/Paper/Purpur. Bedrock Edition używa innego systemu (behavior packs). Jeśli chcesz łączyć graczy Java i Bedrock na jednym serwerze, sprawdź Geyser.
Komentarze