본문으로 건너뛰기
버전: Minecraft 26.2

오류 코드

Poly 모드 로더는 문제를 POLY-영역-번호 코드로 알립니다. 시작 단계에서 오류 수준 문제가 생기면 그 단계에서 실행을 멈추고(Poly 모드 로더 launch stopped in phase …), 실행 중 콜백에서 생기면 영역에 따라 기록만 남기고 계속하거나 그 기능만 끕니다.

로그에서 코드를 찾은 뒤 아래 표에서 영역을 고르세요. 로그 위치와 보고서는 문제 해결에 있습니다.

영역 한눈에 보기​

영역뜻
POLY-ENTRYPOINT엔트리포인트 클래스를 만들거나 실행하지 못함
POLY-CONTENT콘텐츠 ID 오류, 늦은 선언, 창작 탭·태그·메뉴 문제
POLY-COMMAND명령어 이름 충돌, 늦은 등록
POLY-NETWORK채널 ID 오류, 연결 전 전송, 잘못된 페이로드
POLY-CLIENT서버에서 클라이언트 API 사용, HUD·그리기 실패
POLY-WORLDGEN모르는 배치 기능, 생성기·바이옴 ID 오류
POLY-RESOURCE, POLY-PERMISSION리로드 디렉터리·권한 노드 오류, 리스너·공급자 실패, 빌드 때 찾은 리소스 파일 문제(004~009)
POLY-STORAGE, POLY-BACKUP더 새 버전의 저장 데이터, 백업 확인 실패
POLY-GAMETEST, POLY-SCHEDULE테스트 등록 오류, 예약 작업 예외
POLY-METADATApoly.mod.json 문제
POLY-DEPENDENCY모드 사이 관계 문제
POLY-SYSTEM시스템 교체 문제
POLY-TRANSFORM코드 변환 규칙·캐시 문제
POLY-COMPAT지원하지 않는 다른 로더 모드
POLY-BOOTSTRAP, POLY-DISCOVERY게임 jar, 버전 어댑터, 게임 계층, 메타데이터 없는 jar
POLY-SHUTDOWN, POLY-EVENT종료 작업, 이벤트 리스너

Native API​

