====== 마인크래프트 에센셜 플러그인 설치와 설정 (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)}}