Fabric

Tdb (토론 | 기여)님의 2025년 7월 23일 (수) 02:11 판 (문자열 찾아 바꾸기 - "분류:마인크래프트" 문자열을 "분류:마인크래프트/모드" 문자열로)
(차이) ← 이전 판 | 최신판 (차이) | 다음 판 → (차이)

Fabric(패브릭)은 마인크래프트 Java Edition을 위한 경량 모드 로더이자 모딩 툴체인이다. 2018년에 개발이 시작되어 빠른 업데이트와 뛰어난 성능으로 현대적인 모딩 플랫폼으로 자리잡았다.

Fabric은 모듈식 설계와 최소한의 개입을 원칙으로 하는 모드 로더로, Forge의 무거운 구조에 대한 대안으로 만들어졌다. 빠른 마인크래프트 버전 업데이트 대응과 가벼운 실행 환경이 특징이며, 성능 최적화 모드들의 주요 플랫폼이 되었다.

주요 특징

  • 경량 설계: 최소한의 리소스 사용
  • 빠른 업데이트: 새 마인크래프트 버전 즉시 지원
  • 모듈식 구조: 필요한 기능만 선택적 사용
  • 개발자 친화적: 간단한 API와 도구
  • 스냅샷 지원: 마인크래프트 스냅샷 버전도 지원

구성 요소

Fabric은 여러 프로젝트로 구성되어 있다:

  • Fabric Loader: 모드를 로드하는 핵심 시스템
  • Fabric API: 모드 개발을 위한 표준 라이브러리
  • Yarn: 마인크래프트 매핑 (난독화 해제)
  • Fabric Loom: Gradle 플러그인
  • Tiny Remapper: JAR 파일 리매핑 도구

설치 방법

바닐라 런처 설치

1. fabricmc.net/use/installer 방문
2. "Download for Windows" 또는 "Universal/.JAR" 다운로드
3. 설치 프로그램 실행
4. 설치하려는 마인크래프트 버전 선택
5. "Install" 클릭
6. 설치 완료 확인

수동 설치 (고급)

1. Fabric Loader JAR 다운로드
2. 마인크래프트 런처에서 새 설치 생성
3. 버전을 fabric-loader-버전으로 설정
4. 게임 실행

Fabric API

대부분의 Fabric 모드는 Fabric API가 필요하다:

1. CurseForge 또는 Modrinth에서 Fabric API 다운로드
2. 마인크래프트 버전에 맞는 버전 선택
3. .minecraft/mods 폴더에 복사
4. Fabric API는 일반 모드처럼 설치

모드 설치

1. Fabric Loader 설치 확인
2. Fabric API 설치 (대부분 필수)
3. 호환되는 모드 다운로드
4. mods 폴더에 모드 파일(.jar) 복사:
   - Windows: %appdata%\.minecraft\mods
   - macOS: ~/Library/Application Support/minecraft/mods
   - Linux: ~/.minecraft/mods
5. 마인크래프트 실행 (Fabric 프로필 선택)

서버 설치

1. fabricmc.net/use/server에서 서버 설치 프로그램 다운로드
2. 실행하여 서버 파일 생성:
   java -jar fabric-installer.jar server -mcversion 1.21
3. 생성된 fabric-server-launch.jar 실행:
   java -Xmx2G -jar fabric-server-launch.jar nogui
4. eula.txt에서 eula=true 설정
5. 서버 재시작

대표적인 Fabric 모드

성능 최적화

  • Sodium: 렌더링 엔진 최적화
  • Lithium: 게임 로직 최적화
  • Phosphor: 조명 엔진 최적화 (구버전)
  • Starlight: 새로운 조명 엔진 (신버전)
  • FerriteCore: 메모리 사용량 감소
  • LazyDFU: 시작 시간 단축

그래픽 개선

  • Iris Shaders: 셰이더 지원
  • LambDynamicLights: 동적 조명
  • Continuity: 연결된 텍스처
  • LambdaBetterGrass: 향상된 잔디 렌더링

유틸리티

  • Mod Menu: 모드 목록 및 설정
  • REI (Roughly Enough Items): 아이템 검색
  • WTHIT: 블록 정보 표시
  • Xaero's Minimap: 미니맵