코드의미
POLY-CONTENT-001잘못되었거나 중복된 콘텐츠 ID
POLY-CONTENT-002등록이 닫힌 뒤 선언
POLY-CONTENT-003창작 탭에 추가할 수 없음
POLY-CONTENT-004팩 종류를 알 수 없음
POLY-CONTENT-005이 게임 버전에서 메뉴 타입이나 스폰 위치 규칙을 만들 수 없음
POLY-CONTENT-006블록 모양 함수가 예외를 던지거나 null을 돌려줌
POLY-CONTENT-007addToTag로 태그에 넣은 항목이 레지스트리가 얼 때 등록되어 있지 않음(그 항목만 빠지고 태그의 나머지는 불러옴)
POLY-CONTENT-008모드 창작 탭의 항목이나 아이콘이 레지스트리가 얼 때 등록된 아이템이 아님(그것만 빠짐. 아이콘은 첫 항목으로 대신하고, 항목이 하나도 남지 않은 탭은 등록하지 않음)
POLY-COMMAND-001두 모드가 같은 최상위 명령어를 등록(경고, 트리 병합)
POLY-COMMAND-002등록이 닫힌 뒤 등록
POLY-NETWORK-001채널 ID 오류
POLY-NETWORK-002연결 전 송신 또는 등록이 닫힌 뒤 선언
POLY-NETWORK-003크기 초과(서버 방향 32 KiB, 클라이언트 방향 1 MiB)
POLY-NETWORK-004해독 실패(페이로드를 버림)
POLY-NETWORK-005접속 준비 교환의 모드 코드가 예외를 던짐(요청 실패는 건너뜀, 답 실패는 무응답, 검사 실패는 거절), 또는 잘못된 대기 시간
POLY-GAMETEST-001잘못된 테스트 이름·시간
POLY-GAMETEST-002등록이 닫힌 뒤 등록
POLY-CLIENT-001서버에서 클라이언트 API 사용
POLY-CLIENT-002클라이언트 ID 오류·등록 종료
POLY-CLIENT-003HUD 레이어·그리기 실패(그 레이어만 끔)
POLY-CLIENT-004키 바인딩 추가 실패
POLY-CLIENT-005동적 텍스처를 클라이언트 스레드가 아닌 곳에서 올림, 또는 파티클·후처리 연결 실패
POLY-CLIENT-006모드 셰이더 파이프라인을 만들거나 컴파일하지 못함(한 번 기록, 그 사각형은 건너뜀)
POLY-CLIENT-007모드 셰이더 유니폼 값이 예외를 던지거나 개수가 틀림, 또는 업로드 실패(한 번 기록, 마지막 올바른 값을 씀)
POLY-SCHEDULE-001예약 작업이 예외를 던짐(기록 후 계속)
POLY-WORLDGEN-001모르는 배치 기능(시작을 멈춤)
POLY-WORLDGEN-002등록이 닫힌 뒤 선언
POLY-WORLDGEN-003바이옴 기능·스폰 목록에 접근할 수 없음
POLY-WORLDGEN-004잘못되었거나 중복된 생성기·바이옴·배치 기능·density function·구조물 ID, 또는 density function 범위가 거꾸로
POLY-WORLDGEN-005코드 배치 기능·density function·구조물이 예외를 던짐(한 번 기록, 그 자리는 건너뜀)
POLY-RESOURCE-001잘못된 리로드 디렉터리
POLY-RESOURCE-002등록이 닫힌 뒤 선언
POLY-RESOURCE-003파일을 읽지 못함·리스너 실패(기록 후 계속)
POLY-RESOURCE-004(빌드, checkPolyResources) 게임이 건너뛰는 리소스 경로: 대문자·공백 등
POLY-RESOURCE-005(빌드) JSON 문법 오류. 줄·칸 번호 포함
POLY-RESOURCE-006(빌드) 아이템 정의·블록 상태·모델 부모가 가리키는 모델이 모드에 없음, 또는 네임스페이스를 빠뜨림
POLY-RESOURCE-007(빌드) 모델이 가리키는 텍스처가 모드에 없음, 또는 네임스페이스를 빠뜨림
POLY-RESOURCE-008(빌드) 번역 파일이 객체가 아니거나 값이 글자가 아님
POLY-RESOURCE-009(빌드, polyResources) 잘못된 이름·텍스처·도구, 같은 이름을 두 번 선언, 아이템에 블록 설정
POLY-PERMISSION-001잘못되었거나 중복된 권한 노드
POLY-PERMISSION-002등록이 닫힌 뒤 선언
POLY-PERMISSION-003공급자 예외(그 공급자 건너뜀)
POLY-STORAGE-001저장소가 더 새 버전으로 저장됨(그대로 둠)
POLY-BACKUP-001월드 백업 확인 실패(불러오기는 계속)
POLY-BOOTSTRAP-004게임 계층 jar를 찾을 수 없음
POLY-BOOTSTRAP-005게임 계층 시작 실패

엔트리포인트​

코드의미
POLY-ENTRYPOINT-001엔트리포인트 클래스를 로드하지 못함
POLY-ENTRYPOINT-002엔트리포인트 형식이 맞지 않음(필요한 인터페이스 미구현, public 인수 없는 생성자 없음)
POLY-ENTRYPOINT-003엔트리포인트 실행 중 예외(실행 중단)

메타데이터 — poly.mod.json​

코드의미수준
POLY-METADATA-001JSON 문법 오류오류
POLY-METADATA-002필수 필드 없음오류
POLY-METADATA-003필드 타입이 틀림오류
POLY-METADATA-004지원하지 않는 schemaVersion오류
POLY-METADATA-005잘못된 모드 ID오류
POLY-METADATA-006잘못된 버전오류
POLY-METADATA-007잘못된 environment오류
POLY-METADATA-008잘못된 엔트리포인트오류
POLY-METADATA-009잘못된 버전 범위오류
POLY-METADATA-010아직 지원하지 않는 기능(예: 비어 있지 않은 provides)오류
POLY-METADATA-011모르는 필드경고
POLY-METADATA-012필요한 권한(capabilities) 없음오류
POLY-METADATA-013모르는 권한경고
POLY-METADATA-014잘못된 시스템 교체 선언오류
POLY-METADATA-015잘못된 변환 선언오류
POLY-METADATA-016잘못된 접근 확대 선언오류

