Legacy4J 설치 방법: 사용할 프로필의 Minecraft Java 버전과 모드 로더를 확인합니다. 두 조건에 맞는 파일을 선택해 해당 프로필에 추가하고, 다른 모드를 넣기 전에 새 월드에서 실행을 확인하세요. 프로젝트는 조합별로 파일을 배포하므로 가장 최신 번호가 항상 맞는 것은 아닙니다. 이 가이드는 사전 확인, 설치, 로드 검증, 업데이트와 문제 해결 순서를 설명합니다.
Legacy4J는 Minecraft Java Edition에 콘솔을 연상시키는 인터페이스를 더하는 커뮤니티 모드입니다. Minecraft Legacy Console Edition 검색에서 함께 언급되는 데스크톱 앱 Legacy Launcher와는 별개의 프로젝트이며 Minecraft 본체나 게임 라이선스를 제공하지 않습니다. LCE 런처를 찾는 중이라면 Legacy4J와 Legacy Launcher의 비교 페이지에서 먼저 제품을 구분하세요.
실제로 플레이할 Java 프로필을 열고 Minecraft 버전과 로더를 적어 둡니다. 프로젝트가 호환 빌드를 제공하는 경우 Fabric, Forge, NeoForge 또는 Quilt일 수 있습니다. 프로필 이름만으로는 충분하지 않습니다. 서로 다른 프로필은 게임 버전, 로더, Java 설정, 모드 폴더와 월드가 다를 수 있으므로 JAR을 받기 전에 세부 정보를 확인하세요.
별도의 테스트 프로필을 만들고 중요한 월드를 백업합니다. 기존 프로필은 그대로 두어 결과를 비교하고 문제가 생겼을 때 작동하던 구성으로 돌아갈 수 있게 합니다. 새 프로필에 기존 월드나 모드를 한꺼번에 복사하면 충돌 원인을 찾기 어려워질 수 있습니다.
이 분리는 게임을 지우거나 런처를 새로 설치하라는 뜻이 아닙니다. 지금 쓰는 인스턴스와 다른 위치에 테스트 환경을 하나 두면 됩니다. 이름에 게임 버전과 로더를 기록해 두면 나중에 여러 프로필을 열었을 때도 어떤 환경인지 쉽게 구별할 수 있습니다.
Legacy4J에는 모든 환경에서 쓸 수 있는 단일 JAR이 없습니다. Modrinth는 Minecraft 버전과 로더에 따라 파일을 나눠 제공합니다. 2026년 11월 5일 API에서 확인한 최신 항목 이름은 1.21.10-1.9.1-fabric이며 Minecraft 1.21.10과 Fabric을 대상으로 합니다. 이는 확인 시점의 사례이지 모든 프로필에 알맞은 파일이라는 뜻은 아니며, 다른 호환 계열이 없다는 뜻도 아닙니다. 이전 Minecraft 버전을 사용할 때도 그 게임과 로더 조합을 선택해야 하며 새 JAR을 이전 버전에 억지로 넣어서는 안 됩니다.
공식 프로젝트 페이지에서 내 프로필에 표시된 정확한 게임 버전과 로더를 기준으로 목록을 좁히고 배포 설명을 읽습니다. 필요한 라이브러리나 의존 모드가 적혀 있다면 같은 프로필과 버전에 맞는 파일만 추가하세요. 두 조건을 모두 충족하는 항목이 없다면 가까운 버전을 억지로 설치하지 말고 호환 프로필을 선택하거나 새 빌드가 나올 때까지 기다리는 편이 낫습니다.
파일 이름의 숫자만 보고 최신 버전을 고르지 마세요. Minecraft 버전과 로더 표기를 함께 확인해야 합니다. Fabric 전용 파일은 Fabric 프로필에 넣고, NeoForge 환경에 Fabric 파일을 넣어도 런처가 자동 변환해 주지 않습니다. Modrinth 목록에서 원하는 조합을 찾을 수 없다면 지원되는 다른 프로필을 만들 수 있는지 확인하세요.
프로젝트 페이지에 필요한 라이브러리가 표시되어도 다른 버전의 파일을 임의로 더하지 마세요. 의존성도 같은 게임 버전과 로더에 맞아야 합니다. 설명에 요구 조건이 분명하지 않으면 파일을 추측해서 설치하기보다 공식 안내와 버전 정보를 다시 확인하고, 오류가 계속되면 해당 버전의 지원 범위를 먼저 살펴보세요.
런처마다 버튼 위치는 다르지만 순서는 같습니다. 먼저 로더를 설치하고 그 로더 프로필을 선택한 다음 프로필의 모드 목록에 Legacy4J를 추가합니다. 런처에 모드 검색이나 인스턴스 관리 기능이 있다면 프로필별 설치 흐름을 이용하고 적용 전에 Minecraft 버전을 다시 확인하세요. 인스턴스마다 폴더가 나뉘는 런처에서 공용 폴더라고 추측한 위치에 파일을 복사하지 마세요.
수동으로 설치하려면 공식 Modrinth 페이지에서 조건에 맞는 JAR을 받습니다. 코드 소스 압축 파일이나 설치 프로그램이 아니라 모드 파일인지 확인하세요. 선택한 프로필의 게임 디렉터리를 열고 그 안의 mods 폴더를 사용합니다. 폴더가 없다면 로더 프로필을 한 번 실행한 뒤 종료하세요. 일부 런처는 첫 실행 때 인스턴스 폴더를 만듭니다. 확인된 프로필 안에만 mods 폴더를 만들고 JAR을 넣습니다.
배포 설명에 의존 모드가 적혀 있을 때만 같은 프로필에 추가합니다. 각 파일은 한 개씩 유지하세요. Legacy4J 여러 버전, 다른 로더, 다른 Minecraft 버전용 파일을 함께 넣지 않습니다. 런처의 가져오기 버튼을 사용하더라도 대상 프로필과 게임 버전을 마지막으로 확인하세요.
Legacy4J 설치 방법의 핵심은 로더 프로필을 고르고, 두 조건에 맞는 파일을 받은 다음 해당 인스턴스에만 넣는 것입니다. 먼저 공용 게임 폴더에 파일을 복사하고 어느 프로필에 적용되는지 추측하지 마세요. 위치를 모르면 런처의 인스턴스 설정에서 게임 디렉터리 열기를 선택해 실제 경로를 확인합니다.
테스트 프로필을 실행하고 메인 메뉴가 나타날 때까지 기다립니다. 런처의 모드 목록, 로더 화면 또는 게임 로그에서 Legacy4J와 버전을 찾으세요. 게임이 켜졌다는 사실만으로 모드가 로드되었다고 볼 수 없습니다. 중요한 저장 월드를 열기 전에 메뉴의 예상된 변화를 확인합니다. 로그를 볼 때는 방금 실행한 인스턴스의 파일인지 확인하고 오래된 다른 프로필 로그와 혼동하지 마세요.
첫 검증에는 임시 월드를 사용합니다. 월드에 들어갈 수 있는지, 키보드와 마우스가 작동하는지 먼저 확인한 뒤 필요한 컨트롤러를 시험합니다. Steam Input이나 별도의 컨트롤러 모드는 기본 프로필이 정상 동작한 후 추가하세요. 입력 설정을 여러 개 한 번에 겹치면 조작 충돌이 Legacy4J 설치 오류처럼 보일 수 있습니다.
아래 그림은 프로젝트 갤러리의 튜토리얼 공간입니다. 실제 메뉴는 Legacy4J 버전, 언어, 리소스 팩, 설정에 따라 다를 수 있습니다. 화면이 조금 다르다고 설치 실패로 단정하지 말고 설치된 프로필의 모드 목록과 로그를 기준으로 확인하세요.
메뉴가 나오기 전에 Minecraft가 종료되면 테스트 프로필에서 Legacy4J 파일을 빼고 다시 실행합니다. 깨끗한 상태로 실행된다면 JAR의 게임 버전과 로더를 확인하고 첫 충돌 보고서에서 의존성 누락이나 호환되지 않는 모드를 찾으세요. 해당 프로필에 맞는 파일만 다시 추가합니다. 런처 전체를 바로 재설치하면 인스턴스 경로처럼 원인 파악에 필요한 정보가 사라질 수 있습니다. 충돌 후 Legacy4J 설치 방법을 다시 시도할 때는 깨끗한 테스트 프로필에서 한 번에 파일 하나만 바꾸세요.
게임은 실행되지만 Legacy4J가 목록에 없으면 로더 프로필을 선택했는지, 그 프로필의 mods 폴더에 파일을 넣었는지 확인하세요. 다운로드가 끝났고 확장자가 .jar인지도 확인합니다. 관리형, 포터블, 안정판 런처는 이름이 비슷해도 인스턴스별 경로가 다를 수 있습니다.
의존성이 없다는 알림이 나오면 배포 설명이나 오류 메시지에 적힌 의존 모드를 확인하고 같은 Minecraft 버전 및 로더를 맞춥니다. 지원되지 않는 클래스나 버전 오류가 보이면 Java 실행 옵션을 바꾸기 전에 중복되거나 잘못된 모드 파일을 제거하세요. 첫 충돌 보고서를 보관하고 게임 버전, 로더, Legacy4J 파일명, 함께 설치한 모드를 기록합니다.
메뉴는 정상인데 컨트롤러만 불안정하면 깨끗한 프로필에서 키보드와 마우스를 먼저 시험합니다. 이후 컨트롤 설정, Steam Input, 다른 입력 모드를 하나씩 확인하세요. 키 지정 중복이나 여러 입력 계층은 핵심 모드가 로드된 뒤에도 조작 결과에 영향을 줍니다.
업데이트 전에 새 배포판이 프로필의 Minecraft 버전과 로더를 계속 지원하는지 확인하세요. 모드 목록을 기록하고 중요한 월드를 백업합니다. 런처가 자동으로 바꾸지 않는다면 이전 JAR을 제거한 다음 새 파일을 넣으세요. 같은 폴더에 Legacy4J 두 버전을 두면 충돌할 수 있습니다. 의존 모드는 배포 설명이 요구할 때만 업데이트합니다.
Legacy4J를 제거하려면 Minecraft를 종료하고 해당 프로필의 mods 폴더에서 JAR을 옮깁니다. 다른 모드가 사용하는 의존성일 수 있으므로 이용 중인 모드를 확인한 뒤 제거하세요. 다시 실행하여 나머지 모드가 작동하는지 확인합니다. 필요한 월드를 점검할 때까지 백업은 활성 프로필과 분리해 보관하세요.
업데이트 후 문제가 생겼다면 바꾼 파일 목록을 이전 상태와 비교합니다. 모든 모드를 한꺼번에 제거했다가 다시 설치하기보다 Legacy4J와 명시된 의존성부터 확인하면 문제 범위를 좁히기 쉽습니다. 깨끗한 프로필은 계속 비교 대상으로 남겨 둡니다.
Modrinth 버전 API는 2026년 11월 5일 확인에서 1.21.10-1.9.1-fabric을 최신 레코드로 반환했습니다. 메타데이터에는 Minecraft 1.21.10, Fabric, 26,964,065바이트 JAR, 2026년 8월 29일 공개가 표시됩니다. CDN 주소의 HTTP 응답과 바이너리 MIME은 별도로 검증하지 않았습니다. 따라서 이 주소를 검증된 직접 다운로드로 안내하지 않고 공식 프로젝트의 파일 선택 페이지로 연결합니다. 배포판은 바뀔 수 있으니 실제 설치 시 Modrinth를 다시 확인하세요.
Modrinth 프로젝트 페이지 또는 연결된 소스 저장소를 이용하고 파일이 Minecraft 및 로더 필터와 맞는지 확인합니다. 프로젝트, 배포판, 파일 정체를 알 수 없는 미러는 피하세요. 이 안내는 악성코드 검사를 완료했다고 주장하지 않습니다. Legacy4J는 Minecraft 라이선스, 유료 게임 파일, 계정 우회, 상용 Bedrock Edition 지원을 제공하지 않습니다.
Modrinth의 Legacy4J 프로젝트와 버전 선택 · Legacy4J 다운로드 및 설치 안내 · Legacy4J 소스 저장소
기본적인 Legacy4J 설치 방법은 게임 버전, 로더, 배포판, 프로필을 맞추는 것입니다. 호환 JAR을 해당 프로필에 넣고 월드를 시험하기 전에 모드 목록이나 로그에서 로드를 확인하세요.
선택한 파일에 표시된 게임 버전을 사용하세요. 2026년 11월 5일 Modrinth에서 확인한 레코드는 Minecraft 1.21.10과 Fabric용이지만, 다른 프로필은 다른 빌드가 필요할 수 있습니다.
프로젝트가 게임과 로더 조합별로 파일을 배포합니다. 선택한 파일 표기를 따르고 서로 다른 로더 빌드를 한 프로필에 섞지 마세요.
실행할 정확한 프로필의 mods 폴더에 둡니다. 관리형 인스턴스는 경로가 각각 다를 수 있으므로 복사 전에 확인하세요.
깨끗한 프로필에서 게임 버전과 로더, 누락된 의존성, 중복 파일, 첫 충돌 보고서를 확인하세요.
아닙니다. Legacy4J는 Java Edition 모드이고 Legacy Launcher는 LCE 관련 별도 데스크톱 앱입니다. 비교 페이지에서 필요한 안내를 고를 수 있습니다.
