다음 단계 — 추가 리소스와 커뮤니티
NeoForge 26 마스터 학습 코스 완주 축하. 공식 문서, 커뮤니티, 심화 라이브러리, 모드 배포 방법까지 향후 학습 방향을 안내합니다.
🎉 NeoForge 26 마스터 학습 코스 완료를 축하합니다! 환경 설정(phase-0)부터 4개 마스터 캡스톤 모드 자작(phase-6)까지 마쳤습니다. 이제 자신만의 모드를 만들 준비가 되었습니다.
외부 리소스
코스를 마쳤다고 학습이 끝나는 건 아닙니다. 아래 리소스들은 실제 모딩 작업에서 자주 참조하게 될 곳들입니다.
공식 채널
| 리소스 | 설명 | 링크 |
|---|---|---|
| NeoForge 공식 문서 | API 레퍼런스, 가이드, 마이그레이션 노트 | docs.neoforged.net |
| NeoForge Discord | 실시간 질문, 공지, 커뮤니티 쇼케이스 채널 | discord.neoforged.net |
| NeoForge GitHub | 소스 코드, 이슈 트래커, PR | github.com/neoforged/NeoForge |
커뮤니티
| 리소스 | 설명 | 링크 |
|---|---|---|
| r/feedthebeast | 모드팩, 모드 개발 토론 Reddit 커뮤니티 | reddit.com/r/feedthebeast |
| NeoForge Community Showcase | Discord 내 #community-showcase 채널. 완성 모드 공유 | Discord 참고 |
심화 라이브러리
| 라이브러리 | 용도 | 링크 |
|---|---|---|
| Mixin | Vanilla 클래스 바이트코드 직접 패치 | github.com/SpongePowered/Mixin |
| GeckoLib | Blockbench 모델 + 커스텀 애니메이션 | github.com/bernie-g/geckolib |
| KubeJS | JavaScript로 레시피·이벤트 스크립팅 | kubejs.com |
모드 배포 플랫폼
| 플랫폼 | 설명 | 링크 |
|---|---|---|
| CurseForge | 가장 큰 Minecraft 모드 배포 플랫폼 | curseforge.com/minecraft |
| Modrinth | 오픈소스 친화적 모드 배포 플랫폼 | modrinth.com |
NeoForge 26에서 매핑이 필요 없는 이유
구버전 튜토리얼을 보면 Mojang 매핑, Parchment, Yarn 같은 용어가 자주 나옵니다. 이게 뭔지, 왜 이제는 신경 쓰지 않아도 되는지 간단히 정리합니다.
과거의 문제: Mojang은 오랫동안 Minecraft 소스 코드를 난독화해서 배포했습니다. a.b(), c.d 같은 이름으로 컴파일된 코드를 모더들이 읽을 수 있게 변환하려면 별도의 매핑 파일이 필요했습니다.
1.20.5 이후 변화: Mojang이 공식적으로 난독화를 제거했습니다. BlockEntity, ItemStack, ServerPlayer 같은 원본 이름이 그대로 배포됩니다.
NeoForge 26: 이 변화를 완전히 수용합니다. 모든 클래스, 메서드, 필드 이름이 사람이 읽을 수 있는 형태입니다.
Parchment는? 파라미터 이름까지 추가해주는 선택적 매핑입니다. 필수가 아닙니다. IDE 자동완성이 p_12345_ 같은 파라미터 이름을 보여줄 때 불편하다면 추가할 수 있지만, 코스 전체를 Parchment 없이 진행했고 문제없었습니다.
향후 학습 주제
코스에서 다루지 않은 심화 주제들입니다. 관심 분야에 따라 골라서 탐구하세요.
Mixin — Vanilla 클래스 직접 패치
NeoForge API로 해결할 수 없는 동작을 바꿔야 할 때 씁니다. Java 바이트코드 수준에서 Vanilla 클래스를 수정합니다.
주의할 점이 있습니다. Mixin은 강력하지만 다른 모드와 충돌하기 쉽습니다. 같은 메서드를 여러 모드가 동시에 패치하면 예측 불가능한 동작이 생깁니다. NeoForge API로 해결 가능한 건 Mixin 대신 API를 쓰는 게 원칙입니다.
GeckoLib — 커스텀 모델과 애니메이션
Blockbench에서 만든 3D 모델과 애니메이션을 Minecraft 엔티티, 블록, 아이템에 적용합니다. 기본 Minecraft 애니메이션 시스템보다 훨씬 유연합니다.
커스텀 몹을 만들거나 복잡한 기계 블록 애니메이션이 필요할 때 GeckoLib이 표준 선택지입니다.
KubeJS — 스크립트 기반 모딩
JavaScript로 레시피 추가, 이벤트 처리, 아이템 속성 변경을 할 수 있습니다. Java 코드 변경 없이 데이터팩을 강화하는 느낌입니다.
모드팩 제작자들이 많이 씁니다. 모드 자체를 만드는 게 아니라 기존 모드들을 조합하고 커스터마이징할 때 유용합니다.
JEI 통합 — 인게임 레시피 뷰어
Just Enough Items(JEI)는 Minecraft에서 가장 많이 쓰이는 레시피 뷰어 모드입니다. 자신의 모드에 커스텀 레시피 카테고리를 추가하면 플레이어가 인게임에서 바로 확인할 수 있습니다.
JEI API를 통해 커스텀 기계의 레시피를 등록하는 방법은 JEI 공식 문서와 예제를 참고하세요.
모드 배포하기
완성한 모드를 세상에 공개하는 절차입니다.
1. GitHub 저장소 공개
examplemod-template-26.1.2/를 기반으로 만든 프로젝트를 GitHub에 올립니다. README.md에 모드 설명, 설치 방법, 의존 모드 목록을 적어두세요.
2. 라이선스 선택
| 라이선스 | 특징 |
|---|---|
| MIT | 가장 자유로운 오픈소스. 상업적 사용 허용 |
| Apache-2.0 | MIT와 비슷하지만 특허 조항 포함 |
| CC-BY-NC | 비상업적 사용만 허용. 모드팩 포함 제한 가능 |
| ARR (All Rights Reserved) | 소스 비공개. 재배포 금지 |
모드팩에 포함되길 원한다면 MIT나 Apache-2.0을 권장합니다. CC-BY-NC는 모드팩 제작자들이 꺼리는 경우가 많습니다.
3. CurseForge / Modrinth 등록
두 플랫폼 모두 등록하는 게 노출 면에서 유리합니다.
- 계정 생성 후 프로젝트 페이지 만들기
- 모드 설명, 스크린샷, 의존 모드 목록 작성
./gradlew build로 생성된 JAR 파일 업로드- NeoForge 버전과 Minecraft 버전 태그 정확히 지정
⚠️ 외부 링크 깨짐 검증 본문의 모든
https://링크는 작성 시점(2026-05-27)에 유효합니다. 시간이 지나 링크가 깨지면 archive.org Wayback Machine을 활용하세요.
💌 코스 후기 / 피드백 이 코스가 도움이 되었다면 GitHub 저장소에 ⭐ 부탁드립니다. 개선 제안이나 오타는 Issue로 남겨주세요.