클라이언트 배포

서버가 플레이어에게 특정 버전의 클라이언트나 특정 모드 설치를 요구한다면, 신규 플레이어가 더 쉽게 서버에 들어올 수 있도록 클라이언트를 받을 방법을 먼저 제공해야 한다.

Java 에디션

JRE 제공 방법

이 튜토리얼의 다른 문서에서 Minecraft Java 에디션에서 JRE가 얼마나 중요한지 자세히 설명했지만, 서버 운영자의 플레이어가 모두 컴퓨터를 잘 아는 건 아니다. 자기 컴퓨터에서 Minecraft가 어떻게 돌아가는지 모르는 플레이어도 있다. 친구나 유료 업체가 원격으로 Java 환경을 깔아 준 플레이어도 있고, 모드팩에 들어 있는 JRE만 계속 써 온 플레이어도 있다. 그래서 서버에 따라서는 누구나 따라 할 수 있는 JRE 설치 안내나 환경을 제공하는 게 꼭 필요하다.

모드팩에 포함하기

서버 전용 클라이언트 모드팩을 만들어 제공한다면, 모드팩에 JRE를 포함하는 방법이 편리하고 적극 추천할 만하다.

아래에서는 HMCL을 예로 Windows용 모드팩에 JRE를 포함하는 방법을 설명하고, 다른 런처에도 쓸 수 있는 일반적인 방법도 소개한다.

Windows용 JRE 다운로드: 모드팩에 특별한 JRE 요구 사항이 없다면 Adoptium Temurin이나 Azul Zulu에서 x64 아키텍처용 압축판(사이트에 따라 “zip” 버전으로 제공) JDK를 받으면 된다. 이 JDK들은 용량이 작아서 모드팩에 넣기 좋다.

모드팩이 JRE를 엄격하게 요구한다면(예: 반드시 Oracle JDK를 써야 하는 경우) 다음과 같은 일반적인 방법으로 압축판 배포 파일을 찾을 수 있다.
- 해당 JDK 제공 업체의 공식 웹사이트를 연다.
- “Downloads”, “Releases”, “Archives”와 관련된 페이지를 찾는다.
- 다운로드 페이지에서 플랫폼은 Windows, 아키텍처는 x64(또는 amd64)를 고르고, 확장자가 .zip, .7z, .tar.gz인 파일을 찾는다.
- 그 파일이 JDK 또는 JRE이고, 원하는 Java 버전(예: 17, 21)인지 확인한다.
- 받은 뒤 압축을 풀어 폴더째로 모드팩에 넣으면 된다.
보통 압축판 JDK에는 bin/javaw.exe가 들어 있으니, 런처가 이 경로를 가리키게 설정하면 된다. 압축판을 찾을 수 없다면 해당 JDK의 문서를 찾아보거나 커뮤니티가 관리하는 미러 사이트(예: Adoptium, MCL Mirror 등)에서 맞는 버전을 찾아보자.
모드팩 디렉터리에 압축 해제. HMCL 기준 구조는 다음과 같다.
- 디렉터리MyModpack
  - 디렉터리java
    bin
  - HMCL.exe
  - hmcl.json
  - .minecraft
런처 설정 조정: HMCL 기준으로 버전 관리로 가서 버전별 게임 설정 사용(다른 게임 버전에 영향 없음) 이 켜져 있는지 확인하고, 게임 Java에서 Java 버전 지정을 고른 뒤 같은 줄 오른쪽 입력란에 다음을 적는다.
Terminal window
```
./java/bin/javaw.exe
```
경로 형식을 어느 정도 안다면 모드팩에 포함한 Java의 위치를 상황에 맞게 바꿔도 된다. 런처에 적은 Java 경로가 제대로 가리키기만 하면 된다.
저장한 뒤 게임을 실행해 테스트: 이제 게임은 시스템 Java 대신 내장 Java로 실행된다. 런처 “설정” 페이지에서 현재 Java 경로를 다시 확인해, 모드팩 안의 java/bin/javaw.exe를 가리키는지 확인하자.
패키징할 때는 런처 설정 파일도 함께 넣는 것을 권한다(예: HMCL의 hmcl.json. 일부 운영체제에서는 숨김 파일이라 파일 관리자 설정을 바꾸지 않으면 보이지 않는다). 그래야 설정이 유지되어 플레이어가 다시 설정할 필요가 없다. 가볍거나 기능이 부족한 서드파티 런처(일부 개조 런처 포함)에서는 명령줄 실행 스크립트로 JRE를 지정할 수 있다.

