Bedrock 전용 서버 가이드
Minecraft 베드락 서버에 애드온 추가하는 방법
Minecraft 베드락 전용 서버에 애드온을 추가하려면 먼저 서버를 중지하고 월드를 백업하세요. 압축을 푼 팩을 종류에 맞는 서버 폴더에 복사한 뒤, 실제로 불러오는 월드의 목록에 팩의 header UUID와 버전을 등록합니다. 처음에는 팩 하나만 적용하고 두 번째 플레이어 계정으로도 확인하세요.
이 안내는 파일을 직접 관리하는 베드락 전용 서버(BDS)를 위한 절차입니다. 개인 Bedrock 월드에 .mcaddon을 가져오는 작업과 다르며, Realms나 호스팅 업체의 비공개 제어판에 직접 접근하는 방법도 아닙니다. 공유 월드를 바꾸기 전에 팩 manifest와 실제 서버 버전을 확인하세요.
빠른 답변
파일을 서버에 배치한 다음 실제로 불러오는 월드에 연결하세요
베드락 전용 서버는 서버 콘솔에서 .mcaddon 파일을 여는 방식으로 애드온을 설치하지 않습니다. .mcaddon은 Bedrock 클라이언트에서 가져오기 편한 패키지입니다. BDS에서는 팩 폴더를 압축 해제하고 행동 팩과 리소스 팩을 나눈 뒤 서버 파일 옆에 있는 해당 디렉터리에 복사합니다.
서버는 현재 불러오는 월드에 등록된 팩만 사용합니다. 해당 월드의 world_behavior_packs.json 또는 world_resource_packs.json에 manifest의 header UUID와 버전을 추가하세요. manifest.json은 팩 폴더에 유지하고, 모듈 UUID나 폴더 이름 대신 header UUID를 사용합니다.
수정 전에 월드 전체를 복사하고 BDS를 중지하세요. 서버가 실행 중이면 저장 작업이 변경 사항을 덮어쓸 수 있습니다. 복사본에서 관리자 계정과 일반 플레이어 계정 모두로 확인하고, 서버 재시작과 실제 플레이가 정상적으로 끝날 때까지 복구용 백업을 보관하세요.
2026년 9월 23일 확인한 Verity Bedrock 출처 스냅샷에는 V26.50용 ThatMob's Verity 4.0.0이 등록되어 있으며 업로드 날짜는 2026년 9월 17일입니다. 이 파일 목록은 팩 릴리스 정보를 보여줄 뿐, 모든 전용 서버·Realm·월드와의 호환성을 증명하지 않습니다. 공유 서버에서 사용하기 전에 해당 팩의 manifest와 출처 안내를 확인하세요.
행동 팩
서버 측 규칙과 엔티티를 추가하거나 변경합니다. behavior_packs에 넣고 현재 월드의 행동 팩 목록에 등록하세요.
리소스 팩
텍스처, 사운드 등 클라이언트가 보는 자료를 제공합니다. resource_packs에 넣고 접속 시 플레이어가 다운로드를 승인해야 하는지 확인하세요.
월드 단위 설정
디스크에 폴더가 있다고 활성화된 것은 아닙니다. 월드 팩 목록과 서버의 월드 설정이 어떤 콘텐츠를 불러올지 결정합니다.
설치 절차
7가지 점검으로 BDS에 팩 추가하기
직접 관리하는 BDS에서는 아래 순서로 진행하세요. 호스팅 패널은 경로와 폴더 이름이 다를 수 있지만 월드와 manifest 확인은 여전히 필요합니다.
서버 유형과 활성 월드 확인
관리 중인 서버가 Realm이 아니라 베드락 전용 서버인지 확인하세요. server.properties의 level-name을 읽으면 worlds 아래에서 실제 월드 폴더를 찾을 수 있습니다. 관리형 호스팅에서는 로컬 BDS 경로를 추측하지 말고 파일 관리자나 업체 안내를 따르세요.
팩 요구 버전과 게임 버전 비교
manifest.json에서 format_version, minimum_engine_version, header UUID와 버전, 의존성을 확인하세요. 실제 서버 릴리스와 지원하는 팩 유형에 맞춰 비교합니다. 파일명이나 프로젝트 페이지의 제목만으로 호환성을 판단할 수는 없습니다.
서버를 중지하고 백업
월드 데이터를 수정하기 전에 BDS를 정상 종료하세요. 활성 월드 폴더 전체와 기존 팩 목록, server.properties를 별도로 복사합니다. 월드 이름과 날짜를 표시하면 문제가 생겼을 때 다른 저장 데이터를 잘못 복구하는 일을 줄일 수 있습니다.
압축을 풀고 팩 유형별로 분리
다운로드를 풀어 manifest.json이 바로 들어 있는 폴더를 찾습니다. 행동 팩은 behavior_packs, 리소스 팩은 resource_packs에 둡니다. 폴더가 한 단계 더 중첩되지 않았는지 확인하고 .zip이나 .mcaddon 안에 그대로 두지 마세요.
해당 월드에 팩 등록
worlds/<월드 이름>/의 world_behavior_packs.json 또는 world_resource_packs.json에 해당 유형의 팩을 각각 등록합니다. pack_id에는 header UUID를, version에는 같은 header의 숫자 세 개를 입력합니다. JSON 문법과 manifest에 선언된 의존성을 함께 확인하세요.
클라이언트 리소스 설정 확인
월드가 리소스 팩을 쓰면 server.properties의 texturepack-required를 확인하세요. 활성화하면 호환되는 클라이언트가 제공된 리소스 다운로드를 승인해야 합니다. 모든 기기에서 자료가 똑같이 보인다는 뜻은 아니므로 테스트 전에 플레이어에게 안내하세요.
재시작하고 복사본에서 테스트
서버를 시작한 뒤 콘솔이나 로그에서 manifest, 의존성, JSON 오류를 살펴보세요. 호환 버전의 클라이언트로 접속해 행동과 시각 자료를 확인하고 다른 플레이어 계정으로도 점검합니다. 정상적인 재시작과 복구 방법을 확인한 다음에 본 월드에 적용하세요.
파일 위치와 범위
클라이언트 가져오기 폴더와 BDS 월드 폴더는 다릅니다
개인 기기에서 .mcaddon을 열면 로컬 Bedrock 프로필로 가져오며 com.mojang 폴더 안에 저장될 수 있습니다. 이 클라이언트 저장 위치는 서버의 behavior_packs, resource_packs, worlds 디렉터리와 다릅니다. 자신의 PC에만 파일을 복사해도 전용 서버가 팩을 불러오지는 않습니다.
BDS 경로는 운영체제, 설치 방식, 컨테이너, 호스팅 패널에 따라 달라집니다. 서버 실행 파일과 server.properties가 있는 위치에서 시작하고 level-name으로 월드를 확인하세요. 패널은 가상 루트를 보여줄 수도 있으니 업체의 경로 매핑을 따르고, 추측한 Windows 경로를 Linux 컨테이너에 입력하지 마세요.
manifest.json은 팩 파일과 함께 유지합니다. header UUID는 월드 목록에서 팩을 식별하지만 module UUID는 팩 내부 모듈을 구분하므로 용도가 다릅니다. 제작자가 의존성을 지정했다면 해당 팩도 설치하고 각 manifest의 정확한 ID와 버전을 사용하세요.
BDS 파일 지도
애드온 구성요소별로 사용하는 파일과 폴더
정확한 루트 경로는 설치 방식마다 다릅니다. 아래는 일반적인 BDS 폴더의 역할이므로 서버 패키지나 호스팅 안내와 대조하세요.
플레이어 동기화
서버 팩과 플레이어 개인 애드온은 항상 같은 것이 아닙니다
서버는 월드 리소스 팩을 접속하는 클라이언트에 제공할 수 있습니다. texturepack-required는 플레이어가 접속을 위해 다운로드를 승인해야 하는지 정합니다. 이 옵션이 행동 팩을 플레이어 기기에 로컬 설치하거나 호환성 문제를 해결해 주지는 않습니다. 모든 플랫폼이 동일하게 렌더링된다는 보장도 없으므로 실제 사용할 서버와 클라이언트 버전 조합을 확인하세요.
행동 팩은 보통 서버 월드 설정의 일부로 실행되고, 리소스 팩은 클라이언트에 시각 자료와 소리를 제공합니다. 하나의 애드온이 두 종류를 모두 포함할 수도 있습니다. 각각 맞는 목록에 등록하고, 텍스처가 보인다는 이유만으로 행동 팩까지 로드됐다고 판단하지 마세요. 엔티티가 보이는 것 역시 모든 리소스의 동기화를 증명하지 않습니다.
여러 애드온 사이에 의존성이 있을 수 있습니다. 선언된 의존 팩을 모두 설치하고 중복 header UUID가 없는지 확인하세요. 목록의 버전과 설치 폴더를 맞추고, 제작자가 특정 순서나 실험 기능을 요구하면 해당 릴리스의 안내를 따릅니다. 문제를 좁히기 쉽도록 복사한 월드에 팩을 하나씩 추가하세요.
그림의 화살표는 운영자가 서버에서 팩을 활성화한 뒤 클라이언트가 접속하고 리소스를 받을 수 있다는 개념적 경계를 나타냅니다. Minecraft 게임 화면, 제어판 또는 검증된 통신 로그가 아닙니다.
문제 해결
애드온을 넣었는데 서버에서 작동하지 않는 이유
증상에 맞춰 다음 점검 위치를 찾으세요. 한 번에 한 항목만 바꾸고 수정한 월드가 정상적으로 열린 뒤까지 백업을 보관합니다.
다른 월드를 불러오는 중
server.properties의 level-name과 수정한 팩 목록이 들어 있는 폴더를 비교하세요. 다른 저장 데이터에 팩이 있어도 현재 월드에서는 활성화되지 않습니다.
manifest가 중첩됐거나 압축된 상태
대상 팩 폴더 바로 안에 manifest.json이 있는지 확인합니다. 압축 해제 과정에서 바깥쪽 폴더가 한 단계 추가되지 않았는지 살펴보세요.
UUID 또는 버전이 맞지 않음
manifest.json의 header UUID와 header version을 사용하세요. 폴더 이름, module UUID, 이전 다운로드에서 가져온 값으로 대체하지 마세요.
팩 종류에 맞지 않는 폴더
행동 자료는 behavior_packs, 리소스는 resource_packs에 배치하고 해당 월드 JSON에 각각 등록합니다. 클라이언트에 가져오는 것만으로 서버 팩이 활성화되지는 않습니다.
의존 팩이나 실험 설정 누락
manifest의 dependencies와 해당 릴리스 안내를 확인하세요. 필요한 버전을 함께 설치하고 제작자가 요구할 때는 월드 실험 설정도 점검합니다.
플레이어에게 리소스가 보이지 않음
월드 리소스 목록, 다운로드 요청 설정, 클라이언트 승인과 지원 버전을 확인합니다. 클라이언트 캐시를 지우기 전에 설정을 기록하고 서버 월드를 먼저 삭제하지 마세요.
관련 가이드
사용 환경에 맞는 다음 안내
관련 페이지에서 개인 월드 가져오기와 전용 서버 구성을 구분해 확인할 수 있습니다.
개인 Bedrock 월드에 애드온 가져오기
기기나 로컬 월드에 .mcaddon을 가져오는 클라이언트 절차를 안내합니다.
개인 월드 안내 보기Bedrock 리소스 팩 문제 해결
클라이언트의 파일 유형, 가져오기, 월드 활성화 여부를 살펴봅니다.
리소스 팩 안내 열기Bedrock 출처 및 버전 안내
Verity Bedrock 출처 페이지와 팩별 호환성 정보를 확인합니다.
Bedrock 출처 확인Minecraft 버전 요약
공유 월드 테스트 전에 게임과 팩의 기록된 버전을 비교합니다.
버전 정보 보기참고 자료
서버를 바꾸기 전에 확인할 공식 문서
공식 문서는 전용 서버, 팩 구조와 애드온 개념을 설명합니다. 제3자 팩의 호환성을 인증하는 자료는 아닙니다.
Minecraft 베드락 전용 서버
공식 서버 다운로드와 플랫폼 정보입니다. 실제 환경과 맞는 릴리스를 확인하세요.
Minecraft 서버 페이지Microsoft Learn: 행동 팩
행동 팩 구조와 manifest에 대한 공식 제작자 문서입니다.
공식 문서 읽기Microsoft Learn: 리소스 팩
리소스 팩의 파일과 구성에 대한 공식 제작자 문서입니다.
공식 문서 읽기Minecraft 도움말: 베드락 애드온 자주 묻는 질문
플레이어를 위한 Bedrock 애드온과 지원 플랫폼 관련 공식 정보입니다.
공식 도움말 열기자주 묻는 질문
Minecraft 베드락 서버 애드온 자주 묻는 질문
Minecraft 베드락 서버에 애드온을 어떻게 추가하나요?
직접 관리하는 베드락 전용 서버에서는 월드를 중지하고 백업한 뒤 팩을 압축 해제합니다. 폴더를 behavior_packs 또는 resource_packs에 복사하고 활성 월드의 해당 JSON 목록에 header UUID와 버전을 추가하세요. 재시작 후 본 월드가 아닌 복사본에서 먼저 테스트합니다.
서버에서 .mcaddon을 열면 설치되나요?
대개 Bedrock 클라이언트 프로필로 가져오는 작업이며 전용 서버 월드 설치가 아닙니다. 팩 폴더를 풀어서 BDS 절차를 따르세요. 호스팅 업체에는 별도의 업로드 과정이 있을 수 있으므로 안내를 확인해야 합니다.
모든 플레이어가 같은 애드온을 따로 설치해야 하나요?
항상 그렇지는 않습니다. 서버가 리소스 팩을 제공할 수 있고 texturepack-required로 다운로드 승인을 요구할 수 있습니다. 행동 팩은 서버의 월드 설정과 함께 구성합니다. 다만 버전, 플랫폼, 팩 설계와 서버 설정에 따라 결과가 달라집니다.
Bedrock 전용 서버에 애드온 여러 개를 넣으려면?
각 팩을 압축 해제해 해당 폴더에 배치하고 자신의 header UUID와 버전을 맞는 월드 목록에 등록합니다. 의존 팩을 포함하고 ID 중복을 확인하세요. 복사한 월드에 하나씩 추가하면 충돌 위치를 찾고 문서에 정해진 순서를 지키기 쉽습니다.
이 BDS 절차를 Minecraft Realms에도 쓸 수 있나요?
아니요. 여기에 나온 경로는 운영자가 관리하는 베드락 전용 서버용입니다. Realms는 같은 서버 파일 시스템을 공개하지 않으므로 Realm 소유자가 지원하는 월드 및 팩 절차를 사용해야 합니다. 관리형 호스팅은 패널 전용 방법을 요구할 수도 있습니다.
Verity Bedrock 목록이 BDS 호환성을 증명하나요?
아니요. 2026년 9월 23일 확인한 출처 정보에는 V26.50용 4.0.0이 표시되지만 전용 서버 테스트를 의미하지 않습니다. manifest와 출처 안내를 서버 빌드에 맞춰 보고 백업 월드에서 시험하세요. 안정적인 직접 다운로드 파일 URL은 검증되지 않아 Bedrock 다운로드 버튼은 공식 CurseForge 파일 페이지를 사용합니다.
팩이 폴더에 있는데 서버 월드에 적용되지 않는 이유는 무엇인가요?
level-name에 지정된 활성 월드와 팩을 넣은 월드 폴더가 같은지 확인하세요. world_behavior_packs.json에는 manifest.json 헤더의 UUID와 버전이 들어 있어야 합니다. 다른 월드에 연결했거나 매니페스트 값이 맞지 않으면 파일이 있어도 팩은 활성화되지 않습니다.
Verity Bedrock 배포 정보만으로 서버 호환성을 확인할 수 있나요?
아니요. 2026년 9월 23일에 확인한 Verity 출처 기록에는 V26.50용 버전 4.0.0이 표시되어 있습니다. 하지만 배포 기록은 전용 서버에서의 호환성 테스트를 뜻하지 않습니다. 팩 매니페스트와 배포처 안내를 BDS 빌드에 맞춰 확인한 뒤 월드 백업본에서 먼저 테스트하세요. 확인 가능한 안정적인 파일 직링크가 없어 Bedrock 다운로드 버튼은 CurseForge 공식 파일 페이지로 연결됩니다.