BetterAltay로 커스텀 베드락 서버 구축하는 방법

멀티플레이어 마인크래프트 베드락 월드를 운영하다 보면 관리자들은 제한적인 공식 전용 서버와 무거운 서드파티 래퍼 사이에서 고민에 빠지곤 합니다. BetterAltay는 독립적인 PHP 기반 서버 엔진을 제공하여 이러한 문제를 해결하며, 제한적인 호스팅 환경에 갇히지 않고 플러그인, 게임 성능, 커스텀 월드 규칙을 세밀하게 제어할 수 있도록 도와줍니다.

베드락 호스팅에 BetterAltay가 가져다주는 이점

서버 관리에 뛰어드는 대부분의 플레이어는 모장의 바닐라 베드락 데디케이트 서버로 시작합니다. 소수의 친구들과 함께 바닐라 야생 서버를 즐기기에는 충분하지만, 커스텀 미니게임, 엄격한 권한 노드, 커스텀 명령어 구조를 원하게 되는 순간 한계에 부딪히게 됩니다. 바로 그때 커스텀 소프트웨어 코어가 필요해집니다.

BetterAltay는 이전 커뮤니티의 기반, 특히 Altay 프로젝트와 PocketMine-MP 3.28.0의 명맥을 이어받은 포크 버전입니다. 주로 PHP로 구축되었으며, 하단에 무거운 Java 에뮬레이터를 구동하는 오버헤드 없이 확장 가능한 API 레이어가 필요한 서버 운영자를 타겟으로 합니다. 이 저장소는 LGPL-3.0 라이선스 하에 GitHub에서 131개의 스타를 획득했으며, 경량의 PHP 기반 베드락 아키텍처에 대한 꾸준한 관심이 있음을 증명합니다.

마인크래프트 서버에 왜 하필 PHP일까요? 자바 Spigot이나 Paper 포크에 익숙하다면 다소 생소하게 들릴 수 있습니다. PHP는 전용 바이너리 런타임과 결합할 때 비동기 이벤트 기반 엔진 모델을 제공하므로, 월드를 부팅하기 위해 4기가바이트의 힙 메모리를 할당할 필요 없이 가벼운 하드웨어에서도 포켓 서버를 원활하게 구동할 수 있습니다.

바닐라 베드락 대신 선택하는 이유

베드락 서버 관리는 자바 에디션과는 완전히 다른 분야입니다.

이번 달에만 26,437명의 플레이어가 접속 중인 Donutsmp 서버 트래커를 살펴보면, 대규모 네트워크는 일반적으로 특화된 인프라에 의존합니다. 하지만 개인 커뮤니티, 학교 동아리, 혹은 커스텀 야생 월드의 경우 날렵한 독립형 코어를 실행하는 것이 훨씬 실용적입니다.

BetterAltay 인스턴스를 실행해야 하는 실용적인 이유는 다음과 같습니다.

• 레거시 API3 플러그인 지원: 경제 시스템, 토지 소유권, 커스텀 텔레포트 핸들러를 포함하여 PocketMine API3 표준용으로 제작된 광범위한 커뮤니티 빌드 플러그인 생태계를 이용할 수 있습니다.
• 낮은 메모리 사용량: 바닐라 베드락 엔진 바이너리를 실행하지 않기 때문에, BetterAltay는 저가형 VPS 인스턴스를 과부하시키는 렌더링 오버헤드와 불필요한 백그라운드 엔티티 검사를 건너뜁니다.
• 세밀한 설정: 고정된 서버 설정에 갇히는 대신, 표준 설정 파일을 통해 틱 레이트부터 커스텀 패킷 처리에 이르기까지 모든 것을 직접 수정할 수 있습니다.
• 타겟팅된 버그 수정: 1.45.0 태그와 같은 최근 릴리스는 양털의 염료 색상 매핑과 같은 특정 베드락 고유의 문제를 해결하는 동시에, 베드락 v26.50 릴리스까지 호환성을 확장합니다.

BetterAltay 설치 및 실행 방법

BetterAltay를 설정하려면 두 가지 핵심 구성 요소가 필요합니다. 바로 패키징된 서버 아카이브(Phar 파일)와 베드락 패킷 처리에 맞게 미리 컴파일된 PHP 바이너리 번들입니다.

운영체제의 기본 웹 서버 PHP 빌드로 이를 실행하려고 해서는 안 됩니다. 웹 PHP에는 마인크래프트 네트워크 패킷을 처리하는 데 필요한 컴파일된 확장 기능(pthreads 및 pocketmine-chunkutils 등)이 누락되어 있습니다.

1단계: 서버 파일 다운로드

GitHub의 공식 릴리스 페이지에서 컴파일된 서버 phar를 직접 다운로드하세요. 로컬 머신이나 Linux 서버에 서버 전용 폴더를 만듭니다.

mkdir bedrock-server
cd bedrock-server
wget https://github.com/BetterAltayBedrock/BetterAltay/releases/download/1.45.0/BetterAltay.phar

2단계: PHP 바이너리 및 시작 스크립트 확보

