ChunkyMap 문서 원본 보기

'''ChunkyMap'''은 [[마인크래프트]] 서버의 월드를 사전 생성하고 렌더링하는 플러그인이다. [[Chunky(마인크래프트)|Chunky]]와 함께 사용하여 고품질의 월드 맵을 생성할 수 있으며, 서버 성능 최적화에도 도움을 준다.

== 주요 기능 ==
=== 월드 사전 생성 ===
* 지정된 영역의 청크를 미리 생성
* 다양한 생성 패턴 지원 (원형, 사각형, 다각형)
* 일시정지 및 재개 기능
* 진행률 실시간 확인

=== 맵 렌더링 ===
* 2D 평면 맵 생성
* 아이소메트릭 3D 뷰 지원
* 고해상도 이미지 출력
* 웹 맵 타일 생성

== 명령어 ==
{| class="wikitable"
! 명령어 !! 설명 !! 권한
|-
| /chunky start || 청크 생성 시작 || chunky.command.start
|-
| /chunky pause || 생성 일시정지 || chunky.command.pause
|-
| /chunky continue || 생성 재개 || chunky.command.continue
|-
| /chunky cancel || 생성 취소 || chunky.command.cancel
|-
| /chunky world <월드명> || 대상 월드 설정 || chunky.command.world
|-
| /chunky radius <반경> || 생성 반경 설정 || chunky.command.radius
|-
| /chunky center <x> <z> || 중심점 설정 || chunky.command.center
|-
| /chunky pattern <패턴> || 생성 패턴 설정 || chunky.command.pattern
|-
| /chunky progress || 진행 상황 확인 || chunky.command.progress
|}

== 설정 ==
<pre>
# config.yml 주요 설정
generation:
  threads: 2  # 생성 스레드 수
  chunk-per-second: 100  # 초당 생성 청크 수
  lighting-mode: FAST  # 조명 계산 모드
  
world-settings:
  default:
    radius: 5000  # 기본 생성 반경
    spawn-radius: 500  # 스폰 주변 우선 생성
    
rendering:
  tile-size: 512  # 타일 크기
  zoom-levels: 5  # 줌 레벨 수
  render-caves: false  # 동굴 렌더링
  
performance:
  max-loaded-chunks: 500  # 최대 로드 청크
  unload-delay: 5000  # 언로드 지연 (ms)
  save-interval: 300  # 저장 간격 (초)
</pre>

== 생성 패턴 ==
=== 사용 가능한 패턴 ===
<pre>
# 패턴 종류와 특징
- concentric: 중심에서 바깥으로 (기본값)
- spiral: 나선형
- linear: 선형 (좌에서 우로)
- random: 무작위

# 커스텀 패턴 설정
/chunky pattern custom
/chunky shape circle  # 원형
/chunky shape square  # 사각형
/chunky shape polygon <점들>  # 다각형
</pre>

== 맵 렌더링 설정 ==
<pre>
# render.yml
maps:
  overworld:
    enabled: true
    perspective: TOP_DOWN  # 또는 ISOMETRIC
    lighting: true
    shadows: true
    water-transparency: true
    
  nether:
    enabled: true
    height-limit: 127  # 네더 천장 제거
    
  end:
    enabled: true
    void-color: "#000000"
    
output:
  format: PNG  # PNG, JPEG, WEBP
  quality: 90  # JPEG/WEBP 품질
  path: "maps/"
</pre>

== 웹맵 연동 ==
=== 타일 생성 ===
<pre>
web-map:
  enabled: true
  tile-format: PNG
  zoom:
    min: 0
    max: 7
  update-interval: 3600  # 1시간마다 업데이트
  
  layers:
    - name: "day"
      lighting: DAY
    - name: "night"
      lighting: NIGHT
    - name: "caves"
      slice-y: 11
</pre>

== 진행 상황 모니터링 ==
<pre>
# 진행률 표시 설정
progress:
  show-eta: true  # 예상 완료 시간
  update-frequency: 5  # 업데이트 주기 (초)
  broadcast: true  # 전체 공지
  
  messages:
    start: "&a청크 생성을 시작합니다. 총 %total% 청크"
    update: "&e진행률: %percent%% (%done%/%total%) - ETA: %eta%"
    complete: "&a청크 생성 완료! 소요 시간: %time%"
</pre>

== 성능 최적화 팁 ==
* '''사전 생성 시간''': 플레이어가 적은 새벽 시간 활용
* '''단계별 생성''': 스폰 주변부터 점진적으로 확장
* '''리소스 관리''': CPU와 메모리 사용량 모니터링
* '''백업''': 대규모 생성 전 월드 백업 필수

== 고급 기능 ==
=== 선택적 생성 ===
<pre>
# 특정 조건의 청크만 생성
filters:
  biomes:
    include:
      - OCEAN
      - DEEP_OCEAN
    exclude:
      - MUSHROOM_FIELDS
      
  structures:
    generate-only:
      - VILLAGE
      - STRONGHOLD
</pre>

=== 통계 및 분석 ===
<pre>
statistics:
  enabled: true
  track:
    - chunks-per-region
    - generation-time
    - biome-distribution
    - structure-count
    
  export:
    format: JSON
    path: "stats/chunky-stats.json"
</pre>

== 다른 플러그인과의 연동 ==
* '''[[Dynmap]]''': 생성된 청크 자동 렌더링
* '''[[BlueMap]]''': 3D 맵 업데이트
* '''[[WorldBorder]]''': 경계 내 청크만 생성

== 문제 해결 ==
* '''메모리 부족''': 청크 생성 속도 감소, 스레드 수 조정
* '''서버 렉''': max-loaded-chunks 값 감소
* '''생성 중단''': <nowiki>/chunky continue</nowiki>로 재개 가능

[[분류:마인크래프트]]