예를 들어 배치 스크립트 start.bat으로 Minecraft를 실행한다.
Terminal window
```
@echo off
set JAVA_PATH=%~dp0jre\bin\javaw.exe
%JAVA_PATH% -jar launcher.jar
```
주의
모드팩에 Java를 포함할 때의 라이선스 위험
1. 재배포를 허용하지 않는 JDK도 있다. 이런 JDK를 모드팩에 넣어 공개 배포하면 안 된다(커뮤니티 안에서만 공유하거나 공식 사이트 또는 클라우드 저장소 다운로드를 안내하는 경우는 제외). 재배포를 금지하는 대표적인 JDK로 Oracle JDK가 있다.
2. Java 파일 구조를 잘 알아서 필요 없는 파일 일부를 지우고 싶더라도 원본 라이선스 파일과 저작권 정보는 지우면 안 된다. 사정상 꼭 지워야 하거나 이미 없어졌다면 모드팩을 공개 배포하지 말자.
3. 모드팩에 여러분의 개발 팀이 만들었거나 대리 판매하는 유료 소프트웨어(유료 모드 등)가 들어 있어 플레이어가 돈을 내고 받아야 한다면, 라이선스에서 유료 또는 상업적 배포를 금지하는 JDK는 포함하지 말자.

JDK 설치 파일 다운로드 제공

플레이어가 여러분처럼 직접 컴퓨터에 Java를 설치하게 하는 방법이다. 여건이 된다면 모드팩을 직접 만들어 Java를 포함하는 것을 권한다. 컴퓨터 지식이 거의 없는 초보 플레이어는 혼자서 Java를 제대로 설치하지 못할 수도 있기 때문이다.

먼저 플레이어에게 추천할 설치 파일을 직접 받아 두는 게 좋다. 이때 Windows 플레이어용 다운로드 링크는 .msi나 .exe 확장자의 설치 프로그램을 고르자.

직접 링크

플레이어에게 추천할 JDK의 공식 배포 페이지에서 다운로드 버튼을 찾아 우클릭하고 링크 복사를 누른다. 보통 이렇게 하면 JDK 직접 다운로드 링크가 클립보드에 복사된다. 이 링크를 커뮤니티나 공식 공지에 올리면 플레이어가 링크를 눌러 브라우저에서 바로 JDK 설치 파일을 받을 수 있다.

어떤 JDK 공식 사이트는 고정된 직접 링크가 없어서 이 방법이 통하지 않는다. 이럴 때는 서드파티 JDK 미러 사이트에서 같은 방법으로 직접 링크를 구할 수 있다.

커뮤니티 파일 공유

서버에 채팅 커뮤니티가 있고, 그 플랫폼이 파일을 오래 보관해 멤버가 받을 수 있게 해 준다면 이 기능을 잘 활용하자. JDK 설치 파일을 올려 두면 초보 플레이어가 질문할 때마다 거기서 받으라고 안내할 수 있다.

클라우드 저장소

대부분의 JDK 공식 다운로드 서버가 해외에 있어서, JDK를 받을 때 다운로드가 느리거나 여러 번 시도해도 계속 실패하는 플레이어가 있을 수 있다. 다른 커뮤니티 기여자가 제공하는 JDK 클라우드 저장소 링크를 알고 있다면 예비 다운로드 경로로 제공하자. 자기 클라우드 저장소 계정이나 서버에 JDK 설치 파일을 올려 공개 다운로드로 설정해도 된다. 링크를 얻었으면 플레이어 공지나 문서에 JDK 공식 다운로드 링크와 함께 올려 두자.

