FastAsyncVoxelSniper 문서 원본 보기

'''FastAsyncVoxelSniper''' (FAVS)는 대규모 지형 편집을 위한 고성능 플러그인이다. [[VoxelSniper]]의 기능을 [[FastAsyncWorldEdit]]의 비동기 처리 엔진과 결합하여 서버 렉 없이 빠른 지형 편집을 가능하게 한다.

== 주요 기능 ==
=== 브러시 시스템 ===
FAVS는 40개 이상의 다양한 브러시를 제공한다:
* '''Ball Brush''': 구형 편집
* '''Voxel Brush''': 정육면체 편집
* '''Disc Brush''': 원반형 편집
* '''Erosion Brush''': 자연스러운 침식 효과
* '''Overlay Brush''': 표면 덮기
* '''Blend Brush''': 지형 부드럽게 만들기

=== 비동기 처리 ===
모든 편집 작업이 비동기적으로 처리되어 대규모 작업 시에도 서버 TPS가 유지된다. 수백만 블록을 한 번에 편집해도 다른 플레이어들의 게임플레이에 영향을 주지 않는다.

=== 마스크와 패턴 ===
복잡한 편집을 위한 고급 마스크 시스템:
* 블록 타입 마스크
* 바이옴 마스크
* 각도 마스크
* 노이즈 마스크

== 명령어 ==
{| class="wikitable"
! 명령어 !! 설명 !! 권한
|-
| /b <브러시명> || 브러시 선택 || favs.brush.*
|-
| /b <크기> || 브러시 크기 설정 || favs.brush.*
|-
| /v <블록> || 브러시 재료 설정 || favs.brush.*
|-
| /vr <블록> || 교체할 블록 설정 || favs.brush.*
|-
| /u [횟수] || 실행 취소 || favs.undo
|-
| /d || 기본 브러시로 초기화 || favs.default
|-
| /p <재료> || 수행자 리스트 설정 || favs.performer
|}

== 브러시 설정 ==
<pre>
# 브러시 사용 예시
/b ball  # Ball 브러시 선택
/b 5  # 브러시 크기 5로 설정
/v stone  # 재료를 돌로 설정
/b e melt  # Erosion 브러시의 melt 모드 선택

# 고급 설정
/b over d3  # Overlay 브러시, 깊이 3
/b blob  # Blob 브러시 (불규칙한 형태)
/b drain  # 액체 제거 브러시
</pre>

== 성능 최적화 ==
=== 청크 처리 ===
* 편집된 청크는 자동으로 큐에 추가되어 순차적으로 처리
* 대기열 크기와 처리 속도 조절 가능
* 메모리 사용량 실시간 모니터링

=== 설정 파일 ===
<pre>
# config.yml 성능 관련 설정
async:
  threads: 2  # 비동기 스레드 수
  queue:
    max-wait-ms: 1000  # 최대 대기 시간
    parallel-threads: 1  # 병렬 처리 스레드
    
limits:
  max-brush-radius: 100  # 최대 브러시 크기
  max-history-size: 15  # 실행 취소 기록 수
</pre>

== 고급 기능 ==
=== 스텐실 ===
3D 모델을 불러와서 브러시로 사용할 수 있다:
* <nowiki>/vs load <이름></nowiki> - 스텐실 불러오기
* <nowiki>/vs save <이름></nowiki> - 현재 선택 영역을 스텐실로 저장
* 회전, 크기 조절 지원

=== 커스텀 브러시 ===
JavaScript를 사용하여 커스텀 브러시 제작 가능:
<pre>
// custom_brush.js 예시
function brush(editSession, position, pattern, size) {
    for (let x = -size; x <= size; x++) {
        for (let y = -size; y <= size; y++) {
            for (let z = -size; z <= size; z++) {
                if (Math.sqrt(x*x + y*y + z*z) <= size) {
                    editSession.setBlock(
                        position.add(x, y, z), 
                        pattern
                    );
                }
            }
        }
    }
}
</pre>

== 활용 팁 ==
* '''지형 생성''': Erosion과 Blend 브러시를 조합하여 자연스러운 지형 제작
* '''구조물 복사''': Stencil 기능으로 건축물을 저장하고 반복 사용
* '''바이옴 편집''': Biome 브러시로 대규모 바이옴 변경
* '''월드 페인팅''': Overlay와 Splatter 브러시로 자연스러운 텍스처 적용

== 주의사항 ==
* 대규모 편집 시 백업 필수
* 브러시 크기가 클수록 서버 자원 사용량 증가
* 히스토리 기능은 메모리를 많이 사용하므로 적절히 제한 필요

== 호환성 ==
* [[마인크래프트]] 1.13 - 1.21
* [[FastAsyncWorldEdit]] 필수
* [[WorldGuard]] 연동 지원 (지역 보호)

[[분류:마인크래프트/플러그인]]