ItemWeaver

01 · Start here

Overview

ItemWeaver turns a server-owned folder into live Minecraft content. A server administrator authors JSON and assets; players install the mod once and receive the active content automatically when they join.

Supported content

Generic items, swords, pickaxes, axes, shovels, hoes, four armor slots, simple placeable blocks, shaped and shapeless recipes, random block-break drops, 3D GeckoLib items/armor, and animated hostile mobs or bosses.

02 · Environment

Requirements & installation

1. Install Fabric Loader and Fabric API for Minecraft 1.21.8.
2. Put itemweaver-<version>.jar into the server and every player's mods/ folder.
3. Start the server once. ItemWeaver creates its config and the world content folder.
4. If you use a GeckoLib renderer or any custom mob, install GeckoLib on every client. The dedicated server does not need it.

03 · For players

Player guide

1. Install Fabric, Fabric API and the same ItemWeaver release as the server.
2. Install GeckoLib if the server uses 3D items, 3D armor, mobs or bosses.
3. Join the server. The current content archive downloads during connection and is cached by its hash.
4. Use the content normally: crafting recipes, survival drops, equipped armor, blocks and mobs behave like server-defined Minecraft content.

In creative mode, loaded content is grouped into ItemWeaver tabs for items, weapons & tools, armor, blocks and mobs. Debug IDs are hidden by default.

04 · Five-minute workflow

Server quick start

1. Start the world once and open <world>/ItemWeaver/.
2. Create textures/items/ruby.png as a lowercase PNG.
3. Create registry/items/ruby.json with the definition below.
4. Disconnect every player, then run /itemweaver reload from the dedicated-server console or RCON. In single-player, save and reopen the world.
5. Read the command result and server log. Invalid files are skipped with their relative path.

{
  "id": "ruby",
  "type": "item",
  "displayName": "Ruby",
  "texture": "items/ruby.png",
  "stackSize": 64
}

The stable authoring ID is ruby. ItemWeaver assigns an internal pooled Minecraft ID such as sroskus_item:hot_item_001. Use ruby in your recipes and drop definitions.

05 · Filesystem

Folder layout

All authoring input belongs to the server world. Keep file and folder names lowercase inside asset paths.

<world>/ItemWeaver/
├─ registry/
│  ├─ items/
│  ├─ weapons_and_tools/
│  ├─ armors/
│  ├─ blocks/
│  └─ mobs/
├─ textures/
│  ├─ items/
│  ├─ weapons_and_tools/
│  ├─ armors/
│  ├─ blocks/
│  ├─ mobs/
│  └─ models/armor/
├─ models/
│  ├─ items/
│  ├─ weapons_and_tools/
│  ├─ armors/
│  └─ blocks/
├─ geo/
│  ├─ items/
│  ├─ weapons_and_tools/
│  ├─ armors/
│  └─ mobs/
├─ animations/
│  ├─ items/
│  ├─ weapons_and_tools/
│  ├─ armors/
│  └─ mobs/
└─ drops/

Generated output

<world>/datapacks/sroskus_item_generated/
.minecraft/ItemWeaver/cache/<sha256>/
.minecraft/resourcepacks/ItemWeaver Generated/

Existing worlds that already contain Sroskus_Customitems remain supported as a legacy compatibility folder. Do not maintain both folders at the same time.

06 · Core concept

Registry basics

One registry JSON file defines one content entry. The file name is used as the fallback id, but an explicit ID is recommended.

• id accepts lowercase letters, numbers, _, -, . and /.
• Asset paths are relative to their content folder. Absolute paths, drive letters, :, backslashes and .. are rejected.
• Supported type values: item, block, sword, pickaxe, axe, shovel, hoe, helmet, chestplate, leggings, boots.
• Unknown JSON fields are currently ignored; misspelled fields therefore fall back to defaults.

07 · Registry content

Items & tools

Sword example

{
  "id": "ruby_sword",
  "type": "sword",
  "displayName": "Ruby Sword",
  "texture": "weapons_and_tools/ruby_sword.png",
  "durability": 1450,
  "attackDamage": 8.0,
  "attackSpeed": -2.4,
  "rarity": "rare"
}

