마인크래프트 패브릭 설치 방법 🧵 ㅡ 초보자도 10분 완성 Fabric 로더·모드 적용 가이드

🧵 마인크래프트 패브릭(Fabric)이란? ㅡ “가벼운 모드 로더”로 성능·편의 모드에 강합니다

패브릭(Fabric)은 마인크래프트에서 모드(Mod)를 실행할 수 있게 해주는 모드 로더(Mod Loader) 중 하나입니다.
특히 업데이트 대응이 빠르고 비교적 가벼운 편이라, 성능 최적화 모드(예: 렌더링/로딩 개선)나 편의성 모드를 쓰고 싶은 분에게 많이 선택됩니다.

이 글에서는 컴퓨터를 잘 모르는 초보자도 그대로 따라 하면 설치가 끝나도록, 준비물부터 설치·모드 적용·자주 발생하는 오류 해결까지 한 번에 정리해드립니다.

 

---

 

✅ 설치 전 준비물 ㅡ 여기서 막히면 100% 설치가 꼬입니다

패브릭 설치가 안 되는 대부분의 이유는 “패브릭” 문제가 아니라 마인크래프트 버전/자바/런처 실행이 준비가 안 돼서입니다.
아래 3가지를 먼저 확인해주세요.

• 마인크래프트 자바 에디션(Java Edition)이 설치되어 있어야 합니다(베드락 에디션은 방식이 다릅니다).
• 마인크래프트 런처에서 원하는 버전을 한 번이라도 실행해 둬야 합니다(예: 1.21.1을 모드로 할 거면 1.21.1 순정도 1회 실행).
• 자바(Java)는 보통 최신 런처가 자동 처리하지만, 구버전/커스텀 환경에서는 자바 설치가 필요할 수 있습니다(오류 해결 파트 참고).

그리고 가장 중요합니다: 모드 버전 = 마인크래프트 버전이 맞아야 합니다.
예를 들어 1.20.1 모드는 1.20.1 패브릭에서 돌려야 하고, 1.21.x에 억지로 넣으면 거의 100% 오류가 납니다.

 

---

 

📥 패브릭(Fabric) 설치 방법 ㅡ 가장 쉬운 “자동 설치(권장)”

 

초보자라면 무조건 이 방법이 안전합니다.
핵심 흐름은 “패브릭 설치 프로그램 실행 → 런처에 패브릭 프로필 생성 → 한 번 실행”입니다.

1) 패브릭 인스톨러 다운로드

패브릭은 Fabric Installer라는 설치 프로그램으로 설치합니다.
반드시 공식 사이트(https://fabricmc.net/use/installer/)에서 받는 것을 추천합니다(검색으로 뜨는 광고/미러 사이트는 피하세요).

다운로드 후 파일 확장자가 보통 .jar 형태로 받아집니다.

 

2) 인스톨러 실행

다운받은 Fabric Installer(.jar)을 실행하면 설치 창이 뜹니다.
여기서 Client를 선택하고, 설치하려는 Minecraft Version을 원하는 버전으로 맞춥니다(예: 1.21.1).
Loader Version은 기본 추천값 그대로 두셔도 됩니다.

 

옵션(Options) 체크 포인트
설치 위치(게임 폴더)를 직접 지정하는 옵션이 보이면, 초보자는 기본 경로 그대로 두는 게 가장 안전합니다.
다른 런처(프리즘 런처 등)를 쓰는 경우만 경로를 별도 지정하는 편이 좋습니다.

 

3) Install 버튼 클릭 ㅡ 런처에 패브릭 프로필이 생깁니다

출처: https://wiki.fabricmc.net/player:tutorials:install_mcl:windows

 

Install을 누르면 설치가 진행되고, 완료되면 마인크래프트 런처에 Fabric 프로필이 자동으로 추가됩니다.
이제 런처를 열어서 실행 프로필에서 Fabric(또는 Fabric Loader 1.xx)로 선택합니다.

 

4) 패브릭으로 “한 번 실행” (중요)

패브릭 프로필로 게임을 최소 1회 실행해야 mods 폴더 같은 기본 구조가 정상적으로 잡힙니다.
처음 실행은 모드가 없어도 괜찮습니다(순정+패브릭만 실행).

 

---

 

🧩 모드 적용 방법 ㅡ “Fabric API”부터 넣어야 하는 이유

패브릭 모드는 대부분 Fabric API라는 필수 라이브러리를 요구합니다.
초보자분들이 가장 많이 하는 실수가 “모드만 넣고 Fabric API를 안 넣어서” 실행이 안 되는 경우입니다.
그래서 모드 적용 순서는 아래처럼 기억하시면 됩니다: 패브릭 설치 → Fabric API 설치 → 모드 설치

1) mods 폴더 위치 찾기

가장 쉬운 방법은 게임 실행 후, 리소스팩/스크린샷 폴더를 통해 역으로 찾는 방식입니다.
일반적으로 윈도우 기준 기본 경로는 아래와 비슷합니다.

• Win + R키를 눌러 '실행' 프로그램에서 입력: %appdata%\.minecraft\

그 안에 mods 폴더가 있어야 정상입니다.
만약 없다면, 패브릭 프로필로 게임을 1회 실행했는지 다시 확인해주세요.

 

2) Fabric API 넣기

