EssentialsX

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

특징

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

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

모듈

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

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

설치

1. LuckPerms 권한 플러그인 설치 (권장)
2. Vault 설치 (접두사/접미사 지원)
3. 공식 웹사이트에서 최신 버전 다운로드
4. 필요한 모듈을 plugins 폴더에 넣기
5. 서버 재시작

주요 명령어

텔레포트 명령어

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

관리자 명령어

명령어	설명	권한
/god [플레이어]	무적 모드	essentials.god
/fly [플레이어]	비행 모드	essentials.fly
/gamemode <모드>	게임모드 변경	essentials.gamemode
/heal [플레이어]	체력 회복	essentials.heal
/feed [플레이어]	배고픔 회복	essentials.feed
/vanish	투명화	essentials.vanish

경제 명령어

명령어	설명	권한
/balance [플레이어]	잔액 확인	essentials.balance
/pay <플레이어> <금액>	송금	essentials.pay
/eco give <플레이어> <금액>	돈 지급	essentials.eco.give
/eco take <플레이어> <금액>	돈 차감	essentials.eco.take
/eco set <플레이어> <금액>	잔액 설정	essentials.eco.set

유틸리티 명령어

명령어	설명	권한
/kit [이름]	키트 받기	essentials.kit
/mail send <플레이어> <메시지>	메일 보내기	essentials.mail.send
/nick <닉네임>	닉네임 변경	essentials.nick
/repair [all]	아이템 수리	essentials.repair
/workbench	작업대 열기	essentials.workbench

설정

config.yml 주요 설정

# 채팅 형식
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

키트 설정 (kits.yml)

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

표지판

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

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

MiniMessage 지원

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

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

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

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

호환성

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

API

개발자를 위한 API 제공:

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

같이 보기

• LuckPerms
• Vault
• 마인크래프트/플러그인

외부 링크

• 공식 웹사이트
• 공식 위키
• GitHub 저장소
• Discord 서버