전용 클라이언트를 설치해야 다운로드할 수 있거나, 무료 사용자 속도를 심하게 제한하는 클라우드 저장소는 피하자. 신규 플레이어의 경험을 크게 떨어뜨려서, JDK를 받고 설치하는 사이에 새로 시작하는 설렘이 다 사라진다. 게다가 이런 저장소 때문에 떠나 버리는 긱 정신이 있는 플레이어도 있을 수 있다.

서버 공식 웹사이트에서 다운로드

자기 웹 서버에서 JDK 다운로드를 제공한다면 직접 링크를 주거나 다운로드 페이지를 만들어 제공하면 된다. 공식 웹사이트를 직접 만들지 않았다면 사이트를 맡은 운영 담당자와 상의하자.

공식 다운로드 페이지 안내

직접 링크를 찾기 어려울 때만 공식 다운로드 페이지를 플레이어에게 보내고, 버전 고르는 법을 자세히 알려 준다. 플레이어가 정확히 이해할 수 있도록 어떤 버튼을 차례로 눌러야 하는지 하나하나 짚어 주는 튜토리얼을 쓰자.

이 방법은 권하지 않는다. 어떻게 써도 튜토리얼을 잘못 이해하고 엉뚱한 JDK를 받아 게임이 실행되지 않는 플레이어가 나오고, 그 플레이어가 오류 화면을 폰으로 찍어 커뮤니티에 올리는 불필요한 수고가 생긴다.

플레이어가 알아서 찾게 하기

권하지 않는다. 특히 모드 서버라면 신규 플레이어가 커뮤니티에 줄줄이 질문하게 될 수 있다. 서버가 숙련자만 받기로 정한 게 아니라면 일반 플레이어를 위한 JDK 다운로드와 설치 안내를 마련하는 게 좋다.

모드팩 다운로드

최신 버전이나 대형 모드팩은 용량이 매우 크고, 받는 데 트래픽도 많이 들어서 다운로드를 제공하는 서버에 어느 정도 부담이 된다.

다른 사람이 만든 모드팩

저작권 분쟁을 피하려면 해당 모드팩의 공식 다운로드 경로(원작자가 제공하는 CurseForge, GitHub, 클라우드 저장소 등)를 안내하는 것을 강력히 권한다. 일반 플레이어가 공식 경로에서 받기 어려울 가능성이 크다면(예: GitHub에 접속하기 어렵거나 어떤 클라우드 저장소가 무료 사용자 속도를 제한하는 경우) 커뮤니티 안에서 비공개로 공유하는 방식으로 배포하자.

재배포로 볼 수 있는 방식으로 제공하면(특히 원작자가 이미 클라우드 저장소 다운로드를 제공하는데 자기 클라우드 저장소 계정으로 다시 공유하고, 심지어 원작자도 밝히지 않는 경우) 불필요한 문제를 떠안을 수 있다. 꼭 이런 방식으로 제공해야 한다면 먼저 원작자에게 연락해 허락을 받자.

직접 만든 모드팩

커뮤니티 파일 공유(자체 모드팩)

추천. 직접 만든 모드팩은 보통 커뮤니티 파일 공유로 먼저 배포하는 것을 권한다.

클라우드 저장소(자체 모드팩)

공유할 때 전용 클라이언트를 설치해야 다운로드할 수 있거나, 무료 사용자 속도를 심하게 제한하는 클라우드 저장소는 피하자.

서버 공식 웹사이트에서 다운로드(자체 모드팩)

구축 방법은 서버 공식 웹사이트에서 다운로드와 같다.

모드팩은 용량이 매우 크므로, 웹 서버의 트래픽이 무제한이고 대역폭이 넉넉하며 국내에서 직접 접속해도 빠르고 안정적이거나, 트래픽이 충분한 CDN을 이미 설정해 둔 경우에만 고려하자.

런처에서 모드팩을 바로 내보내거나 모드 목록만 제공하기

예비 수단으로만 권한다. 플레이어가 리소스 찾기부터 게임 설치까지 전부 알아서 해야 한다. 기초 지식 없이 그냥 서버에서 놀고 싶은 초보에게는 이 난이도가 상당히 부담스럽고, 커뮤니티에 질문이 쏟아지며, 신규 플레이어 이탈률이 눈에 띄게 올라갈 수도 있다.

Bedrock 에디션 클라이언트 다운로드

