WorldBorder 문서 원본 보기

'''WorldBorder'''는 마인크래프트 서버에서 월드의 경계를 설정하고 관리하는 플러그인이다. 바닐라 월드보더보다 더 많은 기능과 세밀한 제어를 제공한다.

== 주요 기능 ==
=== 경계 설정 ===
* 원형 또는 사각형 경계 설정 가능
* 월드별로 다른 크기의 경계 설정
* 중심점 커스터마이징

=== 동적 경계 ===
시간에 따라 경계가 확대되거나 축소되도록 설정할 수 있다. 배틀로얄 게임모드나 이벤트에 활용 가능하다.

=== 경계 효과 ===
* 경계 근처 플레이어에게 경고 메시지 표시
* 넉백 효과로 플레이어를 안전 지역으로 이동
* 경계 외부 대미지 설정

== 명령어 ==
{| class="wikitable"
! 명령어 !! 설명 !! 권한
|-
| /wb set <반경> || 현재 위치를 중심으로 경계 설정 || worldborder.set
|-
| /wb set <반경> spawn || 스폰을 중심으로 경계 설정 || worldborder.set
|-
| /wb <월드> set <반경> <x> <z> || 특정 좌표를 중심으로 경계 설정 || worldborder.set
|-
| /wb shape <square<nowiki>|</nowiki>round> || 경계 모양 설정 || worldborder.shape
|-
| /wb fill [빈도] || 경계 내 청크 사전 생성 || worldborder.fill
|-
| /wb trim [빈도] || 경계 외부 청크 삭제 || worldborder.trim
|-
| /wb reload || 설정 리로드 || worldborder.reload
|}

== 설정 ==
<pre>
# config.yml 주요 설정
worlds:
  world:
    x: 0
    z: 0
    radiusX: 3000
    radiusZ: 3000
    wrapping: false
    shape: round
    
message:
  frequency: 5  # 경고 메시지 표시 주기 (초)
  
knockback:
  distance: 3.0  # 넉백 거리
  
damage:
  amount: 1  # 경계 외부 대미지
  delay: 5  # 대미지 간격 (초)
</pre>

== 청크 관리 기능 ==
=== Fill 명령어 ===
<nowiki>/wb fill</nowiki> 명령어는 경계 내의 모든 청크를 사전에 생성한다. 이는 서버 성능 향상에 도움이 된다:
* 플레이어가 새로운 지역을 탐험할 때 렉 방지
* 다이나맵 등 지도 플러그인과 연동 시 유용
* 진행률 표시 및 일시정지/재개 기능 지원

=== Trim 명령어 ===
<nowiki>/wb trim</nowiki> 명령어는 경계 외부의 불필요한 청크를 삭제한다:
* 월드 파일 크기 감소
* 백업 시간 단축
* 삭제 전 확인 절차 필수<ref>데이터 손실을 방지하기 위해 반드시 백업 후 실행 권장</ref>

== 활용 예시 ==
* '''서버 자원 관리''': 월드 크기를 제한하여 서버 용량 절약
* '''게임 모드''': 배틀로얄, 하드코어 서바이벌 등에 활용
* '''이벤트''': 점진적으로 축소되는 경계로 긴장감 조성
* '''신규 플레이어 보호''': 초기 지역을 제한하여 커뮤니티 형성 유도

== 다른 플러그인과의 연동 ==
* [[Dynmap]]: 지도에 월드 경계 표시
* [[BlueMap]]: 3D 지도에 경계 렌더링
* ChunkyBorder: 청크 생성 최적화

== 주의사항 ==
* 경계 설정 후 기존 플레이어가 경계 밖에 있을 수 있으므로 사전 공지 필요
* Trim 명령 사용 시 반드시 백업 실행
* Fill 작업은 서버 리소스를 많이 사용하므로 플레이어가 적은 시간에 실행 권장

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