Řešení potíží a zálohování

Začni těmito kontrolami

1. Ověř Minecraft 1.21.8, Java 21 nebo novější, Fabric Loader 0.19.3 nebo novější a Fabric API 0.136.1+1.21.8 nebo kompatibilní novější sestavení pro 1.21.8.
2. Na serveru i všech klientech používej stejnou verzi ArdaNPCs. Ve složce mods/ ponech jen jednu verzi jeho JARu.
3. Zkontroluj, že spouštíš správný profil a svět. Data NPC patří ke konkrétnímu světu.
4. Přečti chybovou zprávu ve hře a příslušnou část logs/latest.log ze serveru i klienta.

Editor a oprávnění

Administrace NPC, úpravy vzhledu a skriptů vyžadují oprávnění operátora alespoň úrovně 2. Creative režim sám o sobě tato oprávnění nenahrazuje.

• Pokud příkaz chybí nebo je odmítnutý, požádej správce serveru o kontrolu oprávnění svého účtu.
• /ardanpcs manager spusť ve hře jako oprávněný hráč. Správce NPC je klientské GUI; serverová konzole ho nezobrazí.
• Pokud příkaz hlásí chybějící klientský mod, zkontroluj instalaci ArdaNPCs a Fabric API také ve svém herním profilu.
• Po změně verze nebo modpacku se znovu připoj se správnou sestavou.

Změna se neuložila nebo po restartu zmizela

1. Dokonči příslušné ukládání: u skinu a pláště Uložit vzhled, u skriptů jejich Uložit, u modelu nejprve použij výběr a potom ulož hlavní editor.
2. Přečti potvrzení nebo chybu. Náhled a změna pole nejsou potvrzením zápisu.
3. Při konfliktu dvou editorů porovnej svůj návrh s aktuálním stavem a teprve potom ulož znovu.
4. Při chybě zápisu zkontroluj volné místo, práva procesu serveru a případné zamčení souborů. V serverovém logu hledej konkrétní cestu a hlášení Failed to write nebo Cannot safely load.

Definice NPC jsou v <world>/data/ardanpcs/npcs.json. Pokud otevřeš jiný svět nebo jinou instanci serveru, pracuješ s jinou sadou NPC. Přítomnost tohoto souboru neznamená, že obsahuje také všechny questové, hráčské nebo inventářové údaje.

Úložiště používá záložní soubory .bak. Při poškozeném hlavním JSON se pokusí načíst platnou zálohu a uchovat poškozené bajty v souboru .corrupt-*. Pokud není platná ani hlavní kopie, ani záloha, načítání selže místo nahrazení dat prázdnou sadou.

Při hlášení poškozených dat soubory nemaž a nenahrazuj prázdným JSON. Zastav server, nejprve zachovej kopii celého světa a logu a obnov ověřenou zálohu. Ruční zásahy do dat dělej při vypnutém serveru. Příkaz reload není náhradou za zálohu ani vrácením poslední úpravy.

Skin, plášť nebo model se nezobrazuje

Hráčský skin nebo PNG

• Skiny a pláště patří humanoidnímu modelu. Pokud má NPC model jiného moba, používá se renderer tohoto moba.
• U hráčského profilu proveď Vyhledat hráče a potom Uložit vzhled. Zkontroluj jméno/UUID; při nedostupné oficiální službě zkus vyhledání později.
• U importu ověř složku config/arda_npcs/import_textures/ na serveru, skutečný PNG formát a velikost nejvýše 256 KiB. Skin musí mít 64 × 64 nebo 64 × 32 pixelů, plášť 64 × 32.
• Soubor, který není v seznamu, zkus pojmenovat jednoduše, například guard.png, a obnov seznam. Nepoužívej podsložky ani odkazy na jinou složku. Seznam zobrazuje nejvýše 64 souborů.
• Při hlášení naplněné kvóty importů neodstraňuj náhodně světové assety: mohou je používat další NPC, šablony nebo mrtvoly. Svět má limit 1024 assetů a 64 MiB jejich obsahu; další postup řeš nad zálohou s přehledem používaných textur.
• U resource packu ověř správný identifikátor i dostupnost stejné textury u klientů. U URL ověř, že jde o přímý dostupný PNG obrázek; plášť vyžaduje HTTPS.

