# Mcast-WorldMapScanner

Mcast-WorldMapScanner vytváří přesnou statickou PNG mapu z horního pohledu z chunků, které jsou skutečně uložené v jednom Paper světě.

## Hlavní vlastnosti

- Jeden Minecraft blok vždy odpovídá jednomu pixelu zdrojové mapy.
- Skenuje existující chunky a nevytváří nový terén.
- Použije celý uložený svět, nebo přesný čtverec určený středem a délkou hrany.
- Zpracuje materiály, biomy, výšky, hloubku vody a povrchové detaily.
- Chybějící části vybrané oblasti zůstávají průhledné.
- Vytvoří ostrou zdrojovou PNG mapu a jednu menší webovou kopii bez rozmazávajícího vyhlazování.
- Podporuje bezpečné pozastavení, pokračování a atomický zápis.
- Ověřené mezisoubory uklízí průběžně.

## Příkazy

/worldmapscanner start
/worldmapscanner status
/worldmapscanner pause
/worldmapscanner resume
/worldmapscanner stop
/worldmapscanner speed <1-64>
/worldmapscanner center <x> <z>
/worldmapscanner size <bloky>
/worldmapscanner area auto
/worldmapscanner help

Příkaz `center` nebo `size` připraví čtvercovou oblast pro další běh. `area auto` vrátí výběr na všechny uložené chunky zvoleného světa. `stop` běh ukončí a neúplný výstup odstraní.

## Výstup

Hotové mapy se ukládají přímo do:

plugins/Mcast-WorldMapScanner/output/

Pokud má vybraná oblast nejvýše 8192 × 8192 bloků, vzniknou právě dva soubory:

- `world-map.png` — zdrojová mapa ve skutečných rozměrech oblasti, 1 blok = 1 pixel,
- `world-map-web.png` — menší ostrá kopie celé oblasti pro web.

Větší oblast zachová hlavní `world-map.png` o velikosti 8192 × 8192 a doplní pevné okolní mapy: north, south, east, west a čtyři rohy. Ještě větší svět přidává celé další prstence stejné souřadnicové sítě. Nic se nezmenšuje ani nepřerozděluje na stejně velké čtvrtiny.

Během práce existuje pouze interní složka `.working-<svět>-<čas>`. Po bezpečném zveřejnění PNG se odstraní společně s technickými mezisoubory; ve výstupní složce zůstávají jen výsledné mapy.

## Výkon

Doba práce roste podle mapované plochy: dvojnásobná délka obou hran znamená přibližně čtyřnásobný počet bloků. Vyšší `speed` může práci zrychlit, ale zvýší využití RAM a zatížení serveru; zvyšujte ji opatrně.

Velký běh může dočasně využít mnoho místa na disku. Plugin skládá mapu po bezpečných úrovních založených na mocninách dvou a malé podklady maže až po vytvoření jejich nástupce. Hotové zdrojové mapy zůstávají jako výsledný produkt.

## Technické informace

- Paper 1.21.11 / Minecraft 1.21.x
- Java 21
- Server-side plugin, ve výchozím stavu pouze pro OP
- Oprávnění: `mcast.worldmapscanner.use`

Verze 2.1 zachovává pevné zdrojové měřítko 1:1, skládá obraz postupně v pracovních stupních založených na mocninách dvou a zveřejní pouze hotové mapové soubory. Nalezený config řady 1.x zálohuje jako `config-before-2.0.0.yml` a převede do stručné podoby.

**Autor:** mcast
**Web:** https://www.mc-amethyst.cz
