이 가이드는 Legion Hosting에서 Minecraft Bedrock Edition 서버를 설정하고 구성하는 방법을 안내합니다. 첫 시작, server.properties 구성, 플레이어 권한, 모든 Bedrock 플랫폼에서의 연결, 월드 관리, 크로스플레이 고려 사항을 다룹니다.

Bedrock 대 Java Edition

Minecraft는 서로 기본적으로 호환되지 않는 두 가지 별개의 에디션으로 존재합니다:

Bedrock 서버는 Bedrock 클라이언트만 허용합니다. Java Edition 플레이어가 Bedrock 호환 서버에 참여해야 한다면, 대신 Geyser 플러그인이 있는 Java 서버를 실행하는 것을 고려하세요. 이 가이드는 전용 Bedrock 서버에만 집중합니다.

1단계 — 첫 시작

Legion Hosting에서 Minecraft Bedrock 서버를 구매한 후, 처음 실행하려면 다음 단계를 따르세요.

1. GPanel에 로그인하고 서버 목록에서 Bedrock 서버를 선택합니다.
2. Startup 탭을 클릭합니다. 서버의 기본 설정을 제어하는 egg 변수가 표시됩니다. 주요 변수는 다음과 같습니다:

   변수	기본값	설명
   BEDROCK_VERSION	latest	설치할 Bedrock Dedicated Server 버전입니다. 시작 시 항상 최신 릴리스를 가져오려면 latest로 설정하거나, 특정 버전 번호를 고정하세요(예: 1.21.51.02).
   SERVERNAME	Dedicated Server	플레이어가 서버를 추가할 때 표시되는 이름입니다.
   GAMEMODE	survival	기본 게임 모드: survival, creative, 또는 adventure.
   DIFFICULTY	easy	월드 난이도: peaceful, easy, normal, 또는 hard.
   CHEATS	false	비운영자 플레이어에게 치트(명령어)가 활성화되는지 여부: true 또는 false.

3. 변경하고 싶은 값을 조정합니다. Startup 변수 변경 사항은 다음 서버 시작 시 적용됩니다.
4. Console 탭으로 돌아가 Start를 클릭합니다.
5. 첫 실행 시 서버가 Bedrock Dedicated Server 바이너리를 다운로드합니다 — 파일 크기에 따라 일반적으로 1–3분 정도 걸립니다.
6. 콘솔에서 Server started 또는 IPv4 supported, port:와 같은 메시지가 보이면 서버가 준비된 것이며 상태가 Running으로 표시됩니다.

2단계 — server.properties 구성

server.properties 파일은 Bedrock 서버의 기본 구성 파일입니다. 첫 시작 시 자동으로 생성되며 서버의 루트 디렉터리에 위치합니다.

1. GPanel에서 Console 탭으로 서버를 정지하고 상태가 Offline으로 표시될 때까지 기다립니다.
2. Files 탭을 클릭하고 파일 편집기에서 server.properties를 엽니다.
3. 필요에 따라 아래 값을 편집한 다음 Save Content를 클릭합니다.
4. 변경 사항을 적용하려면 서버를 시작합니다.

최소한의 server.properties 구성 예시:

server-name=My Legion Bedrock Server
gamemode=survival
difficulty=normal
max-players=10
online-mode=true
allow-cheats=false
view-distance=16
tick-distance=4
level-seed=
level-name=Bedrock level
default-player-permission-level=member

3단계 — 플레이어 권한

Bedrock Dedicated Server는 각 플레이어가 무엇을 할 수 있는지 결정하는 3단계 권한 시스템을 사용합니다:

server.properties의 default-player-permission-level은 모든 새 플레이어의 레벨을 설정합니다. 개별 플레이어에게 특정 권한 레벨을 할당하려면 서버 루트 디렉터리의 permissions.json 파일을 편집하세요:

[
  {
    "permission": "operator",
    "xuid": "1234567890123456"
  },
  {
    "permission": "member",
    "xuid": "9876543210987654"
  }
]

각 항목에는 플레이어의 XUID(Xbox User ID)가 필요하며, 이는 Microsoft 계정에 연결된 16자리 숫자입니다. 다음 방법으로 플레이어의 XUID를 찾을 수 있습니다:

• 플레이어가 접속할 때 서버 콘솔 출력을 확인합니다 — 로그 라인에 XUID가 포함되어 있습니다.
• 온라인 타사 XUID 조회 도구를 사용합니다("Xbox XUID lookup" 검색).

허용 목록 (화이트리스트)

서버를 승인된 플레이어로만 제한하려면 서버 루트 디렉터리의 allowlist.json 파일을 편집하고 server.properties에서 allow-list=true로 설정하세요.

[
  {
    "ignoresPlayerLimit": false,
    "name": "PlayerGamertag",
    "xuid": "1234567890123456"
  },
  {
    "ignoresPlayerLimit": true,
    "name": "AdminGamertag",
    "xuid": "9876543210987654"
  }
]