안드로이드 휴대폰

커뮤니티 파일 공유에 설치 파일 올리기

가장 추천. 거의 모든 플레이어가 무리 없이 설치 파일을 받을 수 있다. 다만 서버가 업데이트되면 관리자가 올려 둔 설치 파일도 제때 바꿔야 한다.

Windows 컴퓨터

보통 Windows 플레이어에게는 설치를 안내할 필요가 없다. 정상적으로는 Windows용 Bedrock 에디션을 유료로 구매(정품 계정)해야만 플레이할 수 있기 때문이다. 다만 어떤 플레이어가 “컴퓨터로도 할 수 있어요?”라고 묻는다면 “할 수 있지만 정품이 필요하다”라고 답하면 된다.

주의할 점이 있다. 보통 컴퓨터로 Bedrock 에디션을 할 수 있는지 모르는 플레이어라면 정품이 없을 가능성이 크고, Minecraft 각 에디션의 차이조차 모를 수도 있다. 이런 플레이어가 Windows에서 Bedrock 에디션을 플레이하도록 안내하려면 시간과 에너지가 엄청나게 든다.

서버가 최신 Bedrock 에디션 클라이언트를 지원하지 않는다면, 플레이어가 Microsoft Store에서 새로 받은 클라이언트로는 서버에 들어올 수 없다. 이럴 때는 Windows 플레이어에게 클라이언트를 다운그레이드할 구버전 설치 파일을 제공해야 한다. 안드로이드나 iOS와 달리 Windows의 UWP 앱 설치 파일인 Appx는 구버전을 덮어 설치할 수 있다. 그러니 안심하고 플레이어에게 설치 파일을 더블클릭해 그대로 덮어 설치하라고 안내하면 된다. 플레이어의 데이터는 모두 그대로 남는다.

Windows용 설치 파일을 받은 뒤에는 안드로이드 설치 파일과 같은 방식으로 플레이어에게 배포하면 된다.

iOS

iOS는 시스템 제약 때문에 Bedrock 에디션을 설치하는 문턱이 높다. 현재 iOS 플레이어에게 적은 비용으로 설치 방법을 제공할 수 있는 방안은 없다.

Windows용 iTunes 12.6.5 패킷 캡처 다운그레이드

먼저 패킷 캡처 다운그레이드 방식으로 자기 Apple ID 서명이 들어간 ipa를 얻는다. 이 설치 파일은 자기 Apple ID로 로그인한 모든 기기에 바로 설치할 수 있고, 만료되지 않으며, 서명이 필요 없고, 설치한 뒤 계정 로그인도 정상적으로 된다. 다만 모르는 사람의 기기에 바로 설치할 때 어떤 제약이 있는지는 아직 알려지지 않았다.

네티즌들이 공유한 바에 따르면, 그다음 ipa를 별도 소프트웨어로 바로 서명하면 해당 계정으로 로그인한 기기에 설치할 수 있다. 이렇게 다시 서명한 설치 파일에서 Microsoft 계정 로그인 시 “Drowned” 오류가 다시 나타나는지는 아직 알 수 없다.

macOS/Linux/Android/iOS 플레이어를 위한 Java 에디션 지원

서버 운영자들 사이에서는 보통 이런 운영체제를 쓰는 플레이어는 컴퓨터 기초 지식이 어느 정도 있다고 가정한다. 서버 문서나 공지에서 이런 운영체제에서의 게임 다운로드와 설치 방법은 다루지 않아도 된다. Java는 원래 크로스플랫폼이라, 대개 플레이어가 아는 지식으로 게임 디렉터리 구조 등을 조금만 고치면 게임을 실행해 서버에 들어올 수 있다. 다만 플레이어들이 흔히 묻는 문제는 다음과 같다.

일부 모드는 Windows가 아닌 시스템에서 충분히 테스트되지 않아 실행되지 않을 수 있다.
macOS에서 zip END header not found 오류: 게임의 mods 디렉터리에서 find . -name '._*' -type f -delete를 실행하게 한다.
macOS 플레이어가 모드팩 압축을 풀지 못하면 App Store에서 MacZip이나 The Unarchiver를 받아 풀게 한다.