Fabric API

Fabric API je základ pro Fabric mody. Sám ve hře nic neukazuje a hráč podle něj nic nepozná — ale bez něj většina ostatních modů nefunguje. Je to sada nástrojů, které autoři modů používají, aby nemuseli psát všechny věci znovu od začátku.

Praktický důsledek: když si hráč stáhne mod a ten po spuštění hlásí, že potřebuje Fabric API (nebo prostě hra spadne), řešení je skoro vždycky doinstalovat Fabric API.

Fabric API patří na obě strany podle toho, co používáš. Mod na straně klienta (třeba Sodium) Fabric API zpravidla nepotřebuje, ale spousta modů ano — a ty pak vyžadují Fabric API i u hráče. Mod na straně serveru, který Fabric API potřebuje, ho potřebuje na serveru. Když si nejsi jistý, nainstaluj ho na obě strany; nic tím nezkazíš.

Verze musí odpovídat přesně verzi hry. Fabric API se vydává pro každou verzi Minecraftu zvlášť a nesprávná verze je nejčastější důvod, proč modovaný server nenastartuje nebo proč hráči padá hra při připojení.

Pro server je to navíc zásada pro hráče: když má server vlastní mody s Fabric API, hráči si musí nainstalovat stejnou verzi, jinak se nepřipojí. Vyplatí se to napsat na web a na Discord — je to nejčastější dotaz na modovaných serverech.

1. Rozhodni, kde Fabric API potřebuješ: na serveru, u hráčů, nebo na obou stranách (nejčastěji obojí).
2. Stáhni Fabric API z modrinth.com/mod/fabric-api ve verzi přesně pro svou verzi hry.
3. Na serveru: zastav server, nahraj .jar do složky mods a nastartuj.
4. U hráčů: soubor patří do složky mods v jejich hře (na Windows %appdata%\.minecraft\mods).
5. Hráči musí mít stejnou verzi hry i Fabric API jako server — jinak se nepřipojí.
6. Zkontroluj konzoli serveru: Fabric API se musí načíst bez chyby a bez hlášky o nekompatibilní verzi.
7. Vyzkoušej připojení z klienta se stejnou verzí — musí projít bez chyby při připojování.
8. Když server hlásí chybějící závislost, doinstaluj i mod, který ji vyžaduje (Fabric API sám nic nepřidává).
9. Napiš hráčům na web a na Discord, které mody potřebují a v jaké verzi — ušetří to polovinu dotazů.
10. Při aktualizaci hry vyměň Fabric API u všech, kdo ho mají: server i hráči. Nesoulad verzí je nejčastější příčina problémů s připojením.
11. Aktualizuj Fabric API společně s hrou a ostatními mody — jedno po druhém znamená víc hledání chyby.

Fabric API sám nic neumí — je to základ pro ostatní mody. Když ho nainstaluješ a nic se nezmění, je to správně.
Nejčastější chyba na modovaných serverech je nesoulad verzí: server má jednu verzi hry a hráč jinou. Napiš hráčům přesně, co mají mít.
Nainstaluj ho na obě strany, když si nejsi jistý. Přítomnost navíc nic nezkazí, chybějící závislost shodí mod.
Verze Fabric API musí odpovídat verzi hry. Po aktualizaci Minecraftu nestačí aktualizovat jen hru — mod musí mít novou verzi taky.
Když mod po instalaci hlásí chybějící závislost, hledej v chybě název chybějícího modu. Konzole to řekne přesně, i s verzí, kterou očekává.
Fabric API je jen pro Fabric. Na NeoForge nebo Forge ho neinstaluj — tam mají vlastní systém a mod by se nenačetl.
Aktualizuj mody společně. Když aktualizuješ jeden a druhý ne, vznikne kombinace, kterou autor netestoval.