🖥️전용 서버

서버 PC 최소 사양

항목	최소 요구
운영 체제	Windows 10(1703+)·11, Windows Server 2016+, Ubuntu 18.04+
CPU · RAM	64비트 Intel·AMD 2코어 이상 · 1GB 이상 (인원이 늘면 더 높게)

- **꼭 확인할 점**: 접속하는 모든 사람에게 교육용 라이선스 / 기능 켜기는 Global Admin만 / VM·클라우드에서도 운영 가능

1. Allow Servers 켜기: Admin Portal → Settings에서 토글 ON
2. Add a Server: 서버를 돌릴 PC의 IP 입력 (IPv6 미지원)
3. 이름·패스코드·Broadcast: 학생에게 보일 이름, 입장 패스코드 설정
4. 서버 ZIP 받기: Configured Windows(또는 Linux) server
5. 첫 실행 → Pending: 압축 해제 후 BedrockServer.exe 실행
6. 기기 로그인으로 등록: microsoft.com/devicelogin에 콘솔 코드 입력 학생은 이렇게 들어갑니다

• Broadcast ON: 플레이 → 서버 목록에 자동으로 표시 → 골라서 입장. 학급 전체가 같은 서버를 쓸 때 추천
• Broadcast OFF: 서버 → 서버 추가 → 12자리 서버 ID 직접 입력. 일부 학생만 들어오게 할 때

• 공식 ‘전용 서버 툴링·스크립팅 가이드’에서 Windows 서버 빌드를 받아 압축 해제(교육용 에디션이 설치된 PC)
• 폴더 구성은 일반 베드락 전용 서버와 거의 같음: bedrock_server.exe, server.properties, allowlist.json, permissions.json, behavior_packs, resource_packs, bedrock_server_how_to.html
• server.properties 기본값: server-public-ip=localhost, server-port=20202 (IPv6 미지원). 19132 기본 포트는 쓰지 않기를 권장
• 실행 파일: Windows bedrock_server.exe / Linux bedrock_server_edu → 방화벽 허용 → 창의 링크에 코드 입력해 로그인

1. 서버 폴더에 worlds 폴더를 만들고, 교육용 에디션 월드 폴더에서 쓸 월드를 복사해 넣기
2. 월드 폴더 이름을 알아보기 쉽게 바꾸기(예: 파쿠르 튜토리얼)
3. server.properties 의 level-name= 에 그 폴더 이름을 그대로 적기(기본값 Bedrock level). 월드에 적용된 리소스·행동팩도 함께 들어옴
4. 서버를 실행하고 포털에서 이름·패스코드·Enable(필요하면 Broadcast)을 정하면 게임의 서버 목록에 뜸

• level-seed= 는 새로 만들 때만 쓰임(비우면 무작위). 서버를 끄면 접속한 학생도 모두 나감

• 월드는 게임에서 먼저 만들며 실험 기능(베타 API)과 쓸 행동팩·리소스팩을 켜 둔 뒤 서버로 옮기기
• 행동팩 폴더도 서버의 행동팩 폴더에 복사 → 행동팩 manifest.json header의 uuid = 월드의 world_behavior_packs.json 의 pack_id
• 팩을 하나 더 넣을 때: 항목 { } 를 복사해 하나 더 만들고 새 팩의 uuid로 바꿈 → 콘솔에 Pack Stack 두 개가 뜨면 성공
• 고치기 전에 콘솔에 stop 으로 서버를 멈춤. 명령어가 막히면 allow-cheats=false → true
• 영상은 일반 베드락 전용 서버(2024) 화면. 교육용 서버도 구조는 거의 같음

[
    {
        "pack_id" : "37ecd9df-cd63-4bdd-ba49-fd4def5ca511",
        "version" : [ 1, 0, 0 ]
    }
]

server.properties 수업용 추천값

server-public-ip=192.168.0.10
server-port=20202
allow-list=true
default-player-permission-level=member
allow-commands=true
allow-code-builder=true
gamemode=creative
difficulty=peaceful
max-players=30
view-distance=16
player-idle-timeout=10
disable-custom-skins=true
level-name=우리반월드

밖에서 접속이 안 될 때 점검 순서

1. 모바일 데이터 허용: 앱 설정에서 셀룰러 데이터 ON
2. 공인 IP 확인: curl ip.me → server-public-ip에 입력
3. 공유기 포트포워딩: 내부 IP의 20202 포트, UDP
4. 방화벽 인바운드 규칙: UDP 20202 연결 허용
5. 서버 실행 확인: netstat -an | findstr 20202
6. 외부에서 확인: canyouseeme.org에 공인 IP·포트 입력