FancyNPCs — szybki start i przewodnik po komendach FancyNPCs — Quick Start & Command Guide

FancyNPCs pozwala tworzyć bardzo konfigurowalne NPC: nazwy (MiniMessage), skiny (nicki graczy, adresy URL, pliki), ekwipunek, poświatę, skalę (1.20.5+), zachowania oraz bogate interakcje oparte na akcjach i triggerach.

FancyNPCs lets you create highly customizable NPCs: names (MiniMessage), skins (player names, URLs, files), equipment, glow, scale (1.20.5+), behaviors, and rich interactions using actions/triggers.

Pobieranie i dokumentacja FancyNPCs (Modrinth): modrinth.com/plugin/fancynpcs/versions
Pierwsze kroki: docs.fancyinnovations.com/fancynpcs/getting-started

Instalacja i weryfikacja

Wgraj pobrany plik JAR do /plugins na serwerze.
Zrestartuj serwer.
Sprawdź instalację:
/fancynpcs version

Utwórz pierwszego NPC

# 1) Utwórz NPC o nazwie "myNpc"

/npc create myNpc

# 2) Ustaw wyświetlaną nazwę (MiniMessage)

/npc displayname myNpc <green>My first npc</green>

# 3) Ustaw skin (przykłady)

/npc skin myNpc Notch # nick/uuid gracza

/npc skin myNpc https://example.com/skin.png

/npc skin myNpc cool-skin.png # wrzuć plik do plugins/FancyNpcs/skins

# 4) Przesuń NPC do siebie

/npc move_here myNpc

Zasady nazewnictwa Nazwy NPC akceptują tylko: A–Z a–z 0–9 _ - /

Codzienne zarządzanie

Pomoc i listy

/npc help [page]                       # pomoc do komend

/npc list [--type (type)] [--sort (sort)] # wszystkie NPC

/npc nearby [--radius r] [--type t] [--sort s] # w bieżącym świecie

/npc info (npc)                         # szczegóły NPC

Tworzenie / Kopiowanie / Usuwanie

/npc create (name) [--position x y z] [--world world] [--type type]

/npc copy (npc) (new_name)

/npc remove (npc)

Dostosowanie NPC

Typ, nazwa, skin

/npc type (npc) (type)

/npc displayname (npc) @none|message # MiniMessage, PAPI

/npc skin (npc) @none|@mirror|name|url|file.png [--slim]

Wyposażenie

/npc equipment (npc) set # użyje itemu z ręki; lub @none / typ itemu

/npc equipment (npc) clear

/npc equipment (npc) list

Wygląd i zachowanie

/npc glowing (npc) [disabled | color]

/npc show_in_tab (npc) [state] # tylko typ PLAYER; wymaga ponownego wejścia

/npc collidable (npc) [state]

/npc scale (npc) factor # tylko 1.20.5+

/npc attribute (npc) set|list

Pozycja i rotacja

/npc move_here (npc)                       # do Ciebie

/npc move_to (npc) (x) (y) (z) [world] [--look-in-my-direction]

/npc center (npc)                          # wyśrodkuj na bloku

/npc teleport (npc)                        # Ty → NPC

/npc turn_to_player (npc) [state]

/npc turn_to_player_distance (npc) distance

Interakcje (Actions & Triggers)

Podpinaj akcje do triggerów (np. kliknięcie NPC przez gracza). Zarządzasz listą po indeksach.

/npc action (npc) (trigger) add (actionType) [value]

/npc action (npc) (trigger) add_before index (actionType) [value]

/npc action (npc) (trigger) add_after  index (actionType) [value]

/npc action (npc) (trigger) set        number (actionType) [value]

/npc action (npc) (trigger) remove     number

/npc action (npc) (trigger) move_up    number

/npc action (npc) (trigger) move_down  number

/npc action (npc) (trigger) clear

/npc action (npc) (trigger) list

Cooldown interakcji:

/npc interaction_cooldown (npc) disabled|2min # obsługuje ms, s, min, h, d, mo, y

Szybki start — kopiuj/wklej

/npc create guideNpc

/npc displayname guideNpc <yellow><bold>Guide</bold></yellow>

/npc skin guideNpc @mirror

/npc move_here guideNpc

/npc glowing guideNpc aqua

/npc turn_to_player guideNpc true

/npc action guideNpc INTERACT add COMMAND "msg {player} Welcome to the server!"

/npc interaction_cooldown guideNpc 30s

Uprawnienia (przykłady)

Nadaj w LuckPerms wg potrzeb:

fancynpcs.command.npc.help

fancynpcs.command.npc.create

fancynpcs.command.npc.copy

fancynpcs.command.npc.remove

fancynpcs.command.npc.list

fancynpcs.command.npc.info

fancynpcs.command.npc.type

fancynpcs.command.npc.displayname

fancynpcs.command.npc.skin

fancynpcs.command.npc.equipment.set / .clear / .list

fancynpcs.command.npc.glowing

fancynpcs.command.npc.show_in_tab

fancynpcs.command.npc.collidable

fancynpcs.command.npc.scale

fancynpcs.command.npc.attribute.set / .list

fancynpcs.command.npc.turn_to_player / .turn_to_player_distance

fancynpcs.command.npc.move_to / .teleport / .center / .nearby

fancynpcs.command.npc.action.add / .addBefore / .addAfter / .set / .remove / .moveUp / .moveDown / .clear / .list

fancynpcs.command.npc.interaction_cooldown

Rozwiązywanie problemów

Skin się nie zmienia

Dla url – link musi wskazywać prawidłowy obraz skina Minecraft.
Dla file – plik wrzuć do plugins/FancyNpcs/skins i użyj samej nazwy (np. cool-skin.png).
Użyj --slim dla szczupłych modeli przy skinach URL/plik.

