FastAsyncWorldEdit — plugin pro asynchronní a rychlou úpravu světů v Minecraftu

FastAsyncWorldEdit — plugin pro asynchronní a rychlou úpravu světů v Minecraftu

FastAsyncWorldEdit (zkráceně FAWE) je fork klasického pluginu WorldEdit pro Minecraft, ve kterém bylo přepsáno vnitřní zpracování úprav. Běžný WorldEdit provádí velké příkazy v hlavním vlákně serveru, takže změna stovek tisíc bloků způsobuje zamrzání a timeouty. FAWE rozděluje práci do vláken, seskupuje operace podle chunků a zapisuje je paralelně — stejný //set na oblasti 500x500 se dokončí bez zamrznutí ticků.

Pokud má server již pluginy závislé na WorldEditu (ochrana regionů, generátory struktur, stavební pluginy), stačí pouze nahradit WorldEdit za FAWE. Příkazy a API zůstávají kompatibilní, ale rychlost provádění se zvyšuje.

Výsledek příkazu //set glass na vybrané oblasti — skleněná kostka. Pozadí tvoří prázdná platforma z bílého betonu kolem ní. 

Co FAWE přidává k WorldEditu

Základní příkazy vypadají stejně: //pos1, //pos2, //set, //copy, //paste, //undo. Zásadní rozdíl je v tom, jak jsou interně zpracovávány. K tomu je přidáno asi 200 nových příkazů: pokročilé masky, vzory, transformace, specializované štětce a nástroje pro terén.

Některé věci, které ve vanilla WorldEditu nejsou:

• Neomezené //undo a //redo s historií uloženou na disku. Vrácení zpět je dostupné i po restartu serveru.

• //lazycopy — okamžitě zkopíruje vybranou oblast jakékoli velikosti bez úplného načtení kopie do paměti.

• CFI (Create From Image) — vygeneruje svět z výškové mapy nebo obrázku (/cfi).

• Příkazy kovadliny (Anvil) — masivní změny přímo v souborech regionu: odstranění všech truhel, oříznutí mapy, nahrazení bloků ve vybraném regionu.

• Příkazy osvětlení — /fixlighting, /setlight, /removelight pro manuální přepočet bez nutnosti znovu načítat chunky.

• Inspekce a obnova — //inspect ukáže, kdo blok položil a kdy, //history rollback obnoví svět do stavu před konkrétním datem.

Okno chatu s výstupem příkazu /we help — seznam kategorií FAWE s krátkými popisy. 

Výběry a základní příkazy

Výběr se provádí pomocí dřevěné sekery. Levým kliknutím nastavíte první bod, pravým kliknutím druhý. Alternativně: //pos1 a //pos2 nastaví body na aktuálních souřadnicích hráče, //hpos1 a //hpos2 na bloku, na který se díváte.

Po provedení výběru se zpřístupní základní operace s bloky:

Také se hodí: //copy -b kopíruje společně s biomy, //copy -e přeskočí entity, //paste -a ignoruje vzduchové bloky ze schematicu (zachová to, co už v cílové oblasti je).

Štětce a nástroje

Štětce (brushes) jsou příkazy navázané na předmět ve vaší ruce. Po příkazu /br <typ> pravé kliknutí aktivuje akci tam, kam se díváte. Nejčastěji používané:

• /br sphere <blok> <poloměr> — koule o daném poloměru na kliknutém bodě.

• /br cyl <blok> <poloměr> <výška> — válec.

• /br smooth <poloměr> — vyhlazení terénu.

• /br stencil <vzor> <poloměr> <soubor> — maluje pomocí výškové mapy nebo obrázku.

• /br spline <vzor> — vytvoří křivku přes několik bodů (silnice, tunely, mosty).

• /br sweep — táhne obsah schránky podél křivky.

• /br scatter <vzor> <hustota> — náhodně rozptýlí bloky nebo schematicy s nastavenou hustotou.

• /br copy — levé kliknutí zkopíruje objekt, pravé kliknutí ho vloží. Příznak -r přidá při vkládání náhodnou rotaci.

Štětec /br smooth 10 v akci 

Pro štětce se nastavují masky (/mask) a vzory (/mat). Maska určuje, které bloky mohou být nahrazeny: /mask >stone — pouze bloky nad kamenem, /mask <air — pouze bloky pod vzduchem. Vzor určuje, čím je nahradit: /mat 50%stone,50%cobblestone vytvoří náhodnou směs kamene a dlažební kostky v poměru 50/50, /mat #surfacespread[3][stone] — vzor rozptylu s poloměrem 3.

Schematics — struktury v souborech

FAWE podporuje formáty .schem a .schematic. Příkazy:

• //schem save <název> — uloží aktuální výběr do plugins/FastAsyncWorldEdit/schematics/.

• //schem load <název> — načte soubor do schránky.

• //schem list — seznam dostupných schematiců.

• //schem delete <název> — smaže schematic.

Navíc příkaz /download vytvoří anonymní odkaz na schránku prostřednictvím služby schem.intellectualsites.com. Odkaz je dočasný; můžete soubor odeslat jinému hráči nebo serveru bez nutnosti ho manuálně exportovat přes FTP. To se konfiguruje v sekci web v configu.

Ochrana regionů a limity na hráče

FAWE se integruje s WorldGuard a PlotSquared. Možnost region-restrictions: true v souboru config.yml omezuje úpravy na oblasti, do kterých je hráč přidán.

Ve výchozím nastavení funguje v režimu MEMBER — hráči mohou upravovat pouze tam, kde jsou členy regionu. Alternativně OWNER. Administrátoři obcházejí omezení pomocí oprávnění fawe.bypass. Pro servery s několika chráněnými zónami a volným stavěním ve zbytku světa je praktičtější režim blacklistu: allow-blacklists: true plus worldguard-region-blacklist: true umožňuje úpravy kdekoli kromě chráněných regionů.

Různé limity lze nakonfigurovat pro různé skupiny hráčů. Blok default se zkopíruje pod novým názvem, hodnoty max-changes, max-brush-radius a max-iterations se upraví a oprávnění se udělí hráči. Tímto způsobem mohou na stejném serveru koexistovat přísné limity pro nováčky a rozšířené pro důvěryhodné hráče.

Konfigurace

Hlavní soubory se nacházejí zde: plugins/FastAsyncWorldEdit. Většina výchozích hodnot je vhodná pro typický server — má smysl upravit pouze několik klíčových bloků.

Paměť a limity

Fronta a vlákna

Historie a schránka

Závěr

FastAsyncWorldEdit odstraňuje primární omezení standardního WorldEditu, kvůli kterému mohly rozsáhlé úpravy zastavit server. Na modpack serverech a stavebních sítích, kde hráči současně pracují se stovkami tisíc bloků, FAWE eliminuje timeouty a zamrzání. Na malých survival serverech s ojedinělými úpravami výhoda není tak znatelná, ale plugin ničemu neškodí — je zpětně kompatibilní přes své API.

Pro servery s rozsáhlým stavěním je FastAsyncWorldEdit mnohem praktičtější volbou; pro občasné úpravy vanilla světa postačí standardní alternativy.