Plugin Minecraft FastAsyncVoxelSniper

🔌 O FastAsyncVoxelSniper

FastAsyncVoxelSniper to utrzymany fork VoxelSniper, który przenosi oryginalny zestaw narzędzi do dalekosiężnych brushy i terraformowania do nowoczesnego oprogramowania serwerowego. Projekt koncentruje się na wykonywaniu operacji voxel asynchronicznie, co zmniejsza blokowanie głównego wątku podczas dużych lub częstych edycji, oraz integruje się z FastAsyncWorldEdit tam, gdzie to مناسبne.

🎯 Cel

Wtyczka udostępnia narzędzia brush po stronie serwera do szczegółowego terraformowania, dużych zmian terenu i precyzyjnego stawiania/usuwania bloków. Jest przeznaczona dla administratorów serwerów, budowniczych i zespołów kreatywnych, którzy potrzebują dokładnych, powtarzalnych narzędzi do edycji świata przy zachowaniu responsywności serwera.

⚙️ Funkcje

• Asynchroniczne wykonywanie wielu operacji voxel, aby zmniejszyć lagi serwera podczas dużych edycji.
• Pełny zestaw brushy i parametrów brushy VoxelSniper (ball, disc, erosion, overlay/underlay, splatter, blend, drain itd.).
• System performer do wyboru materiału/wzoru oraz konfiguracji ink/danych dla brushy.
• Składnia poleceń brushy w stylu CLI (np. /b, /v, parametry rekurencji i rozmiaru) jak w klasycznym VoxelSniper.
• Integracja hook z FastAsyncWorldEdit, aby respektować wtyczki ochronne i wykorzystywać asynchroniczne funkcje FAWE.
• Projekt udostępnia opublikowane Javadocs i dokumentację dotyczącą użycia brushy oraz komend.

🧩 Dla kogo

• Serwery kreatywne i budowlane, które potrzebują precyzyjnych narzędzi do terraformowania.
• Serwery Survival/SMP, które pozwalają zaufanym budowniczym lub administracji wykonywać duże edycje.
• Administratorów, którzy wolą klasyczny workflow brushy VoxelSniper, ale potrzebują kompatybilności z nowoczesnymi środowiskami Spigot/Paper.

🏗️ Przykładowe zastosowania

• Administrator używa dużego brusha erosion, aby przekształcić teren na obszarze budowy bez blokowania głównego wątku serwera.
• Budowniczy przemalowuje warstwy gleby za pomocą brusha Overlay, aby szybko zmienić biome lub uporządkować teren po automatycznych edycjach.
• Zespół używa wzorów performer, aby zastąpić materiały w strukturze z zachowaniem orientacji lub danych bloku.

⌨️ Komendy

Uwaga: dokumentacja projektu zawiera wiele komend specyficznych dla brushy i parametrów instrukcji (rekurencję rf[#], rozmiar brushy b[#], modyfikatory performera takie jak m/i oraz informacje specyficzne dla brushy). Węzły uprawnień nie są wymienione w publicznej dokumentacji komend.

⚙️ Instalacja

📥 Konfiguracja

• Pobierz oficjalny plik JAR wtyczki z oficjalnej dystrybucji (wydania projektu na Modrinth/CurseForge lub GitHub Releases).
• Umieść plik JAR w katalogu plugins/ swojego serwera dla serwera zgodnego z Bukkit (Spigot/Paper/Purpur).
• Uruchom ponownie serwer i sprawdź logi konsoli pod kątem komunikatów o pomyślnym załadowaniu wtyczki.

📦 Zależności

• Opcjonalny hook: FastAsyncWorldEdit (FAWE) — wtyczka integruje się z FAWE, aby korzystać z asynchronicznych funkcji edycji i respektować ochronę FAWE. FAWE nie jest wymagane do podstawowego użycia, ale jest wymienione jako integracja.

🧠 Uwagi techniczne

• Oficjalne źródło i rozwój są hostowane w repozytorium GitHub organizacji IntellectualSites.
• Projekt publikuje Javadocs i dokumentację utrzymywaną razem z kodem źródłowym.
• Licencja: GPL-3.0-only.
• Wydania są dystrybuowane przez Modrinth i CurseForge, a snapshoty/artefakty są publikowane w Maven Central.

🤝 Kiedy ta wtyczka jest przydatna

Jeśli korzystasz z brushy w stylu VoxelSniper, ale potrzebujesz kompatybilności z nowoczesnymi serwerami Spigot/Paper i mniejszego wpływu na główny wątek przy dużych edycjach, FastAsyncVoxelSniper oferuje utrzymywaną, obsługującą asynchroniczność implementację, która zachowuje klasyczne workflow brushy, jednocześnie integrując się z ochroną FAWE.