Architectury API | MC Mod Wiki

📖 소개

Architectury API는 shedaniel이 개발해 온 마인크래프트 모드 개발자용 **공통 API(브리지) 라이브러리**입니다. shedaniel은 Roughly Enough Items(REI), Cloth Config 같은 인기 모드도 만든 베테랑 모더로, Architectury API는 그가 만든 작품 중 가장 영향력이 큰 인프라성 모드입니다. 일반 사용자 입장에서는 직접 의식하지 않지만, **수많은 모드들이 이 API를 기반으로 Forge·NeoForge·Fabric 세 로더를 동시에 지원할 수 있게 해줍니다**.

역할은 세 가지로 요약됩니다. 모드 개발자가 Forge·NeoForge·Fabric의 API를 따로 부르지 않고 Architectury의 단일 인터페이스로만 짜면 세 로더에서 그대로 돌아가고, 블록 배치나 플레이어 사망 같은 각 로더의 이벤트도 통합된 형식으로 받아 쓸 수 있습니다. 등록·네트워킹·렌더링 같은 공통 작업도 한 방식으로 처리되죠.

**왜 이렇게 많은 모드에 들어 있는가** — Roughly Enough Items(REI), Cloth Config, Polymorph 같은 인기 모드들이 Architectury API를 기반으로 만들어졌기 때문입니다. 이 모드들이 들어간 모드팩이라면 자연스럽게 Architectury API도 함께 깔립니다. 또한 한 번 작성한 모드가 세 로더에서 모두 작동하기 때문에, 신규 모드 개발자들이 점점 Architectury API를 표준으로 채택하는 추세입니다.

사용자 입장에서 Architectury API 자체는 거의 보이지 않습니다 — 인게임 UI도 없고, 직접 사용하는 아이템·기능도 없습니다. 그저 다른 모드들이 정상 작동하도록 뒷받침해주는 인프라일 뿐입니다. 11살 자녀와의 플레이에 영향이 없는, 가장 안전한 의존성 모드 중 하나입니다.

🕒 이 모드는 언제 쓰는가

어떤 모드팩이든 자동으로 깔려 있는 경우가 대부분입니다. 직접 깔 일은 거의 없고, 다른 모드를 추가하다가 'Architectury API required' 에러가 뜰 때만 수동 추가하면 됩니다. 모드팩이 자동 처리하는 경우 신경 쓸 필요 없습니다.

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

REI(Roughly Enough Items)·Cloth Config·Polymorph 같은 인기 모드가 들어간 거의 모든 모드팩에서 자동으로 함께 사용됩니다. DarkRPG·ATM10·Better MC·Cobbleverse 등 거의 모든 현대 모드팩에 포함됩니다.

🎮 플레이 체감 변화

이 모드는 플레이 중에 존재감이 0입니다 — 의존성 라이브러리의 본질입니다. 다만 빠지면 REI 같은 핵심 모드가 작동을 멈추므로, '있는 줄도 모르는 인프라' 그 자체가 이 모드의 정체성입니다. 빠졌을 때만 비로소 이 모드가 무얼 받쳐주고 있었는지 깨닫게 됩니다.

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

Architectury API는 의존성 라이브러리라 사용자가 따라갈 'Getting Started' 흐름이 없습니다. 설치·문제 해결 관점에서 5분 정도면 충분합니다.

1단계 — 설치 확인 (2분)

인스턴스 mods 폴더에서 architectury 검색 (architectury-X.X.X-forge.jar 같은 형식)
자동 설치 모드팩에는 이미 있음
없는데 'Architectury API required' 에러가 뜨면 CurseForge에서 모드팩의 MC 버전·로더에 맞는 빌드 다운로드

2단계 — 버전 매칭 확인 (2분)

잘못된 빌드를 받으면 작동하지 않습니다.

파일 이름에서 마인크래프트 버전 확인 (예: 1.21.1)
파일 이름에서 로더 확인 (forge·neoforge·fabric 명시)
모드팩이 요구하는 메이저 버전(예: Architectury 13.x 등)도 함께 매칭

3단계 — 문제 발생 시 (선택)

Architectury 관련 크래시·오류 시:

crash-report 또는 latest.log에서 'Architectury' 또는 'architectury' 키워드 검색
'version mismatch'나 'incompatible version' 같은 메시지가 있으면 매칭되는 버전 빌드로 교체
모드팩 자체가 잘못 묶은 경우면 모드팩 디스코드 또는 Issues 페이지에 보고

다음 목표 — 추가 점검할 것 없음

Architectury API는 깔려있으면 끝입니다. 다른 모드들(REI 등)이 정상 작동하는지 확인하는 게 실질적 다음 단계이고, 이 모드 자체는 백그라운드에서 조용히 작동합니다.

💡 플레이 팁

