문서의 이전 판입니다!
목차
마인크래프트 에센셜 플러그인 설치와 설정 (EssentialsX, 26.2)
마인크래프트 에센셜 플러그인(EssentialsX)을 26.2 버전에 맞춰 정리했습니다. 받을 파일 고르기, 설치, 설치만 하면 /home 이 “권한이 없습니다”로 막히는 이유와 푸는 방법, 자주 쓰는 명령어, config.yml 에서 자주 바꾸는 설정, 탭 한 칸으로 설정이 사라지는 일까지 다룹니다. Paper 26.2 서버에서 직접 돌려 보고 확인한 내용입니다.
| 항목 | 내용 |
|---|---|
| 썸네일 | |
| 영상 | 마인크래프트 에센셜 플러그인 설치와 설정 - 권한이 없다고 나오는 이유까지 (26.2) |
| 채널 | 수다 SUDA |
| 공개일 | 2026-11-17 |
| 길이 | 약 11분 |
| 게임 버전 | Paper 26.2 빌드 135, EssentialsX 2.22.1-dev |
받을 파일
EssentialsX(본체),EssentialsXChat(채팅),EssentialsXSpawn(스폰) 세 개만 받습니다. 나머지(디스코드 연동 같은 기능)는 필요할 때 넣습니다.- 서버가 26.1.2 면 정식판(2.22.0), 26.2 면 개발 빌드를 받습니다.
- 정식판을 26.2 서버에 넣으면 켜지기는 하지만
You are running an unsupported server version!경고가 나오고, 처음 들어온 사람에게 환영 글과 기본 키트가 나오지 않았습니다. 개발 빌드는 경고가 없고 둘 다 나옵니다. - 개발 빌드는 시험이 덜 된 판입니다. 넣기 전에 서버 폴더를 백업합니다.
설치
서버 폴더 안의 plugins 폴더에 파일 세 개를 넣고 서버를 껐다 켭니다. 서버 창에서 확인합니다.
plugins ess version
plugins를 치면 Essentials, EssentialsChat, EssentialsSpawn 이 초록색으로 보입니다.- 처음 켤 때
plugins/Essentials폴더와 설정 파일config.yml이 생깁니다. - 글은 서버 컴퓨터의 언어를 따릅니다. 한국어 컴퓨터면 손대지 않아도 한글로 나옵니다.
권한이 없다고 나올 때
설치만 한 상태에서는 관리자(op)가 아니면 /home, /spawn, /help 까지 쳐 본 27개가 전부 “이 명령어를 사용할 수 있는 권한이 없습니다.” 로 막혔습니다. op 를 주면 전부 되지만, op 는 서버를 끄는 것까지 할 수 있어서 아무에게나 줄 수 없습니다.
방법 1 : 설정 파일. plugins/Essentials/config.yml 에서 이 줄을 찾아 바꿉니다 (기본값 true).
use-bukkit-permissions: false
- 저장한 뒤 서버를 껐다 켭니다.
ess reload로는 적용되지 않았습니다. - 켜질 때
Permissions listed in as player-commands will be given to all users.줄이 나오면 적용된 것입니다. - 바로 위
player-commands목록에 적힌 여든 개가 모든 사람에게 열립니다. 집, 스폰, 순간이동 요청, 워프, 키트, 귓속말, 돈 명령어는 누구나 쓰고, 회복, 비행, 스폰과 워프 만들기 같은 관리 명령어는 그대로 관리자만 됩니다.
방법 2 : 권한 플러그인(LuckPerms). 등급마다 쓸 수 있는 명령어를 나누려면 이쪽입니다. 다음 편에서 다룹니다.
접속자 명령어
| 명령어 | 하는 일 |
|---|---|
/spawn | 스폰으로 이동 (스폰은 관리자가 /setspawn 으로 정함) |
/sethome / /home / /delhome home | 집 저장, 집으로 이동, 집 지우기. 이름 없이 만든 집은 home |
/back | 순간이동하기 전 자리나 죽은 자리로 돌아가기 |
/tpa 이름 / /tpaccept / /tpdeny | 상대에게 가겠다고 요청, 수락, 거절. 답이 없으면 120초 뒤에 사라짐 |
/tpahere 이름 | 상대를 내 쪽으로 부르기 |
/warp / /warp 이름 | 워프 목록, 워프로 이동. 이름은 한글도 됨 |
/kit / /kit tools | 키트 목록, 기본 키트(돌 도구 네 개) 받기 |
/msg 이름 할말 / /r 할말 | 귓속말, 받은 귓속말에 바로 답하기 |
/nick 별명 | 별명. 앞에 물결표(~)가 붙음 |
/bal / /pay 이름 금액 / /baltop | 잔고, 돈 보내기, 잔고 순위 |
- 기본 설정에서 집은 한 사람에 한 개입니다. 두 번째를 만들면 “오류: 집은 1 개 까지만 가질 수 있습니다.” 가 나옵니다. 설정 파일의
sethome-multiple값은 권한 플러그인으로 권한을 줘야 적용됩니다. - 한글 별명은 기본 설정에서 “오류: 닉네임은 반드시 영어/숫자의 조합이어야 합니다.” 가 나옵니다. 아래 설정에서 풉니다.
관리자 명령어
/setspawn /setwarp 이름 /delwarp 이름 /tp 이름 /tphere 이름 /createkit 이름 기다리는시간(초) eco give 이름 금액 /heal /feed /fly /god /gmc /gms /broadcast 할말 /invsee 이름 ess reload ess version
키트
키트는 plugins/Essentials/kits.yml 에 적습니다. 이름, 기다리는 시간(초), 아이템과 개수 순서입니다. 저장하고 ess reload 를 치면 바로 받을 수 있습니다.
kits:
start:
delay: 86400
items:
- bread 16
- torch 32
- oakboat 1
/createkit 이름 3600을 치면 지금 가방에 든 것이 그대로 키트가 됩니다.- 새로 만든 키트는 관리자만 받을 수 있습니다. 모두에게 열려면
player-commands목록에- kits.start처럼 한 줄을 더하고 서버를 껐다 켭니다.
config.yml 에서 자주 바꾸는 설정
값을 고치고 저장한 뒤 ess reload 를 치면 서버를 끄지 않고 적용됩니다 (use-bukkit-permissions 만 예외).
| 설정 | 하는 일 |
|---|---|
teleport-delay: 3 | 순간이동 전에 기다리는 시간(초). 관리자는 기다리지 않음 |
teleport-cooldown: 10 | 다시 이동할 때까지 쉬는 시간(초) |
starting-balance: 1000 | 처음 주는 돈. 설정을 바꾼 뒤에 처음 들어온 사람부터 받음 |
currency-symbol: '원' | 돈 단위 |
currency-symbol-suffix: true | 단위를 뒤에 붙이기 |
newbies: 아래 announce-format, kit | 처음 온 사람 환영 글과 키트. kit 를 비우면 주지 않음 |
custom-join-message / custom-quit-message | 들어오고 나갈 때 나오는 글 |
spawn-on-join: true | 들어올 때마다 스폰에서 시작 |
respawn-at-home: true | 죽으면 집에서 다시 태어나기 |
allowed-nicks-regex: '^[a-zA-Z_0-9§가-힣]+$' | 한글 별명 허용 |
nickname-prefix: '' | 별명 앞 물결표 없애기 |
chat: 아래 format | 채팅 모양 |
locale: en | 글을 영어로 |
탭 하나로 설정이 사라집니다
config.yml에 탭이 한 칸 들어간 채로ess reload를 쳐도 평소처럼 리로드됐다고 나옵니다.- 그런데 폴더를 보면 설정 파일의 이름이
config.yml.broken.숫자로 바뀌어 있습니다. 서버 창에는The file plugins/Essentials/config.yml is broken, it has been renamed to …한 줄만 지나갑니다. - 서버를 다시 켜면 설정이 전부 기본값으로 돌아가고(돈 단위
$,use-bukkit-permissions: true) 권한도 다시 막힙니다. - 띄어쓰기는 스페이스만 쓰고, 고치기 전에
config.yml을 복사해 둡니다.
관련 쇼츠
이 편에서 한 가지를 떼어 낸 짧은 영상은 공개되면 여기에 더합니다. 전체 목록은 쇼츠 목록에 있습니다.
관련 문서
- 이전 편 : 마인크래프트 서버 만들기 (Paper 26.2)
- 영상 : 유튜브에서 보기
- 구독 : 수다 SUDA 채널 구독하기
설명 목소리는 합성 음성입니다.










