ChunkyBorder는 Chunky 프리젠레이터용 Minecraft 플러그인 애드온입니다. Chunky 선택 범위와 연동되는 최상급 월드 보더 생성 및 적용 기능을 제공하므로, 서버는 플레이 가능 영역을 제한하고, 경계 밖 텔레포트 시도를 다른 곳으로 보내거나 차단하고, 필요에 따라 플레이어 또는 맵에 경계를 표시할 수 있습니다.

🎯 목적

ChunkyBorder는 서버의 플레이 가능 영역을 미리 생성한 청크와 맞춰 유지하는 문제를 해결합니다. Chunky로 영역을 미리 생성한 뒤, 플레이어와 텔레포트가 미리 생성된 구역을 벗어나지 못하게 하는 설정 가능한 청크 인식 월드 보더가 필요할 때 유용하며, 가장자리를 가로지르는 텔레포트도 처리할 수 있습니다.

⚙️ 기능

Chunky 선택 범위에서 월드 보더 생성 (사각형, 원형 및 기타 Chunky 형태).
설정된 경계를 넘어 플레이어가 이동하지 못하도록 차단.
경계 밖에 착지하는 텔레포트를 다른 곳으로 보내거나 차단.
선택 사항인 클라이언트 측 월드 보더 렌더러(해당되는 경우 클라이언트 측 모드/리소스 필요).
선택 사항인 서버 측 파티클 시각화로 경계 가장자리 표시.
경계의 이음새를 넘어 플레이어를 텔레포트시키는 선택 사항인 border wrapping.
플레이어가 경계와 상호작용할 때 표시되는 경계 메시지, 효과, 사운드 사용자 지정 가능.
Dynmap, BlueMap, Pl3xMap, squaremap용 맵 마커 지원.
border wrapping 추가, 제거, 목록 표시, 불러오기, 전환 명령 제공.

🧩 대상

Chunky로 월드 청크를 미리 생성하고, 생성된 영역에 맞는 경계가 필요한 서버 소유자와 관리자.
Survival, SMP 또는 커스텀 맵 서버로, 기본 worldborder만 의존하지 않고 강제된 플레이 가능 한계를 원하는 경우.
웹 맵 플러그인(Dynmap/BlueMap/Pl3xMap/squaremap)을 사용하며 맵에 경계 시각화를 원하는 서버.

🏗️ 사용 예시

스폰 주변에 사각형 플레이 영역을 만들고, Chunky로 미리 생성한 뒤 ChunkyBorder를 추가하여 플레이어가 미리 생성된 구역을 벗어나지 못하게 함.
다른 월드의 기존 Chunky 경계를 불러와 다른 반경으로 다시 적용함.
border wrapping을 활성화하여 제한된 월드의 반대편 가장자리로 텔레포트할 수 있게 함.

⌨️ 명령어

명령어	설명	권한	접근
`chunky border add`	현재 Chunky 선택 범위에서 월드 보더를 생성합니다.	`chunky.command.border`	Admin
`chunky border remove`	현재 선택된 월드의 월드 보더를 제거합니다.	`chunky.command.border`	Admin
`chunky border wrap`	현재 선택된 월드의 border wrapping을 전환합니다.	`chunky.command.border`	Admin
`chunky border list`	저장된 모든 경계를 표시합니다.	`chunky.command.border`	Admin
`chunky border load`	현재 선택된 월드의 월드 보더를 선택 범위로 불러옵니다.	`chunky.command.border`	Admin
`chunky border bypass`	일시적으로 월드 보더를 우회합니다.	`chunky.command.border`	Admin

참고: ChunkyBorder는 Chunky의 선택 및 명령 세트를 사용합니다. 선택 범위를 준비할 때는 Chunky의 명령을 사용하세요(예: chunky radius, chunky shape, chunky world 등).

🔐 권한

권한	설명	기본값
`chunky.command.border`	ChunkyBorder의 경계 명령어 접근 권한을 부여합니다.	지정되지 않음
`chunkyborder.bypass.move`	경계 이동 검사 우회를 허용합니다.	지정되지 않음
`chunkyborder.bypass.place`	경계 블록 설치 검사를 우회할 수 있게 합니다.	지정되지 않음

⚙️ 설치

📥 설정

Minecraft 버전에 맞는 ChunkyBorder JAR을 받아 서버의 plugins/ 디렉터리에 넣습니다.
Chunky 플러그인을 설치합니다(ChunkyBorder는 애드온이며, 선택 범위를 정의하고 청크를 생성하려면 Chunky가 필요합니다).
서버를 재시작하고 콘솔을 확인하여 ChunkyBorder가 올바르게 로드되었는지 확인합니다.

📦 의존성

필요: Chunky (플러그인) — ChunkyBorder는 Chunky 선택 범위에서 경계를 생성합니다.
선택적 연동(맵 마커 / 시각화): Dynmap, BlueMap, Pl3xMap, squaremap.

⚙️ Java / 버전 참고

ChunkyBorder 릴리스는 서로 다른 Minecraft/Java 조합을 대상으로 한 다운로드를 제공합니다. 서버 런타임에 맞는 릴리스를 사용하세요. 공식 릴리스 패키징에는 오래된 Minecraft 범위와 최신 Minecraft 범위에 대한 서로 다른 빌드가 표시됩니다.

🧠 기술 메모

라이선스: GPL-3.0.
ChunkyBorder는 업스트림 저장소에서 플랫폼별 빌드로 배포되며, 주요 배포처는 Spigot 리소스와 프로젝트의 GitHub 저장소입니다.
확인된 테스트 Minecraft 버전은 1.14부터 1.21까지입니다(정확한 호환성과 빌드별 권장 Java 런타임은 프로젝트 릴리스를 참고하세요).
이 플러그인은 맵 플러그인과 연동해 경계 마커를 표시할 수 있지만, 기본적인 경계 적용에는 필요하지 않습니다.

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

Chunky로 청크를 미리 생성하고 그 생성된 영역에 맞는 경계가 필요하다면(텔레포트 처리와 선택적 맵 시각화 포함), ChunkyBorder는 선택 범위, 적용, 시각적 마커를 하나로 묶어 주는 간결한 Chunky 인식 경계 솔루션을 제공하며, Chunky 자체를 대체하지 않습니다.

ChunkyBorder 플러그인 서버