Minecraft plugin NPC

🔌 O NPC

NPC je Minecraft plugin pro servery Spigot, který administrátorům umožňuje vytvářet jednoduché a trvalé NPC. Každé NPC může klonovat skin hráče nebo použít skin založený na entity, ukládá se na disk, takže přetrvá i po restartu serveru, a při interakci hráče zobrazuje nastavitelnou zprávu.

🎯 Účel

Tento plugin poskytuje lehký způsob, jak umístit dekorativní nebo interaktivní NPC do světa serveru — jako značky pro staff, výběr lobby, statické obchodníky nebo jiné jednoduché interakce, kde není potřeba plnohodnotný NPC framework.

⚙️ Funkce

• Vytvářejte NPC, která ve výchozím nastavení klonují skin hráče, který je vytvořil.
• Možnost zadat entity nebo název skinu pro změnu vzhledu NPC.
• NPC přetrvávají po restartech serveru díky ukládání poloh a dat skinu do souboru data.yml.
• Každé NPC může při kliknutí zobrazit vlastní zprávu.
• Základní příkazy pro vytvoření a odstranění pro správu ve hře.
• Plugin ukládá data do složky pluginu (NpcMain) a při prvním spuštění vytváří data.yml.
• Verze poskytované autorem cílí na konkrétní vydání Minecraft/Spigot (samostatný jar pro každou podporovanou verzi serveru).

🧩 Pro koho je určen

Tento plugin je zaměřen na administrátory malých až středně velkých serverů Spigot, kteří potřebují jednoduchá, trvalá NPC bez složitosti větších NPC frameworků. Hodí se pro lobby nebo survival servery, které vyžadují statická NPC pro zprávy nebo kosmetickou přítomnost.

🏗️ Příklady použití

• Umístit NPC na spawnu, které po kliknutí zobrazí pravidla serveru.
• Vytvořit kosmetickou sochu, která odpovídá skinu člena staffu.
• Použít NPC jako pojmenované klikatelné voliče v lobby pro otevření menu (přes zprávu NPC nebo v kombinaci s jinými pluginy).

⌨️ Příkazy

(Výše uvedené příkazy jsou zdokumentované v oficiálních zdrojích pluginu.)

⚙️ Instalace

📥 Nastavení

• Stáhněte jar pluginu odpovídající vaší verzi serveru Spigot.
• Umístěte jar do adresáře serveru plugins/.
• Spusťte nebo restartujte server.
• Při prvním načtení plugin vytvoří složku pluginu (NpcMain) a soubor data.yml pro ukládání záznamů NPC.

📦 Závislosti

• Autor nedokumentuje žádné povinné závislosti.

🧾 Konfigurace

• Data NPC (pozice, názvy, skin signatures, zprávy) se ukládají do data.yml uvnitř složky pluginu.
• Úpravou data.yml lze NPC přejmenovat nebo změnit jeho zprávu; pro načtení ručních změn je nutný restart serveru.

🧠 Technické poznámky

• Autor zveřejňuje oddělené buildy pro konkrétní verze Spigot/Minecraft; aktuální build v repozitáři cílí na Spigot 1.18.2 a poznámky projektu uvádějí, že verze nejsou zpětně kompatibilní napříč hlavními verzemi serveru.
• Repozitář projektu je licencován pod licencí MIT.
• Plugin obsahuje metriky používání (bStats), jak je uvedeno v repozitáři a metadatech zdroje.

🤝 Kdy je tento plugin užitečný

Pokud potřebujete jednoduchá, trvalá NPC, která zobrazují zprávy nebo slouží jako kosmetické/staff značky bez použití většího NPC frameworku, tento plugin nabízí malé řešení cílené na konkrétní verze pro servery Spigot.