• name — 플레이어의 Xbox/Microsoft 게이머태그(대소문자 구분 안 함).
• xuid — 플레이어의 XUID입니다. 항목이 작동하려면 필요합니다.
• ignoresPlayerLimit — true일 때 이 플레이어는 서버가 가득 차 있어도 접속할 수 있습니다. 관리자에게 유용합니다.

4단계 — 연결 방법

연결하기 전에 GPanel에서 서버 상태가 Running으로 표시되는지 확인하세요. GPanel Console 또는 Network 탭에서 서버의 IP 주소와 포트를 메모하세요.

Windows 10/11에서

1. Microsoft Store / Xbox 앱에서 Minecraft(Bedrock Edition)를 엽니다.
2. 메인 메뉴에서 Play를 클릭합니다.
3. 상단의 Servers 탭을 선택합니다.
4. 맨 아래로 스크롤하여 Add Server를 클릭합니다.
5. 서버 이름(원하는 대로)을 입력한 다음 GPanel에서 가져온 Server Address(IP만)와 Port를 입력합니다.
6. Save를 클릭한 다음 서버를 선택하고 Join Server를 클릭합니다.

모바일에서 (iOS / Android)

1. Minecraft를 열고 Play를 탭합니다.
2. Servers 탭을 탭합니다.
3. 아래로 스크롤하여 Add Server를 탭합니다.
4. GPanel에서 가져온 서버 이름, IP 주소, 포트를 입력합니다.
5. Save를 탭한 다음 서버 항목을 탭하여 연결합니다.

콘솔에서 (Xbox, PlayStation, Nintendo Switch)

Bedrock의 콘솔 에디션에는 Servers 탭에 기본 "Add Server" 버튼이 없습니다. 콘솔에서 커스텀 서버에 연결하려면 다음 방법 중 하나를 사용해야 합니다:

• Featured Server 우회 방법: 일부 콘솔에서는 Friends 탭을 통하거나 featured server 리디렉트를 사용하여 서버를 추가할 수 있습니다. 정확한 단계는 콘솔마다 다르며 Minecraft 업데이트에 따라 변경될 수 있습니다.
• 컴패니언 앱 방법: 동일한 네트워크에서 Minecraft Bedrock 컴패니언 앱이나 DNS 기반 도구(BedrockConnect 등)를 사용하여 featured server 주소를 커스텀 서버 IP로 리디렉트합니다.
• LAN 프록시: 동일한 네트워크의 PC에서 원격 서버를 LAN 게임으로 광고하는 프록시 도구를 실행하여 콘솔의 Friends 탭에 표시되도록 합니다.

5단계 — 월드 관리

월드 파일 위치

Bedrock 월드는 서버의 worlds/ 디렉터리에 저장됩니다. worlds/ 내 폴더 이름은 server.properties의 level-name 값과 일치합니다. 기본적으로 이것은 worlds/Bedrock level/입니다.

기존 월드 업로드

싱글플레이어 저장 또는 다른 서버에서 월드를 업로드할 수 있습니다:

1. GPanel Console 탭에서 서버를 정지합니다.
2. GPanel에서 Files 탭을 열고 worlds/ 디렉터리로 이동합니다.
3. 현재 월드를 교체하는 경우 기존 월드 폴더를 삭제하거나 이름을 변경합니다(예: Bedrock level을 Bedrock level backup으로 변경).
4. GPanel 파일 관리자 또는 SFTP를 통해 월드 폴더를 업로드합니다. 폴더에는 최소한 level.dat 파일과 db/ 디렉터리가 포함되어야 합니다.
5. 업로드한 폴더의 이름을 server.properties의 level-name 값과 일치하도록 변경하거나, level-name을 업로드한 폴더 이름과 일치하도록 업데이트합니다.
6. 서버를 시작합니다. 업로드한 월드가 로드되어야 합니다.

백업

정기적인 백업은 데이터 손실, 손상, 우발적 변경으로부터 보호합니다:

• GPanel 백업: GPanel의 Backups 탭을 확인하세요. 플랜에 따라 자동 백업을 이용할 수 있습니다. 이 탭에서 수동 백업을 생성할 수도 있습니다.
• SFTP를 통한 수동 백업: 서버를 정지하고 SFTP를 통해 연결한 후 전체 worlds/ 디렉터리를 로컬 컴퓨터로 다운로드합니다. 이 복사본을 안전한 위치에 보관하세요.
• 주요 변경 전: 새 월드를 업로드하거나, level-name을 변경하거나, 서버 버전을 업데이트하기 전에는 항상 백업을 생성하세요.

6단계 — 크로스플레이 고려 사항

Bedrock Edition의 핵심 장점 중 하나는 기본 크로스플레이입니다 — 모든 Bedrock 플랫폼이 추가 구성 없이 동일한 서버에서 함께 플레이할 수 있습니다. 그러나 명심해야 할 몇 가지가 있습니다:

