Poly 모드 로더 소개
Poly 모드 로더는 하나의 mods 폴더에서 Fabric, NeoForge, Forge, Quilt, Poly 모드를 실행하는 Minecraft: Java Edition 모드 로더입니다. 한 번 설치한 뒤 공식 Minecraft Launcher에서 Poly 모드 로더 프로필을 고르고, 받은 모드 .jar 파일을 mods/ 폴더에 넣으면 됩니다.
- 로더 하나씩 쓰기 — 지원. Minecraft 26.1, 26.1.1, 26.1.2, 26.2, 26.3에서 Fabric, NeoForge, Forge, Quilt, Poly 모드가 모두 실행됩니다.
- 로더 섞어 쓰기 — 일부 지원. Fabric과 Quilt 모드는 함께 실행되며, Forge 모드나 NeoForge 모드와도 한
mods/폴더에 같이 넣을 수 있습니다. 다만 mixin이 그 로더의 패치와 맞지 않는 Fabric·Quilt 모드는 게임 시작 전에 제외되고(POLY-COMPAT-224), 빠진 모드 수가 타이틀 화면에 표시됩니다(Fabric 모드와 Forge 모드 함께 쓰기). Forge 모드와 NeoForge 모드는 아직 한 게임에서 함께 실행되지 않습니다(POLY-COMPAT-221). Minecraft 26.3에서도 1.2.5부터 로더를 섞어 쓸 수 있습니다(1.2.4에서는 게임이 시작에서 멈췄습니다). - 시작 전 자동 점검. 게임을 시작하기 전에
mods/의 모든 모드를 확인합니다. 실행할 수 없는 모드만 빼고 어떤 모드를 왜 뺐는지logs/latest.log에 오류 코드(POLY-…)로 남기므로, 나머지 모드는 그대로 시작됩니다.
Poly 모드 로더 1.4.0는 Minecraft 26.1, 26.1.1, 26.1.2, 26.2, 26.3에서 실행됩니다. 이 문서의 예시는 Minecraft 26.2 기준입니다.
정식 버전
Poly 모드 로더 1.4.0은 정식 버전입니다. 새 모드를 넣기 전에 소중한 월드는 백업해 두세요.
어디서 시작할까요
모드로 플레이하려면 설치 프로그램만 있으면 됩니다. 프로그래밍은 필요 없습니다.
설치설치 프로그램을 받아 Minecraft Launcher에 프로필을 추가하고 모드를 넣습니다지원 버전과 로더어떤 Minecraft 버전에서 어떤 모드가 실행되는지Fabric과 Forge 함께 쓰기두 종류의 모드를 한 게임에 넣는 방법, 되는 것과 아직 안 되는 것플레이어 질문쓸 수 있는 모드, 서버, 월드 백업, 제거 방법
모드를 만들려면 Poly 모드를 만듭니다. Poly 모드 로더의 자체 API인 Native API로 만든 모드입니다.
요구 사항모드를 만들 때 필요한 JDK와 Minecraft 파일첫 Poly 모드 만들기크리스털이 자라는 모드 Crystal Garden을 빈 프로젝트부터 게임 테스트 통과까지 만듭니다Native API영역별로 가장 자주 쓰는 코드와 규칙오류 코드POLY-… 코드의 뜻과 조치
지금 실행되는 것
| 모드 | 상태 |
|---|---|
| Fabric 모드 | 지원. 26.1, 26.1.1, 26.1.2, 26.2, 26.3에서 Fabric 모드가 Fabric Loader에서와 같은 방식으로 실행됩니다. 26.1과 26.2에서 인기 Fabric 모드를 함께 넣고 시험했습니다. 26.2에서는 Sodium, Iris, JEI, Fabric API를 포함한 138개가 저장된 월드를 열어 저장하고 나오며, 100개로 실제 전용 서버가 시작됩니다. 모드마다 기능을 하나하나 확인하지는 않았습니다 |
| NeoForge 모드 | 지원. Poly 모드 로더가 NeoForge와 그 로더 FML을 그대로 실행하며(26.1은 NeoForge 26.1.0.19-beta, 26.1.1은 26.1.1.15-beta, 26.1.2는 26.1.2.122, 26.2는 26.2.0.93, 26.3은 26.3.0.98), NeoForge 파일은 처음 시작할 때 자동으로 받습니다. 26.1, 26.1.2, 26.2에서 인기 NeoForge 모드를 함께 넣고 시험했습니다. 26.2에서는 Sodium, Iris를 포함한 54개가 저장된 월드를 열어 저장하고 나오며, 서버에서는 월드를 만들어 저장하고 실제 전용 서버가 시작됩니다. 설치한 런처 프로필과 서버에서도 실행됩니다. 빠지는 모드는 NeoForge도 실행하지 못하는 경우뿐입니다. 모드마다 기능을 하나하나 확인하지는 않았습니다 |
| Forge 모드 | 지원. Poly 모드 로더 안에서 Forge 자체가 실행되며(26.1은 Forge 62.0.9, 26.1.2는 64.1.5, 26.2는 65.1.5, 26.3은 66.1.0), Forge 파일은 처음 시작할 때 자동으로 받습니다. 26.1과 26.2에서 인기 Forge 모드를 함께 넣고 시험했습니다. 26.2에서는 40개가 저장된 월드를 열어 저장하고 나오며, 서버에서는 월드를 만들어 저장하고 실제 전용 서버가 시작됩니다. 빠지는 모드는 Forge도 거부하는 경우뿐입니다. 모드마다 기능을 하나하나 확인하지는 않았습니다 |
| Quilt 모드 | 지원. 26.1, 26.1.1, 26.1.2, 26.2, 26.3에서 실행되며, Fabric 모드와 함께 넣을 수 있습니다. 26.1, 26.1.2, 26.2에서 버전마다 Modrinth의 Quilt 전용 빌드 전체(26.2는 114개)로 클라이언트, 게임 테스트 서버, 전용 서버에서 시험했고, 실제 Quilt Loader와도 비교했습니다. 빠지는 모드는 Quilt Loader에서도 로드되지 않거나 실행되지 않는 경우뿐입니다. Quilt Standard Libraries(QSL)가 필요한 모드는 QSL의 26.x 판이 없어 실행에서 뺍니다. Fabric 판도 함께 든 모드는 Fabric 모드로 실행합니다. 모드마다 기능을 하나하나 확인하지는 않았습니다 |
| 로더 섞어 쓰기 | 일부 지원. Fabric·Quilt 모드를 Forge 모드 또는 NeoForge 모드와 한 mods/ 폴더에 함께 넣을 수 있습니다. 다만 mixin이 그 로더의 패치와 맞지 않는 Fabric·Quilt 모드는 시작 전에 제외되고 타이틀 화면에 수가 표시됩니다(POLY-COMPAT-224). 26.2에서는 Forge 옆에서 빠지는 Fabric API 모듈은 없지만 Architectury, Balm, Lithium이 빠지고(1.2.5, 2026-10-28: 다른 로더의 모드 88개 로드, 78개 제외), NeoForge 옆에서는 Fabric API 모듈 10개가 빠집니다(2026-10-27: 40개가 NeoForge 모드 40개와 함께 로드, 76개 제외). 두 실행 모두 게임 테스트 서버에서 월드를 만들고 GameTest를 통과해 저장합니다. Forge 모드와 NeoForge 모드는 아직 한 게임에서 함께 실행되지 않습니다(POLY-COMPAT-221). Minecraft 26.3에서도 1.2.5부터 됩니다(헤드리스, 2026-10-28). 1.2.4에서는 게임이 시작에서 멈췄습니다 |
| Poly 모드 | 지원. 싱글플레이와 전용 서버에서 실행됩니다 |
| 설치와 플레이 | 상태 |
|---|---|
| Minecraft 버전 | 26.1, 26.1.1, 26.1.2, 26.2, 26.3 |
| 설치 프로그램 | Windows, macOS, Linux용 .jar. 공식 Minecraft Launcher에 프로필을 추가하고, 전용 서버도 설치할 수 있습니다 |
| 클라이언트·전용 서버 | 둘 다 Poly 모드 로더를 거쳐 시작합니다. 클라이언트는 저장된 월드를 여는 데까지, 전용 서버는 Minecraft EULA 확인 단계까지 자동으로 시험합니다 |
로더별 기술적인 내용(Mixin, 중첩 jar, NeoForge 실행 방식)은 호환성에, 아직 없는 것은 아직 없는 기능에 있습니다.
모드 개발자를 위한 정보
공개 API는 모두 PREVIEW 등급이어서 버전이 바뀔 때 달라질 수 있습니다. 모드 개발자는 모드 템플릿에서 시작하며, Poly 모드 로더는 Gradle이 웹사이트의 Maven 저장소에서 다운로드합니다. 자세한 내용은 모드 템플릿 받기를 참고하세요. 모드는 Java 25로 빌드합니다.
Poly 모드로 만들 수 있는 것
Poly 모드는 게임 내부 클래스 대신 Native API로 콘텐츠를 추가합니다. Native API에는 Minecraft 타입이 없고, 게임 버전마다 Poly 모드 로더의 게임 계층이 이를 구현합니다.
콘텐츠블록(상태 속성, 블록 엔티티, 메뉴), 아이템과 데이터 컴포넌트, 음식, 투사체, 상태 효과, 게임 규칙, 사운드, 파티클몹과 게임플레이AI 목표, 상자 모델과 애니메이션, 탈것, 자연 스폰, 피해 이벤트, 발전 과제월드월드 저장소, 작업 예약, 코드 바이옴과 지형 생성기, 데이터 차원·구조물, 청크 강제 로드클라이언트키 바인딩, HUD, 모드 화면, 블록 엔티티 그리기, 후처리 셰이더, 동적 텍스처네트워크와 운영페이로드 채널, 동기화 데이터, 명령어와 권한, 리로드 리스너, 데이터 버전, 자동 월드 백업게임 내 테스트모드가 등록한 테스트를 Mojang 게임 테스트 서버에서 창 없이 실행합니다
개발 쪽에서 지금 되는 것
| 항목 | 상태 |
|---|---|
| Poly 모드 | poly.mod.json 검증, 의존성 해석, common/client/server 엔트리포인트 |
| Native API | 콘텐츠, 월드·엔티티, 명령어, 네트워크, 클라이언트, 리소스·운영, 게임 내 테스트 (모두 PREVIEW) |
| 클래스 변환 | 사전 계획, descriptor·바이트코드 사전조건 검증, 충돌 거부, 변환 캐시 |