가이드

Fabric 모드 설치하는 법

2026년 10월 18일 업데이트

Fabric 모드가 실행되려면 두 가지가 필요해요. 내 Minecraft 버전에 정확히 맞는 Fabric Loader, 그리고 대부분의 Fabric 모드가 의존하는 별도의 모드인 Fabric API(거의 항상 필요해요). 그다음 모드 .jar를 mods/ 폴더에 넣으면 돼요. 내 게임과 서버에서 하는 방법을 알려 드릴게요.

시작하기 좋은 예시예요.

Codexe로 이걸 생성하기

단계별 안내

  1. 1.Minecraft 버전 고르기

    모든 모드는 하나의 Minecraft 버전(또는 좁은 범위)용으로 빌드돼요. 먼저 버전을 고른 다음 그 버전용 모드를 내려받으세요.

  2. 2.Fabric Loader 설치하기

    fabricmc.net에서 Fabric 설치 프로그램을 내려받아 Client를 고르고, Minecraft 버전을 선택해서 설치하세요. Minecraft Launcher에 "fabric-loader" 프로필이 추가돼요.

  3. 3.프로필을 한 번 실행하기

    Fabric 프로필로 게임을 시작했다가 닫으세요. 그러면 .minecraft 안에 mods/ 폴더가 만들어져요.

  4. 4.Fabric API와 모드 넣기

    같은 Minecraft 버전용 Fabric API를 내려받고, 그것과 모드 .jar를 .minecraft/mods/에 넣으세요. 압축을 풀지 마세요.

  5. 5.게임을 시작하고 확인하기

    Fabric 프로필을 실행하세요. 모드에 의존성이 빠졌거나 다른 버전용이면, Fabric이 해당 모드와 필요한 것을 알려 주는 화면을 띄워요.

mods 폴더 위치

  • Windows: %appdata%\.minecraft\mods(실행 창이나 탐색기 주소 표시줄에 붙여 넣으세요).
  • macOS: ~/Library/Application Support/minecraft/mods.
  • Linux: ~/.minecraft/mods.
  • 다른 런처(Prism, MultiMC, Modrinth App, CurseForge 앱)는 인스턴스마다 별도의 폴더를 써요. 런처의 "mods 폴더 열기" 버튼을 쓰세요.

서버에 설치하기

멀티플레이를 하려면 서버에도 Fabric이 필요해요. 같은 Minecraft 버전과 로더 버전의 Fabric 서버 런처를 받거나(또는 설치 프로그램을 Server 모드로 실행하거나), 한 번 시작한 다음 Fabric API와 모드를 서버의 mods/ 폴더에 넣고 재시작하세요.

어떤 모드를 어디에 넣을지는 모드에 따라 달라요:

  • 콘텐츠 모드(새 블록, 아이템, 몹): 서버와 모든 플레이어의 클라이언트에.
  • 클라이언트 전용 모드(HUD, 미니맵, 셰이더, 키 설정): 클라이언트에만. 일부는 전용 서버에 넣으면 크래시가 나요.
  • 서버 전용 모드(성능, 관리 도구, 일부 게임 규칙): 서버에만. 모드 설명에 그렇게 되어 있다면 플레이어는 기본 Fabric이나 바닐라로도 접속할 수 있어요.

자주 생기는 문제

  • "Incompatible mods found": 모드가 다른 Minecraft 버전용이거나 더 새로운 Fabric Loader가 필요해요. Fabric이 모드 이름을 알려 주니 맞는 버전으로 바꾸세요.
  • Requires fabric-api: mods/에 Fabric API가 없거나 다른 버전용이에요.
  • 모드가 아무것도 하지 않아요: Fabric 프로필 대신 일반 프로필로 시작했거나, 모드가 Forge나 NeoForge용이에요. Fabric은 Forge 모드를 불러오지 않아요.
  • 전용 서버에서 클라이언트 클래스가 언급되며 크래시: 클라이언트 전용 모드가 서버에 설치됐어요.

Codexe로 만든 모드

Codexe에서 만든 Fabric 모드는 준비 완료 전에 컴파일되고, .jar에는 올바른 fabric.mod.json이 들어 있어야 해요. Fabric API에 맞춰 빌드되니 Fabric API를 옆에 함께 설치하세요. 컴파일이 된다는 건 모드가 빌드된다는 뜻이지, 크래시 없이 실행된다는 뜻은 아니에요. 그리고 모드는 아직 Codexe 테스트 서버에서 체험할 수 없으니, 만들 때 지정한 버전으로 내 클라이언트에서 테스트하세요.

질문

모든 모드에 Fabric API가 필요한가요?

전부는 아니지만 대부분 필요해요. 필요한 경우 모드 페이지에 의존성으로 적혀 있어요. 필요 없는 모드와 함께 설치해도 문제는 없어요.

Fabric에서 Forge 모드를 쓸 수 있나요?

아니요. 서로 다른 API를 가진 다른 로더예요. 모드의 Fabric 버전이 있다면 그걸 쓰세요. Fabric과 Forge 비교를 참고하세요.

Fabric 모드가 Quilt에서 작동하나요?

Quilt는 Fabric의 포크라서 대부분의 Fabric 모드를 불러오지만, 전부는 아니에요. 모드 페이지를 확인하세요.

설치할 Fabric 모드 만들기

이 프롬프트는 바로 보낼 수 있는 상태로 열려요:

“Lantern Staff를 추가하는 Fabric 1.21.1 모드: 우클릭하면 30초 뒤에 사라지는 빛 블록을 놓고, 64번 사용 가능, 막대기, 랜턴, 금괴로 조합, 텍스처와 영어 이름 포함.”

Codexe로 이걸 생성하기
Fabric 모드 설치하는 법 (클라이언트와 서버) | Codexe