YUNG's API | MC Mod Wiki

📖 소개

YUNG's API는 YUNGNICKYOUNG이 자기 모드들을 위해 만든 라이브러리입니다. 모드 페이지가 스스로 "YUNG의 모드들을 위한 라이브러리 모드"라고 밝히고 있으며, 게임 안에 추가되는 콘텐츠는 없습니다.

API가 제공하는 것 (모드 페이지 기준): - AutoRegistration 시스템 (1.18+) — 어노테이션 하나로 필드를 등록할 수 있고, 모드 로더에 상관없이 동작합니다 - Jigsaw Manager 재구현 — 바닐라 Jigsaw 매니저를 성능 개선과 함께 다시 구현한 것으로, 커스텀 풀 요소 타입과 여러 속성을 추가로 지원합니다. 작가 본인이 Better Dungeons 코드를 실제 사용 예로 제시합니다 - 구조물 탐색용 criteria trigger — 지정한 구조물이 존재하지 않으면 바닐라처럼 즉시 통과 처리되지 않고 안전하게 실패합니다 - JSON 직렬화·역직렬화 인터페이스 (타입 어댑터 내장) - 벡터·컬럼 위치용 경량 수학 유틸리티 - BlockStateRandomizer / ItemRandomizer — 구조물에 블록·아이템 랜덤화를 붙이기 위한 데이터 추상화

어떤 모드가 의존하는가. YUNG의 구조물 모드 전부가 이 API를 필수 의존성으로 요구합니다 — Better Dungeons, Better Mineshafts, Better Strongholds, Better Desert Temples, Better Jungle Temples, Better Ocean Monuments, Better Witch Huts, Better Nether Fortresses, Better End Island, Better Caves, Cave Biomes, Bridges, Extras. 모드팩에 이 중 하나라도 들어 있으면 YUNG's API도 함께 들어옵니다.

Paxi도 YUNG's API에 의존합니다. Paxi는 데이터팩·리소스팩을 월드마다 따로 넣지 않고 config/paxi 폴더에서 전역으로 불러오게 해 주는 별개의 유틸리티지만, 같은 작가의 모드답게 이 API를 필수로 요구합니다. 즉 두 모드는 하는 일은 다르되 '서로 무관'하지는 않습니다.

Fabric 환경에서는 YUNG의 모드들이 Fabric API와 Cloth Config도 함께 요구합니다(Mod Menu는 선택). Forge·NeoForge 환경에서는 YUNG's API만 있으면 됩니다.

라이선스는 LGPL-3.0-only입니다.

🕒 이 모드는 언제 쓰는가

YUNG의 모드가 모드팩에 하나라도 있으면 자동으로 함께 로드됩니다. 사용자가 조작할 부분은 없습니다.

📦 어떤 모드팩에서 중요한가

YUNG의 구조물 모드(Better Dungeons·Better Mineshafts·Better Strongholds 등)를 포함한 모드팩. Paxi를 쓰는 모드팩에도 함께 들어갑니다.

🚀 시작 가이드 — 첫 30분 동안 해야 할 것

1단계 — 모드팩에 이미 있는지 확인. YUNG의 모드나 Paxi가 들어 있다면 이 API도 함께 들어 있습니다.

2단계 — 그대로 둡니다. 설정할 것도, 조작할 것도 없습니다.

3단계 — 직접 모드를 추가하는 경우. Better Dungeons 같은 YUNG 모드를 개별로 넣는다면 YUNG's API를 같은 마인크래프트 버전·로더로 함께 받아야 하고, Fabric이라면 Fabric API와 Cloth Config도 필요합니다.

💡 플레이 팁

임의로 빼지 마세요 — YUNG의 모드는 전부 이 API를 필수 의존성으로 요구합니다. 빠지면 해당 모드들이 로드되지 않습니다.
설정할 것이 없습니다 — 라이브러리라 자체 설정도, JEI 검색 결과도 없습니다.
버전을 맞추세요 — 모드팩 업데이트 시 YUNG's API 버전이 구조물 모드가 요구하는 버전과 어긋나면 로드에 실패합니다. 함께 갱신하는 게 안전합니다.
Fabric이라면 Fabric API·Cloth Config도 필요합니다 — YUNG's API 하나로는 Fabric용 YUNG 모드가 뜨지 않습니다.
Paxi를 쓰고 있다면 이미 깔려 있습니다 — Paxi도 YUNG's API를 필수로 요구합니다.

⚠️ 자주 헷갈리는 부분

• '아무 일도 안 일어남'이 정상입니다 — 콘텐츠가 없는 라이브러리입니다. 단독 설치는 의미가 없습니다.
• Paxi와 다른 모드입니다 — 같은 작가지만 Paxi는 데이터팩·리소스팩을 전역으로 불러오는 유틸리티이고, YUNG's API는 코드 라이브러리입니다. 다만 Paxi 쪽이 이 API에 의존하는 관계입니다.

❓ 자주 묻는 질문

어떤 모드가 이 API를 요구하나요?

YUNG의 모드 전부입니다. Better Dungeons, Better Mineshafts, Better Strongholds, Better Desert Temples, Better Jungle Temples, Better Ocean Monuments, Better Witch Huts, Better Nether Fortresses, Better End Island, Better Caves, Cave Biomes, Bridges, Extras — 그리고 Paxi까지 필수 의존성으로 요구합니다.

이 API만 깔면 뭐가 생기나요?

아무것도 생기지 않습니다. 콘텐츠가 없는 라이브러리이고, 다른 모드가 요구할 때만 의미가 있습니다.

Paxi와 뭐가 다른가요?

Paxi는 config/paxi 폴더에 넣어 둔 데이터팩·리소스팩을 모든 월드에 자동으로 적용해 주는 유틸리티 모드입니다. YUNG's API는 모드 개발용 코드 라이브러리이고요. 같은 작가의 모드지만 하는 일이 다르며, Paxi 쪽이 YUNG's API를 의존성으로 요구합니다.

빼도 되나요?

안 됩니다. 의존하는 YUNG 모드들이 로드되지 않습니다.

📦 이 모드가 포함된 모드팩

Home Project 1

MC 1.20.1 Forge 어려움 RPG보스

3인 로컬 멀티를 위해 빈 프로필에서 직접 조립한 1.20.1 Forge 커스텀 모드팩. 보스·스킬트리·퀘스트 중심으로 73개를 5단계에 나눠 쌓은 조립 레시피를 인터랙티브 체크리스트로 공개합니다.

🎯 어울리는 분 보스전·스킬트리·3인 협동을 직접 구성해보고 싶은 분에게 맞습니다.

DarkRPG

MC 1.20.1 Fabric 어려움 RPG마법

흡혈귀·드래곤·마법·퀘스트가 결합된 본격 RPG 모드팩. Epic Fight 패링 전투와 풍부한 보스 사냥으로 새로운 진행 흐름이 만들어집니다.

🎯 어울리는 분 보스 사냥 퀘스트와 패링 기반 액션 RPG를 좋아하는 가족 단위 플레이어에게 잘 맞습니다.