Bedrock 애드온 설치하기
Files 탭에서 Bedrock 서버에 비헤이비어 팩과 리소스 팩을 올리고, 실제로 적용되도록 월드에서 켜 주는 방법입니다.
읽는 시간 4분 · 2026년 10월 21일 업데이트 · 작성: GuavaHost Team
Files (파일) 탭에서 Bedrock 서버에 비헤이비어 팩과 리소스 팩을 올리고, 실제로 적용되도록 월드에서 켜 주는 방법입니다.
Bedrock의 애드온은 두 부분으로 나뉩니다. 작동 방식을 바꾸는 비헤이비어 팩과 보이는 모습을 바꾸는 리소스 팩입니다. 대부분의 애드온은 둘 다 포함합니다. 하나를 설치하는 것은 사실 두 가지 일입니다. 팩 파일을 서버에 올리는 일과, 그것을 쓰고 싶은 특정 월드에서 켜 주는 일입니다. 켜기 전까지 올리기만 해서는 아무 일도 일어나지 않습니다.
시작하기 전에
- 애드온 파일을 준비하세요. 팩은 보통
.mcpack이나.mcaddon파일, 또는 그냥 폴더로 내려받아집니다. 서버는 압축된 파일이 아니라 폴더를 읽으므로, 각 팩은 자기 폴더에 압축이 풀린 상태로 들어가야 합니다..mcpack은 사실.zip이고,.mcaddon은 여러 팩을 하나로 묶은 것인 경우가 많습니다. - 월드 이름을 알아 두세요. 서버에서 사용 중인 월드는
worlds/아래의 폴더, 예를 들어worlds/Bedrock level에 있습니다. 확실하지 않으면 Files 탭을 열고worlds/안에서 내 월드와 맞는 폴더를 찾아보세요.
서버에서 각 항목이 있는 곳
Files 탭의 서버 최상위에 다음 폴더들이 보입니다.
behavior_packs/는 서버에 설치된 모든 비헤이비어 팩을 담습니다.resource_packs/는 모든 리소스 팩을 담습니다.worlds/는 월드를 담습니다. 팩을 실제로 켜 주는 대상은 각 월드 폴더입니다.
팩이 behavior_packs/나 resource_packs/에 있다는 것은 쓸 수 있게 준비되었다는 뜻일 뿐입니다. 월드에 쓰라고 알려 주기 전까지는 켜져 있지 않습니다.
1단계: 팩 올리기
- 먼저 페이지 상단의 Stop 버튼으로 서버를 정지하세요. 돌아가는 동안 파일을 편집하면 변경이 덮어써지거나 무시될 수 있습니다.
- Files 탭을 엽니다.
behavior_packs/폴더로 들어가세요. 팩마다 자기 하위 폴더에 들어가고, 그 폴더의 최상위에 팩의manifest.json이 있어야 합니다. 브라우저 업로더는 폴더가 아니라 파일을 받으므로 이렇게 하세요.- New folder를 클릭해 팩 이름(예를 들어
YourPack)으로 만들고 그 안으로 들어갑니다. - 컴퓨터에서
.mcpack의 확장자를.zip으로 바꿉니다(폴더로 받았다면manifest.json이 zip 최상위에 오도록 내용물을 압축하세요). - Upload files를 클릭해 그
.zip을 고르고, 옆의 Unpack을 누릅니다. 파일들이 지금 있는 폴더에 풀립니다. 끝난 뒤.zip은 지우세요.
- New folder를 클릭해 팩 이름(예를 들어
- 뒤로 나와
resource_packs/로 들어가, 애드온에 리소스 팩이 포함되어 있다면 같은 작업을 하세요.
팩 폴더 전체를 SFTP로 올려도 됩니다.
간단한 점검: behavior_packs/YourPack/manifest.json이 있어야 합니다. manifest.json이 한 단계 더 깊은 폴더에 묻혀 있으면 서버가 팩을 찾지 못합니다.
2단계: 월드에서 팩 켜기
두 종류의 팩 모두 보통 특정 월드에서 켜 주어야 하고, 월드 폴더 안의 작은 파일 두 개로 켭니다.
- 비헤이비어 팩은
world_behavior_packs.json입니다. - 리소스 팩은
world_resource_packs.json입니다.
각 항목은 팩을 ID와 버전으로 연결하며, 둘 다 팩의 manifest.json에서 가져옵니다.
- 월드 폴더, 예를 들어
worlds/Bedrock level을 엽니다. world_behavior_packs.json을 클릭해 엽니다. 없다면 컴퓨터에서 그 이름 그대로 평범한 텍스트 파일로 만들어 Upload files로 월드 폴더에 올리세요. Files 탭에는 새 파일을 만드는 버튼이 없습니다.- 비헤이비어 팩의
manifest.json에 있는uuid와version으로 항목을 추가합니다. 형식은 이렇습니다.
[
{
"pack_id": "00000000-0000-0000-0000-000000000000",
"version": [1, 0, 0]
}
]
pack_id를 팩의 실제 UUID로, version을 실제 버전 번호로 바꾸세요. 파일에 이미 항목이 있다면 기존 것을 지우지 말고 목록에 추가하세요. 4. world_resource_packs.json에도 리소스 팩의 UUID와 버전으로 같은 작업을 하세요. 5. 각 파일에서 Save를 누른 뒤 Start 버튼으로 서버를 시작하세요.
플레이어가 접속하면 Bedrock은 비헤이비어 팩을 곧바로 적용하고, 리소스 팩은 서버의 리소스 팩 설정에 따라 제안하거나 적용합니다.
문제 해결
- 게임에서 아무것도 바뀌지 않았습니다. 가장 흔한 원인은 팩을 올리기만 하고 켜지 않은 것입니다.
world_behavior_packs.json과world_resource_packs.json을 다시 확인하고 UUID와 버전이 매니페스트와 정확히 일치하는지 보세요. - 편집한 뒤 서버가 시작되지 않았습니다. 쉼표나 괄호가 빠진 JSON 파일은 월드 불러오기를 멈춥니다. 파일을 JSON 검사기에 붙여 넣어 문법을 고치고 다시 시도하세요. 편집하기 전에 원본 사본을 남겨 두면 여기서 고생을 많이 줄일 수 있습니다.
- 팩을 찾을 수 없습니다. 폴더가
behavior_packs/나resource_packs/바로 안에 있는지, 그리고manifest.json이 한 단계 더 깊은 곳이 아니라 그 폴더의 최상위에 있는지 확인하세요. - 버전 불일치입니다. 월드 JSON의
version배열은 팩manifest.json의version과 일치해야 합니다. 다르면 게임이 그 팩을 무시합니다. - 플레이어에게 리소스 팩이 적용되지 않습니다. 서버의 리소스 팩 정책이 팩을 강제할지 선택 사항으로 둘지에 영향을 줍니다. Bedrock에서는
server.properties의texturepack-required설정이고, Minecraft tools (Minecraft 도구) 아래 Server properties (서버 설정) 페이지에 Require the world resource pack으로 표시됩니다. 켜면 팩을 강제하고, 끄면 선택 사항이 됩니다.
아직 해결되지 않았나요? discord.gg/GuavaHost의 Discord에 들어오시면 팀이 도와드립니다.
- bedrock
- addons
- behavior-packs
- resource-packs
- files
- world
Host a Minecraft Bedrock server From $4.00/mo, with instant setup and DDoS protection.
아직 해결되지 않았나요? 저희 팀이 24시간 대기하며 질문에 답해 드려요.