• 모든 Bedrock 플랫폼이 호환됩니다. Xbox 플레이어가 휴대폰, Switch, 또는 Windows 10/11 PC 사용자와 함께 플레이할 수 있습니다. 모드나 플러그인이 필요 없습니다 — 크로스플레이는 Bedrock 프로토콜에 내장되어 있습니다.
• Microsoft 계정 필요. online-mode=true(기본값이자 권장 설정)일 때 모든 플레이어는 플랫폼에 관계없이 Microsoft / Xbox Live 계정에 로그인해야 합니다. 로그인하지 않은 플레이어는 참여할 수 없습니다.
• 입력 방식 차이. 콘솔 플레이어는 컨트롤러를, 모바일 플레이어는 터치 컨트롤을, PC 플레이어는 키보드와 마우스를 사용할 수 있습니다. 복잡한 레드스톤 장치나 PvP 경기장을 만들 때 이를 염두에 두세요 — 입력 방식은 서로 다른 플레이 경험을 만듭니다.
• 버전 일치가 중요합니다. 연결하는 모든 클라이언트는 서버와 동일한 Bedrock 버전이어야 합니다. 한 플랫폼의 플레이어가 자동 업데이트되었지만 다른 플레이어는 그렇지 않은 경우, 모든 클라이언트가 서버 버전과 일치할 때까지 함께 플레이할 수 없습니다. 이를 제어하려면 버전 고정(BEDROCK_VERSION Startup 변수)을 사용하세요.
• Java Edition은 호환되지 않습니다. Java Edition 플레이어는 Bedrock 서버에 연결할 수 없습니다. Java와 Bedrock 플레이어를 모두 지원해야 한다면, Java 서버를 위해 Bedrock 프로토콜을 변환하는 Geyser 플러그인이 있는 Java 서버를 실행하는 것을 고려하세요.

문제 해결

서버가 Running으로 표시되지만 아무도 연결할 수 없음

• 올바른 IP 주소와 포트를 별도의 필드에 입력했는지 다시 확인하세요(콜론으로 결합하지 않음).
• 콘솔에서 Server started 메시지를 확인하여 서버가 실제로 완전히 시작되었는지 확인하세요.
• 클라이언트의 Minecraft 버전이 서버 버전과 정확히 일치하는지 확인하세요. 사소한 버전 불일치도 연결을 방해합니다.
• server.properties에서 allow-list가 true로 설정된 경우, 연결하는 플레이어의 XUID가 allowlist.json에 나열되어 있는지 확인하세요.

"Could not connect: Outdated server" 또는 "Outdated client"

이는 클라이언트와 서버가 서로 다른 Bedrock 버전을 실행하고 있음을 의미합니다. 클라이언트를 서버와 일치하도록 업데이트하거나, BEDROCK_VERSION Startup 변수를 클라이언트 버전과 일치하도록 변경하고 서버를 재시작하세요.

업로드 후 월드가 로드되지 않음

• 업로드한 월드 폴더가 추가 하위 디렉터리에 중첩되지 않고 worlds/ 바로 안에 있는지 확인하세요(예: worlds/Bedrock level/level.dat이 올바르고, worlds/Bedrock level/Bedrock level/level.dat은 잘못됨).
• 폴더 이름이 공백과 대소문자를 포함하여 server.properties의 level-name 값과 정확히 일치하는지 확인하세요.
• 월드에 유효한 level.dat 파일과 db/ 디렉터리가 포함되어 있는지 확인하세요.
• Java Edition 월드는 Bedrock 서버와 호환되지 않습니다. 업로드하기 전에 타사 도구(Chunker 또는 Amulet 등)를 사용하여 변환해야 합니다.

성능 문제(렉, 느린 청크 로딩)

• server.properties에서 view-distance를 낮추세요. 10에서 16 사이의 값이 권장됩니다. 기본값 32는 대부분의 호스팅 서버에 매우 높습니다.
• tick-distance를 4(최소값)로 낮추세요. 이는 시뮬레이션 영역을 줄이고 CPU 사용량을 낮춥니다.
• 서버가 자주 정원에 도달하면 max-players를 줄이세요.
• GPanel의 리소스 사용량 그래프를 확인하여 서버가 RAM이나 CPU 한도에 도달하는지 확인하세요. 그렇다면 플랜 업그레이드를 고려하세요.

콘솔 플레이어가 "Add Server" 버튼을 찾을 수 없음

이것은 플랫폼 제한입니다 — Xbox, PlayStation, Nintendo Switch는 모든 사용자에게 "Add Server" 옵션을 기본적으로 노출하지 않습니다. 위 4단계의 콘솔 연결 방법을 참조하세요. 콘솔 접근 설정에 도움이 필요하면 지원 티켓을 열어 주세요.

관련 문서

• Minecraft Java 서버 설정 가이드 — 대신 Java Edition 서버를 실행하는 경우
• 서버 IP 및 포트 찾는 방법
• SFTP를 통한 파일 업로드 방법

여기서 다루지 않은 문제가 발생하면 지원 티켓을 열어 주시면 저희 팀이 도와드리겠습니다.