Tool types share the same authoring fields. rarity is parsed in the current release but does not yet change the runtime rarity color or behavior; do not rely on it.

08 · Equipment

Armor

{
  "id": "ruby_chestplate",
  "type": "chestplate",
  "displayName": "Ruby Chestplate",
  "texture": "armors/ruby_chestplate.png",
  "armorTexture": "ruby",
  "durability": 640,
  "armor": 8,
  "toughness": 2.0,
  "knockbackResistance": 0.05
}

Every piece in one vanilla armor set should use the same armorTexture prefix.

textures/models/armor/ruby_layer_1.png  # helmet, chestplate, boots
textures/models/armor/ruby_layer_2.png  # leggings

The prefix must be a simple lowercase file prefix without folders. Missing layers use a fallback texture. For 3D worn armor, use "renderer": "geckolib" and follow the bone names in the GeckoLib section.

09 · World content

Blocks

{
  "id": "ruby_block",
  "type": "block",
  "displayName": "Ruby Block",
  "texture": "blocks/ruby_block.png",
  "hardness": 5.0,
  "resistance": 8.0,
  "lightLevel": 7,
  "dropSelf": true
}

• Without model, ItemWeaver generates a simple cube_all block model.
• lightLevel is clamped from 0 to 15.
• dropSelf=false suppresses the additional custom-block self drop.
• The current hot block supports one simple blockstate without properties.
• GeckoLib block rendering is not supported in this release.

10 · Crafting

Recipes

Recipes live inside the registry JSON of the result. There is no authoring recipes/ folder.

"recipe": {
  "type": "shaped",
  "pattern": [" R ", " R ", " S "],
  "keys": {
    "R": "ruby",
    "S": "minecraft:stick"
  },
  "count": 1
}

"recipe": {
  "type": "shapeless",
  "ingredients": [
    "ruby",
    "minecraft:blaze_powder"
  ],
  "count": 1
}

• Shaped patterns are 1–3 rows, each 1–3 characters, all with equal width.
• Shapeless recipes accept 1–9 ingredients.
• count must be 1–64.
• Ingredients may be stable ItemWeaver IDs or vanilla/modded namespaced IDs.
• Ingredient tags such as #minecraft:planks are not supported yet.

11 · Loot rules

Block drops

Each file in drops/ is one independent roll after a successful survival block break.

{
  "block": "minecraft:cobblestone",
  "drop": "ruby",
  "amount": 1,
  "chance": 5.0
}

• chance is a percentage clamped to 0–100.
• amount is clamped to 1–64. At most 64 rules are loaded for one block and one break can create at most 256 configured item units.
• The custom drop is added to normal block loot; creative breaks do not trigger it.
• Fortune, Silk Touch, held tool, dimension and biome are not checked in this release.
• Several rules for the same block roll independently.

12 · Visual authoring

Textures & vanilla models

Flat items and tools

Put a PNG in the matching textures/ category. If model is omitted, ItemWeaver generates minecraft:item/generated for items or minecraft:item/handheld for tools.

Custom vanilla model

{
  "parent": "minecraft:item/handheld",
  "textures": {
    "layer0": "sroskus_item:item/weapons_and_tools/ruby_sword"
  },
  "display": {
    "thirdperson_righthand": {
      "rotation": [0, -90, 55],
      "translation": [0, 4, 0.5],
      "scale": [0.85, 0.85, 0.85]
    }
  }
}

Save it under models/weapons_and_tools/ruby_sword.json, then set that same relative path in the registry model field. Namespace references remain sroskus_item for compatibility.

13 · Animated 3D

GeckoLib 3D

Set renderer to geckolib for 3D items, tools, weapons or armor. Mobs always use GeckoLib.

{
  "id": "void_sword",
  "type": "sword",
  "displayName": "Void Sword",
  "texture": "weapons_and_tools/void_sword.png",
  "renderer": "geckolib",
  "geo": {
    "model": "weapons_and_tools/void_sword.geo.json",
    "texture": "weapons_and_tools/void_sword.png",
    "animation": "weapons_and_tools/void_sword.animation.json",
    "idleAnimation": "animation.void_sword.idle"
  }
}

