====== 마인크래프트 에센셜 플러그인 설치와 설정 (EssentialsX, 26.2) ======
마인크래프트 에센셜 플러그인(EssentialsX)을 26.2 버전에 맞춰 정리했습니다. 받을 파일 고르기, 설치, 설치만 하면 ''/home'' 이 "권한이 없습니다"로 막히는 이유와 푸는 방법, 자주 쓰는 명령어, ''config.yml'' 에서 자주 바꾸는 설정, 탭 한 칸으로 설정이 사라지는 일까지 다룹니다. Paper 26.2 서버에서 직접 돌려 보고 확인한 내용입니다.
{{youtube>VrWERzYYArU?large}}
^ 항목 ^ 내용 ^
| 썸네일 | {{유튜브:수다:강좌:04-thumb.jpg?320|마인크래프트 에센셜 플러그인 설치와 설정 - 권한이 없다고 나오는 이유까지 (26.2)}} |
| 영상 | [[https://youtu.be/VrWERzYYArU|마인크래프트 에센셜 플러그인 설치와 설정 - 권한이 없다고 나오는 이유까지 (26.2)]] |
| 채널 | [[유튜브:수다:start|수다 SUDA]] |
| 공개일 | 2026-11-17 |
| 길이 | 약 11분 |
| 게임 버전 | Paper 26.2 빌드 135, EssentialsX 2.22.1-dev |
===== 받을 파일 =====
* 받는 곳 : [[https://essentialsx.net/downloads.html]]
* ''EssentialsX'' (본체), ''EssentialsXChat'' (채팅), ''EssentialsXSpawn'' (스폰) 세 개만 받습니다. 나머지(디스코드 연동 같은 기능)는 필요할 때 넣습니다.
* 서버가 26.1.2 면 정식판(2.22.0), 26.2 면 개발 빌드를 받습니다.
* 정식판을 26.2 서버에 넣으면 켜지기는 하지만 ''You are running an unsupported server version!'' 경고가 나오고, 처음 들어온 사람에게 환영 글과 기본 키트가 나오지 않았습니다. 개발 빌드는 경고가 없고 둘 다 나옵니다.
* 개발 빌드는 시험이 덜 된 판입니다. 넣기 전에 서버 폴더를 백업합니다.
{{ 유튜브:수다:강좌:04-0057.jpg?640 |내려받는 파일 아홉 개 가운데 EssentialsX, EssentialsXChat, EssentialsXSpawn 세 개만 받으면 된다는 화면}}
{{ 유튜브:수다:강좌:04-0077.jpg?640 |26.2 서버에 정식판 2.22.0 을 넣었을 때 나오는 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). 등급마다 쓸 수 있는 명령어를 나누려면 이쪽입니다. 다음 편에서 다룹니다.
{{ 유튜브:수다:강좌:04-0003.jpg?640 |에센셜을 설치한 뒤 /home 을 치자 권한이 없다고 나오는 게임 화면}}
{{ 유튜브:수다:강좌:04-0199.jpg?640 |config.yml 358번째 줄 use-bukkit-permissions 를 true 에서 false 로 바꾸는 화면}}
{{ 유튜브:수다:강좌:04-0222.jpg?640 |서버를 껐다 켠 뒤 player-commands 권한이 모두에게 주어졌다고 나오는 서버 기록}}
===== 접속자 명령어 =====
^ 명령어 ^ 하는 일 ^
| ''/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'' 값은 권한 플러그인으로 권한을 줘야 적용됩니다.
* 한글 별명은 기본 설정에서 "오류: 닉네임은 반드시 영어/숫자의 조합이어야 합니다." 가 나옵니다. 아래 설정에서 풉니다.
{{ 유튜브:수다:강좌:04-0268.jpg?640 |/sethome 을 치자 이곳을 집으로 설정했습니다 라고 나오는 화면}}
{{ 유튜브:수다:강좌:04-0321.jpg?640 |상대가 /tpaccept 를 쳐서 요청한 사람이 상대 옆으로 이동한 화면}}
===== 관리자 명령어 =====
/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'' 처럼 한 줄을 더하고 서버를 껐다 켭니다.
{{ 유튜브:수다:강좌:04-0378.jpg?640 |kits.yml 에 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'' | 글을 영어로 |
{{ 유튜브:수다:강좌:04-0492.jpg?640 |config.yml 120번째 줄 teleport-delay 를 0 에서 3 으로 바꾸는 화면}}
===== 탭 하나로 설정이 사라집니다 =====
* ''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'' 을 복사해 둡니다.
{{ 유튜브:수다:강좌:04-0593.jpg?640 |Essentials 폴더에 config.yml 이 없고 config.yml.broken 파일만 남은 화면}}
===== 관련 쇼츠 =====
이 편에서 한 가지를 떼어 낸 짧은 영상은 공개되면 여기에 더합니다. 전체 목록은 [[유튜브:수다:쇼츠|쇼츠 목록]]에 있습니다.
===== 관련 문서 =====
* 이전 편 : [[유튜브:수다:강좌:03-서버만들기|마인크래프트 서버 만들기 (Paper 26.2)]]
* 특별 편 : [[유튜브:수다:특별:01-huskhomes|에센셜 대신 HuskHomes - 집, 워프, tpa 플러그인 (26.2)]]
* [[유튜브:수다:강좌:02-기본명령어|마인크래프트 기본 명령어 총정리 (26.2)]]
* [[유튜브:수다:start|수다 SUDA 채널 영상 목록]]
* 영상 : [[https://youtu.be/VrWERzYYArU|유튜브에서 보기]]
* 커뮤니티 : [[https://gameboy.kr/board/suda/11355/|게임보이 수다 게시판의 이 영상 글]]
* 구독 : [[https://www.youtube.com/@sudacraft?sub_confirmation=1|수다 SUDA 채널 구독하기]]
설명 목소리는 합성 음성입니다.
{{htmlmetatags>metatag-description=(마인크래프트 에센셜 플러그인(EssentialsX)을 Paper 26.2 서버에 설치하고 설정하는 방법. 받을 파일, 설치, 권한이 없다고 나올 때 use-bukkit-permissions 로 푸는 법, 집, 스폰, 순간이동 요청, 워프, 키트, 돈 명령어와 config.yml 설정을 정리했습니다.)
metatag-keywords=(에센셜 플러그인, 마크 에센셜, 마인크래프트 에센셜, EssentialsX, 에센셜 설정, 에센셜 권한, use-bukkit-permissions, 마인크래프트 플러그인, Paper 서버, 마인크래프트 26.2, 수다 SUDA)
metatag-og:type=(article)
metatag-og:site_name=(수다위키)
metatag-og:locale=(ko_KR)
metatag-og:title=(마인크래프트 에센셜 플러그인 설치와 설정 - 권한이 없다고 나오는 이유까지 (26.2))
metatag-og:description=(마인크래프트 에센셜 플러그인(EssentialsX)을 Paper 26.2 서버에 설치하고 설정하는 방법. 받을 파일, 설치, 권한이 없다고 나올 때 use-bukkit-permissions 로 푸는 법, 집, 스폰, 순간이동 요청, 워프, 키트, 돈 명령어와 config.yml 설정을 정리했습니다.)
metatag-media-og:image=(유튜브:수다:강좌:04-thumb.jpg)
metatag-og:image:width=(1280)
metatag-og:image:height=(720)
metatag-og:image:alt=(마인크래프트 에센셜 플러그인 설치와 설정 - 권한이 없다고 나오는 이유까지 (26.2))
metatag-twitter:card=(summary_large_image)
metatag-twitter:site=(@sudapeople)}}