마무리와 통합 빌드
마스터 트랙 캡스톤을 README로 정리하고, tools·dimension·machine·capstone 4개 JAR을 함께 로드해 End-to-End 흐름을 검증합니다.
마무리와 통합 빌드
캡스톤의 마지막 단계는 코드를 더 추가하는 일이 아니라, 4개 모드가 하나의 플레이 흐름으로 연결되는지 증명하는 일입니다. 지금까지 만든 master_tools, master_dimension, master_machine, master_capstone은 각각 독립 주제를 다뤘지만, 최종 결과물은 하나의 모드팩처럼 동작해야 합니다.
이 챕터에서는 capstone/README.md로 전체 흐름을 정리하고, 4개 JAR 동시 로드와 End-to-End 시나리오를 점검합니다.
1. README.md로 최종 흐름 고정
examplemod-master-projects/capstone/README.md는 캡스톤을 다시 열었을 때 가장 먼저 읽는 문서입니다. 여기에 다음 3가지를 반드시 남깁니다.
- 어떤 모드를 통합하는가
- 플레이어가 어떤 순서로 진행하는가
- 어떤 의존성을 함께 로드해야 하는가
# Master Capstone - NeoForge 26 통합 캡스톤 (마스터 트랙 #4)
3개 마스터 트랙 모드(tools/dimension/machine)를 통합한 종합 캡스톤 모드.
## 핵심 게임 루프
1. 차원 입장
2. 광물 채굴
3. 귀환 + 가공
4. 몹 처치
5. 사운드/파티클 효과README의 목적은 튜토리얼 본문을 반복하는 것이 아닙니다. 전체 시스템을 한 화면에서 이해하게 하는 지도입니다. 코드 파일 목록보다 플레이 흐름을 먼저 보여주면, 나중에 버그를 추적할 때 어느 모드가 어느 단계에 관여하는지 빠르게 판단할 수 있습니다.
2. 최종 모드 메타 확인
examplemod-master-projects/capstone/src/main/templates/META-INF/neoforge.mods.toml의 표시 정보는 캡스톤의 의도를 바로 드러내야 합니다.
displayName="Master Capstone"
description='''tools/dimension/machine 통합 캡스톤 — 차원→채굴→가공→몹 전체 게임 루프'''이 이름과 설명은 Mods 메뉴에서 사용자가 확인하는 첫 정보입니다. 캡스톤은 독립 기능 하나가 아니라 통합 시나리오이므로, 설명에도 차원·채굴·가공·몹 흐름을 명시합니다.
3. 4개 JAR 순차 빌드
마스터 트랙은 4개 프로젝트로 분리되어 있으므로 각 프로젝트 루트에서 빌드합니다.
cd "examplemod-master-projects\tools"; .\gradlew.bat build
cd "..\dimension"; .\gradlew.bat build
cd "..\machine"; .\gradlew.bat build
cd "..\capstone"; .\gradlew.bat build빌드가 끝나면 각 프로젝트의 build/libs/에서 JAR을 확인합니다.
| 프로젝트 | 로드 역할 |
|---|---|
tools | Ruby/Sapphire 재료와 도구 Tier 제공 |
dimension | Magic Realm 차원과 포탈 제공 |
machine | Crusher BlockEntity와 Recipe 타입 제공 |
capstone | WorldGen, GemGuardian, 이벤트, 사운드·파티클 통합 |
⚠️ 한 모드 누락 시 로드 실패
4개 JAR(tools/dimension/machine/capstone) 중 하나라도mods/에 없으면:
→MasterCapstoneMod의존성 검사 실패
→Missing required dependency master_tools에러
항상 4개 모두mods/에 배치하세요.neoforge.mods.toml에required의존성이 명시되어 있습니다.
4. Mods 메뉴에서 동시 로드 확인
게임을 실행한 뒤 Mods 메뉴에서 다음 4개 항목이 모두 보이는지 확인합니다.
- Master Tools
- Master Dimension
- Master Machine
- Master Capstone
Mods 메뉴에서 4개가 모두 보이는지 확인하는 것이 통합 검증의 첫 관문입니다. 4개 중 하나라도 보이지 않으면 End-to-End 검증을 시작하지 말고, 먼저 해당 JAR이 mods/ 폴더에 있는지 확인합니다.
📷 스크린샷 자리 (직접 캡처해 추가하세요)
End-to-End 게임 루프 점검 — 4개 모드 동시 로드와 흐름
5. End-to-End 시나리오
최종 검증은 아래 순서대로 진행합니다. 외부 배포 자동화나 모드 포털 업로드는 이 코스 범위가 아닙니다. 여기서는 로컬 통합 플레이가 끝까지 이어지는지만 확인합니다.
- Master Tools 곡괭이 획득
master_dimension의 MagicIgniter로 Magic Portal 점화- 포탈 통과 후 Magic Realm 진입
- 지하 탐색 중
master_capstoneRuby Ore 발견 - Master Tools 곡괭이로 Ruby Ore 채굴
- 원래 차원으로 귀환
- Master Machine Crusher 설치
- Ruby Ore를 Crusher에 넣어 정제 보석 획득
- 정제 보석 우클릭으로 enchant 파티클 확인
- 선택 검증: GemGuardian 처치 후 MagicCore 드롭 확인
이 시나리오는 단순 체크리스트가 아니라 모드 간 계약 검증입니다. 예를 들어 Crusher 단계에서 실패한다면 capstone의 recipe JSON 또는 machine의 recipe type 연결을 의심해야 합니다. 차원 입장에서 실패한다면 dimension 모드 또는 의존성 로드 순서를 먼저 확인합니다.
6. 완료 기준
마스터 캡스톤은 다음 조건을 모두 만족하면 완료로 봅니다.
- 4개 프로젝트가 각각 빌드된다.
- 4개 JAR이 같은
mods/폴더에 들어 있다. - Mods 메뉴에서 4개 모드가 모두 표시된다.
- Magic Realm 진입 → 광물 채굴 → 귀환 → Crusher 가공 → 보석 사용 효과까지 이어진다.
- README.md만 읽어도 전체 구조와 실행 순서를 이해할 수 있다.
여기까지 완료하면 마스터 트랙 #4는 단일 기능 튜토리얼이 아니라, 여러 모드가 서로 계약을 맺고 하나의 게임 루프를 만드는 통합 예제로 마무리됩니다.