EssentialsX 문서 원본 보기

'''EssentialsX'''는 [[마인크래프트]] 서버를 위한 필수 플러그인 모음으로, 130개 이상의 명령어와 수많은 기능을 제공한다. 원래 Essentials 2 플러그인의 계승자로, 최신 마인크래프트 버전을 지원하며 성능 향상과 버그 수정, 새로운 기능들이 추가되었다. 8년 이상 커뮤니티에 의해 오픈소스로 개발되고 있으며, 서버 규모에 관계없이 가장 포괄적인 기능 세트를 제공한다.

== 특징 ==
EssentialsX는 서버 운영에 필요한 거의 모든 기능을 하나의 플러그인으로 제공한다:

* '''텔레포트 시스템''': 홈, 워프, 스폰, tpa/tphere 등
* '''관리 도구''': 킥, 밴, 뮤트, 갓모드, 플라이 등
* '''경제 시스템''': 내장 경제 시스템과 밸런스 관리
* '''채팅 기능''': 닉네임, 컬러 채팅, 접두사/접미사
* '''키트 시스템''': 인첸트, 커스텀 아이템 지원
* '''표지판 기능''': 상점, 워프, 거래 등 다양한 표지판
* '''메일 시스템''': 오프라인 플레이어에게 메시지 전송
* '''백업/복원''': 월드 백업 기능

== 모듈 ==
EssentialsX는 핵심 플러그인과 추가 모듈로 구성된다:

{| class="wikitable"
! 모듈 !! 설명
|-
| EssentialsX || 핵심 플러그인 (필수)
|-
| EssentialsX Chat || 채팅 포맷팅, 로컬 채팅
|-
| EssentialsX Spawn || 스폰 관리, 첫 접속 스폰
|-
| EssentialsX Protect || 월드 보호, 폭발 방지
|-
| EssentialsX AntiBuild || 건축 권한 관리
|-
| EssentialsX Discord || Discord 통합
|-
| EssentialsX Discord Link || Discord 계정 연동
|-
| EssentialsX GeoIP || 국가별 IP 확인
|-
| EssentialsX XMPP || XMPP 채팅 지원
|}

== 설치 ==
# [[LuckPerms]] 권한 플러그인 설치 (권장)
# [[Vault]] 설치 (접두사/접미사 지원)
# [https://essentialsx.net/downloads.html 공식 웹사이트]에서 최신 버전 다운로드
# 필요한 모듈을 plugins 폴더에 넣기
# 서버 재시작

== 주요 명령어 ==
=== 텔레포트 명령어 ===
{| class="wikitable"
! 명령어 !! 설명 !! 권한
|-
| /tp [플레이어] || 플레이어에게 텔레포트 || essentials.tp
|-
| /tpa <플레이어> || 텔레포트 요청 || essentials.tpa
|-
| /tphere <플레이어> || 플레이어를 자신에게 텔레포트 || essentials.tphere
|-
| /home [이름] || 홈으로 이동 || essentials.home
|-
| /sethome [이름] || 홈 설정 || essentials.sethome
|-
| /warp [이름] || 워프로 이동 || essentials.warp
|-
| /spawn || 스폰으로 이동 || essentials.spawn
|}

=== 관리자 명령어 ===
{| class="wikitable"
! 명령어 !! 설명 !! 권한
|-
| /god [플레이어] || 무적 모드 || essentials.god
|-
| /fly [플레이어] || 비행 모드 || essentials.fly
|-
| /gamemode <모드> || 게임모드 변경 || essentials.gamemode
|-
| /heal [플레이어] || 체력 회복 || essentials.heal
|-
| /feed [플레이어] || 배고픔 회복 || essentials.feed
|-
| /vanish || 투명화 || essentials.vanish
|}