의존성​

코드의미
POLY-DEPENDENCY-001모드 ID 중복
POLY-DEPENDENCY-002필요한 의존성 없음
POLY-DEPENDENCY-003의존성 버전 불일치
POLY-DEPENDENCY-004의존성 순환
POLY-DEPENDENCY-005충돌하는 모드(conflicts)
POLY-DEPENDENCY-006실행 환경이 맞지 않음
POLY-DEPENDENCY-007지원하지 않는 Minecraft 버전
POLY-DEPENDENCY-008예약된 모드 ID
POLY-DEPENDENCY-009필요한 모드가 설치돼 있지만 로드할 수 없는 다른 로더의 모드임(차단 이유 포함)

시스템 교체​

코드의미
POLY-SYSTEM-001같은 시스템을 둘 이상의 모드가 교체(해결 방법과 함께 보고)
POLY-SYSTEM-002알 수 없는 시스템
POLY-SYSTEM-003제공자 생성 실패, null 반환, 계약 미구현, 시스템별 검증 실패
POLY-SYSTEM-004교체할 수 없는 시스템
POLY-SYSTEM-005잘못된 override
POLY-SYSTEM-006Poly 모드 로더가 시스템을 연결하기 전에 게임이 훅을 호출

변환​

코드의미
POLY-TRANSFORM-001대상 클래스 없음
POLY-TRANSFORM-002대상 메서드(name+descriptor) 없음
POLY-TRANSFORM-003바이트코드 사전조건 실패
POLY-TRANSFORM-004같은 메서드를 고치는 규칙끼리 충돌: after로 하나의 순서를 정하지 않았거나 합칠 수 없는 동작(모두 거부)
POLY-TRANSFORM-005변환 결과 검증 실패
POLY-TRANSFORM-006게임 버전 불일치
POLY-TRANSFORM-007규칙 ID 중복
POLY-TRANSFORM-008캐시 항목 손상(삭제 후 다시 변환, 경고)
POLY-TRANSFORM-009캐시 쓰기·정리 실패, 또는 정리 뒤에도 한도 초과(경고, 로딩은 계속)
POLY-TRANSFORM-010접근 확대 대상(클래스나 정확한 멤버) 없음
POLY-TRANSFORM-011(경고) 다른 로더의 변환기(Fabric 모드의 Mixin @Redirect·@WrapOperation)가 이미 그 호출을 바꾸거나 옮겨서, 그 클래스에서만 호출 리디렉션 규칙을 빼고 적용. 클래스는 그대로 로드됩니다

다른 로더 호환성​