model is required. animation and idleAnimation are optional; item rendering currently supports one looping idle animation.

Armor bones

armorHead
armorBody
armorRightArm
armorLeftArm
armorRightLeg
armorLeftLeg
armorRightBoot
armorLeftBoot

Match the PNG aspect ratio to texture_width and texture_height in the exported .geo.json. A mismatch is logged and usually produces incorrect UVs.

14 · Entities

Mobs & bosses

{
  "id": "stone_golem",
  "displayName": "Stone Golem",
  "health": 120,
  "attackDamage": 10,
  "movementSpeed": 0.22,
  "followRange": 40,
  "knockbackResistance": 0.7,
  "spawnEggTexture": "mobs/stone_golem_egg.png",
  "geo": {
    "model": "mobs/stone_golem.geo.json",
    "texture": "mobs/stone_golem.png",
    "animation": "mobs/stone_golem.animation.json",
    "idleAnimation": "animation.stone_golem.idle",
    "walkAnimation": "animation.stone_golem.walk",
    "attackAnimation": "animation.stone_golem.attack",
    "deathAnimation": "animation.stone_golem.death"
  },
  "drops": [
    { "item": "ruby", "amount": 2, "chance": 35.0 }
  ]
}

Mobs use fixed hostile behavior: swim, melee chase, wander, look at and target players. Ranged attacks, configurable goals, boss phases and boss bars are not available yet.

width and height are optional. ItemWeaver estimates them from cubes in the first Blockbench geometry (16 model units = 1 block); explicit values override the estimate and are clamped to 0.5–8 blocks.

A mob may define at most 64 drop rules. Each amount is clamped to 1–64; one death emits at most 128 configured item units and 32 ItemEntity stacks.

15 · Population

Natural spawning

"spawn": {
  "biomes": ["minecraft:dark_forest", "mirkwood", "me:fangorn"],
  "chance": 8.0,
  "groupMin": 1,
  "groupMax": 2,
  "maxNearby": 3
}

• A full namespace:path matches one biome ID. A path without namespace matches that path in any namespace.
• Spawn checks happen near live, non-spectator players on the terrain surface and only in loaded chunks.
• Peaceful difficulty and doMobSpawning=false disable attempts.
• groupMax is capped at 8. maxNearby is capped at 32, but production servers should keep it far lower.
• Vanilla light and biome spawn-list rules are not consulted.

16 · Administration

Commands & reload

Commands require Minecraft permission level 2. The legacy aliases remain available for compatibility.

reload cannot be run by a connected player because its safety guard requires an empty server. Use the dedicated-server console or RCON. In single-player, save and reopen the world so content is applied at integrated-server startup.

Safe reload workflow

1. Back up the content folder, world and generated slot mapping before changing stable IDs or performing a migration.
2. Edit and validate files outside the live server where possible.
3. Disconnect every player, run reload once from the console, wait for completion and read every reported error.
4. Test crafting, stats, model rendering and drops before inviting players back.

17 · Networking

Client sync & cache

1. The server builds a deterministic archive from registry files and only the assets referenced by valid loaded definitions.
2. The client receives a manifest with the SHA-256 hash and checks .minecraft/ItemWeaver/cache/.
3. On a cache miss, the archive is transferred in bounded chunks, verified, extracted safely and marked complete.
4. Extracted caches and generated packs are reused only when their bounded per-file SHA-256 manifest matches exactly; missing, added or changed files invalidate them.
5. The client generates and mounts a local resource pack, then completes the connection.

Block-drop files, server config, templates and unused PNGs are not sent to players. A maintenance /itemweaver reload prepares the new manifest for subsequent joins; unchanged hashes reuse cached content.

A matching cache in the legacy .minecraft/Sroskus_Customitems/cache/ location is reused only when it also has the current integrity manifest. Older cache formats are downloaded once into .minecraft/ItemWeaver/cache/ instead of being trusted blindly.

