Forge 문서 원본 보기

'''Forge'''(포지)는 [[마인크래프트]] Java Edition을 위한 가장 오래되고 널리 사용되는 모드 로더이다. 2011년부터 개발되어 온 Forge는 방대한 모드 생태계를 구축했으며, 대규모 모드팩의 기반이 되는 플랫폼이다.

Minecraft Forge는 LexManos와 CPW가 주도하는 오픈소스 프로젝트로, 모드 개발자들이 마인크래프트를 수정하고 확장할 수 있는 API와 라이브러리를 제공한다. 복잡한 기술 모드부터 간단한 편의 기능까지 수만 개의 모드가 Forge를 기반으로 작동한다.

== 주요 특징 ==
* '''광범위한 모드 지원''': 가장 많은 모드가 Forge를 지원
* '''안정적인 API''': 오랜 개발 기간으로 안정화된 API
* '''모드 간 호환성''': 통일된 시스템으로 모드 충돌 최소화
* '''자동 의존성 관리''': 필요한 라이브러리 자동 다운로드

== 시스템 요구사항 ==
* Java 8 이상 (마인크래프트 버전에 따라 다름)
  - 1.12.2 이하: Java 8
  - 1.13-1.16: Java 8 또는 11
  - 1.17 이상: Java 17
  - 1.20.5 이상: Java 21
* 최소 2GB RAM (모드팩은 4-8GB 권장)

== 설치 방법 ==
=== Windows ===
<pre>
1. files.minecraftforge.net에서 설치하려는 마인크래프트 버전 선택
2. "Installer" 클릭하여 다운로드
3. 다운로드한 .jar 파일 실행
4. "Install client" 선택 후 "OK" 클릭
5. 설치 완료 메시지 확인
</pre>

=== macOS/Linux ===
<pre>
1. 터미널에서 다운로드한 파일 위치로 이동
2. 다음 명령어 실행:
   java -jar forge-버전-installer.jar
3. GUI가 열리면 "Install client" 선택
4. 설치 완료 확인
</pre>

== 서버 설치 ==
<pre>
1. Forge 인스톨러 다운로드
2. "Install server" 선택
3. 서버 폴더 지정
4. 설치 완료 후 생성된 파일 확인:
   - minecraft_server.jar
   - forge-버전.jar
   - libraries 폴더
5. 서버 실행:
   java -Xmx4G -Xms2G -jar forge-버전.jar nogui
</pre>

== 모드 설치 ==
=== 기본 설치 방법 ===
<pre>
1. 호환되는 모드 다운로드 (.jar 파일)
2. 마인크래프트 폴더 열기:
   - Windows: %appdata%\.minecraft
   - macOS: ~/Library/Application Support/minecraft
   - Linux: ~/.minecraft
3. "mods" 폴더에 모드 파일 복사
4. 마인크래프트 실행 (Forge 프로필 선택)
</pre>

=== 모드 호환성 확인 ===
* 마인크래프트 버전 일치 확인
* Forge 버전 호환성 확인
* 의존성 모드 확인 (필요한 경우)

== 설정 파일 ==
=== forge.cfg ===
<pre>
# 주요 설정
general {
    # 청크 로딩 제한
    clumpingThreshold=64
    
    # 모드 정렬
    sortRecipies=true
    
    # 디버그 옵션
    enableGlobalConfig=false
    
    # 성능 설정
    alwaysSetupTerrainOffThread=true
    forgeLightPipelineEnabled=true
}

# 클라이언트 설정
client {
    # 스플래시 화면
    forgeSplashEnabled=true
    
    # 리소스팩 병합
    resourcePackCacheEnabled=true
}
</pre>

== 대표적인 Forge 모드 ==
=== 기술 모드 ===
* '''Applied Energistics 2''': 고급 저장 시스템
* '''IndustrialCraft 2''': 산업화 모드
* '''Thermal Expansion''': 기계와 에너지 시스템
* '''Ender IO''': 컴팩트한 기계 모드

=== 마법 모드 ===
* '''Thaumcraft''': 연구 기반 마법 시스템
* '''Botania''': 자연 마법 모드
* '''Blood Magic''': 피를 이용한 마법

