Poly 모드 로더 설치 (플레이어)
설치 프로그램은 공식 Minecraft Launcher에 Poly 모드 로더 <Minecraft 버전> 프로필(예: Poly 모드 로더 26.2)을 추가합니다. 이 프로필로 플레이하면 게임이 Poly 모드 로더를 거쳐 시작됩니다.
Poly 모드 로더는 아직 알파 단계입니다. 아끼는 월드는 먼저 백업해 두세요. 지원하는 Minecraft 버전은 26.1, 26.1.1, 26.1.2, 26.2입니다.
준비
- Minecraft Launcher에서 쓸 버전(예: 26.2)의 바닐라 Minecraft를 한 번 실행했다가 종료합니다. 이때 게임 파일과 런처용 Java가 다운로드됩니다.
- Minecraft Launcher를 닫습니다. 런처가 켜진 채로 설치하면, 런처가 종료되면서 새 프로필을 지워 버릴 수 있습니다.
다운로드
다운로드 페이지에 모든 Poly 모드 로더 빌드와 빌드별 변경 요약이 있습니다. 파일은 GitHub 릴리스에서 받습니다. 빌드마다 파일이 두 개 있습니다.
| 파일 | 사용 환경 |
|---|---|
PolyModLoader-<버전>.exe | Windows. Java를 따로 설치하지 않아도 됩니다(런처가 받아 둔 Java를 사용합니다) |
PolyModLoader-<버전>.jar | macOS, Linux, 또는 Java 17 이상이 설치된 Windows |
설치 프로그램에 아직 코드 서명이 없어서 처음 실행할 때 Windows SmartScreen이 경고를 표시할 수 있습니다. GitHub 릴리스에서 직접 받은 파일이라면 추가 정보 → 실행을 누르세요.
설치
- Windows
- macOS · Linux (.jar)
PolyModLoader-<버전>.exe를 실행합니다.
PolyModLoader-<버전>.jar를 더블클릭하거나 터미널에서 실행합니다.
java -jar PolyModLoader-<버전>.jar
설치 창에서 Minecraft 버전을 고르고 런처 폴더를 확인한 뒤 설치를 누릅니다.
런처 폴더의 기본값은 Windows %APPDATA%\.minecraft, macOS ~/Library/Application Support/minecraft, Linux ~/.minecraft입니다.
메모리. 게임이 쓸 메모리를 고릅니다.
- 최대 메모리 (-Xmx): PC 메모리에 맞춰 값을 미리 골라 둡니다(8GB면 4G, 16GB 이상이면 6G). 런처 기본값을 고르면 런처 설정(2G)을 그대로 씁니다.
- 시작 메모리 (-Xms): 보통은 지정 안 함으로 둡니다.
이 값은 런처 프로필의 JVM 인수에 들어가므로, 나중에 런처에서 바꿀 수 있습니다. 거기에 따로 적어 둔 다른 JVM 인수는 그대로 남습니다.
설치가 끝나면 설치 여부를 알림으로 알려 줍니다. 알림을 누르면 mods 폴더가 열립니다. 설치 프로그램은 저절로 닫힙니다. 열어 두려면 완료되면 설치 프로그램 닫기를 끄세요. 읽어야 할 경고가 있을 때도 닫히지 않습니다.
설치 프로그램은 다음 작업을 합니다.
- Poly 모드 로더 파일을 런처 폴더의
libraries/에 넣습니다. versions/polymodloader-<버전>-<Minecraft 버전>/버전을 만듭니다. 바닐라 게임 파일은 그대로 쓰고, 시작할 때만 Poly 모드 로더를 거칩니다.launcher_profiles.json에 Poly 모드 로더 <Minecraft 버전> 프로필을 추가합니다. 다른 프로필은 건드리지 않으며, 수정하기 전의 파일은launcher_profiles.json.polymodloader-backup으로 남겨 둡니다.mods/폴더를 만듭니다.
다시 설치하면 프로필을 고치거나 새 Poly 모드 로더 버전으로 바꿉니다. 다른 Minecraft 버전으로 설치하면 프로필이 하나 더 생깁니다.
플레이
- Minecraft Launcher를 엽니다.
- 플레이 버튼 옆 목록에서 Poly 모드 로더 <Minecraft 버전> 프로필을 골라 플레이합니다.
- 모드는 런처 폴더의
mods/에 넣습니다.
mods/에 넣은 jar | 처리 방식 |
|---|---|
Poly 모드(poly.mod.json이 있는 jar) | 로드합니다 |
| Fabric 모드 | Mixin을 쓰는 모드를 포함해 로드합니다. 실행할 수 없는 모드는 빼고 이유를 로그에 남깁니다. 클라이언트에서 인기 Fabric 모드를 26.2는 실제 모드 138개, 26.1은 126개(각각 테스트 모드 2개를 더해 140개, 128개) 함께 넣고 저장된 월드를 플레이하고 저장한 뒤 나오는 것까지 확인했습니다. 모드마다 기능을 확인하지는 않았습니다. 호환성을 보세요 |
| Forge 모드 | 로드합니다. Poly 모드 로더가 Forge를 직접 실행하며, Forge 모드를 넣고 처음 실행할 때 Forge 파일을 내려받습니다. Forge가 거부할 모드는 빼고 이유를 로그에 남깁니다(POLY-COMPAT-209). 클라이언트에서 인기 Forge 모드를 함께 넣고(26.2는 40개) 저장된 월드를 플레이하고 저장한 뒤 나오는 것까지 확인했고, Fabric 모드와 함께도 됩니다. 모드마다 기능을 확인하지는 않았습니다. Fabric 모드와 Forge 모드 함께 쓰기를 보세요 |
| NeoForge 모드 | 기본적으로 로드하지 않고 이유를 로그에 남깁니다. 기본값이 꺼진 실험 기능으로 -Dpoly.neoforge=on을 주면 로드하지만, 아직 26.2 서버에서만 확인했고 Fabric 모드와 함께는 안 됩니다 |
quilt.mod.json만 있는 Quilt 모드 | 아직 로드하지 않습니다(POLY-DISCOVERY-002). fabric.mod.json도 든 Quilt 모드는 Fabric 모드로 실행합니다 |
타이틀 화면 왼쪽 아래, 게임 버전 위에 로더별로 로드한 모드 수가 게임 언어로 나옵니다(예: Poly 모드: 2개, Fabric 모드: 14개). 모드가 없는 로더는 줄이 없습니다. Forge 모드가 있으면 그곳에 있는 Forge의 줄 위에 나옵니다.
접속하는 서버에도 있는 모드라면 서버와 클라이언트에 같은 버전을 넣어야 합니다.
명령줄로 설치
.jar는 창 없이 명령줄로도 사용할 수 있습니다.
java -jar PolyModLoader-<버전>.jar install # 기본 런처 폴더에 설치
java -jar PolyModLoader-<버전>.jar install --minecraft <Minecraft 버전> # Minecraft 버전 지정(기본값: 가장 새 버전)
java -jar PolyModLoader-<버전>.jar install --dir <런처 폴더> # 다른 폴더(런처 설치 위치를 바꾼 경우)
java -jar PolyModLoader-<버전>.jar install --no-profile # 버전만 설치하고 프로필은 만들지 않음
java -jar PolyModLoader-<버전>.jar install --max-memory 6G --min-memory 1G # 게임 메모리(-Xmx, -Xms)
java -jar PolyModLoader-<버전>.jar uninstall # 제거
java -jar PolyModLoader-<버전>.jar --help
제거
설치 프로그램에서 제거를 누르거나 uninstall을 실행하면 Poly 모드 로더 버전, 프로필, 파일이 삭제됩니다. mods/ 폴더와 월드는 그대로 남습니다.
문제가 생기면
| 증상 | 조치 |
|---|---|
| 런처에 Poly 모드 로더 프로필이 없음 | 런처를 닫고 다시 설치합니다. 런처 폴더를 바꿨다면 설치 프로그램에서 그 폴더를 지정합니다 |
.exe가 "Java를 찾지 못했습니다"라고 알림 | 런처에서 바닐라 Minecraft를 한 번 실행한 뒤 다시 시도하거나, .jar를 Java 17 이상으로 실행합니다 |
| 게임이 시작하자마자 꺼짐 | 런처 폴더의 logs/latest.log에서 POLY-로 시작하는 오류 코드를 찾아 오류 코드에서 뜻을 확인합니다. 모드가 원인이면 mods/에서 빼고 다시 실행합니다 |
POLY-BOOTSTRAP-006 | 설치 프로그램으로 다시 설치합니다 |
로그에 POLY-COMPAT-133 | Fabric 모드의 Mixin이 게임 클래스에 적용되지 못했습니다. 메시지에 모드 이름이 나옵니다. 그 모드를 빼거나 새 버전을 찾아보세요 |
Poly 모드 로더는 시작할 때 런처 폴더의 .poly/startup-report.json에 보고서를 씁니다. 문제를 알릴 때 이 파일을 함께 보내 주세요.
전용 서버
같은 설치 프로그램으로 서버도 설치합니다. 서버에는 Java 25 이상이 필요합니다.
- 설치 프로그램을 열고 서버를 고른 뒤 서버 폴더를 정합니다.
- Minecraft 버전과 서버 메모리를 고르고 설치를 누릅니다.
설치 프로그램이 그 버전의 Mojang 서버를 받아 확인하고, 옆에 Poly 모드 로더 파일을 둔 뒤 세 파일을 씁니다.
run.bat(Windows)과run.sh: 고른 메모리로 서버를 시작합니다.polymodloader-server.jar: 어느 호스팅에서나 시작할 수 있습니다.java -Xmx4G -jar polymodloader-server.jar nogui
처음 시작하면 Minecraft EULA 확인에서 멈춥니다. EULA를 읽고 eula.txt에 eula=true로 적은 뒤 다시 시작하세요. 설치 프로그램이 대신 동의하지 않습니다.
모드는 서버 폴더의 mods/에 넣습니다. 같은 폴더에 다시 설치하면 Poly 모드 로더만 새 버전으로 바뀌고 월드, 설정, 모드는 그대로 남습니다.
화면이 없는 서버에서는 명령줄을 씁니다.
java -jar PolyModLoader-<version>.jar install-server # 지금 폴더에 설치
java -jar PolyModLoader-<version>.jar install-server --dir <서버 폴더> --minecraft <Minecraft 버전> --max-memory 4G