Reset a stale cache

Close Minecraft and delete only the failing hash folder, or the whole .minecraft/ItemWeaver/cache/ directory. If models are still missing, also delete .minecraft/resourcepacks/ItemWeaver Generated/. The next join recreates both safely.

18 · Settings

Configuration

The compatibility config file remains config/sroskus_item.properties.

generateexamples=false
showdebugtooltips=false

19 · Boundaries

Limits & compatibility

Large slot pools are registered when the game starts so definitions can change without adding new registry entries at runtime. The public release applies global transfer and spawn budgets; content authors must still test large packs on staging.

20 · Fixes

Troubleshooting

21 · Exact fields

Full schema reference

Item, tool, armor and block fields

Mob fields

01 · Začni tady

Úvod

ItemWeaver promění serverovou složku v živý obsah Minecraftu. Správce serveru tvoří JSON a assety; hráči nainstalují mod jednou a při připojení automaticky dostanou právě používaný obsah.

Podporovaný obsah

Obecné předměty, meče, krumpáče, sekery, lopaty, motyky, čtyři části brnění, jednoduché pokládatelné bloky, shaped i shapeless recepty, náhodné dropy z bloků, 3D GeckoLib předměty a brnění a animovaní nepřátelští mobové nebo bossové.

02 · Prostředí

Požadavky a instalace

1. Nainstaluj Fabric Loader a Fabric API pro Minecraft 1.21.8.
2. Vlož itemweaver-<version>.jar do složky mods/ na serveru i u všech hráčů.
3. Jednou spusť server. ItemWeaver vytvoří konfiguraci a složku obsahu ve světě.
4. Pokud používáš GeckoLib renderer nebo jakéhokoli vlastního moba, nainstaluj GeckoLib všem klientům. Dedikovaný server jej nepotřebuje.

03 · Pro hráče

Průvodce hráče

1. Nainstaluj Fabric, Fabric API a stejný release ItemWeaveru jako server.
2. Pokud server používá 3D předměty, 3D brnění, moby nebo bossy, nainstaluj GeckoLib.
3. Připoj se. Aktuální obsah se během připojování stáhne a uloží podle jeho hashe.
4. Obsah používej normálně: crafting, survival dropy, nasazené brnění, bloky i mobové se chovají podle serverové definice.

V creative režimu je načtený obsah rozdělen do záložek ItemWeaveru pro předměty, zbraně a nástroje, brnění, bloky a moby. Ladicí ID jsou ve výchozím stavu skrytá.

04 · Postup na pět minut

Rychlý start serveru

1. Jednou spusť svět a otevři <world>/ItemWeaver/.
2. Vytvoř lowercase PNG textures/items/ruby.png.
3. Vytvoř definici registry/items/ruby.json podle ukázky.
4. Odpoj všechny hráče a potom spusť /itemweaver reload z konzole dedikovaného serveru nebo přes RCON. V single-playeru svět ulož a znovu otevři.
5. Přečti výsledek příkazu a log serveru. Vadné soubory se přeskočí a vypíše se jejich relativní cesta.

{
  "id": "ruby",
  "type": "item",
  "displayName": "Rubín",
  "texture": "items/ruby.png",
  "stackSize": 64
}

Stabilní autorské ID je ruby. ItemWeaver mu přidělí interní pooled Minecraft ID, například sroskus_item:hot_item_001. V receptech a dropech používej ruby.

05 · Soubory

Struktura složek

Veškerý autorský vstup patří do světa serveru. V cestách assetů používej lowercase názvy souborů i složek.

<world>/ItemWeaver/
├─ registry/
│  ├─ items/
│  ├─ weapons_and_tools/
│  ├─ armors/
│  ├─ blocks/
│  └─ mobs/
├─ textures/
│  ├─ items/
│  ├─ weapons_and_tools/
│  ├─ armors/
│  ├─ blocks/
│  ├─ mobs/
│  └─ models/armor/
├─ models/
│  ├─ items/
│  ├─ weapons_and_tools/
│  ├─ armors/
│  └─ blocks/
├─ geo/
│  ├─ items/
│  ├─ weapons_and_tools/
│  ├─ armors/
│  └─ mobs/
├─ animations/
│  ├─ items/
│  ├─ weapons_and_tools/
│  ├─ armors/
│  └─ mobs/
└─ drops/

