Minecraft 플러그인 FastAsyncVoxelSniper

🔌 FastAsyncVoxelSniper 소개

FastAsyncVoxelSniper는 VoxelSniper의 유지보수 포크로, 원래의 장거리 브러시와 지형 편집 툴킷을 최신 서버 소프트웨어에 가져옵니다. 이 프로젝트는 보셀 연산을 비동기적으로 수행하는 데 중점을 두며, 대규모 또는 잦은 편집 중 메인 스레드 블로킹을 줄이고 필요에 따라 FastAsyncWorldEdit와 통합합니다.

🎯 목적

이 플러그인은 세밀한 지형 편집, 대규모 지형 수정, 지정한 블록의 배치/제거를 위한 서버 측 브러시 도구를 제공합니다. 서버의 응답성을 유지하면서 정교하고 반복 가능한 월드 편집 도구가 필요한 서버 관리자, 빌더, 크리에이티브 팀을 위한 것입니다.

⚙️ 기능

• 많은 보셀 연산을 비동기로 실행해 대규모 편집 시 서버 지연을 줄입니다.
• VoxelSniper의 전체 브러시 및 브러시 파라미터 지원(ball, disc, erosion, overlay/underlay, splatter, blend, drain 등).
• 브러시용 material/pattern 선택과 ink/data 설정을 위한 performer 시스템.
• 클래식 VoxelSniper와 같은 CLI 스타일 브러시 명령 구문(예: /b, /v, 재귀 및 크기 파라미터).
• 보호 플러그인을 존중하고 FAWE의 비동기 기능을 활용하기 위한 FastAsyncWorldEdit 훅 통합.
• 브러시 사용법과 명령에 대한 공개 Javadocs 및 문서를 제공합니다.

🧩 대상

• 세밀한 지형 편집 도구가 필요한 크리에이티브 및 빌드 서버.
• 신뢰할 수 있는 빌더나 스태프가 큰 편집을 할 수 있도록 허용하는 Survival/SMP 서버.
• 클래식 VoxelSniper 브러시 워크플로우를 선호하지만 최신 Spigot/Paper 환경과의 호환성이 필요한 관리자.

🏗️ 사용 예시

• 관리자가 큰 erosion 브러시로 빌드 구역의 지형을 재형성하면서 메인 서버 스레드를 막지 않습니다.
• 빌더가 Overlay 브러시로 표토층을 다시 칠해 바이옴을 빠르게 바꾸거나 자동 편집 후 지형을 정리합니다.
• 팀이 performer 패턴을 사용해 구조물의 방향이나 블록 데이터를 보존하면서 재료를 교체합니다.

⌨️ 명령어

참고: 프로젝트 문서에는 브러시별 명령과 지시 파라미터(재귀 rf[#], 브러시 크기 b[#], m/i 같은 performer 수정자, 브러시별 정보)가 많이 나와 있습니다. 권한 노드는 공개 명령 참고서에 나열되어 있지 않습니다.

⚙️ 설치

📥 설정

• 공식 배포본에서 공식 플러그인 JAR를 다운로드합니다(Modrinth/CurseForge의 프로젝트 릴리스 또는 GitHub 릴리스).
• Bukkit 호환 서버(Spigot/Paper/Purpur)의 plugins/ 디렉터리에 JAR를 넣습니다.
• 서버를 재시작하고 콘솔 로그에서 플러그인 로드 성공 메시지를 확인합니다.

📦 의존성

• 선택적 훅: FastAsyncWorldEdit(FAWE) — 이 플러그인은 FAWE와 통합되어 비동기 편집 기능을 사용하고 FAWE 보호 기능을 존중합니다. 기본 사용에는 FAWE가 엄격히 필요하지 않지만 통합 항목으로 포함됩니다.

🧠 기술 메모

• 공식 소스와 개발은 IntellectualSites 조직의 GitHub 저장소에서 호스팅됩니다.
• 프로젝트는 코드베이스와 함께 유지되는 Javadocs와 문서를 공개합니다.
• GPL-3.0-only로 라이선스가 부여됩니다.
• 릴리스는 Modrinth와 CurseForge를 통해 배포되며, 스냅샷/아티팩트는 Maven Central에 게시됩니다.

🤝 이 플러그인이 유용한 경우

VoxelSniper 스타일 브러시에 의존하지만 최신 Spigot/Paper 서버와의 호환성, 그리고 대규모 편집 시 메인 스레드 영향 감소가 필요하다면, FastAsyncVoxelSniper는 클래식 브러시 워크플로우를 유지하면서 FAWE 보호 기능과 통합되는 유지보수된 비동기 대응 구현을 제공합니다.