유튜브:수다:강좌:05-럭펌

문서의 이전 판입니다!


마인크래프트 럭펌(LuckPerms) 설정 방법 (그룹, 권한, 접두사, 웹 편집기, 26.2)

마인크래프트 권한 플러그인 럭펌(LuckPerms)을 설치부터 그룹, 권한, 접두사, 웹 편집기까지 정리했습니다. op 를 주지 않고 누구에게 어떤 명령어를 열어 줄지 나눠서 정하는 방법, op 와 럭펌이 어떻게 따로 움직이는지, 권한을 줬는데 안 될 때 이유를 찾는 법까지 다룹니다. Paper 26.2 서버에 LuckPerms 5.5.90 을 넣고 직접 쳐서 확인한 내용입니다.

항목 내용
썸네일 마인크래프트 럭펌(LuckPerms) 설정 방법 - 그룹, 권한, 접두사, 웹 편집기까지 (26.2)
영상 마인크래프트 럭펌(LuckPerms) 설정 방법 - 그룹, 권한, 접두사, 웹 편집기까지 (26.2)
채널 수다 SUDA
공개일 2026-11-19
길이 약 8분 40초
게임 버전 Paper 26.2 빌드 135, LuckPerms 5.5.90

명령어는 서버 창 기준입니다. 게임 안에서는 앞에 / 를 붙입니다.

설치

  • 받는 곳 (공식) : https://luckperms.net/download
  • Paper 나 Spigot 서버라면 Bukkit 이라고 적힌 것을 받습니다.
  • 받은 파일(LuckPerms-Bukkit-5.5.90.jar)을 서버 폴더 안의 plugins 폴더에 넣고 서버를 다시 켭니다. 서버를 처음 만드는 과정은 3편 서버 만들기에서 다뤘습니다.
  • 서버 기록에 [LuckPerms] Successfully enabled. 가 보이면 설치가 끝난 것입니다.
  • plugins/LuckPerms 폴더에 설정 파일 config.yml 과 저장 파일 luckperms-h2-v2.mv.db 가 생깁니다.
  • 서버 창에 lp info 를 치면 버전과 저장 방식(H2)이 나옵니다. 이 서버에서는 안내 글이 따로 설정하지 않아도 한글로 나왔습니다.

서버 기록에 LuckPerms v5.5.90 이 켜지고 Successfully enabled 가 나온 화면

권한, 그룹, 사람

  • 권한 : 명령어 하나를 여는 열쇠입니다. 이름은 점으로 이어진 영어 낱말입니다 (예 : minecraft.command.gamemode).
  • 그룹 : 그 열쇠를 여러 개 꿴 묶음입니다.
  • 사람 : 그룹에 넣으면 그 묶음을 통째로 받습니다.
  • 처음에는 default 그룹 하나만 있고, 서버에 들어온 사람은 모두 이 그룹에 들어갑니다.

그룹 만들기

lp creategroup vip
lp creategroup admin
lp listgroups
lp deletegroup 그룹
  • 이름에 대문자를 적어도 소문자로 바뀌어 만들어집니다 (VIP2 는 vip2).
  • default 그룹은 지울 수 없습니다 (“기본 그룹은 삭제할 수 없습니다.”).

권한 주기

lp group vip permission set minecraft.command.gamemode true
lp group vip permission set minecraft.command.give false
lp group vip permission unset minecraft.command.give
lp group vip permission info
lp group vip permission settemp minecraft.command.time true 1h
  • 순서는 lp group, 그룹 이름, permission set, 권한 이름, true 입니다.
  • 마인크래프트 기본 명령어의 권한 이름은 minecraft.command. 뒤에 명령어 이름을 붙인 것입니다 (minecraft.command.gamemode, minecraft.command.give, minecraft.command.time).
  • false 는 막기입니다. 막아 둔 권한은 다른 곳에서 true 를 물려받아도 열리지 않습니다.
  • 준 것이든 막은 것이든 지울 때는 unset 입니다.
  • 별표 : minecraft.command.* 는 기본 명령어 전부, * 하나는 서버의 모든 권한입니다. * 는 관리자 그룹에만 씁니다 (lp group admin permission set * true).
  • settemp 와 1h 를 적으면 한 시간 뒤에 사라집니다.

lp group vip permission set minecraft.command.gamemode true 를 치고 true 로 설정했다는 글이 나온 화면

사람을 그룹에 넣기

lp user 이름 parent add 그룹
lp user 이름 parent set 그룹
lp user 이름 parent remove 그룹
lp user 이름 info
lp group 그룹 listmembers
  • 넣자마자 적용됩니다. 다시 접속하지 않아도 됩니다.
  • 서버에 한 번도 들어오지 않은 사람은 이름으로 찾지 못합니다 (“사용자 …을(를) 찾을 수 없습니다.”).
  • parent add 는 그룹을 하나 더 얹고, parent set 은 원래 그룹을 지우고 그 그룹만 남깁니다. parent remove 로 다 빼면 default 로 돌아갑니다.
  • 한 사람에게만 권한을 줄 때는 group 자리에 user 와 이름을 적습니다 (lp user Camera permission set minecraft.command.time true). 사람이 늘면 관리하기 어려우니 그룹에 주는 쪽을 권합니다.