=== 탐험/차원 모드 ===
* '''Twilight Forest''': 황혼의 숲 차원
* '''The Aether''': 천상계 차원
* '''Galacticraft''': 우주 탐험

=== 편의 모드 ===
* '''JEI (Just Enough Items)''': 아이템 검색 및 레시피
* '''JourneyMap''': 지도 모드
* '''Inventory Tweaks''': 인벤토리 정리

== 모드팩 ==
Forge를 기반으로 한 주요 모드팩:
* '''Feed The Beast (FTB)''': 다양한 테마의 모드팩
* '''All the Mods''': 대규모 종합 모드팩
* '''SkyFactory''': 스카이블록 모드팩
* '''RLCraft''': 하드코어 서바이벌

== 개발자를 위한 정보 ==
=== 개발 환경 설정 ===
<pre>
1. Forge MDK (Mod Development Kit) 다운로드
2. 압축 해제 후 프로젝트 폴더 생성
3. 터미널에서 실행:
   ./gradlew genEclipseRuns (Eclipse용)
   ./gradlew genVSCodeRuns (VS Code용)
4. IDE에서 프로젝트 임포트
</pre>

=== 기본 모드 구조 ===
<pre>
// 메인 모드 클래스
@Mod("examplemod")
public class ExampleMod {
    public static final String MOD_ID = "examplemod";
    
    public ExampleMod() {
        FMLJavaModLoadingContext.get().getModEventBus()
            .addListener(this::setup);
    }
    
    private void setup(final FMLCommonSetupEvent event) {
        // 초기화 코드
    }
}
</pre>

== 성능 최적화 ==
=== JVM 인수 ===
<pre>
# 권장 JVM 인수 (6GB RAM 할당)
-Xmx6G -Xms6G -XX:+UseG1GC -XX:+ParallelRefProcEnabled 
-XX:MaxGCPauseMillis=200 -XX:+UnlockExperimentalVMOptions 
-XX:+DisableExplicitGC -XX:+AlwaysPreTouch 
-XX:G1NewSizePercent=30 -XX:G1MaxNewSizePercent=40 
-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
</pre>

=== 모드 최적화 팁 ===
* 불필요한 모드 제거
* 설정에서 과도한 기능 비활성화
* 청크 로딩 제한 설정
* 엔티티 수 제한

== 문제 해결 ==
=== 일반적인 오류 ===
* '''크래시 리포트 읽기''': crash-reports 폴더 확인
* '''모드 충돌''': 한 번에 하나씩 모드 제거하여 원인 파악
* '''메모리 부족''': RAM 할당량 증가
* '''버전 불일치''': 모든 모드가 같은 MC/Forge 버전인지 확인

=== 호환성 문제 ===
* Forge와 Fabric은 함께 사용 불가
* OptiFine은 별도 설치 필요 (mods 폴더에 추가)
* 셰이더는 OptiFine 또는 별도 셰이더 모드 필요

== Forge vs 다른 모드 로더 ==
{| class="wikitable"
! 특징 !! Forge !! Fabric !! Quilt
|-
| 모드 수 || 가장 많음 || 보통 || 적음
|-
| 성능 || 무거움 || 가벼움 || 가벼움
|-
| 업데이트 속도 || 느림 || 빠름 || 빠름
|-
| API 복잡도 || 복잡 || 단순 || 중간
|-
| 대규모 모드팩 || 최적 || 제한적 || 제한적
|}

== 2025년 현황 ==
* '''[[NeoForge]]''': Forge의 포크 프로젝트로 일부 개발자 이동
* 마인크래프트 1.20.5 이상에서는 NeoForge 고려
* 기존 모드들의 [[NeoForge]] 이식 진행 중
* Forge는 여전히 1.20.4 이하 버전에서 주류

== 추가 자료 ==
* 공식 포럼: minecraftforge.net/forum
* 문서: mcforge.readthedocs.io
* Discord: discord.gg/minecraft-forge-server<ref>Forge 커뮤니티의 공식 Discord 서버로, 모드 개발과 사용에 대한 도움을 받을 수 있음</ref>

[[분류:마인크래프트/모드]]