Fabric API 파일(.jar)을 다운로드해서 mods 폴더에 그대로 넣습니다.
압축을 풀거나 폴더를 또 만들 필요가 없습니다(그냥 .jar 파일을 넣는 구조).

 

3) 원하는 모드 넣기

모드 파일(.jar)도 동일하게 mods 폴더에 넣습니다.
이때 반드시 마인크래프트 버전과 패브릭(Fabric)용 모드인지 확인해야 합니다(포지/네오포지용 모드는 그대로 넣으면 충돌합니다).

 

4) 패브릭 프로필로 실행해서 “모드 목록 확인”

런처에서 패브릭 프로필로 실행하면 로딩 화면 또는 모드 관련 메뉴(설치한 모드에 따라 다름)에서 정상 인식 여부를 확인할 수 있습니다.
실행이 바로 꺼진다면, 아래 오류 해결 파트를 먼저 체크해주세요.

 

---

 

🖥️ 런처/프로필 설정 ㅡ 초보자가 자주 놓치는 체크리스트

출처: https://fabricmc.net/2019/12/10/115.html

 

패브릭 설치는 됐는데 “자꾸 순정으로 켜진다”거나 “프로필이 안 보인다”는 경우가 많습니다.
아래를 순서대로 확인하면 대부분 해결됩니다.

• 런처 실행 프로필에서 Fabric Loader 프로필이 선택되어 있는지 확인
• 런처의 설치(Installations) 탭에서 Fabric 프로필이 숨김 처리되지 않았는지 확인
• 패브릭 설치 시 버전을 1.21.1로 했는데, 런처에서는 1.21.0을 켜고 있지 않은지 확인
• 다른 런처(프리즘/멀티MC 계열)를 쓴다면 “인스톨러 설치 경로”가 해당 런처 인스턴스 폴더인지 확인

특히 “버전 불일치”는 정말 흔합니다.
모드가 1.20.1인데 1.20.4 패브릭으로 켜면, 설치가 잘 되어도 게임은 바로 튕길 수 있습니다.

 

---

 

🛠️ 자주 발생하는 오류 해결 ㅡ 안 켜질 때 여기만 보면 됩니다

오류 1) 게임이 실행하자마자 꺼짐(크래시)

대부분 아래 3가지 중 하나입니다.

• Fabric API 누락: 필수 라이브러리 요구 모드가 매우 많습니다.
• 버전 불일치: 마인크래프트 버전/모드 버전/패브릭 로더 버전이 맞는지 확인하세요.
• 포지/네오포지용 모드 혼입: “Fabric” 표기 없는 모드는 의심부터 하세요.

오류 2) mods 폴더가 안 생김

패브릭 프로필로 게임을 1회 실행했는지 확인하세요.
그래도 없다면, 설치 경로가 기본 .minecraft가 아닌 다른 폴더로 잡혔을 수 있으니 인스톨러에서 경로를 확인하는 게 좋습니다.

오류 3) .jar 파일이 실행이 안 됨(인스톨러 더블클릭해도 반응 없음)

이 경우는 보통 PC에 자바 실행 환경 연결이 꼬였을 때 발생합니다.
해결 방법은 아래 중 하나로 진행하면 됩니다.

• 마인크래프트 런처 최신 버전 사용(최신 런처는 자바를 포함/관리하는 경우가 많음)
• Java 설치 후 .jar 연결(자바가 없으면 .jar 실행이 안 될 수 있음)
• 인스톨러 대신 “다른 방식 설치(런처/모드팩 툴)”로 진행(아래 참고)

오류 4) 모드가 서로 충돌하는 느낌(렉/그래픽 이상)

모드는 “같은 영역을 건드리면” 충돌하기 쉽습니다.
예를 들어 그래픽/렌더링 최적화 모드를 여러 개 겹치면 충돌이 날 수 있으니, 처음에는 모드를 1~3개만 넣고 정상 작동을 확인한 뒤 점점 늘리는 방식을 추천합니다.

 

---

 

📦 “자동으로 모드까지 설치”하는 방법 ㅡ 모드팩/런처 활용(초보자 추천)

패브릭 자체는 위 방식이 정석이지만, 초보자는 모드팩/런처를 쓰면 훨씬 편합니다.
핵심 장점은 버전/의존성(Fabric API 등)을 자동으로 맞춰주는 점입니다.

• 모드팩 런처: 모드팩을 선택하면 패브릭/모드가 함께 설치되는 형태
• 인스턴스 관리: “순정”과 “모드”를 폴더 단위로 분리해 충돌을 줄임
• 업데이트 관리: 모드 버전 업데이트가 비교적 쉬움

단, 어떤 도구든 공식/신뢰 가능한 출처에서만 다운로드하는 습관은 꼭 지켜주세요.

 

---

 

🧾 패브릭 설치 한 줄 요약 ㅡ 이 순서만 기억하면 끝

1) 런처에서 원하는 버전 순정을 1회 실행
2) Fabric Installer로 Client 설치(버전 선택)
3) 런처에서 Fabric 프로필로 1회 실행(mods 폴더 생성)
4) mods 폴더에 Fabric API 넣기
5) 원하는 모드(.jar) 넣기 → Fabric 프로필로 실행

여기까지 했는데도 안 되면, 거의 항상 “버전 불일치” 또는 “Fabric API 누락”입니다.
이 두 가지만 다시 체크해도 대부분 해결됩니다.