Plugin Minecraft FastAsyncWorldEdit

🔌 O FastAsyncWorldEdit

FastAsyncWorldEdit to wtyczka do Minecrafta zaprojektowana do wykonywania dużych i częstych edycji świata asynchronicznie, aby nie blokować serwera. To wydajny fork WorldEdit, skupiony na poprawie użycia pamięci i CPU, bezpieczniejszej edycji wieloosobowej oraz dodatkowych funkcjach edytora przydatnych dla builderów, twórców map i administratorów sieci.

🎯 Cel

Głównym celem wtyczki jest umożliwienie personelowi serwera i deweloperom wykonywania bardzo dużych edycji (schematy, masowe podmiany, wypełnianie regionów, kopiuj/wklej) oraz zapewnienie trwałej historii, rollbacku i schowków, przy jednoczesnym minimalizowaniu wpływu na wydajność ticków serwera.

⚙️ Funkcje

• Asynchroniczne przetwarzanie edycji z wieloma trybami umieszczania (bloki, umieszczanie po chunkach, world/CFI), aby zmniejszyć obciążenie głównego wątku.
• Obsługa dużych edycji i zabezpieczenia dla serwerów wieloosobowych (limity per gracz dla encji, tile, pamięci, zmian, iteracji, regionów, ekwipunku).
• Integracja schowka z webem oraz schowki międzyserwerowe/wieloserwerowe.
• Nieskończona historia cofania/ponawiania dla każdego świata, narzędzia inspekcji i rollbacku do wyszukiwania i przywracania zmian.
• Rozszerzone API zgodne z WorldEdit oraz asynchroniczne wrappery dla typowych operacji.
• Wiele dodatkowych brushy, narzędzi, masek, składni wzorów, transformacji i formatów schematów (w tym naprawa częściowo uszkodzonych schematów).
• Funkcje wizualizacji, tryby celowania, akcje przewijania, mieszanie biomów, malowanie świata w grze, import obrazów i wizualizacja schematów.
• Kontrole logowania (konfigurowalna kompresja i buforowanie) oraz opcja bypass dla szybkich, nielogowanych edycji.

🧩 Dla kogo jest

• Administratorów i moderatorów serwerów, którzy wykonują duże budowy lub zarządzają obszarami creative/podobnymi do creative.
• Twórców map i builderów, którzy muszą wklejać, przekształcać i zarządzać bardzo dużymi schematami.
• Operatorów sieci, którzy potrzebują bezpiecznej edycji o wysokiej przepustowości na wielu serwerach backend.
• Deweloperów, którzy potrzebują zachowania API zgodnego z WorldEdit, ale chcą operacji asynchronicznych i nieblokujących.

🏗️ Przykładowe zastosowania

• Wkleja i przekształca bardzo duży schemat bez powodowania dużego laga ticków u graczy online.
• Przeszukuje ostatnią historię i wykonuje precyzyjny rollback po przypadkowej dużej zmianie.
• Korzysta z trwałych schowków do udostępniania budowli między serwerami lub członkami zespołu.

⚙️ Instalacja

📥 Konfiguracja

• Pobierz oficjalny plik jar wtyczki z zaufanej strony wydań (Modrinth lub strona zasobów wtyczki).
• Umieść plik jar w folderze plugins/ na serwerze.
• Uruchom ponownie serwer i sprawdź logi konsoli, aby potwierdzić, że wtyczka ładuje się poprawnie.

📦 Zależności

• FAWE integruje się z wtyczkami ochrony; znane obsługiwane integracje obejmują WorldGuard i PlotSquared (wymienione jako obsługiwane integracje, a nie wymagane zależności główne).

🧠 Uwagi techniczne

• FAWE zachowuje zgodność API z WorldEdit i dodaje asynchroniczne wrappery, dzięki czemu wiele wtyczek WorldEdit działa z asynchronicznymi operacjami FAWE.
• Oficjalnie wspierane platformy serwerowe to Bukkit/Spigot/Paper/Purpur. Przed wdrożeniem potwierdź dokładną zgodność ze swoją wersją serwera.
• Wydania i uwagi o zgodności obejmują nowoczesne wersje Minecrafta (projekt wymienia kilka serii 1.16.5+ oraz 1.20/1.21); sprawdź pobierane wydanie, aby poznać dokładnie obsługiwane wersje.
• Projekt jest publikowany na licencji GPL-3.0-only.

🤝 Kiedy ta wtyczka jest przydatna

Jeśli regularnie wykonujesz edycje na dużą skalę, prowadzisz serwery creative lub z dużymi budowami, albo potrzebujesz działania API WorldEdit bez blokowania głównego wątku serwera, FastAsyncWorldEdit zapewnia operacje asynchroniczne, ulepszone narzędzia oraz funkcje rollbacku/historii, które zmniejszają przerwy związane z edycją i czynią duże zmiany bezpieczniejszymi na działających serwerach.