**직접 설정할 필요 없음**: 의존성 모드이므로 깔려 있기만 하면 자동 작동합니다. 일반 플레이어가 설정 파일을 손댈 일이 거의 없습니다.
**버전 매칭이 가장 중요**: Architectury API는 마인크래프트 버전별로 별도 빌드가 있습니다. 모드팩의 MC 버전·로더에 정확히 맞는 빌드를 받아야 합니다. 자동 설치 모드팩에서는 자동 처리됩니다.
**REI(Roughly Enough Items) 사용 시 필수**: REI가 들어간 모드팩에서는 Architectury API가 반드시 함께 있어야 합니다. JEI를 쓰는 모드팩에서는 필요 없는 경우도 있지만, 대부분의 현대 모드팩은 양쪽 모두 호환되도록 의존성을 제공합니다.
**Forge·NeoForge·Fabric 모두 지원**: 어떤 로더를 쓰든 같은 모드(이름은 같지만 내부 빌드는 다름)가 작동합니다. 멀티 로더 환경의 큰 장점입니다.
**모드 충돌 시 가장 먼저 의심**: 모드 로딩 오류 메시지에 'Architectury'가 보이면 거의 100% 버전 매칭 실패입니다. 모드팩이 요구하는 정확한 Architectury API 버전을 다시 받으면 해결됩니다.

⚠️ 자주 헷갈리는 부분

• **단독 모드가 아닙니다** — Architectury API만 깔아도 플레이에 보이는 변화가 없습니다. 다른 모드들이 이 API를 활용해야만 효과가 나타나며, 이 모드 자체는 '인프라'입니다.
• **같은 이름이지만 로더별 다른 빌드**: Forge용·NeoForge용·Fabric용 빌드가 각각 다릅니다. 'Architectury'라는 이름은 같지만 다른 로더 빌드를 깔면 작동하지 않습니다. 모드팩의 로더를 정확히 확인하고 맞는 빌드를 받아야 합니다.
• **버전 호환성이 까다로움**: Architectury는 마인크래프트 버전·로더에 매우 민감해서, 모드팩 업데이트 시 버전 매칭이 깨지는 경우가 있습니다. 갑자기 모드들이 작동을 멈추면 Architectury 버전부터 확인하는 게 정석입니다.

❓ 자주 묻는 질문

Architectury API만 따로 깔면 뭐가 좋아지나요?

**아무 효과도 없습니다.** Architectury API는 라이브러리·의존성 모드라 단독으로는 변화가 없고, REI(Roughly Enough Items), Cloth Config 같은 모드가 이 API를 활용해야 비로소 효과가 나옵니다. 'REI 깔았는데 작동 안 함' 같은 상황에서 이 모드 누락이 가장 흔한 원인입니다.

왜 Forge·NeoForge·Fabric 모두 지원하나요?

**Architectury API 자체가 멀티 로더 브리지**이기 때문입니다. shedaniel(제작자)이 모드 개발자들이 한 번 작성한 코드를 세 로더 모두에서 작동시킬 수 있게 만든 인프라입니다. 그래서 같은 이름이지만 로더별로 다른 빌드(forge·neoforge·fabric jar)가 따로 존재하며, 본인 모드팩의 로더에 정확히 맞는 빌드만 작동합니다.

JEI를 쓰는 모드팩에서도 Architectury API가 필요한가요?

**JEI 자체는 Architectury가 필요 없습니다** — JEI는 Forge·NeoForge 전용으로 독자 개발된 모드입니다. 하지만 같은 모드팩에 Cloth Config 같은 다른 Architectury 기반 모드가 들어있다면 의존성으로 깔립니다. 현대 키친싱크 팩은 거의 모두 Architectury API를 포함하고 있다고 보면 됩니다.

11살 자녀와 함께 플레이해도 괜찮나요?

네, 완전히 안전합니다. 사용자가 직접 의식하고 사용하는 모드가 아니라 다른 모드의 동작을 보조하는 백그라운드 라이브러리라 시각적·메커니즘적으로 자녀가 느끼는 변화가 0입니다. 다른 모드가 안전하면 Architectury API도 안전합니다.

다른 의존성 라이브러리(Apothic Attributes·CreativeCore·Curios API 등)와 충돌하지 않나요?

**충돌 보고 거의 없습니다**. 각 라이브러리 모드가 담당하는 영역이 완전히 다릅니다 — Architectury는 멀티 로더 브리지, Apothic Attributes는 속성 시스템, CreativeCore는 CreativeMD의 작가 통합 라이브러리, Curios API는 큐리오스 슬롯 등. 같은 모드팩에 여러 라이브러리가 함께 깔려 있어도 안전하게 공존하며, 오히려 의존성이 잘 갖춰진 모드팩일수록 라이브러리 모드 수가 많은 게 정상입니다.

📦 이 모드가 포함된 모드팩

Story of Tempest

MC 1.21.1 NeoForge 어려움 RPG애니메이션

라노벨·애니 '전생했더니 슬라임이었던 건에 대하여(Tensura)' 기반 RPG 모드팩. T:Reincarnated를 중심으로 종족 진화·유니크 스킬·마법을 즐기는 멀티플레이 PvP 서버용 팩.

🎯 어울리는 분 전생슬라임(Tensura) 애니를 좋아하고, 종족 진화·유니크 스킬을 서버에서 다른 사람들과 경쟁하며 키우고 싶은 플레이어용.

DarkRPG

MC 1.21.1 NeoForge 어려움 RPG마법

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

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