다음으로, Benedikt05/PHP-Binaries 저장소를 통해 메인테이너가 제공하는 공식 래퍼 스크립트와 미리 빌드된 바이너리를 가져옵니다. 운영체제에 따라 Linux/macOS에서는 start.sh를 사용하고, Windows에서는 start.cmd(또는 start.ps1)를 사용합니다.

# Linux/macOS의 경우:
chmod +x start.sh
./start.sh

Windows의 경우, 압축을 해제한 PHP 바이너리 폴더를 BetterAltay.phar 옆에 놓고 start.cmd를 더블 클릭하여 기본 설정 파일을 생성합니다.

접속 설정 및 상태 모니터링

서버가 처음으로 부팅되면 표준 server.properties 및 pocketmine.yml 설정 파일이 생성됩니다. 친구들에게 주소를 공유하기 전에 네트워크 포트와 플레이어 권한을 잠금 설정하는 것이 좋습니다.

비공개 야생 월드를 호스팅하는 경우 플레이어 접근 관리가 필수적입니다. 무료 마인크래프트 화이트리스트 생성기를 사용하여 구조화된 권한 목록을 빠르게 생성할 수 있으며, 이를 통해 허용된 사용자 이름을 올바르게 포맷하여 승인되지 않은 계정이 초대 없이 세션에 참여하는 것을 방지할 수 있습니다.

라우터나 방화벽에서 19132번 포트(UDP)를 연 후 외부에서 연결을 확인하세요. 서버 IP와 포트를 당사의 마인크래프트 서버 상태 체커에 입력하여 베드락 인스턴스가 수신 패킷을 받고 정확한 플레이어 수를 반환하고 있는지 확인할 수 있습니다.

팁, 문제점 및 흔히 발생하는 함정

커스텀 서버 코어는 엄청난 유연성을 제공하지만, 바닐라 마인크래프트와 100% 동일한 복사본은 아닙니다. 장기 야생 월드를 마이그레이션하기 전에 이러한 현실을 염두에 두세요.

첫째, 몹 AI와 레드스톤 메커니즘은 모장의 비공개 소스 물리 엔진 대신 커스텀 서버 로직을 통해 구현됩니다. 커뮤니티가 초복잡 피스톤 비행기나 독특한 베드락 레드스톤 타이밍에 의존하는 경우 행동 차이를 느끼게 될 것입니다. 즐겨 사용하는 장치들은 먼저 샌드박스 월드에서 테스트해 보세요.

둘째, 플러그인 선택을 엄격하게 관리하세요. 공개 아카이브에서 API3 플러그인을 널리 사용할 수 있지만, 오래된 플러그인은 더 이상 사용되지 않는 패킷 구조를 타겟으로 할 수 있습니다. 라이브 서버 디렉토리에 로드하기 전에 항상 테스트 포트에서 플러그인 호환성을 확인하세요.

셋째, 정기적인 월드 백업을 유지하세요. BetterAltay는 월드 제공업체 설정에 따라 leveldb 및 anvil 형식을 사용합니다. worlds/ 디렉토리를 백업하는 데는 몇 초밖에 걸리지 않으며 수많은 시간의 좌절을 덜어줍니다.

바닐라 베드락으로 롤백하는 방법

BetterAltay가 그룹에 적합하지 않다고 판단되면 표준 설정으로 돌아가는 것은 간단합니다. BetterAltay는 자체 디렉토리 내에서만 작동하므로 시스템 수준의 후크나 레지스트리 수정이 발생하지 않습니다.

1. 터미널에서 stop 명령어를 실행하여 안전하게 서버를 중지합니다.
2. worlds/ 디렉토리 내부에 위치한 월드 폴더를 안전한 장소로 복사합니다.
3. 모장에서 공식 베드락 데디케이트 서버를 다운로드합니다.
4. 저장된 월드 폴더를 바닐라 서버의 worlds/ 폴더에 넣고 해당 월드 이름을 가리키도록 server.properties를 수정합니다.

   바닐라로 돌아가면 플러그인 기능은 사라지지만 지형, 블록 및 인벤토리 데이터는 그대로 유지됩니다.

   ---

   BetterAltay에 대한 나의 생각

   BetterAltay는 PHP 기반 베드락 소프트웨어의 가벼운 느낌과 빠른 시작 시간을 선호하는 커뮤니티 호스트를 위해 중요한 틈새시장을 채워줍니다. 클래식 API3 플러그인에 대한 접근성을 유지하면서 최신 프로토콜 버전(베드락 v26.50 등)에 대한 지원을 지속적으로 유지하고 있습니다.

   무거운 가상 머신을 실행하지 않고 가벼운 베드락 서버를 완벽하게 제어하고 싶다면, 다음 비공개 멀티플레이어 프로젝트를 위해 BetterAltay를 꼭 한번 살펴보세요.

   BetterAltay를 사용해 볼 준비가 되셨나요?

   소스를 가져오고, 전체 문서를 읽거나, GitHub에 이슈를 열어보세요. 유용하다고 생각된다면 저장소에 스타를 눌러주세요. 메인테이너에게 도움이 되며 다른 마인크래프트 플레이어에게 프로젝트가 노출되는 데 기여합니다.

   GitHub에서 BetterAltayBedrock/BetterAltay 방문하기 ↗