코드의미
POLY-COMPAT-001브리지가 없는 로더의 모드(차단)
POLY-COMPAT-002브리지가 메타데이터를 읽다 실패함(그 jar만 차단)
POLY-COMPAT-003브리지가 실행 준비(prepareLaunch, 예: Fabric Loader API 구성)에 실패함(엔트리포인트 전에 시작을 멈춤)
POLY-COMPAT-100Fabric: 메타데이터(형식 오류, 읽을 수 없는 버전 조건, 읽을 수 없는 mixins 목록 포함)
POLY-COMPAT-101폐기(2026-10-22). Mixin만으로 모드를 막지 않습니다. Mixin 설정은 131·132·136으로 판정합니다
POLY-COMPAT-102폐기(2026-10-21). class tweaker는 더 이상 그 자체로 모드를 막지 않고, 접근 줄을 접근 확대로 적용합니다(125~130)
POLY-COMPAT-103폐기(2026-10-21). 중첩 jar는 더 이상 그 자체로 차단하지 않고 풀어서 판정합니다(120~124)
POLY-COMPAT-104폐기(2026-10-21). 다른 모드 의존은 더 이상 그 자체로 차단하지 않고 114로 판정합니다
POLY-COMPAT-105·106폐기(2026-10-22). preLaunch와 :: 엔트리포인트 값은 Fabric Loader처럼 실행합니다
POLY-COMPAT-107·108Fabric: 기타 엔트리포인트(경고, FabricLoader.getEntrypoints로 다른 모드가 받을 수 있음), 실행 환경
POLY-COMPAT-110Fabric 엔트리포인트가 예외를 던짐(시작을 멈춤)
POLY-COMPAT-111링크 검사: Poly 모드 로더가 제공하지 않는 로더 런타임 클래스나 메서드를 씀(예: FabricLauncherBase 같은 Fabric Loader 내부 클래스)
POLY-COMPAT-112링크 검사: 이 게임 버전에 없는 Minecraft 클래스·메서드·필드를 참조함
POLY-COMPAT-113링크 검사(경고): 설치되지 않은 모드의 클래스, 전용 서버에서 참조하는 클라이언트 클래스나 클라이언트 전용 모드의 클래스, JDK incubator 클래스, 설치된 jar에 없는 형식을 쓰는 게임 멤버
POLY-COMPAT-114필수 의존성이 없음·차단됨·버전 불일치(minecraft, java 포함). 차단된 의존성은 그 이유까지 적습니다
POLY-COMPAT-115breaks로 선언한 모드가 설치됨
POLY-COMPAT-116conflicts로 선언한 모드가 설치됨(경고)
POLY-COMPAT-117다른 설치된 모드와 같은 ID(별칭 포함)
POLY-COMPAT-118링크 검사: 이 Java가 읽을 수 없는 클래스 파일, 또는 없는 JDK 클래스
POLY-COMPAT-119링크 검사: 선언한 엔트리포인트 클래스가 어느 jar에도 없음
POLY-COMPAT-120(경고) 중첩 jar에서 나온 모드: 담고 있던 jar와 경로
POLY-COMPAT-121중첩 모드를 담은 바깥 jar가 로드되지 않음
POLY-COMPAT-122같은 모드의 다른 사본이 쓰임(Poly 모드 > 직접 설치한 모드 > 가장 높은 버전의 중첩 사본)
POLY-COMPAT-123jars에 적힌 중첩 jar가 없거나 읽을 수 없음, 또는 8겹보다 깊은 중첩(바깥 모드를 차단)
POLY-COMPAT-124(경고) 로드되지만 그 안의 중첩 모드 일부가 로드되지 않아 일부만 동작함
POLY-COMPAT-125Fabric class tweaker: accessWidener로 지정한 파일이 없거나 읽을 수 없음, 또는 Fabric Loader가 거부할 줄이 있음. 잘못된 줄마다 파일:줄 메시지로 보여 줌
POLY-COMPAT-126Fabric class tweaker: 이름 공간이 official이 아님(예: 이 게임 버전에는 없는 매핑이 필요한 intermediary)
POLY-COMPAT-127폐기(2026-10-22). class tweaker의 inject-interface·extend-enum 줄은 Fabric Loader처럼 적용합니다
POLY-COMPAT-128링크 검사: class tweaker 대상이 게임 jar 밖의 클래스. 그 모드와 그 모드에 의존하는 모드를 차단(파일:줄 포함)
POLY-COMPAT-129(정보) class tweaker가 넓히는 접근 요약
POLY-COMPAT-130링크 검사(경고): 전용 서버에서는 클라이언트 클래스를 대상으로 한 class tweaker 줄을 빼고 적용
POLY-COMPAT-131(정보) 모드의 Mixin 설정과 그중 이쪽(클라이언트·서버)에 적용하는 설정
POLY-COMPAT-132required로 표시한 Mixin 설정이 더 새 Mixin을 요구함. Mixin이 게임을 멈추므로 그 모드를 뺌
POLY-COMPAT-133로더 브리지의 변환기(Fabric: 환경 제거, 인터페이스 주입, Mixin)가 클래스 변환에 실패함. 그 클래스는 로드되지 않으며, 오류에 클래스와 (Mixin이면) Mixin과 그 모드가 나옴
POLY-COMPAT-134Mixin을 시작하지 못함: 쓸 수 없는 설정, 두 모드가 같은 설정을 씀(Fabric Loader도 거부), 또는 Mixin 단계 진입 실패. 시작을 멈춤
POLY-COMPAT-135링크 검사: class tweaker의 inject-interface 줄이 설치된 jar 어디에도 없는 인터페이스를 가리킴. 그 모드를 차단
POLY-COMPAT-136(경고) 없거나 JSON 객체가 아니거나, required가 아니면서 더 새 Mixin을 요구하는 Mixin 설정. Fabric Loader에서처럼 Mixin이 오류를 남기고 건너뜀
POLY-COMPAT-137링크 검사(경고): class tweaker 줄(접근 확대나 인터페이스 주입)의 클래스나 정확한 멤버가 이 게임 버전에 없음. Fabric Loader처럼 빼고 적용
POLY-COMPAT-138(제한) MinecraftForge와 함께 실행할 때 Fabric 모드의 mixin이 Forge가 패치한 클래스를 만남: 패치가 없앤 주입 지점(Forge가 같은 지점을 옮긴 곳에 주입하거나, 그 주입은 실행되지 않음), mixin이 쓰는 멤버를 패치가 없앰(그 mixin은 빠짐), 패치가 타입을 바꾼 필드의 접근자(부르면 214), 또는 주입이 이름으로 잡는 지역 변수를 패치가 없앰(그 주입은 실행되지 않음). 모드의 나머지는 실행됨
POLY-COMPAT-139MinecraftForge가 같은 모드 ID의 Forge 모드로도 로드하는 Fabric 모드(두 로더용으로 각각 만든 같은 모드)는 로드하지 않음. Forge 빌드가 실행됨. Fabric 빌드가 필요한 모드는 의존 검사로 빠짐
POLY-COMPAT-200–204NeoForge(neoforge.mods.toml)와 Forge(mods.toml), 로더마다 자기 브리지가 보고: 메타데이터, FML 언어 공급자, Mixin, Access Transformer, 의존성(경고)
POLY-COMPAT-205NeoForge·Forge 라이브러리 jar(FMLModType 매니페스트, 차단)
POLY-COMPAT-206MinecraftForge 파일(설치 프로그램, 라이브러리, 패치된 게임 jar)을 준비하지 못했거나, Poly 모드 로더 클래스 경로에 Forge 파일 시스템이 없음. Forge 모드는 로드하지 않음
POLY-COMPAT-2070.1.0-alpha.14에서 폐기: 이제 Forge 모드와 Fabric 모드를 함께 실행합니다. 번호는 다시 쓰지 않음
POLY-COMPAT-208FML이 시작하다 실패함(실행이 멈추고, 로그에 FML 자신의 오류가 있음)
POLY-COMPAT-209FML이 거부할 Forge 모드를 FML 시작 전에 빼서 나머지가 실행되게 함: 언어 로더나 forge·minecraft 버전 범위가 맞지 않음, 필수 모드가 없거나 빠짐, 설치된 의존 모드의 버전이 범위 밖, 서버에 넣은 클라이언트 전용 모드(@OnlyIn(Dist.CLIENT)인 @Mod 클래스, 또는 minecraft를 클라이언트 쪽에서만 요구). 그 모드가 필요한 모드도 함께 빠짐
POLY-COMPAT-210클라이언트에서 MinecraftForge와 함께 실행할 때, 타이틀 화면에 Forge의 브랜딩과 그 위의 로더별 모드 수를 그리려고 부르는 Forge의 BrandingControl.forEachLine을 찾지 못했습니다. 타이틀 화면을 그리지 못하고, 메시지에 메서드 이름이 나옵니다. Forge가 패치한 타이틀 화면도 같은 메서드를 부르므로 Forge 설치가 손상된 경우입니다
POLY-COMPAT-211Forge의 ModList.getModFileById나 ModList.isLoaded가 Poly 모드 로더가 확인한 코드와 달라 바꾸지 않음: Forge 모드가 그 메서드로 같은 게임의 Fabric 모드와 Poly 모드를 보지 못함. 실행은 계속됨(ADR-0025)
POLY-COMPAT-212(정보) MinecraftForge와 함께 실행할 때 Fabric 모드의 mixin을 Forge가 패치한 클래스에 맞춰 바꾸고, 쓰인 대로 동작함: Forge 패치가 같은 코드로 더한 접근자·호출자나 mixin이 더하는 메서드는 Forge의 메서드에 맡김. 또는 주입이 이름으로 잡는 지역 변수를 Forge 패치가 바꾼 이름으로 잡음
POLY-COMPAT-213(제한) MinecraftForge와 함께 실행할 때 Fabric 모드의 mixin이 더하는 메서드를 Forge 패치도 다른 코드로 더함. mixin의 메서드는 다른 이름을 받고 그 모드의 mixin은 그것을 부름. 그 이름을 부르는 다른 코드는 Forge의 메서드를 부름. 접근자라면 모드 설정에 따라 Mixin이 Forge의 메서드를 접근자로 바꾸므로, 그것을 부르는 Forge 코드가 접근자를 부름
POLY-COMPAT-214MinecraftForge와 함께 실행할 때 Forge 패치가 필드 타입을 바꿔 동작할 수 없는 Fabric 모드의 접근자를 그 모드가 부름. 메시지에 모드, 접근자, 필드, 두 타입이 나옴. 모드의 그 기능은 Forge와 함께 동작하지 않음(Fabric API의 FabricDefaultAttributeRegistry.MODIFY)
POLY-COMPAT-215(실험 중인 NeoForge 지원, -Dpoly.neoforge=on) NeoForge의 FMLLoader가 Poly 모드 로더가 확인한 코드와 달라, 게임 클래스로더가 NeoForge의 게임 레이어를 정의하게 할 수 없음. FML 자신의 클래스로더가 게임을 소유하게 두지 않고 시작을 멈춤. 메시지에 찾지 못한 부분이 있음. Poly 모드 로더가 확인하지 않은 NeoForge 버전이라는 뜻
POLY-COMPAT-216(실험 중인 NeoForge 지원, -Dpoly.neoforge=on) 이번 실행에서 NeoForge를 실행할 수 없어 NeoForge 모드를 빼고 나머지로 게임을 시작함: 이 Minecraft 버전용 NeoForge 릴리스가 없음, NeoForge 파일을 받거나 확인할 수 없음, 같은 게임에 Fabric 모드가 있음(아직 함께 실행하지 않음), NeoForge에 필요한 Poly 모드 로더 Java agent 없이 시작함. 메시지에 이유가 있음
POLY-COMPAT-217(실험 중인 NeoForge 지원, -Dpoly.neoforge=on) NeoForge의 FML이 거부할 NeoForge 모드를 FML 시작 전에 빼서 나머지가 실행되게 함(FML은 실행 전체를 멈춤). 이유는 FML 11이 neoforge.mods.toml에서 확인하는 것: javafml 로더 버전, 필수 모드가 없거나 빠짐, neoforge·minecraft·다른 모드의 버전이 선언한 범위 밖, 호환되지 않는 모드가 설치됨. 그 모드가 필요한 모드도 함께 빠짐