Wyświetlana nazwa pokazuje „surowe” tagi

Używaj tagów MiniMessage, np. <green>…</green>. Unikaj legacy kolorów & w tej komendzie.

Akcje się nie uruchamiają

Dodaj je pod właściwy trigger (np. INTERACT) i sprawdź: /npc action (npc) (trigger) list.
Sprawdź kontekst komendy: część akcji wykonuje gracz i wymaga permisji.
Na czas testów zmniejsz interaction_cooldown.

Przydatne linki

FancyNPCs (wszystkie wersje): Modrinth
Dokumentacja – Getting started: Documentation

Downloads & Docs FancyNPCs (Modrinth): modrinth.com/plugin/fancynpcs/versions
Getting started guide: docs.fancyinnovations.com/fancynpcs/getting-started

Difficulty: Easy

Install & Verify

Drop the downloaded JAR into /plugins on your server.
Restart the server.
Verify install:
/fancynpcs version

Create Your First NPC

# 1) Create NPC named "myNpc"

/npc create myNpc

# 2) Set display name (MiniMessage supported)

/npc displayname myNpc <green>My first npc</green>

# 3) Set skin (examples)

/npc skin myNpc Notch # player name/uuid

/npc skin myNpc https://example.com/skin.png

/npc skin myNpc cool-skin.png # put file in plugins/FancyNpcs/skins

# 4) Move NPC to you

/npc move_here myNpc

Name rules NPC names accept only: A–Z a–z 0–9 _ - /

Everyday Management

Help & Listing

/npc help [page]                       # command help

/npc list [--type (type)] [--sort (sort)] # list all NPCs

/npc nearby [--radius r] [--type t] [--sort s] # list in current world

/npc info (npc)                         # NPC details

Create / Copy / Remove

/npc create (name) [--position x y z] [--world world] [--type type]

/npc copy (npc) (new_name)

/npc remove (npc)

Customize Your NPCs

Type, Name, Skin

/npc type (npc) (type)

/npc displayname (npc) @none|message # MiniMessage, PAPI supported

/npc skin (npc) @none|@mirror|name|url|file.png [--slim]

Equipment

/npc equipment (npc) set # uses item in your main hand, or @none / item type

/npc equipment (npc) clear

/npc equipment (npc) list

Appearance & Behavior

/npc glowing (npc) [disabled | color]

/npc show_in_tab (npc) [state] # PLAYER type only; may require rejoin

/npc collidable (npc) [state]

/npc scale (npc) factor # 1.20.5+ only

/npc attribute (npc) set|list

Location & Rotation

/npc move_here (npc)                       # to you

/npc move_to (npc) (x) (y) (z) [world] [--look-in-my-direction]

/npc center (npc)                          # center on block

/npc teleport (npc)                        # you → NPC

/npc turn_to_player (npc) [state]

/npc turn_to_player_distance (npc) distance

Interactions (Actions & Triggers)

Attach actions to triggers (e.g., when a player clicks the NPC). Manage the list by index.

/npc action (npc) (trigger) add (actionType) [value]

/npc action (npc) (trigger) add_before index (actionType) [value]

/npc action (npc) (trigger) add_after  index (actionType) [value]

/npc action (npc) (trigger) set        number (actionType) [value]

/npc action (npc) (trigger) remove     number

/npc action (npc) (trigger) move_up    number

/npc action (npc) (trigger) move_down  number

/npc action (npc) (trigger) clear

/npc action (npc) (trigger) list

Interaction cooldown:

/npc interaction_cooldown (npc) disabled|2min # supports ms, s, min, h, d, mo, y

Quick Starter — Copy/Paste

/npc create guideNpc

/npc displayname guideNpc <yellow><bold>Guide</bold></yellow>

/npc skin guideNpc @mirror

/npc move_here guideNpc

/npc glowing guideNpc aqua

/npc turn_to_player guideNpc true

/npc action guideNpc INTERACT add COMMAND "msg {player} Welcome to the server!"

/npc interaction_cooldown guideNpc 30s

Permissions (examples)

Grant via LuckPerms as needed:

fancynpcs.command.npc.help

fancynpcs.command.npc.create

fancynpcs.command.npc.copy

fancynpcs.command.npc.remove

fancynpcs.command.npc.list

fancynpcs.command.npc.info

fancynpcs.command.npc.type

fancynpcs.command.npc.displayname

fancynpcs.command.npc.skin

fancynpcs.command.npc.equipment.set / .clear / .list

fancynpcs.command.npc.glowing

fancynpcs.command.npc.show_in_tab

fancynpcs.command.npc.collidable

fancynpcs.command.npc.scale

fancynpcs.command.npc.attribute.set / .list

fancynpcs.command.npc.turn_to_player / .turn_to_player_distance

fancynpcs.command.npc.move_to / .teleport / .center / .nearby

fancynpcs.command.npc.action.add / .addBefore / .addAfter / .set / .remove / .moveUp / .moveDown / .clear / .list

fancynpcs.command.npc.interaction_cooldown

Troubleshooting

Skin doesn’t change

For url, make sure it points to a valid Minecraft skin image.
For file, place the image in plugins/FancyNpcs/skins and use just the file name (e.g., cool-skin.png).
Use --slim for slim models on URL/file skins.

Display name shows raw tags

Use MiniMessage tags like <green>…</green>. Avoid legacy & colors here.

Actions don’t run

Add them under the correct trigger (e.g., INTERACT), then /npc action (npc) (trigger) list to confirm.
Check command context: some actions run as the player and require permissions.
Reduce the interaction_cooldown while testing.

Handy Links

FancyNPCs (all versions): Modrinth
FancyNPCs docs — Getting started: Documentation