Minecraft 플러그인 FastAsyncWorldEdit

🔌 FastAsyncWorldEdit 소개

FastAsyncWorldEdit는 서버를 블로킹하지 않도록 대규모이면서 잦은 월드 편집을 비동기적으로 수행하도록 설계된 Minecraft 플러그인입니다. WorldEdit의 고성능 포크로, 메모리와 CPU 개선, 더 안전한 다중 사용자 편집, 그리고 빌더, 맵 제작자, 네트워크 관리자에게 유용한 추가 편집 기능에 중점을 둡니다.

🎯 목적

이 플러그인의 핵심 목적은 서버 스태프와 개발자가 매우 큰 편집(schematics, 대량 치환, 지역 채우기, 복사/붙여넣기)을 수행할 수 있게 하고, 영구적인 기록, 롤백, 클립보드 서비스를 제공하면서 서버 tick 성능에 미치는 영향을 최소화하는 것입니다.

⚙️ 기능

• 메인 스레드 부담을 줄이기 위한 여러 배치 모드(blocks, chunk placement, world/CFI)를 갖춘 비동기 편집 처리.
• 대규모 편집 지원과 멀티플레이어 서버를 위한 안전장치(엔티티, 타일, 메모리, 변경, 반복, 지역, 인벤토리에 대한 플레이어별 제한).
• 클립보드 웹 연동 및 멀티 서버/서버 간 클립보드.
• 월드별 무제한 undo/redo 기록, 변경 사항 검색 및 복원을 위한 inspection 및 rollback 도구.
• WorldEdit 호환 API 확장과 일반 작업을 위한 비동기 래퍼.
• 다양한 추가 brushes, tools, masks, pattern syntax, transforms, schematic 형식(부분적으로 손상된 schematic 복구 포함).
• 시각화, 타겟 모드, 스크롤 액션, biome mixing, 인게임 월드 페인팅, 이미지 가져오기 및 schematic 시각화 기능.
• 로깅 제어(설정 가능한 압축 및 버퍼링)와 기록되지 않는 빠른 편집을 위한 bypass 옵션.

🧩 대상 사용자

• 대규모 건축을 하거나 creative/creative와 비슷한 구역을 관리하는 서버 관리자와 모더레이터.
• 매우 큰 schematic을 붙여넣고, 변환하고, 관리해야 하는 맵 제작자와 빌더.
• 여러 백엔드 서버에 걸쳐 안전하고 높은 처리량의 편집이 필요한 네트워크 운영자.
• WorldEdit와 호환되는 API 동작이 필요하지만 비동기식의 블로킹 없는 작업을 원하는 개발자.

🏗️ 사용 예시

• 온라인 플레이어에게 큰 tick lag를 일으키지 않고 매우 큰 schematic을 붙여넣고 변환합니다.
• 최근 기록을 검색한 뒤, 실수로 큰 변경을 한 후 대상 롤백을 수행합니다.
• 영구 클립보드를 사용해 서버나 팀원 간에 건축물을 공유합니다.

⚙️ 설치

📥 설정

• 신뢰할 수 있는 릴리스 페이지(Modrinth 또는 플러그인 리소스 페이지)에서 공식 플러그인 jar를 다운로드하세요.
• jar 파일을 서버의 plugins/ 폴더에 넣으세요.
• 서버를 재시작하고 콘솔 로그를 확인해 플러그인이 정상적으로 로드되는지 확인하세요.

📦 의존성

• FAWE는 보호 플러그인과 통합됩니다. 알려진 지원 통합에는 WorldGuard와 PlotSquared가 포함됩니다(필수 핵심 의존성이 아니라 지원되는 통합으로 표시됨).

🧠 기술 참고

• FAWE는 WorldEdit와의 API 호환성을 유지하면서 비동기 래퍼를 추가해 많은 WorldEdit 플러그인이 FAWE의 비동기 작업과 함께 동작하도록 합니다.
• 공식 지원 서버 플랫폼에는 Bukkit/Spigot/Paper/Purpur가 포함됩니다. 배포 전에 사용 중인 서버 빌드와의 정확한 호환성을 확인하세요.
• 릴리스와 호환성 노트는 최신 Minecraft 버전을 다룹니다(프로젝트에는 여러 1.16.5+ 및 1.20/1.21 계열이 안내되어 있음). 정확한 지원 버전은 다운로드한 릴리스를 확인하세요.
• 이 프로젝트는 GPL-3.0-only 라이선스로 배포됩니다.

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

대규모 편집을 자주 수행하거나, creative 또는 대형 빌더 서버를 운영하거나, 메인 서버 스레드를 블로킹하지 않는 WorldEdit API 동작이 필요하다면 FastAsyncWorldEdit는 비동기 작업, 향상된 도구, 그리고 편집 관련 중단을 줄이고 라이브 서버에서 대규모 편집을 더 안전하게 만드는 rollback/기록 기능을 제공합니다.