자세한 내용은 호환성에 있습니다.

부트스트랩과 검색​

코드의미
POLY-BOOTSTRAP-001게임 jar를 읽을 수 없음
POLY-BOOTSTRAP-002이 Minecraft 버전의 버전 어댑터가 없음
POLY-BOOTSTRAP-003실행 설정 오류
POLY-BOOTSTRAP-004게임 계층 jar를 찾을 수 없음
POLY-BOOTSTRAP-005게임 계층 시작 실패
POLY-BOOTSTRAP-006poly.gameJar가 없고, 실행 클래스 경로에서 게임 jar(version.json이 있는 jar)를 찾지 못했거나 둘 이상 찾음. 설치 프로그램으로 다시 설치하거나 -Dpoly.gameJar를 지정합니다
POLY-BOOTSTRAP-007게임이 오류로 멈췄고 그 오류가 Poly 모드 로더 실행기까지 올라옴. 오류를 기록하고 상태 1로 끝내서, 모드가 시작한 스레드가 게임 없이 프로세스를 붙잡지 않게 함
POLY-DISCOVERY-002알려진 모드 메타데이터가 없는 jar(로드하지 않음)
POLY-DISCOVERY-003jar로 읽을 수 없는 파일(받다 끊긴 파일 등, 로드하지 않음). 다른 모드는 계속 판정합니다

종료와 이벤트​

코드의미
POLY-SHUTDOWN-001종료 작업 실패(나머지는 계속)
POLY-SHUTDOWN-002종료가 시작된 뒤 등록
POLY-EVENT-001리스너 예외(그 리스너 비활성화)
POLY-EVENT-002서버 접근자가 버전 어댑터와 맞지 않음
POLY-EVENT-003결정 이벤트 리스너가 null을 돌려줌(그 리스너를 비활성화하고 답은 PASS로 침)
Buy me a coffee