편의 기능

  • Shulker Box Tooltip: 셜커 박스 내용 미리보기
  • AppleSkin: 음식 정보 표시
  • Light Overlay: 몹 스폰 가능 지역 표시

개발 환경 설정

프로젝트 생성

1. Fabric Example Mod 템플릿 다운로드
2. gradle.properties에서 버전 설정:
   minecraft_version=1.21
   yarn_mappings=1.21+build.1
   loader_version=0.15.11
   fabric_version=0.100.0+1.21
3. IDE에서 프로젝트 열기
4. Gradle 동기화 실행

기본 모드 구조

// 메인 모드 클래스
public class ExampleMod implements ModInitializer {
    public static final String MOD_ID = "examplemod";
    
    @Override
    public void onInitialize() {
        // 모드 초기화 코드
        LOGGER.info("Hello Fabric world!");
    }
}

// fabric.mod.json
{
  "schemaVersion": 1,
  "id": "examplemod",
  "version": "1.0.0",
  "name": "Example Mod",
  "entrypoints": {
    "main": ["com.example.ExampleMod"]
  },
  "depends": {
    "fabricloader": ">=0.15.11",
    "minecraft": "1.21",
    "java": ">=21"
  }
}

Fabric vs Forge

특징 Fabric Forge
성능 매우 가벼움 무거움
시작 속도 빠름 느림
업데이트 속도 매우 빠름 느림
모드 수 적음 많음
API 복잡도 단순 복잡
스냅샷 지원 지원 미지원
대규모 모드팩 제한적 최적화됨

최적화 설정

권장 모드 조합

# 필수 성능 모드
- Fabric API
- Sodium
- Lithium
- Starlight (1.19 이하) 또는 내장 (1.20+)
- FerriteCore
- LazyDFU

# 추가 최적화
- Entity Culling
- MoreCulling
- ImmediatelyFast
- ModernFix

JVM 인수

# Fabric용 최적화 JVM 인수 (4GB RAM)
-Xmx4G -Xms4G -XX:+UseG1GC -XX:+ParallelRefProcEnabled 
-XX:MaxGCPauseMillis=200 -XX:+UnlockExperimentalVMOptions 
-XX:+DisableExplicitGC -XX:+AlwaysPreTouch 
-XX:G1HeapRegionSize=8M -XX:G1ReservePercent=20 
-XX:G1HeapWastePercent=5 -XX:G1MixedGCCountTarget=4 
-XX:InitiatingHeapOccupancyPercent=15 
-XX:G1MixedGCLiveThresholdPercent=90 
-XX:G1RSetUpdatingPauseTimePercent=5 
-XX:SurvivorRatio=32 -XX:+PerfDisableSharedMem 
-XX:MaxTenuringThreshold=1

문제 해결

일반적인 문제

  • Fabric API 누락: 대부분의 모드가 Fabric API 필요
  • 버전 불일치: 모드가 현재 MC 버전 지원하는지 확인
  • 의존성 오류: 필요한 라이브러리 모드 설치
  • 충돌: 한 번에 하나씩 모드 제거하여 확인

호환성

  • Forge 모드와 호환 불가
  • OptiFine 대신 Sodium + Iris 사용 권장
  • 일부 모드는 특정 버전의 Fabric API 필요

Fabric 생태계

Quilt

Fabric의 포크 프로젝트로, 추가 기능과 개선사항을 제공한다:

  • 대부분의 Fabric 모드와 호환
  • 향상된 모드 로딩 시스템
  • 추가 개발자 도구

도구 및 유틸리티

  • MultiMC/Prism Launcher: Fabric 자동 설치 지원
  • packwiz: 모드팩 관리 도구
  • Fabric Installer: GUI/CLI 설치 프로그램

업데이트 방법

1. 새 버전의 Fabric Installer 다운로드
2. 원하는 마인크래프트 버전 선택
3. "Install" 클릭 (기존 설치 덮어쓰기)
4. Fabric API 최신 버전 다운로드
5. 모든 모드의 호환 버전 확인 및 업데이트

추가 자료

  • 공식 웹사이트: fabricmc.net
  • 문서: fabricmc.net/wiki
  • 디스코드: discord.gg/v6v4pMv