vip 그룹에 넣은 직후 다시 접속하지 않고 /gamemode creative 가 된 게임 화면

parent add 는 default 와 vip 둘 다, parent set 은 vip 만 남는다는 비교 화면

그룹이 그룹을 물려받기

lp group admin parent add vip
lp group vip parent add default
  • admin 이 vip 를 물려받으면 admin 에 직접 주지 않은 게임 모드 권한도 true 로 나옵니다. 이제 vip 의 권한을 고치면 admin 에도 함께 적용됩니다.
  • vip 가 default 를 물려받게 해 두면 공통 권한은 default 에만 적으면 됩니다.

admin 의 permission check 결과가 vip 에 의해 상속받아 true 로 나온 화면

접두사

lp group vip meta setprefix 100 "&6[VIP] "
lp group admin meta setprefix 200 "&c[관리자] "
  • 띄어쓰기를 넣으려면 큰따옴표로 감쌉니다. 앞의 &6 은 색 코드입니다. 한글도 됩니다.
  • 가운데 숫자는 우선순위입니다. 두 그룹에 모두 속한 사람은 숫자가 큰 접두사(''[관리자] '')를 받습니다.
  • 럭펌은 접두사를 저장만 합니다. 채팅에 보이게 하려면 채팅 플러그인을 하나 더 넣어야 합니다.

lp group vip meta setprefix 100 "&6[VIP] " 를 치고 우선순위 100 의 접두사가 설정된 화면

두 그룹에 모두 속한 Camera 의 lp user info 에 접두사 [관리자] 가 나온 화면

op 와 럭펌

  • op 는 럭펌과 따로 움직입니다. op 인 사람은 럭펌에 적힌 것이 없어도 명령어를 쓰고, 럭펌에서 false 로 막아 두어도 명령어가 됩니다.
  • op 는 전부 아니면 전무이고, 그룹은 골라서 줄 수 있습니다. 그래서 관리자도 op 대신 admin 그룹에 넣는 쪽을 권합니다.
  • 게임 안에서 /lp 명령어를 쓰려면 그 사람에게 럭펌 권한이 있어야 합니다. 럭펌 권한의 이름은 luckperms 로 시작합니다. admin 그룹에 * 를 줬다면 이미 들어 있습니다.

op 인 사람은 럭펌에서 false 로 막아 둔 /gamemode creative 가 되는 게임 화면

웹 편집기

lp editor
  • 나온 주소를 브라우저에서 엽니다. 처음 열면 브라우저를 서버에 연결하라는 창이 뜹니다. 닫아도 편집과 저장은 됩니다.
  • 왼쪽에서 그룹을 고르면 그 그룹의 권한이 표로 보이고, 여기서 권한을 더하고 값을 고칩니다.
  • 저장을 누르면 명령어 한 줄(/lp applyedits 와 코드)이 나옵니다. 그 줄을 서버 창에 붙여 넣어야 서버에 적용됩니다.
  • 편집기를 열면 서버의 권한 자료가 럭펌 사이트에 잠시 올라갑니다. 그래서 편집기 주소는 다른 사람에게 보여 주지 않습니다.

웹 편집기에서 vip 그룹을 골라 권한 표가 보이는 화면

안 될 때 찾는 법

lp user 이름 permission check 권한
lp verbose on
lp verbose off
lp search 권한
  • permission check 는 결과와 함께 그 권한이 어디에서 왔는지 이유를 보여 줍니다. undefined 는 어디에서도 주지 않았다는 뜻입니다.
  • 권한 이름을 모를 때는 lp verbose on 을 켜고 그 명령어를 쳐 봅니다. 서버 창에 방금 검사한 권한 이름과 결과가 찍힙니다. 다 봤으면 lp verbose off 로 끕니다.
  • 어떤 권한을 누가 가졌는지는 lp search 로 찾습니다 (예 : lp search minecraft.command.gamemode → > vip - true).

permission check 결과 true 와 vip 에서 왔다는 이유가 나온 화면

lp verbose on 을 켠 뒤 서버 창에 검사한 권한 이름과 결과가 찍힌 화면

정리

  1. 그룹은 creategroup 으로 만듭니다.
  2. 권한을 줄 때는 permission set, 지울 때는 unset 입니다.
  3. 사람도 그룹도 parent add 로 그룹에 넣습니다.
  4. 접두사는 meta setprefix 이고, 보이게 하려면 채팅 플러그인이 필요합니다.
  5. 명령어가 번거로우면 웹 편집기(lp editor)를 씁니다.
  6. 안 될 때는 permission check 와 verbose 로 이유를 찾습니다.

관련 쇼츠

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

관련 문서

유튜브/수다/강좌/05-럭펌.1795081276.txt.gz · 마지막으로 수정됨: 저자 sudapeople