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 채팅 지원 |
설치
주요 명령어
텔레포트 명령어
| 명령어 | 설명 | 권한 |
|---|---|---|
| /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>