Generované výstupy

<world>/datapacks/sroskus_item_generated/
.minecraft/ItemWeaver/cache/<sha256>/
.minecraft/resourcepacks/ItemWeaver Generated/

Existující světy se složkou Sroskus_Customitems zůstávají podporované jako legacy varianta. Neudržuj současně obě složky.

06 · Hlavní princip

Základy registru

Jeden registry JSON definuje jednu položku obsahu. Název souboru slouží jako náhradní id, ale doporučujeme ID vždy napsat výslovně.

• id přijímá lowercase písmena, čísla, _, -, . a /.
• Cesty assetů jsou relativní ke své obsahové složce. Absolutní cesty, písmena disku, :, zpětná lomítka a .. jsou odmítnuté.
• Podporované hodnoty type: item, block, sword, pickaxe, axe, shovel, hoe, helmet, chestplate, leggings, boots.
• Neznámá JSON pole se nyní ignorují; překlep proto často tiše použije výchozí hodnotu.

07 · Obsah registru

Předměty a nástroje

Ukázka meče

{
  "id": "ruby_sword",
  "type": "sword",
  "displayName": "Rubínový meč",
  "texture": "weapons_and_tools/ruby_sword.png",
  "durability": 1450,
  "attackDamage": 8.0,
  "attackSpeed": -2.4,
  "rarity": "rare"
}

Všechny typy nástrojů používají stejná autorská pole. rarity se v aktuálním releasu načte, ale ještě nemění runtime barvu ani chování; nespoléhej na něj.

08 · Výbava

Brnění

{
  "id": "ruby_chestplate",
  "type": "chestplate",
  "displayName": "Rubínový kyrys",
  "texture": "armors/ruby_chestplate.png",
  "armorTexture": "ruby",
  "durability": 640,
  "armor": 8,
  "toughness": 2.0,
  "knockbackResistance": 0.05
}

Každá část jednoho vanilla setu musí používat stejný prefix armorTexture.

textures/models/armor/ruby_layer_1.png  # helma, kyrys, boty
textures/models/armor/ruby_layer_2.png  # kalhoty

Prefix musí být jednoduchý lowercase název bez složky. Chybějící vrstva použije fallback texturu. Pro 3D brnění nastav "renderer": "geckolib" a použij názvy kostí ze sekce GeckoLib.

09 · Obsah světa

Bloky

{
  "id": "ruby_block",
  "type": "block",
  "displayName": "Rubínový blok",
  "texture": "blocks/ruby_block.png",
  "hardness": 5.0,
  "resistance": 8.0,
  "lightLevel": 7,
  "dropSelf": true
}

• Bez model ItemWeaver vygeneruje jednoduchý block model cube_all.
• lightLevel je omezený na 0 až 15.
• dropSelf=false vypne dodatečný self-drop vlastního bloku.
• Aktuální hot block má jen jeden jednoduchý blockstate bez properties.
• GeckoLib renderování bloků tento release nepodporuje.

10 · Crafting

Recepty

Recept patří dovnitř registry JSON výsledného předmětu. Vstupní složka recipes/ neexistuje.

"recipe": {
  "type": "shaped",
  "pattern": [" R ", " R ", " S "],
  "keys": {
    "R": "ruby",
    "S": "minecraft:stick"
  },
  "count": 1
}

"recipe": {
  "type": "shapeless",
  "ingredients": [
    "ruby",
    "minecraft:blaze_powder"
  ],
  "count": 1
}

• Shaped pattern má 1–3 řádky, každý 1–3 znaky, všechny stejně dlouhé.
• Shapeless recept přijímá 1–9 ingrediencí.
• count musí být 1–64.
• Ingredience mohou být stabilní ItemWeaver ID nebo namespaced vanilla/modded ID.
• Tagy ingrediencí jako #minecraft:planks zatím nejsou podporované.

