WorldGuard 문서 원본 보기

'''WorldGuard'''는 [[마인크래프트]] 서버에서 지역을 보호하고 다양한 게임플레이 기능을 조정할 수 있게 해주는 플러그인이다. sk89q가 개발했으며, 현재는 EngineHub 팀이 유지보수하고 있다. Bukkit보다 오래된 역사를 가진 프로젝트 중 하나로, 그리핑 방지와 서버 관리에 필수적인 도구로 자리잡았다.

== 주요 기능 ==
=== 지역 보호 ===
* 특정 영역을 선택하여 보호 구역 설정
* 구역별로 다른 권한과 규칙 적용
* 플레이어별, 그룹별 접근 권한 관리
* 중첩된 구역 생성 및 우선순위 설정

=== 게임플레이 제어 ===
* TNT, 크리퍼, 엔더맨 등의 피해 방지
* 화재 확산, 용암/물 흐름 제어
* PvP 활성화/비활성화 구역 설정
* 몹 스폰 제어

=== 블랙리스트 ===
* 특정 아이템이나 블록 사용 금지
* 명령어 사용 제한
* 구역별로 다른 블랙리스트 적용

== 설치 ==
WorldGuard는 [[WorldEdit]]을 필수로 요구한다.

# Paper 또는 Spigot 서버 준비
# WorldEdit 플러그인 설치
# [https://dev.bukkit.org/projects/worldguard WorldGuard] 다운로드
# 두 플러그인을 plugins 폴더에 넣고 서버 재시작

== 기본 명령어 ==
=== 구역 관리 ===
{| class="wikitable"
! 명령어 !! 설명
|-
| /rg define <이름> [소유자] || 새 구역 생성
|-
| /rg redefine <이름> || 구역 경계 재설정
|-
| /rg remove <이름> || 구역 삭제
|-
| /rg list [페이지] || 구역 목록 표시
|-
| /rg info <이름> || 구역 정보 확인
|}

=== 플래그 설정 ===
{| class="wikitable"
! 명령어 !! 설명
|-
| /rg flag <구역> <플래그> <값> || 플래그 설정
|-
| /rg flag <구역> <플래그> || 플래그 제거
|-
| /rg flags <구역> || 모든 플래그 확인
|}

=== 멤버 관리 ===
{| class="wikitable"
! 명령어 !! 설명
|-
| /rg addowner <구역> <플레이어> || 소유자 추가
|-
| /rg removeowner <구역> <플레이어> || 소유자 제거
|-
| /rg addmember <구역> <플레이어> || 멤버 추가
|-
| /rg removemember <구역> <플레이어> || 멤버 제거
|}

== 주요 플래그 ==
WorldGuard는 다양한 플래그를 통해 구역을 세밀하게 제어할 수 있다:

=== 기본 플래그 ===
* '''build''': 블록 설치/파괴 허용
* '''pvp''': PvP 허용
* '''mob-spawning''': 몹 스폰 허용
* '''use''': 문, 레버 등 사용 허용
* '''interact''': 상자, 화로 등 상호작용 허용

=== 환경 플래그 ===
* '''tnt''': TNT 폭발 허용
* '''creeper-explosion''': 크리퍼 폭발 허용
* '''fire-spread''': 불 번짐 허용
* '''lava-flow''': 용암 흐름 허용
* '''water-flow''': 물 흐름 허용

=== 게임플레이 플래그 ===
* '''entry''': 구역 진입 허용
* '''exit''': 구역 퇴장 허용
* '''greeting''': 진입 시 메시지
* '''farewell''': 퇴장 시 메시지
* '''heal-amount''': 자동 회복량
* '''feed-amount''': 자동 포만감 회복

== 권한 노드 ==
* '''worldguard.*''': 모든 WorldGuard 권한
* '''worldguard.region.*''': 모든 구역 관리 권한
* '''worldguard.region.define.*''': 구역 생성
* '''worldguard.region.remove.*''': 구역 삭제
* '''worldguard.region.flag.*''': 플래그 설정
* '''worldguard.region.bypass.<월드>''': 구역 보호 무시

== 설정 파일 ==
config.yml에서 전역 설정을 관리할 수 있다:

<pre>
# 기본 보호 설정
protection:
  # 블록 관련
  block-tnt: true
  block-creeper-explosions: true
  block-wither-explosions: true
  
  # 환경 관련
  disable-fire-spread: true
  disable-lava-fire-spread: true
  disable-ice-melting: false
  
  # 게임플레이
  block-potions: []
  block-creature-spawn: []
</pre>

== 버전 정보 ==
최신 버전은 7.0.14로, Minecraft 1.21.5-1.21.7을 지원한다. 이전 버전의 마인크래프트를 사용하는 경우 호환되는 버전을 확인해야 한다.

== 확장 플러그인 ==
* '''WorldGuard Extra Flags''': 추가 플래그 제공
* '''WorldGuardRegionProtect''': 관리자 구역 추가 보호
* '''WorldEditRegions''': WorldEdit 선택을 구역으로 변환

== 같이 보기 ==
* [[WorldEdit]]
* [[마인크래프트/플러그인]]

== 외부 링크 ==
* [https://worldguard.enginehub.org/ 공식 문서]
* [https://github.com/EngineHub/WorldGuard GitHub 저장소]
* [https://discord.gg/enginehub 공식 Discord]
* [https://dev.bukkit.org/projects/worldguard Bukkit 페이지]

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