ZNPCs: plugin pro vytváření NPC v Minecraftu
Závislosti: Typ serveru: Paper nebo Spigot 1.8.8–1.21.4 Verze Minecraftu: 1.8.8–1.21.4 Závislé pluginy: PlaceholderAPI (nepovinné, pro…
Závislosti: Typ serveru: Paper nebo Spigot 1.8.8–1.21.4 Verze Minecraftu: 1.8.8–1.21.4 Závislé pluginy: PlaceholderAPI (nepovinné, pro proměnné v hologramech) Stáhnout: SpigotMC / GitHub Pokud potřebujete jednoduché NPC
Závislosti:
Typ serveru: Paper nebo Spigot 1.8.8–1.21.4
Verze Minecraftu: 1.8.8–1.21.4
Závislé pluginy: PlaceholderAPI (nepovinné, pro proměnné v hologramech)
Stáhnout: SpigotMC / GitHub
Pokud potřebujete jednoduché NPC do lobby nebo jako dekoraci, Citizens se může ukázat jako příliš těžkopádný. ZNPCs řeší stejný úkol jednodušeji: je to jediný soubor .jar bez spousty závislostí, který umožňuje umístit postavy s vlastním skinem, textem a reakcí na kliknutí.
Hlavní možnosti
Všechna NPC mají jedinečné číselné ID. Můžete vytvořit běžného hráče se skinem podle přezdívky nebo URL, nebo umístit moba, jako je ZOMBIE nebo KOSTLIVEC.
Když hráč na NPC klikne, plugin provede zadané akce. Může to být zpráva, příkaz jménem hráče nebo konzole, nebo dokonce odeslání hráče na jiný server přes BungeeCord. Pokud je akcí více, provedou se postupně. Pro každou akci můžete také nastavit cooldown (zpoždění).
Text nad hlavou (Lines)
Nad NPC lze přidat text pomocí příkazu lines. Plugin podporuje barevné kódy, a pokud je nainstalován PlaceholderAPI, tak i proměnné jako %player_name% nebo %server_online%. Výšku textu můžete změnit příkazem height.
Trasy (Paths)
NPC nemusí nutně stát na místě. Abyste ho naučili chodit, musíte zapnout režim nahrávání (/znpcs path create <název>) a sami projít požadovanou trasu. Po dokončení je třeba zadat /znpcs path exit. Poté se tato trasa přiřadí konkrétnímu NPC (/znpcs path set <id> <název>) a to po ní začne donekonečna chodit.
Důležitý detail: pohyb je velmi jednoduchý. ZNPCs nepoužívá vanilla hledání cesty (Pathfinder), takže postavy nebudou obcházet překážky ani reagovat na ostatní hráče.
Vybavení a vzhled
Postavy lze obléct do brnění a dát jim předměty do rukou. Stačí vzít požadovanou věc a zadat /znpcs equip <id> <slot> (dostupné sloty: HAND, OFFHAND, HELMET, CHESTPLATE, LEGGINGS, BOOTS).
Chování NPC lze také nastavit příkazem toggle: přimět ho, aby se díval na nejbližší hráče (look), zrcadlit skin hráče, který se na něj dívá (mirror), nebo přidat záři (glow) zvolené barvy.
Příkazy
Tyto příkazy vyžadují administrátorská práva (znpcs.admin).
Příkaz | Popis | Právo |
| Vytvoří NPC na vašich souřadnicích | znpcs.admin |
| Smaže NPC | znpcs.admin |
| Vypíše seznam NPC a jejich ID | znpcs.admin |
| Teleportuje NPC k vám | znpcs.admin |
| Teleportuje vás k NPC | znpcs.admin |
| Změní typ existujícího NPC | znpcs.admin |
| Změní skin postavy | znpcs.admin |
| Předá NPC předmět z vaší ruky | znpcs.admin |
| Změní text nad NPC | znpcs.admin |
| Změní výšku textu (výchozí 1) | znpcs.admin |
| Přidá akci při kliknutí | znpcs.admin |
| Zobrazí seznam akcí NPC (s jejich ID) | znpcs.admin |
| Smaže akci podle jejího ID | znpcs.admin |
| Nastaví zpoždění pro provedení akce | znpcs.admin |
| Nahraje novou trasu | znpcs.admin |
| Ukončí režim nahrávání trasy | znpcs.admin |
| Přiřadí trasu NPC | znpcs.admin |
| Zapíná/vypíná možnosti (look, holo, mirror) | znpcs.admin |
| Přidá efekt záře zvolené barvy | znpcs.admin |
Typy akcí pro action add:
CMD (provede příkaz jménem hráče)
CONSOLE (provede příkaz z konzole)
CHAT (hráč napíše zprávu do chatu)
MESSAGE (odešle zprávu hráči)
SERVER (přesune na jiný server přes BungeeCord)
Přístupová práva
Tady je vše maximálně jednoduché. Téměř na všechno stačí jen jedna nóda:
Nóda | Co umožňuje |
znpcs.admin | Plný přístup ke všem příkazům |
Konfigurace
config.json
Parametr | Hodnota | Popis |
| 500 | Maximální počet bodů (kroků), které lze zaznamenat pro jednu trasu NPC. Pokud je trasa příliš dlouhá, nahrávání se po dosažení tohoto limitu automaticky zastaví. |
| "DEFAULT" | Algoritmus generování interních názvů pro NPC. Výchozí hodnota zajišťuje správné navázání ID. |
| TRUE | Při vytvoření NPC ho automaticky zarovná přesně do středu bloku. Zabraňuje posunutí modelu k okraji bloku. |
| "-" | Znak, který plugin používá k nahrazení mezer v textu příkazů nebo při generování identifikátorů. |
| 600 | Interval automatického ukládání vytvořených postav do souboru npcs.json (600 sekund = 10 minut). Chrání před ztrátou dat při náhlém pádu serveru. |
| TRUE | Aktivace ladicího režimu. Plugin začne vypisovat podrobné technické informace a chybové logy do konzole serveru. Na stabilních serverech se doporučuje vypnout (false) kvůli přehlednosti konzole. |
| 0.3 | Vzdálenost mezi řádky hologramu (textu) nad hlavou NPC. Nižší hodnota text více stáhne k sobě. |
| 32 | Poloměr (v blocích), v jehož rámci server začíná hráči posílat pakety pro vykreslení modelu NPC. Snížení hodnoty šetří prostředky serveru i klienta. |
| FALSE | Podpora dynamické změny barev (přechod RGB) pro text hologramů. Zapnutí může vytvářet dodatečnou zátěž na klienta. |
npcs.json
Všechna vytvořená NPC se zapisují do souboru npcs.json. Plugin ho generuje automaticky, takže je lepší ho ručně neupravovat. Jediným důvodem, proč do tohoto souboru zasahovat, je situace, kdy potřebujete přenést nastavená NPC na jiný server.
conversations.json
Všechny dialogy se ukládají sem.
paths
Složka, v níž se ukládají všechny zaznamenané trasy.
data.json
Zde se ukládají všechny podrobné informace o vytvořených NPC.
Integrace
Pokud je na serveru nainstalován PlaceholderAPI, ZNPCs ho zachytí automaticky bez zvláštních rozšíření. To se hodí například tehdy, když chcete nad NPC zobrazit dynamické počítadlo hráčů online.
Kompatibilita
Původní ZNPCs funguje správně jen do verze 1.21.1. Pro novější servery (1.21.1 a výše) je třeba nainstalovat fork ZNPC Plus.
Plugin se také nespustí na Folii kvůli jejím specifikům v práci s entitami.
Kdy se vyplatí používat ZNPCs
Pokud potřebujete umístit na spawnu NPC, které jen otevře menu, vydá startovní sadu nebo přesměruje hráče na jiné servery minihier, ZNPCs je skvělá volba. Dělá přesně to, co slibuje, a nezatěžuje server zbytečnými funkcemi.
Ale pokud plánujete vytvářet rozvětvené dialogy nebo složité questy, potřebujete ekosystém Citizens + Denizen. ZNPCs k tomu není určen.
Instalace
Typická instalace trvá asi 5 minut. Postup je stejný; liší se jen loader a odpovídající verze.
- 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.