=== 경제 명령어 ===
{| class="wikitable"
! 명령어 !! 설명 !! 권한
|-
| /balance [플레이어] || 잔액 확인 || essentials.balance
|-
| /pay <플레이어> <금액> || 송금 || essentials.pay
|-
| /eco give <플레이어> <금액> || 돈 지급 || essentials.eco.give
|-
| /eco take <플레이어> <금액> || 돈 차감 || essentials.eco.take
|-
| /eco set <플레이어> <금액> || 잔액 설정 || essentials.eco.set
|}

=== 유틸리티 명령어 ===
{| class="wikitable"
! 명령어 !! 설명 !! 권한
|-
| /kit [이름] || 키트 받기 || essentials.kit
|-
| /mail send <플레이어> <메시지> || 메일 보내기 || essentials.mail.send
|-
| /nick <닉네임> || 닉네임 변경 || essentials.nick
|-
| /repair [all] || 아이템 수리 || essentials.repair
|-
| /workbench || 작업대 열기 || essentials.workbench
|}

== 설정 ==
=== config.yml 주요 설정 ===
<pre>
# 채팅 형식
chat:
  format: '<{DISPLAYNAME}> {MESSAGE}'
  group-formats:
    default: '{DISPLAYNAME}: {MESSAGE}'
    admin: '&c[Admin]&r {DISPLAYNAME}: {MESSAGE}'

# 스폰 설정
spawn:
  spawn-on-join: false
  respawn-at-home: true

# 경제 설정
economy:
  starting-balance: 1000.0
  max-money: 10000000
  min-money: -10000

# 홈 제한
sethome-multiple:
  default: 3
  vip: 5
  staff: 10

# 텔레포트 설정
teleport-delay: 3
teleport-cooldown: 0
teleport-safety: true
</pre>

=== 키트 설정 (kits.yml) ===
<pre>
kits:
  starter:
    delay: 86400
    items:
      - stone_sword 1
      - stone_pickaxe 1
      - stone_axe 1
      - bread 32
      - oak_log 16
  
  vip:
    delay: 604800
    items:
      - diamond_sword 1 sharpness:2
      - diamond_pickaxe 1 efficiency:3 unbreaking:2
      - golden_apple 5
</pre>

== 표지판 ==
EssentialsX는 다양한 기능의 표지판을 지원한다:

* '''[Buy]''': 아이템 구매
* '''[Sell]''': 아이템 판매
* '''[Trade]''': 아이템 거래
* '''[Free]''': 무료 아이템
* '''[Disposal]''': 쓰레기통
* '''[Warp]''': 워프 표지판
* '''[Kit]''': 키트 표지판
* '''[Balance]''': 잔액 확인

== MiniMessage 지원 ==
EssentialsX 2.21.0부터 MiniMessage를 통한 리치 텍스트를 지원한다:

<pre>
# 클릭 가능한 링크
welcome-message: '<click:open_url:https://example.com>웹사이트 방문하기</click>'

# 호버 텍스트
hover-example: '<hover:show_text:"추가 정보">마우스를 올려보세요</hover>'

# RGB 색상
rgb-text: '<gradient:#ff0000:#0000ff>그라디언트 텍스트</gradient>'
</pre>

== 호환성 ==
* '''권장 서버''': Paper (최신 버전)
* '''지원 버전''': 1.8.8 - 1.21.8
* '''지원 중단 예정''': Spigot (Paper 사용 권장)
* '''지원하지 않음''': Mohist, Cauldron, Forge 하이브리드 서버

== API ==
개발자를 위한 API 제공:

<pre>
<dependency>
    <groupId>net.essentialsx</groupId>
    <artifactId>EssentialsX</artifactId>
    <version>2.21.1</version>
    <scope>provided</scope>
</dependency>
</pre>

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

== 외부 링크 ==
* [https://essentialsx.net/ 공식 웹사이트]
* [https://wiki.essentialsx.net/ 공식 위키]
* [https://github.com/EssentialsX/Essentials GitHub 저장소]
* [https://discord.gg/casfFyh Discord 서버]

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