Discord
Wiki - Pluginy

WorldEdit - plugin do edycji terenu na serwerze

WorldEdit to legendarny plugin od EngineHub, który pozwala na masową edycję terenu, kopiowanie i wklejanie struktur, malowanie pędzlami i generowanie kształtów geometrycznych. Działa na Paper, Spigot, Fabric i Forge od wersji 1.7.10 do 1.21.x.

Czas czytania: ~6 min Platforma: Paper / Spigot / Fabric / Forge

Co to jest WorldEdit

WorldEdit to darmowy, open-source plugin do edycji terenu, rozwijany przez zespół EngineHub (twórców WorldGuard). Jest standardowym narzędziem builderów na serwerach Minecraft od ponad dekady. Zamiast ręcznie stawiać tysiące bloków, WorldEdit pozwala zaznaczać regiony i modyfikować je jedną komendą.

Plugin obsługuje zarówno serwery (Paper, Spigot, Purpur) jak i klienty z modami (Fabric, Forge). Wersja serwerowa i modowa mają identyczne komendy, więc umiejętności przenoszą się między platformami. Kod źródłowy dostępny jest na GitHub.

WorldEdit jest bazą dla FastAsyncWorldEdit (FAWE), który dodaje asynchroniczne przetwarzanie operacji i znacznie zwiększa wydajność przy dużych edycjach. Na serwerach produkcyjnych zaleca się używanie FAWE zamiast czystego WorldEdit.

Zaznaczanie regionów

Podstawą pracy z WorldEdit jest zaznaczanie regionów. Domyślnie używa się drewnianego toporka (wand) do wyznaczania dwóch punktów prostopadłościanu:

  • Lewy klik - ustawia punkt 1 (pos1)
  • Prawy klik - ustawia punkt 2 (pos2)
  • //wand - daje drewniany toporek do zaznaczania
  • //pos1 / //pos2 - ustawia punkt w miejscu, gdzie stoisz

Oprócz prostokątnych regionów WorldEdit obsługuje zaznaczanie wielokątne (//sel poly), cylindryczne (//sel cyl), sferyczne (//sel sphere) i konweksowe (//sel convex). Zmiana trybu zaznaczania komendą //sel [typ].

Komenda //expand [ilość] [kierunek] powiększa zaznaczenie, a //contract je zmniejsza. Przydatne, gdy trzeba powiększyć region bez ponownego zaznaczania.

Kluczowe komendy

Komenda Działanie
//set [blok]Wypełnia zaznaczenie jednym blokiem
//replace [stary] [nowy]Zamienia jeden blok na inny w zaznaczeniu
//copyKopiuje zaznaczenie do schowka
//pasteWkleja schowek w obecnej pozycji
//rotate [kąt]Obraca schowek o podany kąt
//flip [kierunek]Odbija schowek lustrzanie
//stack [ilość] [kierunek]Powiela zaznaczenie w danym kierunku
//move [ilość] [kierunek]Przesuwa zaznaczenie
//undoCofnij ostatnią operację
//redoPonów cofniętą operację
//drain [promień]Usuwa wodę i lawę w promieniu
//regenRegeneruje teren w zaznaczeniu

WorldEdit obsługuje wzorce bloków - na przykład //set 70%stone,30%cobblestone wypełni zaznaczenie mieszanką kamienia i bruku. Można też używać filtrów stanów bloków, np. //set oak_stairs[facing=north].

Pędzle i narzędzia

Pędzle pozwalają na edycję terenu przez klikanie w bloki, bez zaznaczania regionów. Przypisujesz pędzel do trzymanego przedmiotu:

  • //brush sphere [blok] [promień] - maluje kule z wybranego bloku
  • //brush cyl [blok] [promień] [wysokość] - maluje cylindry
  • //brush smooth [promień] - wygładza teren
  • //brush gravity [promień] - symuluje grawitację (bloki opadają)
  • //brush clipboard - wkleja schowek przy każdym kliknięciu

Narzędzia jednorazowe: //tool tree (sadzi drzewa), //tool repl [blok] (zamienia kliknięty blok), //tool info (wyświetla informacje o bloku). Maska pędzla (//mask [blok]) ogranicza, na jakich blokach pędzel działa.

Schematy (schematic)

Schematy to zapisane struktury, które można wklejać wielokrotnie. WorldEdit używa formatu .schem (dawniej .schematic). Workflow:

  1. Zaznacz region i skopiuj go: //copy
  2. Zapisz schemat: //schem save [nazwa]
  3. Wczytaj schemat: //schem load [nazwa]
  4. Wklej: //paste

Schematy zapisują się w folderze plugins/WorldEdit/schematics/. Można je pobrać z internetu (np. z Planet Minecraft) i umieścić w tym katalogu. Komenda //schem list wyświetla wszystkie dostępne schematy.

Na dużych serwerach builderskich schematy to podstawa pracy - zespoły tworzą biblioteki gotowych elementów (drzewa, budynki, detale), które łączy się w większe kompozycje.

Konfiguracja i uprawnienia

Plik konfiguracyjny to plugins/WorldEdit/config.yml. Najważniejsze ustawienia:

# Limity bezpieczeństwa
limits:
  max-blocks-changed: 50000     # maks. bloków na operację
  max-radius: 100               # maks. promień pędzla/komendy
  max-brush-radius: 15          # maks. promień pędzla
  butcher-radius: 200           # maks. promień //butcher

# Historia
history:
  size: 15                      # ile operacji //undo pamięta
  expiration: 10                # po ilu minutach czyści historię

Kluczowe uprawnienia (kontrolowane przez LuckPerms):

  • worldedit.selection.* - zaznaczanie regionów
  • worldedit.clipboard.* - kopiowanie i wklejanie
  • worldedit.brush.* - korzystanie z pędzli
  • worldedit.schematic.* - zapis i wczytywanie schematów
  • worldedit.region.* - operacje na regionach (set, replace)

Na serwerach produkcyjnych zdecydowanie zaleca się użycie FAWE zamiast czystego WorldEdit. FAWE przetwarza operacje asynchronicznie, nie blokuje głównego wątku serwera i obsługuje znacznie większe edycje bez lagów. Jest w pełni kompatybilny z komendami WorldEdit.