모드팩에 모드 추가 설치하기 — 충돌 없이 안전하게

왜 모드팩에 모드를 추가하나

잘 만들어진 모드팩이라도 "내가 좋아하는 그 모드가 빠져 있네" 같은 아쉬움이 있습니다. 자주 추가하는 것들:

Xaero's Minimap & World Map — 미니맵·전체 지도·웨이포인트

Sophisticated Backpacks / Storage — 인벤토리 관리

FTB Ultimine — 연결된 같은 종류 블록 연쇄 채굴

셰이더 로더 + 셰이더팩 — 비주얼 보강 (Fabric은 Iris, Forge/NeoForge는 [Oculus](/mods/oculus/))

작가가 의도적으로 뺀 게 아니라 그냥 안 넣은 경우가 대부분이라 추가로 보강할 수 있습니다. 다만 잘못하면 모드팩이 안 켜질 수 있으니 단계를 지켜서 진행하세요.

시작 전 — 백업 먼저

모드 추가에서 가장 흔한 사고는 "추가했더니 게임이 안 켜진다"입니다. 백업이 있으면 되돌리는 데 몇 분이면 되고, 없으면 진행 데이터를 잃을 수 있습니다.

CurseForge 앱

인스턴스 우클릭 → 'Duplicate'로 복제

복제본에 날짜를 붙여 이름 지정 (예: -backup-05-12)

원본에서 작업하고, 문제가 생기면 복제본으로 복귀

Prism Launcher

인스턴스 우클릭 → 'Export Instance'

또는 인스턴스 폴더 자체를 압축

월드(saves) 폴더만 따로 한 벌 더 복사해 두면 더 안전합니다

수동 백업 (모든 런처)

인스턴스 폴더를 통째로 압축해 두는 것이 가장 확실합니다.

1단계 — 모드팩의 버전과 로더 확인

추가할 모드는 같은 마인크래프트 버전 + 같은 로더 빌드여야 합니다. 다르면 로드되지 않거나 크래시합니다.

CurseForge 앱에서 확인

인스턴스 우클릭 → 'Modpack Info' 또는 'Edit'에서 확인:

Minecraft Version: 예) 1.20.1, 1.21.1

Loader: Forge / NeoForge / Fabric / Quilt

Loader Version: 예) Forge 47.x(1.20.1), NeoForge 21.x(1.21.x)

Prism Launcher에서 확인

인스턴스 우클릭 → Edit → 좌측 'Version' 항목에서 마인크래프트 버전과 로더가 함께 표시됩니다.

예시 — DarkRPG는 1.20.1 Fabric입니다. 추가할 모드도 1.21.1 NeoForge 빌드를 받아야 합니다.

2단계 — 모드 다운로드 (버전 정확히 맞추기)

CurseForge

모드 페이지 → 'Files' 탭

'Game Version' 필터로 마인크래프트 버전 선택

'Mod Loader' 필터로 로더 선택

조건에 맞는 최신 파일(.jar) 다운로드

Modrinth

모드 페이지 → 'Versions' 탭

같은 방식으로 버전·로더 필터 적용 후 다운로드

베타·알파는 피하기

파일에 Alpha·Beta 표시가 있으면 개발 중 빌드입니다. 진행 중인 월드에 넣기 전에는 안정 빌드를 우선하세요.

3단계 — 의존 모드 확인

많은 모드가 라이브러리 모드를 필요로 합니다. 의존 모드 없이 넣으면 로더가 '의존성 누락' 화면을 띄우거나 크래시합니다.

확인 방법

CurseForge 모드 페이지의 'Relations' / 'Dependencies' 항목, Modrinth 모드 페이지의 좌측 의존성 목록을 봅니다.

Required: 반드시 함께 설치

Optional: 선택 사항 (연동 기능이 있을 때만 필요)

Included/Embedded: 모드 안에 포함돼 있어 따로 받을 필요 없음

자주 보이는 라이브러리

[Architectury API](/mods/architectury-api/) — 여러 로더를 동시에 지원하는 모드들의 브리지 라이브러리

[Bookshelf](/mods/bookshelf/) — Darkhax의 모드들이 공유하는 라이브러리

[Curios API](/mods/curios-api/) — 반지·목걸이 같은 장신구 슬롯을 제공하는 API

[GeckoLib](/mods/geckolib/) — 3D 애니메이션을 쓰는 모드의 필수 라이브러리

[Cloth Config API](/mods/cloth-config/) — 설정 화면 라이브러리

[Balm](/mods/balm/) — BlayTheNinth의 모드들(Waystones 등)이 공유하는 라이브러리

의존 모드 역시 같은 마인크래프트 버전 + 로더로 받아야 합니다.

4단계 — 설치

CurseForge 앱의 'Add More Content' (권장)

인스턴스 페이지 → 'Add More Content'

모드 검색 → 'Install'

필요한 의존 모드를 함께 처리해 주므로 누락 사고가 줄어듭니다

직접 넣기 (모든 런처 공통)

인스턴스 폴더 열기 → mods 폴더

받아 둔 .jar 파일을 넣기

런처에서 실행

Prism Launcher

인스턴스 우클릭 → Edit → 'Mods' 탭에서 jar를 추가하거나, 런처 안에서 Modrinth·CurseForge를 검색해 설치할 수 있습니다.