11 · Pravidla lootu

Dropy z bloků

Každý soubor ve drops/ představuje jeden nezávislý hod po úspěšném rozbití bloku v survivalu.

{
  "block": "minecraft:cobblestone",
  "drop": "ruby",
  "amount": 1,
  "chance": 5.0
}

• chance je procento omezené na 0–100.
• amount je omezené na 1–64. Pro jeden blok se načte nejvýše 64 pravidel a jedno rozbití vytvoří nejvýše 256 nastavených kusů předmětů.
• Vlastní drop se přidá k běžnému lootu bloku; creative rozbití jej nespustí.
• Fortune, Silk Touch, držený nástroj, dimenze ani biome se v tomto releasu nekontrolují.
• Více pravidel pro stejný blok se vyhodnocuje nezávisle.

12 · Tvorba vzhledu

Textury a vanilla modely

Ploché předměty a nástroje

Vlož PNG do odpovídající kategorie textures/. Bez pole model ItemWeaver vygeneruje minecraft:item/generated pro předmět nebo minecraft:item/handheld pro nástroj.

Vlastní vanilla model

{
  "parent": "minecraft:item/handheld",
  "textures": {
    "layer0": "sroskus_item:item/weapons_and_tools/ruby_sword"
  },
  "display": {
    "thirdperson_righthand": {
      "rotation": [0, -90, 55],
      "translation": [0, 4, 0.5],
      "scale": [0.85, 0.85, 0.85]
    }
  }
}

Ulož jej jako models/weapons_and_tools/ruby_sword.json a stejnou relativní cestu napiš do pole model. Namespace v odkazech zůstává kvůli kompatibilitě sroskus_item.

13 · Animované 3D

GeckoLib 3D

Pro 3D předmět, nástroj, zbraň nebo brnění nastav renderer na geckolib. Mobové GeckoLib používají vždy.

{
  "id": "void_sword",
  "type": "sword",
  "displayName": "Meč prázdnoty",
  "texture": "weapons_and_tools/void_sword.png",
  "renderer": "geckolib",
  "geo": {
    "model": "weapons_and_tools/void_sword.geo.json",
    "texture": "weapons_and_tools/void_sword.png",
    "animation": "weapons_and_tools/void_sword.animation.json",
    "idleAnimation": "animation.void_sword.idle"
  }
}

model je povinný. animation a idleAnimation jsou volitelné; render předmětů nyní podporuje jednu looped idle animaci.

Kosti brnění

armorHead
armorBody
armorRightArm
armorLeftArm
armorRightLeg
armorLeftLeg
armorRightBoot
armorLeftBoot

Poměr PNG musí odpovídat texture_width a texture_height v exportovaném .geo.json. Neshoda se zapíše do logu a obvykle způsobí špatné UV.

14 · Entity

Mobové a bossové

{
  "id": "stone_golem",
  "displayName": "Kamenný golem",
  "health": 120,
  "attackDamage": 10,
  "movementSpeed": 0.22,
  "followRange": 40,
  "knockbackResistance": 0.7,
  "spawnEggTexture": "mobs/stone_golem_egg.png",
  "geo": {
    "model": "mobs/stone_golem.geo.json",
    "texture": "mobs/stone_golem.png",
    "animation": "mobs/stone_golem.animation.json",
    "idleAnimation": "animation.stone_golem.idle",
    "walkAnimation": "animation.stone_golem.walk",
    "attackAnimation": "animation.stone_golem.attack",
    "deathAnimation": "animation.stone_golem.death"
  },
  "drops": [
    { "item": "ruby", "amount": 2, "chance": 35.0 }
  ]
}

Mobové mají pevné nepřátelské chování: plavání, melee pronásledování, náhodnou chůzi, pohled na hráče a target hráče. Ranged útoky, nastavitelné goals, fáze bossů ani bossbar zatím nejsou k dispozici.

width a height jsou volitelné. ItemWeaver je odhadne z kostek první Blockbench geometrie (16 modelových jednotek = 1 blok); explicitní hodnoty mají přednost a omezí se na 0,5–8 bloků.

