ChunkyMap

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

주요 기능

월드 사전 생성

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

맵 렌더링

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

명령어

명령어	설명	권한
/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

설정

# 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  # 저장 간격 (초)

생성 패턴

사용 가능한 패턴

# 패턴 종류와 특징
- concentric: 중심에서 바깥으로 (기본값)
- spiral: 나선형
- linear: 선형 (좌에서 우로)
- random: 무작위

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

맵 렌더링 설정

# 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/"

웹맵 연동

타일 생성

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

진행 상황 모니터링

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

성능 최적화 팁

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

고급 기능

선택적 생성

# 특정 조건의 청크만 생성
filters:
  biomes:
    include:
      - OCEAN
      - DEEP_OCEAN
    exclude:
      - MUSHROOM_FIELDS
      
  structures:
    generate-only:
      - VILLAGE
      - STRONGHOLD

통계 및 분석

statistics:
  enabled: true
  track:
    - chunks-per-region
    - generation-time
    - biome-distribution
    - structure-count
    
  export:
    format: JSON
    path: "stats/chunky-stats.json"

다른 플러그인과의 연동

• Dynmap: 생성된 청크 자동 렌더링
• BlueMap: 3D 맵 업데이트
• WorldBorder: 경계 내 청크만 생성

문제 해결

• 메모리 부족: 청크 생성 속도 감소, 스레드 수 조정
• 서버 렉: max-loaded-chunks 값 감소
• 생성 중단: /chunky continue로 재개 가능