Discord

Citizens

Tworzenie NPC (postaci niezależnych) z wygladem graczy, dialogami, sciezkami ruchu i integracja z questami. Podstawa serwerow RPG.

RPG i NPC SpigotPaperPurpur

O pluginie Citizens

Citizens to plugin do tworzenia i zarządzania NPC (Non-Player Characters) na serwerze Minecraft. NPC wygladaja jak prawdziwi gracze (z dowolnym skinem), ale sa kontrolowane przez serwer. Moga stac w miejscu, chodzic wyznaczonymi sciezkami, prowadzić dialogi, handlowac z graczami i pelnic funkcje questowe. Citizens jest fundamentem serwerow RPG i MMO. NPC moga miec 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 questow).

Citizens to jeden z kluczowych pluginow RPG, który powinienes rozwazyc 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 skonfigurowac w pliku konfiguracyjnym pluginu.

  • NPC z dowolnym skinem
  • Ścieżki ruchu (waypoints)
  • Integracja z Denizen (dialogi)
  • Różne typy NPC (handlarz, straznik)
  • Sentinel (NPC bojowe)
  • Obsługa ponad 20 typow bytow

Komendy Citizens

Citizens rejestruje 6 komend (pokazujemy najważniejsze). Pelna lista dostepna jest w oficjalnej dokumentacji. Pamietaj, ze każda komende możesz zablokowac lub odlokowac przez system uprawnien (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 najblizszego gracza citizens.npc.lookclose
Podpowiedz: Uzyj autouzupelniania w konsoli serwera (Tab), zeby zobaczyć dostępne argumenty komend. Na serwerze z LuckPerms nadawaj uprawnienia grupom, nie pojedynczym graczom.

Uprawnienia (permissions)

System uprawnien pozwala kontrolowac, kto może używać poszczegolnych funkcji Citizens. Uprawnienia nadajesz przez plugin rang, np. LuckPerms (/lp group [grupa] permission set [node] true). Kolumna "Domyslnie OP" oznacza, czy operatorzy serwera maja to uprawnienie bez konfiguracji.

Node uprawnienia Opis Domyslnie OP
citizens.npc.create Tworzenie NPC Tak
citizens.npc.edit Edycja NPC Tak
citizens.npc.remove Usuwanie NPC Tak

Konfiguracja Citizens

Po pierwszym uruchomieniu Citizens wygeneruje plik konfiguracyjny w folderze plugins/Citizens/. Poniżej najważniejsze opcje z komentarzami. Pełna lista ustawien jest w oficjalnej dokumentacji.

config.yml Przykladowa konfiguracja
# config.yml Citizens
npc:
  default:
    look-close:
      enabled: false       # Domyslnie NPC nie patrzy na graczy
      range: 5             # Zasieg patrzenia
    pathfinding:
      enabled: true
      attack-range: 1.75   # Zasieg ataku strażnikow
  max-npcs-per-player: 10  # Limit NPC per gracz

Po zmianie konfiguracji zapisz plik i uzyj komendy przeladowania pluginu (np. /reload lub dedykowanej komendy pluginu). Jeśli plugin nie pobiera zmian po przeladowaniu, zrestartuj serwer komenda /stop.

YAML to wredny format. Jeden bledny spacja albo tabulacja może zepsuc cały plik. Uzywaj edytora z podswietlaniem skladni (VS Code, Notepad++) i sprawdzaj plik na yamllint.com przed wrzuceniem na serwer.

Jak zainstalowac Citizens

Pobierz Citizens z oficjalnego CI. Wrzuc .jar do plugins/, zrestartuj serwer. Tworz NPC komenda /npc create [nazwa]. Dla dialogow i questow zainstaluj Denizen lub BetonQuest.

  1. Pobierz Citizens z oficjalnej strony. Upewnij sie, ze pobierasz wersje kompatybilna z Twoja wersja Minecraft (1.8.8 - 1.21.x).
  2. Skopiuj pobrany plik .jar do folderu plugins/ w katalogu Twojego serwera.
  3. Zrestartuj serwer komenda /stop i uruchom go ponownie. Nie uzywaj /reload przy pierwszej instalacji.
  4. Sprawdź konsole serwera. Jeśli Citizens zaladowal sie poprawnie, zobaczysz komunikat z wersja pluginu. Jeśli pojawił sie błąd, sprawdź czy masz zainstalowane wszystkie zaleznosciow.
  5. Skonfiguruj plugin edytujac plik plugins/Citizens/config.yml (lub odpowiednik). Po zmianach uzyj komendy przeladowania.
Kompatybilnosc serwerow: Citizens działa na Spigot, Paper, Purpur. Rekomendujemy Paper jako silnik serwera — ma lepsza wydajność i więcej API niz Spigot.

Alternatywy dla Citizens

Citizens nie jest jedynym pluginem w swojej kategorii. Poniżej znajdziesz alternatywy, które warto rozwazyc, jeśli szukasz czegos innego lub Citizens nie spelnia Twoich oczekiwan.

FancyNPCs

Lzejsza alternatywa z minimalistycznym podejsciem do tworzenia NPC.

ZNPCsPlus

Nowoczesny plugin NPC z obsługa pakietow, bez ProtocolLib.

Często zadawane pytania o Citizens

Jak zainstalowac Citizens?

Pobierz Citizens z oficjalnego CI. Wrzuc .jar do plugins/, zrestartuj serwer. Tworz NPC komenda /npc create [nazwa]. Dla dialogow i questow zainstaluj Denizen lub BetonQuest. Szczegolowa instrukcja z zaleznosciami i konfiguracja znajduje sie w sekcji instalacja powyżej.

Na jakich silnikach serwerowych działa Citizens?

Citizens działa na: Spigot, Paper, Purpur. Rekomendujemy Paper jako silnik — wiekszosci serwerow daje najlepsza rownowage miedzy wydajnoscia a kompatybilnoscia z pluginami. Więcej o silnikach serwerowych przeczytasz w naszym porownaniu.

Czy Citizens jest darmowy?

Citizens jest dostępny na oficjalnej stronie. Sprawdź szczegóły licencji na stronie pobierania.

Citizens nie działa — co robic?

Sprawdź plik logs/latest.log w katalogu serwera. Najczestsze 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 moge 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.

Inne pluginy z kategorii RPG i NPC

Komentarze