Jeden mob může mít nejvýše 64 pravidel dropu. Každé amount je omezené na 1–64; jedna smrt vytvoří nejvýše 128 nastavených kusů a 32 ItemEntity stacků.

15 · Populace

Přirozený spawn

"spawn": {
  "biomes": ["minecraft:dark_forest", "mirkwood", "me:fangorn"],
  "chance": 8.0,
  "groupMin": 1,
  "groupMax": 2,
  "maxNearby": 3
}

• Celé namespace:path odpovídá jednomu biome ID. Path bez namespace odpovídá stejnému path v libovolném namespace.
• Spawn se kontroluje poblíž živých hráčů mimo spectator, na povrchu terénu a jen v načtených chunkech.
• Peaceful a doMobSpawning=false pokusy vypnou.
• groupMax má maximum 8. maxNearby má maximum 32, ale produkční server by jej měl držet výrazně níž.
• Vanilla pravidla světla a biome spawn listu se nepoužívají.

16 · Správa

Příkazy a reload

Příkazy vyžadují Minecraft permission level 2. Staré aliasy zůstávají kvůli kompatibilitě.

reload nemůže spustit připojený hráč, protože bezpečnostní kontrola vyžaduje prázdný server. Použij konzoli dedikovaného serveru nebo RCON. V single-playeru svět ulož a znovu otevři; obsah se aplikuje při startu integrovaného serveru.

Bezpečný postup reloadu

1. Před změnou stabilních ID nebo migrací zazálohuj obsah, svět i vygenerované mapování slotů.
2. Pokud možno soubory uprav a zkontroluj mimo živý server.
3. Odpoj všechny hráče, spusť reload jednou z konzole, počkej na dokončení a přečti každou nahlášenou chybu.
4. Než pustíš hráče zpět, otestuj crafting, statistiky, modely a dropy.

17 · Síť

Synchronizace a cache

1. Server vytvoří deterministický archiv z registry souborů a jen assetů, na které odkazují platné načtené definice.
2. Klient dostane manifest se SHA-256 hashem a zkontroluje .minecraft/ItemWeaver/cache/.
3. Pokud cache chybí, archiv se přenese v omezených částech, ověří, bezpečně rozbalí a označí jako hotový.
4. Rozbalená cache i vygenerovaný pack se znovu použijí jen tehdy, když přesně sedí jejich omezený SHA-256 manifest jednotlivých souborů; chybějící, přidaný nebo změněný soubor je zneplatní.
5. Klient vygeneruje a připojí místní resource pack a dokončí připojení.

Soubory dropů z bloků, serverová konfigurace, šablony ani nepoužité PNG se hráčům neposílají. Údržbový /itemweaver reload připraví nový manifest pro další připojení; nezměněný hash znovu použije cache.

Odpovídající cache ve staré cestě .minecraft/Sroskus_Customitems/cache/ se znovu použije jen tehdy, když obsahuje i aktuální integritní manifest. Starší formát cache se raději jednou znovu stáhne do .minecraft/ItemWeaver/cache/, než aby se mu slepě důvěřovalo.

Reset zastaralé cache

Vypni Minecraft a smaž jen vadnou složku hashe, případně celé .minecraft/ItemWeaver/cache/. Pokud modely stále chybí, smaž také .minecraft/resourcepacks/ItemWeaver Generated/. Při dalším připojení se obě části bezpečně vytvoří znovu.

18 · Nastavení

Konfigurace

Kompatibilní konfigurační soubor zůstává config/sroskus_item.properties.

generateexamples=false
showdebugtooltips=false

19 · Hranice

Limity a kompatibilita

Velké pooly slotů se registrují při startu hry, aby šlo definice měnit bez přidávání nových registry entries za běhu. Veřejný release používá globální síťový i spawn budget; velký obsah je přesto nutné otestovat na staging serveru.

20 · Opravy

Řešení problémů

21 · Přesná pole

Kompletní reference

Pole předmětů, nástrojů, brnění a bloků

Pole mobů