- 검증 기준
- Paper 1.21.11 · Java 21
- 편집 기반
- WorldEdit 7.4.2 · FAWE 2.15.3
- 변경 이력
- LocalSession · undo · redo
하는 일
관리자가 WorldEdit .schem 파일을 그룹으로 정의하면, 플레이어는 평범한 주 손 아이템 하나에 그룹을 바인딩해 재사용 가능한 나무·구조물 브러시로 쓸 수 있습니다.
지면을 클릭할 때 그룹 안의 파일 하나를 같은 확률로 고르고 선택적으로 Y축 회전해 배치하며, 결과는 플레이어의 WorldEdit 편집 이력에 남습니다.
빠른 시작
요구 사항 확인
Paper 1.21.11과 Java 21에 WorldEdit 7.4.2 또는 FAWE 2.15.3을 설치합니다.
파일과 그룹 구성
plugins/Scape/schematics/trees/아래에.schem을 두고treebrush.groups에 그룹을 추가합니다.설정 검증
/scape treebrush validate후/scape treebrush reload를 실행합니다.아이템 바인딩
아이템을 주 손에 들고
/scape treebrush <group>을 실행합니다.배치와 해제
지면을 클릭해 배치하고 필요하면
//undo를 사용합니다./scape treebrush off로 바인딩을 해제합니다.
핵심 동작과 안전성
- 아이템별 바인딩
- Paper PDC를 사용해 개별 item stack에 그룹을 저장합니다. 같은 재질의 아이템도 서로 다른 그룹을 가질 수 있습니다.
- 선택과 회전
- 그룹 안의 파일을 균등 무작위로 선택합니다. Y축 회전과 양의 360 약수인 회전 간격을 설정할 수 있습니다.
- 즉시 반복 회피
- 가능한 경우 직전에 사용한 같은 파일·회전 조합을 바로 다시 선택하지 않습니다.
- 편집 세션 통합
- WorldEdit LocalSession과 EditSession을 사용해 mask, change limit, block bag, side effect, undo·redo 이력을 유지합니다.
- FAWE 작업 처리
- FAWE가 있으면 스키매틱 로드와 paste를 FAWE 작업 스레드에서 처리합니다.
- WorldGuard 검사
- 선택적으로 회전된 전체 bounding box를 보수적으로 확인하고, 검사 실패 시 paste를 거부합니다.
- 안전한 설정 교체
- 전체 검증이 성공해야 새 registry를 적용합니다. 실패하면 마지막 정상 구성을 유지합니다.
- 경로와 그룹 검증
- 경로 이탈과 symbolic-link escape를 막고, 최대 8단계 중첩에서 cycle·중복·누락·지원하지 않는 형식을 거부합니다.
주요 명령
- 안내
-
/scape기본 안내/scape treebrushtreebrush 안내 - 바인딩
-
/scape treebrush <group>주 손 아이템에 그룹 바인딩/scape treebrush <group> -r <degrees>회전 간격과 함께 바인딩/scape treebrush off현재 아이템 바인딩 해제/scape treebrush status현재 상태 확인 - 그룹 관리
-
list사용 가능한 그룹info <group>그룹 구성 확인validate현재 설정 검증reload검증 후 설정 교체 - 입력 형식
-
/bep명령 alias//scapeWorldEdit 스타일 입력
호환성과 한계
요구 사항
- Java 21, Paper 1.21.11
- WorldEdit 7.4.2 또는 FAWE 2.15.3
- WorldGuard 7.0.17 선택 사용
- 플레이어별 paste는 한 번에 하나만 진행
지원 경계
- Folia 호환 선언과 plugin·JAR hot swap을 제공하지 않습니다.
- 바인딩된 아이템은 브러시 사용 중 일반 상호작용과 블록 파괴를 억제합니다.
- 90도가 아닌 회전은 실험적이며 방향 블록과 반올림 좌표가 완벽하지 않을 수 있습니다.
- 활성 FAWE global transform이 anchor·높이·보호 경계를 무효화할 수 있으면 요청을 거부합니다.