====== 에센셜 대신 HuskHomes - 마인크래프트 집, 워프, tpa 플러그인 설치와 설정 (26.2) ======
마인크래프트 서버의 집, 워프, 순간이동 플러그인 HuskHomes(허스크홈즈)를 에센셜(EssentialsX)과 비교해 정리했습니다. 받을 파일과 설치, 한국어로 바꾸기, 집, 공개 집, 순간이동 요청, 워프와 스폰, 되돌아가기와 무작위 이동, 권한, 설정 파일, 에센셜에서 집과 워프를 옮겨 오는 법까지 다룹니다. Paper 26.2 서버에 HuskHomes 4.11.1 을 넣고 명령어, 권한, 설정을 직접 쳐서 확인한 내용입니다.
{{youtube>OASvicAMqgc?large}}
^ 항목 ^ 내용 ^
| 썸네일 | {{유튜브:수다:특별:01-thumb.jpg?320|에센셜 대신 HuskHomes - 마인크래프트 집·워프·tpa 플러그인 설치와 설정 총정리 (26.2)}} |
| 영상 | [[https://youtu.be/OASvicAMqgc|에센셜 대신 HuskHomes - 마인크래프트 집·워프·tpa 플러그인 설치와 설정 총정리 (26.2)]] |
| 채널 | [[유튜브:수다:start|수다 SUDA]] |
| 공개일 | 2026-11-18 |
| 길이 | 9분 53초 |
| 게임 버전 | Paper 26.2 빌드 135, HuskHomes 4.11.1 |
===== 에센셜과 다른 점 =====
* 설치만 해도 관리자가 아닌 사람이 집, 요청, 워프 이동, 스폰, 무작위 이동을 씁니다. 에센셜은 설치만 하면 관리자가 아닌 사람의 명령어가 모두 "권한이 없습니다"로 막혔습니다 ([[유튜브:수다:강좌:04-에센셜|4편]]).
* 채팅창에 버튼이 달린 메뉴가 나옵니다 (''/edithome'', 요청 수락과 거절 버튼, 죽은 자리로 돌아가기 버튼).
* 공개 집 ''/phome'', 무작위 이동 ''/rtp'' 이 들어 있습니다.
* 서버 여러 대(Velocity, BungeeCord)와 MySQL, MariaDB, PostgreSQL 을 쓰면 집과 워프가 서버를 넘어 이어집니다 (공식 문서에 따른 내용. 영상에서는 서버 한 대만 돌렸습니다).
* 한국어 번역이 들어 있습니다 (''language: ko-kr'').
* 집, 워프, 순간이동만 맡습니다. 키트, 돈, 별명은 없습니다.
{{ 유튜브:수다:특별:01-0050.jpg?640 |설치만 한 상태에서 관리자가 아닌 사람이 쓴 결과. 에센셜은 권한 없음, 허스크홈즈는 됨}}
===== 받을 파일과 설치 =====
* 받는 곳 : [[https://modrinth.com/plugin/huskhomes]]
* Paper 서버 : ''HuskHomes-Paper-4.11.1.jar'' 하나 (정식판, 26.2 지원). 무료, 공개 소스(Apache 2.0).
* 서버 폴더의 ''plugins'' 에 넣고 서버를 켭니다. 서버 창에 ''[HuskHomes] Successfully enabled HuskHomes v4.11.1'' 이 나오면 됩니다.
* ''plugins/HuskHomes'' 폴더에 설정 파일 ''config.yml'', 글 파일, 저장 파일 ''HuskHomesData.db'' (SQLite) 가 생깁니다. 집과 워프는 이 저장 파일에 들어갑니다. 서버 한 대라면 데이터베이스를 따로 깔 필요가 없습니다.
===== 한국어로 바꾸기 =====
''plugins/HuskHomes/config.yml'' 맨 위의 값을 바꾸고 서버 창에서 reload 합니다.
language: ko-kr
huskhomes reload
{{ 유튜브:수다:특별:01-0146.jpg?640 |서버 창에서 huskhomes reload 를 친 뒤 /sethome two 가 한글로 답하는 화면}}
===== 집 =====
^ 명령어 ^ 하는 일 ^
| ''/sethome 이름'' | 지금 자리를 집으로 저장. 이름을 빼면 ''home'' |
| ''/home 이름'' | 5초를 센 뒤 그 집으로 이동. 세는 동안 맞으면 취소 |
| ''/homelist'' (''/homes'') | 내 집 목록 |
| ''/edithome 이름'' | 그 집의 정보와 버튼. ''rename 새이름'', ''description 설명'', ''relocate'', ''privacy public/private'' |
| ''/delhome 이름'' | 집 지우기 |
| ''/delhome all confirm'' | 모든 집 지우기. ''confirm'' 없이 치면 한 번 더 묻습니다 |
* 한글 집 이름은 처음에 막혀 있습니다 ("오류: 집 이름은 반드시 영어, 숫자여야 합니다. (A-Z, 0-9, -_)"). ''config.yml'' 의 ''names:'' 아래 ''restrict'' 를 ''false'' 로 바꾸면 됩니다. 워프 이름도 처음에는 한글이 막혀 있습니다.
* 한 사람이 만들 수 있는 집은 처음에 10개입니다 (''max_homes: 10''). 3으로 줄여 보니 네 번째 집에서 "오류: 3개 이상의 집을 생성할 수 없습니다!" 가 나왔습니다.
{{ 유튜브:수다:특별:01-0161.jpg?640 |/home farm 을 치자 5 초 뒤에 이동됩니다 라고 세는 화면}}
{{ 유튜브:수다:특별:01-0179.jpg?640 |/edithome farm 을 치자 채팅창에 집 정보와 버튼이 나온 화면}}
===== 공개 집 =====
* ''/edithome 집이름 privacy public'' 으로 집을 공개로 바꾸면 다른 사람도 올 수 있습니다.
* 다른 사람은 ''/phomelist'' 로 공개 집 목록을 보고 ''/phome 주인이름.집이름'' 으로 찾아갑니다.
* 공개하지 않은 남의 집 목록(''/homelist 이름'')은 볼 수 없습니다.
* 공개할 수 있는 집의 수는 ''max_public_homes'' 로 따로 정합니다 (기본 10).
{{ 유튜브:수다:특별:01-0239.jpg?640 |/phome Alex.cabin 으로 다른 사람의 공개 집에 찾아가는 화면}}
===== 순간이동 요청 =====
^ 명령어 ^ 하는 일 ^
| ''/tpa 이름'' | 상대에게 가겠다고 요청. 상대 채팅창에 수락과 거절 버튼이 나옴 |
| ''/tpahere 이름'' | 상대를 내 쪽으로 부르기 |
| ''/tpaccept'' (''/tpyes'') | 수락. 5초 뒤 이동 |
| ''/tpdecline'' (''/tpdeny'', ''/tpno'') | 거절 |
| ''/tpignore'' | 요청을 받지 않기. 한 번 더 치면 다시 받음 |
* 요청은 60초가 지나면 사라집니다 (''teleport_request_expiry_time: 60''). 사라질 때 따로 알려 주지는 않았습니다.
{{ 유튜브:수다:특별:01-0261.jpg?640 |요청을 받은 Steve 의 채팅창에 수락과 거절 버튼이 나온 화면}}
===== 워프와 스폰 =====
* 관리자 : ''/setwarp 이름'', ''/delwarp 이름'', ''/editwarp 이름'', ''/setspawn''
* 누구나 : ''/warplist'' (''/warps''), ''/warp 이름'', ''/spawn''
* 관리자가 아니면 ''/setwarp'' 는 없는 명령어처럼 "알 수 없거나 불완전한 명령어입니다" 로 나옵니다.
===== 되돌아가기와 무작위 이동 =====
* 죽으면 채팅창에 "죽은 곳으로 되돌아 갈까요?" 와 이동 버튼이 나옵니다.
* ''/back'' : 죽은 뒤에 치면 죽은 자리로, 순간이동한 뒤에 치면 이동하기 전 자리로 돌아갑니다.
* ''/rtp'' : 멀리 떨어진 안전한 자리로 아무 데나 보냅니다. 스폰에서 500칸부터 5,000칸 사이에서 고릅니다 (''rtp: region: min: 500 / max: 5000''). 해 보니 1,786칸쯤 떨어진 곳에 내렸습니다.
* 한 번 쓰면 10분을 기다려야 다시 쓸 수 있습니다 (''cooldowns:'' 아래 ''RANDOM_TELEPORT: 600'').
{{ 유튜브:수다:특별:01-0330.jpg?640 |죽은 뒤 채팅창에 죽은 곳으로 되돌아 갈까요 와 이동 버튼이 나온 화면}}
{{ 유튜브:수다:특별:01-0345.jpg?640 |/rtp 를 치자 랜덤 이동할 안전한 장소를 찾는 중입니다 가 나온 화면}}
===== 권한 =====
권한 플러그인이 없을 때 :
* 누구나 : home, sethome, homelist, delhome, edithome, phome, phomelist, warp, warplist, spawn, tpa, tpahere, tpaccept, tpdecline, tpignore, rtp, back
* 관리자만 : tp, tphere, tpall, tpaall, tpoffline, setwarp, delwarp, editwarp, setspawn, huskhomes reload
* 관리자는 5초를 세지 않고 바로 이동했습니다.
등급마다 다르게 주려면 권한 플러그인(LuckPerms)을 함께 씁니다.
^ 권한 ^ 하는 일 ^
| ''huskhomes.command.명령어이름'' | 명령어마다 (예 ''huskhomes.command.rtp'') |
| ''huskhomes.max_homes.숫자'' | 집 개수 |
| ''huskhomes.max_public_homes.숫자'' | 공개 집 개수 |
| ''huskhomes.teleport_warmup.초'' | 이동 전에 세는 시간 |
| ''huskhomes.bypass_teleport_warmup'' | 세지 않고 바로 |
| ''huskhomes.bypass_cooldowns'' | 기다리는 시간 무시 |
| ''huskhomes.warp.워프이름'' | 워프마다 (''permission_restrict_warps: true'' 일 때) |
lp user Alex permission set huskhomes.max_homes.2 true
lp group default permission set huskhomes.command.rtp false
* 첫 줄 뒤 Alex 의 세 번째 집은 "오류: 2개 이상의 집을 생성할 수 없습니다!" 로 막혔고, 둘째 줄 뒤 ''/rtp'' 는 알 수 없는 명령어가 됐습니다.
{{ 유튜브:수다:특별:01-0397.jpg?640 |lp user Alex permission set huskhomes.max_homes.2 true 뒤 /sethome h3 가 막힌 화면}}
===== config.yml 에서 자주 바꾸는 설정 =====
^ 설정 ^ 하는 일 ^
| ''language: ko-kr'' | 한국어 |
| ''general: max_homes: 10'' | 한 사람의 집 개수 |
| ''general: max_public_homes: 10'' | 공개 집 개수 |
| ''general: teleport_warmup_time: 5'' | 이동 전에 세는 시간(초). 0 이면 바로 |
| ''general: teleport_warmup_cancel_on_damage'' / ''_on_move'' | 맞거나 움직이면 취소 |
| ''general: teleport_warmup_display: ACTION_BAR'' | 세는 글 자리. CHAT, TITLE, SUBTITLE, NONE |
| ''general: teleport_request_expiry_time: 60'' | 요청이 사라지는 시간(초) |
| ''general: always_respawn_at_spawn: false'' | 죽으면 늘 스폰에서 |
| ''general: names: restrict: false'' | 한글 집, 워프 이름 허용 |
| ''rtp: region: min: 500 / max: 5000'' | 무작위 이동 거리 |
| ''cooldowns: cooldown_times: RANDOM_TELEPORT: 600'' | ''/rtp'' 를 다시 쓸 때까지(초) |
| ''%%disabled_commands: ['/rtp']%%'' | 명령어 없애기 |
**조심할 점** : ''huskhomes reload'' 로는 언어와 집 개수만 바로 바뀌었습니다. ''teleport_warmup_time'' 과 ''disabled_commands'' 는 서버를 껐다 켜야 바뀌었습니다. reload 의 답에도 "A restart is needed for config changes to take effect." 가 나옵니다. 설정을 고치면 서버를 껐다 켜세요.
{{ 유튜브:수다:특별:01-0470.jpg?640 |고친 설정이 reload 와 껐다 켜기에서 바뀌었는지 정리한 표}}
===== 에센셜에서 옮겨 오기 =====
- 두 플러그인을 함께 넣고 서버를 켭니다. 가져오기 전에 서버 폴더를 백업합니다 (같은 이름의 집은 덮어씁니다).
- 서버 창에서 가져오기를 칩니다.
- 에센셜을 계속 쓰면 ''Essentials/config.yml'' 의 ''disabled-commands'' 에 겹치는 명령어를 적고 서버를 껐다 켭니다.
huskhomes import start EssentialsX
겹치는 명령어 :
home homes sethome homelist delhome warp setwarp createwarp warplist delwarp tp tphere tpa tpahere tpaccept tpdeny tpno rtp tpignore tpoffline tpall tpaall spawn setspawn back
* 두 플러그인을 함께 넣기만 하면 ''/home'' 같은 겹치는 명령어는 에센셜이 받았습니다. ''disabled-commands'' 를 적고 껐다 켜면 HuskHomes 가 받습니다.
* 키트, 돈처럼 겹치지 않는 것은 에센셜이 그대로 맡습니다. 에센셜이 더 필요 없으면 가져온 뒤에 에센셜 파일을 빼면 됩니다.
{{ 유튜브:수다:특별:01-0504.jpg?640 |가져오기 뒤 /huskhomes:homelist 에 에센셜에서 만든 집 세 개, /huskhomes:warplist 에 워프가 들어온 화면}}
===== 영상 시간표 =====
^ 시각 ^ 내용 ^
| 0:00 | 시작 |
| 0:33 | 에센셜과 다른 점 |
| 1:35 | 받을 파일과 설치 |
| 2:14 | 한국어로 바꾸기 |
| 2:29 | 집 |
| 3:46 | 공개 집 |
| 4:13 | 순간이동 요청 |
| 4:56 | 워프와 스폰 |
| 5:28 | 되돌아가기와 무작위 이동 |
| 6:09 | 권한 |
| 6:55 | 설정 파일 |
| 8:00 | 에센셜에서 옮겨 오기 |
| 8:57 | 정리 |
===== 관련 쇼츠 =====
이 편에서 한 가지를 떼어 낸 짧은 영상은 공개되면 여기에 더합니다. 전체 목록은 [[유튜브:수다:쇼츠|쇼츠 목록]]에 있습니다.
===== 관련 문서 =====
* [[유튜브:수다:강좌:04-에센셜|마인크래프트 에센셜 플러그인 설치와 설정 (26.2)]]
* [[유튜브:수다:강좌:03-서버만들기|마인크래프트 서버 만들기 (Paper 26.2)]]
* [[유튜브:수다:start|수다 SUDA 채널 영상 목록]]
* 영상 : [[https://youtu.be/OASvicAMqgc|유튜브에서 보기]]
* HuskHomes 공식 문서 : [[https://william278.net/docs/huskhomes/]]
* 구독 : [[https://www.youtube.com/@sudacraft?sub_confirmation=1|수다 SUDA 채널 구독하기]]
설명 목소리는 합성 음성입니다.
{{htmlmetatags>metatag-description=(마인크래프트 집, 워프, 순간이동 플러그인 HuskHomes 를 Paper 26.2 서버에 설치하고 설정하는 방법. 에센셜과 다른 점, 한국어 설정, 집, 공개 집, tpa, 워프, 스폰, 무작위 이동 명령어와 LuckPerms 권한, config.yml 설정, 에센셜에서 옮겨 오기를 정리했습니다.)
metatag-keywords=(HuskHomes, 허스크홈즈, 홈 플러그인, 마크 홈 플러그인, tpa 플러그인, 워프 플러그인, 에센셜 플러그인, 마인크래프트 플러그인, Paper 서버, 마인크래프트 26.2, 수다 SUDA)
metatag-og:type=(article)
metatag-og:site_name=(수다위키)
metatag-og:locale=(ko_KR)
metatag-og:title=(에센셜 대신 HuskHomes - 마인크래프트 집·워프·tpa 플러그인 설치와 설정 총정리 (26.2))
metatag-og:description=(마인크래프트 집, 워프, 순간이동 플러그인 HuskHomes 를 Paper 26.2 서버에 설치하고 설정하는 방법. 에센셜과 다른 점, 한국어 설정, 집, 공개 집, tpa, 워프, 스폰, 무작위 이동 명령어와 LuckPerms 권한, config.yml 설정, 에센셜에서 옮겨 오기를 정리했습니다.)
metatag-media-og:image=(유튜브:수다:특별:01-thumb.jpg)
metatag-og:image:width=(1280)
metatag-og:image:height=(720)
metatag-og:image:alt=(에센셜 대신 HuskHomes - 마인크래프트 집·워프·tpa 플러그인 설치와 설정 총정리 (26.2))
metatag-twitter:card=(summary_large_image)
metatag-twitter:site=(@sudapeople)}}