5단계 — 첫 실행 확인

모드 로딩 화면을 통과하는지 — 여기서 멈추거나 크래시하면 충돌 또는 의존성 문제

메인 메뉴 진입 확인

기존 월드 진입 확인

추가한 모드가 실제로 동작하는지 확인 (예: Xaero's Minimap이면 화면 구석에 미니맵이 뜨는지)

정상 동작하지 않으면

게임을 끄고 백업 인스턴스로 복귀

또는 추가한 모드를 mods에서 빼고 다시 실행

여러 개를 한 번에 넣었다면 하나씩 빼면서 원인을 찾습니다. 자세한 절차는 [모드 충돌 해결 가이드](/guides/mod-conflict-troubleshooting/)에 있습니다

6단계 — 멀티플레이라면

클라이언트에만 넣어도 되는 모드

서버에 없어도 되는 종류입니다.

미니맵 (Xaero's Minimap)

인벤토리 정리·HUD 개선류

셰이더 로더와 셰이더팩

[Entity Culling](/mods/entity-culling/) 같은 클라이언트 전용 최적화 모드

서버와 클라이언트 모두 필요한 모드

아이템·블록·차원을 추가하는 모드

게임 규칙이나 전투·진행 방식을 바꾸는 모드

이런 모드는 서버와 모든 참가자가 같은 버전으로 설치해야 합니다. 한 명이라도 다르면 접속이 거부되거나 크래시합니다.

자주 추가하는 QoL 모드

[Xaero's Minimap + World Map](/mods/xaeros-maps/)

서로 별개의 두 모드입니다. 둘 다 쓰려면 각각 받아야 합니다

미니맵은 화면 구석에 뜨고, 월드맵은 M 키로 엽니다

웨이포인트는 미니맵 쪽 기능입니다 — B 키로 생성, U 키로 목록

죽으면 데스포인트가 자동으로 생깁니다

[Waystones](/mods/waystones/)와 함께 쓰면 이동 동선을 지도에 정리하기 좋습니다

[FTB Ultimine](/mods/ftb-ultimine/)

키를 누르고 있는 동안에만 연결된 같은 종류 블록이 한꺼번에 캐집니다. 기본 키는 백틱(`)

자동 발동이 아니라서 원치 않는 연쇄 채굴이 일어나지 않습니다

한 번에 캐는 블록 수는 기본 64개이며 서버 설정으로 조정합니다

블록당 허기 소모 계수가 설정에 있습니다 — 대량 채굴 후 배가 빨리 꺼질 수 있습니다

[Sophisticated Backpacks](/mods/sophisticated-backpacks/)

백팩이 가죽 → 구리 → 철 → 금 → 다이아몬드 → 네더라이트의 6단계로 올라가고, 티어가 오르면 저장 슬롯과 업그레이드 슬롯이 함께 늘어납니다

Pickup·Magnet·Filter·Void·Compacting·Stack 같은 업그레이드를 끼워 쓰는 게 핵심입니다

웅크린 채 우클릭하면 블록으로 놓을 수 있어 호퍼·파이프로 자동화에 물릴 수 있습니다

[Just Enough Resources](/mods/just-enough-resources/)

JEI 애드온입니다. JEI가 "어떻게 만드는가"를 답한다면 JER은 "어디서 나오는가"를 답합니다

광물의 높이별 생성 분포, 몹 드롭, 상자 전리품을 JEI 화면 안에서 확인할 수 있습니다

모드팩이 광물을 수십 종 추가했을 때 특히 유용합니다 (JEI가 이미 깔려 있어야 합니다)

자주 발생하는 문제

게임 시작 시 크래시

원인: 버전·로더 불일치, 의존 모드 누락, 모드 간 충돌

확인: 인스턴스 폴더 → crash-reports/ → 최신 파일에서 에러 종류와 모드 이름 확인

해결: 의심 모드를 빼거나 백업으로 복귀. 절차는 [모드 충돌 해결 가이드](/guides/mod-conflict-troubleshooting/) 참조

게임은 켜지는데 새 모드가 안 보임

원인: 의존 모드 누락, 또는 마인크래프트 버전이 정확히 일치하지 않음 (예: 1.21 vs 1.21.1)

해결: 모드 페이지에서 지원 버전을 다시 확인하고 의존 모드를 채웁니다

멀티 서버 접속 거부

원인: 서버와 클라이언트의 모드 구성이 다름

해결: 서버에도 같은 모드를 넣거나, 클라이언트에서 그 모드를 뺍니다

모드팩 업데이트 후 추가한 모드가 사라짐

원인: 업데이트가 mods 폴더를 팩 기준으로 다시 구성합니다

해결: 업데이트 후 추가 모드를 다시 넣습니다. 어떤 모드를 넣었는지 목록으로 적어 두면 복구가 빨라집니다

참고 가이드

[모드 충돌 해결 가이드](/guides/mod-conflict-troubleshooting/) — 크래시 리포트 읽는 법

[모드팩 설치 실패 해결 가이드](/guides/modpack-installation-troubleshooting/) — 런처·Java 문제

[세이브 손상 복구 가이드](/guides/world-save-recovery/) — 사고 발생 시 복구

[JEI / EMI 완전 사용 가이드](/guides/jei-emi-complete-guide/) — 레시피 뷰어 활용