유튜브:수다:강좌:04-에센셜

마인크래프트 에센셜 플러그인 설치와 설정 (EssentialsX, 26.2)

마인크래프트 에센셜 플러그인(EssentialsX)을 26.2 버전에 맞춰 정리했습니다. 받을 파일 고르기, 설치, 설치만 하면 /home 이 “권한이 없습니다”로 막히는 이유와 푸는 방법, 자주 쓰는 명령어, config.yml 에서 자주 바꾸는 설정, 탭 한 칸으로 설정이 사라지는 일까지 다룹니다. Paper 26.2 서버에서 직접 돌려 보고 확인한 내용입니다.

항목 내용
썸네일 마인크래프트 에센셜 플러그인 설치와 설정 - 권한이 없다고 나오는 이유까지 (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! 경고가 나오고, 처음 들어온 사람에게 환영 글과 기본 키트가 나오지 않았습니다. 개발 빌드는 경고가 없고 둘 다 나옵니다.
  • 개발 빌드는 시험이 덜 된 판입니다. 넣기 전에 서버 폴더를 백업합니다.

내려받는 파일 아홉 개 가운데 EssentialsX, EssentialsXChat, EssentialsXSpawn 세 개만 받으면 된다는 화면

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). 등급마다 쓸 수 있는 명령어를 나누려면 이쪽입니다. 다음 편에서 다룹니다.

에센셜을 설치한 뒤 /home 을 치자 권한이 없다고 나오는 게임 화면

config.yml 358번째 줄 use-bukkit-permissions 를 true 에서 false 로 바꾸는 화면

서버를 껐다 켠 뒤 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 값은 권한 플러그인으로 권한을 줘야 적용됩니다.
  • 한글 별명은 기본 설정에서 “오류: 닉네임은 반드시 영어/숫자의 조합이어야 합니다.” 가 나옵니다. 아래 설정에서 풉니다.

/sethome 을 치자 이곳을 집으로 설정했습니다 라고 나오는 화면

상대가 /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 처럼 한 줄을 더하고 서버를 껐다 켭니다.

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 글을 영어로

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 을 복사해 둡니다.

Essentials 폴더에 config.yml 이 없고 config.yml.broken 파일만 남은 화면

관련 쇼츠

이 편에서 한 가지를 떼어 낸 짧은 영상은 공개되면 여기에 더합니다. 전체 목록은 쇼츠 목록에 있습니다.

관련 문서

유튜브/수다/강좌/04-에센셜.txt · 마지막으로 수정됨: 저자 sudapeople