🔌 WorldEdit 소개

WorldEdit는 EngineHub에서 개발한 Minecraft 플러그인 및 모드로, 게임 내 맵 편집과 지형 조성 도구를 제공합니다. 이 도구는 지역 선택, 대량 블록 수정, 구조물 복사 및 붙여넣기, schematic 저장/불러오기, 지형의 프로그래밍 생성 등을 위한 명령어, 브러시, 도구를 제공합니다.

🎯 목적

WorldEdit는 넓은 월드를 직접 건축하거나 복구해야 하는 문제를 빠르고 반복 가능한 편집 작업으로 해결합니다. 효율적인 월드 관리와 대규모 편집 기능이 필요한 서버 관리자, 빌더, 개발자를 위한 도구입니다.

⚙️ 기능

  • 지역 선택 및 조작(pos1/pos2 선택, 지역 작업)
  • 클립보드 작업: 복사, 잘라내기, 붙여넣기, 회전, 뒤집기
  • schematic 저장/불러오기 및 클립보드 관리
  • 대규모 교체, 지정, 채우기, 지형 조성 도구
  • 지형을 다듬기 위한 브러시와 도구
  • 대규모 편집을 제어하는 성능 관련 명령어와 제한
  • 통합과 확장을 위한 개발자 API 및 문서

🧩 대상 사용자

  • 대량 편집과 롤백 도구가 필요한 Survival 및 SMP 서버
  • 큰 건축물을 작업하는 Creative/build 팀과 맵 제작자
  • griefing을 수정하거나 대규모 변경을 해야 하는 서버 관리자
  • API를 통해 월드 편집 기능을 통합하고 싶은 플러그인 개발자

🏗️ 사용 예시

  • 월드 업데이트 후 넓은 지역의 바이옴 표면 블록을 빠르게 교체하기
  • 한 위치의 건축물을 복사해 여러 월드에 붙여넣기
  • schematic을 사용해 플레이어가 만든 지역 복원하기
  • 어드벤처 맵용 스크립트 기반 지형 생성

⌨️ 명령어

명령어설명권한접근
/worldedit helpWorldEdit 도움말과 하위 명령어를 표시합니다.worldedit.helpAdmin
/worldedit reloadWorldEdit 설정을 다시 불러옵니다.worldedit.reloadAdmin
/worldedit reportWorldEdit 진단 보고서를 작성합니다.worldedit.reportAdmin
//undo기록에서 마지막 편집을 되돌립니다.worldedit.history.undo, worldedit.history.undo.selfAdmin
//redo마지막으로 되돌린 편집을 다시 적용합니다.worldedit.history.redo, worldedit.history.redo.selfAdmin
/searchitem블록 또는 아이템을 이름으로 검색합니다.worldedit.searchitemPlayer

(참고: 이 표는 WorldEdit 공식 문서에 제공된, 일반적으로 사용되는 문서화된 명령어와 해당 권한 노드를 나열합니다.)

🔐 권한

권한설명기본값
worldedit.helpWorldEdit 도움말 목록에 접근합니다.지정되지 않음
worldedit.reloadWorldEdit 설정을 다시 불러옵니다.지정되지 않음
worldedit.reportWorldEdit 진단 보고서를 생성합니다.지정되지 않음
worldedit.history.undo다른 플레이어의 기록 항목을 되돌립니다.지정되지 않음
worldedit.history.redo다른 플레이어의 기록 항목을 다시 적용합니다.지정되지 않음
worldedit.history.clear편집 기록을 지웁니다.지정되지 않음
worldedit.limit블록 변경 제한을 설정하거나 수정합니다.지정되지 않음
worldedit.timeout평가 제한 시간을 수정합니다.지정되지 않음
worldedit.searchitem아이템/블록 검색 명령어를 사용합니다.지정되지 않음
worldedit.global-mask글로벌 마스크를 설정합니다.지정되지 않음

(이 권한 노드는 공식 명령어 및 권한 문서에서 가져온 것입니다. 문서에 명확한 기본값이 없는 경우 기본값은 "지정되지 않음"으로 표시됩니다.)

⚙️ 설치

📥 설정

  • 사용 중인 플랫폼에 맞는 공식 WorldEdit 빌드(plugin 또는 mod)를 받으세요.
  • WorldEdit .jar 파일을 서버의 plugins/(Bukkit/Spigot/Paper의 경우)에 넣거나, 필요에 따라 Fabric/NeoForge용 모드 빌드를 설치하세요.
  • 서버를 다시 시작하고 서버 로그를 확인해 WorldEdit가 올바르게 로드되었는지 확인하세요.

📦 플랫폼 참고

  • WorldEdit는 서버 플러그인과 지원되는 모드 로더용 모드 형태로 제공됩니다. 공식 문서와 다운로드에서는 Bukkit, Spigot, Paper, Fabric, NeoForge, Sponge용 빌드를 안내합니다.

🧠 기술 노트

  • WorldEdit는 오픈 소스이며 GPL v3 라이선스를 따릅니다.
  • 소스 코드와 이슈 추적은 EngineHub의 WorldEdit GitHub 저장소에서 확인할 수 있습니다.
  • 공식 문서에는 통합과 예제를 위한 Developer API 섹션이 포함되어 있습니다.
  • 이 플러그인에는 대규모 편집을 제어하기 위한 설정 옵션, 제한, 성능 관련 설정이 포함되어 있습니다.

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

서버 월드를 프로그래밍 방식 또는 대량으로 편집해야 할 때—건축, 복원, 수리 등—WorldEdit는 해당 작업을 안정적이고 반복 가능하게 수행할 수 있도록 문서화된 명령어, 도구, API를 제공합니다.

WorldEdit 플러그인 서버

플러그인 WorldEdit 페이지에는 모니터링에서 이 플러그인을 확인한 서버, 사용 중인 플랫폼과 버전이 표시됩니다.

플러그인은 명령어, 경제, 보호, 접근 권한, 미니게임, 연동 및 기타 메커니즘을 추가할 수 있습니다. WorldEdit의 실제 역할은 서버별 설정에 따라 다릅니다.

데이터는 서버의 기술 응답에서 자동으로 생성됩니다. 서버가 플러그인 목록을 비공개로 설정한 경우, WorldEdit을 사용하더라도 이 섹션에 표시되지 않을 수 있습니다.

WorldEdit을 사용하는 서버 목록을 통해 프로젝트를 비교하거나, 지원 버전을 확인하거나, 공개 서버에서의 플러그인 사용 사례를 찾을 수 있습니다.