Struktura složek Minecraft serveru

Kde co na serveru najdete – složky plugins, mods, world, logs a konfigurační soubory. Co je bezpečné smazat a co nesmíte odstranit.

Aktualizováno: 24. srpna 20263 min čtení

Než začnete v záložce FILES cokoli mazat nebo přesouvat, vyplatí se vědět, k čemu jednotlivé adresáře slouží. Minecraft server má logickou a předvídatelnou strukturu – většina běžných potíží (chybějící pluginy, ztracené inventáře hráčů, zdánlivě prázdný server) se týká obsahu jediné konkrétní složky.

#Soubory a adresáře v kořenové složce

Cesta	Význam	Lze bezpečně smazat?
`server.properties`	Hlavní konfigurace serveru (port, MOTD, herní režim, whitelist)	Ne – server vygeneruje nový, ale přijdete o nastavení
`eula.txt`	Potvrzení souhlasu s licencí Mojangu	Ne – server bez něj nenastartuje
`server.jar`	Spouštěcí binární soubor enginu	Ne – server nenastartuje
`world/`	Složka hlavního herního světa	Pouze po vytvoření zálohy
`world_nether/`, `world_the_end/`	Dimenze Nether a End	Stejně jako složka `world/`
`plugins/`	Pluginy a jejich konfigurační data	Jednotlivé `.jar` ano (server nastartuje bez nich)
`mods/`	Herní módy pro Forge/Fabric	Ano, ale svět s modovanými bloky může hlásit chyby
`logs/`	Záznamy serveru včetně `latest.log`	Ano – bezpečné k pravidelnému promazávání
`ops.json`	Seznam administrátorů a operátorů	Opatrně – ztratíte práva OP
`whitelist.json`	Seznam povolených hráčů	Opatrně – ztratíte záznamy whitelistu
`banned-players.json`, `banned-ips.json`	Seznamy zablokovaných hráčů a IP	Ano – smaže evidované bany
`usercache.json`	Vyrovnávací paměť UUID a profilů hráčů	Ano – při startu se vytvoří znovu

#Složka `plugins/` – jak funguje

Každý nainstalovaný plugin si při prvním spuštění vytvoří vlastní podsložku s konfigurací:

plugins/
├── EssentialsX/
│   ├── config.yml
│   └── ...
├── LuckPerms/
│   ├── data/          ← hodnosti a oprávnění
│   └── yml/
└── ...

Konfiguraci pluginu upravujete v souboru config.yml (v integrovaném editoru v záložce FILES).
Provozní data pluginu (databáze hodností LuckPerms, ekonomické záznamy) leží v jeho podsložce – právě tyto složky musíte zálohovat před přeinstalací serveru.

#Anatomie složky herního světa (`world/`)

world/
├── level.dat          ← metadata světa (název, herní čas, počasí)
├── level.dat_old      ← automatická záloha z předchozího uložení
├── session.lock       ← zámek relace (smaže se po korektním zastavení)
├── region/            ← soubory chunků herního světa (.mca)
├── data/              ← mapy, data struktur a scoreboardy
├── playerdata/        ← pozice, životy a inventáře hráčů (.dat)
└── DIM-1/, DIM1/      ← (starší verze) dimenze

Soubor level.dat_old je bezplatné nouzové řešení. Při poškození světa můžete poškozený level.dat smazat a přejmenovat level.dat_old na level.dat – podrobnosti v návodu Poškozený svět.

#Než cokoli smažete

Vytvořte si zálohu serveru.
Server nejprve zastavte (Stop) – složky světa a data pluginů upravujte vždy na vypnutém serveru.
Mažte pouze soubory, jejichž účel bezpečně znáte – v případě pochybností se obraťte na zákaznickou podporu, která se raději podívá na seznam souborů, než aby zachraňovala svět.

#Nejčastější potíže

#Po přeinstalaci zmizely hodnosti a ekonomika

Přeinstalace maže složku plugins/. Data pluginů ležela v jejich podsložkách – obnovte tyto podsložky ze zálohy přes FILES nebo SFTP.

#Svět existuje, ale hráči nemají své věci a jsou na spawnu

Inventáře a pozice hráčů jsou uloženy ve složce world/playerdata. Byla-li tato složka vymazána nebo nenahrána, všichni hráči začínají jako noví na výchozím spawnu – takto to funguje, nejde o chybu.

#Složka s logy zaplňuje diskový prostor

Adresář logs/ můžete zcela bezpečně promazat – smažte komprimované .log.gz archivy a ponechte pouze aktuální soubor latest.log. Vytížení disku sledujte v klientském panelu u položky DISK.

#Co dál

Správce souborů a nahrání vlastní mapy
Databáze MySQL na serveru – data uložená mimo souborový systém