Postup nastavení a importu najdeš na stránce Vzhled, skiny a modely.

Model entity se vrátil na humanoida

1. Zkontroluj celé ID entity a přítomnost jejího modu na serveru i klientovi.
2. Vyber model znovu, použij výběr a ulož hlavní editor.
3. V klientském logu hledej zprávu, že se model nepodařilo vytvořit nebo vykreslit. ArdaNPCs při takové chybě používá výchozí vzhled.
4. Ověř jinou entitu ze stejného modu. Vlastní renderer může vyžadovat stav, který pomocný model neposkytuje.
5. Po odstranění příčiny restartuj klienta a model znovu vyzkoušej; nefunkční typy jsou během běhu klienta zapamatované.

Chybějící speciální animace nemusí znamenat neuložený model. NPC nepřebírá AI ani schopnosti cizí entity a není zaručena univerzální kompatibilita GeckoLib. Větší hitbox také sám nenaučí NPC létat nebo používat útoky původního moba.

Skript nereaguje nebo se vypnul

1. Otevři u NPC panel Skripty a ověř, že jsou skripty zapnuté a správná událost obsahuje kód.
2. Vkládej tělo události; neobaluj ho vlastní funkcí události z jiného modu.
3. Spusť Kontrolu. Oprav oznámenou syntaxi nebo nepodporované API.
4. Spusť Test pro zvolenou událost. Jde o simulaci, nikoli o skutečné předání odměn nebo změnu světa.
5. Klikni na Výpis a přečti panel Diagnostika a výsledek. Zobrazuje poslední chybu a omezený výpis api.log.
6. Po opravě skript ulož. Úspěšné uložení zruší uloženou blokaci chybou a umožní nové spuštění.

ArdaNPCs používá vlastní omezené serverové JavaScript API. Skripty z CustomNPCs nejsou přímo zaměnitelné. Importovaný program s nepodporovanými operacemi nejprve uprav podle diagnostiky; převod není potvrzením, že funguje v každém modpacku.

Při zprávě o vyčerpaném společném rozpočtu omez časté události, dlouhé smyčky a množství efektů. Nepřidávej těsné opakovací smyčky jako náhradu časovače. Podmínka predicate je pouze pro čtení a nemá měnit svět ani uložené proměnné.

Pokud diagnostika hlásí Script runtime unavailable: storage could not be loaded safely, řeš nejprve načtení dat a serverový log. Runtime stav skriptů je v <world>/data/ardanpcs/scripts-state.json; nevymazávej jej jako první pokus o opravu.

Záloha a aktualizace

1. Řádně ukonči hru nebo zastav server a počkej na dokončení ukládání.
2. Zkopíruj celý svět. Záloha musí zahrnovat i vanilla data hráčů, modová data a data/ardanpcs/appearance-assets/.
3. Uchovej také používané konfigurace, verze modů a případné vlastní resource packy. Zdrojové PNG pro další import leží v config/arda_npcs/import_textures/ mimo samotný svět.
4. Novou verzi nejprve vyzkoušej na oddělené kopii světa. Aktualizuj ArdaNPCs na serveru i klientech a odstraň starý JAR z aktivní složky mods/.
5. Ověř otevření editoru, dialog/quest, ukládání po restartu, vzhled na druhém klientovi a služby, které skutečně používáš.

Samotný npcs.json není úplná záloha serveru. Šablony jsou v <world>/data/ardanpcs/templates.json a importované obrázky mají samostatné soubory. Přesunutí samotného JSON do jiného světa obrázky nepřenese.

Při návratu ke starší verzi obnov odpovídající celou zálohu světa a sestavu modů. Nahrazení JARu samo o sobě nevrací změny uložených dat. Soubory .bak pomáhají s jednotlivými úložišti, ale nenahrazují úplnou zálohu světa.

Co přiložit k hlášení chyby

• Verzi Minecraftu, ArdaNPCs, Fabric Loaderu a Fabric API; zda jde o singleplayer nebo server.
• Krátké kroky od otevření editoru po chybu a očekávaný výsledek.
• U modelu přesné ID entity a název/verzi modu, který ji dodává.
• U skriptu událost, relevantní krátkou ukázku kódu a text diagnostiky.
• Relevantní část klientského nebo serverového logu z okamžiku problému. Před zveřejněním odstraň soukromé údaje a přihlašovací informace.