Architectury API | MC Mod Wiki

📖 소개

크래시 로그나 모드 목록에서 Architectury API를 처음 보고 이 페이지에 오셨다면, 짧은 답은 이렇습니다. 직접 설치한 적이 없어도 정상입니다. 다른 모드가 이 라이브러리를 요구해서 따라 들어온 것이고, 게임 안에서 하는 일은 아무것도 없습니다.

Architectury API는 Architectury 팀(shedaniel)이 만든 멀티 로더 브리지 라이브러리입니다. 원래 모드 개발자는 Fabric용과 Forge용 코드를 따로 짜야 합니다. 블록을 등록하는 방법도, 패킷을 주고받는 방법도 로더마다 다르기 때문입니다. Architectury는 그 차이를 한 겹 덮어서, 개발자가 Architectury의 인터페이스에만 맞춰 짜면 네 로더에서 같은 코드가 돌아가게 해줍니다. Modrinth 기준 누적 다운로드는 8,500만 회가 넘습니다 — 라이브러리 모드가 이 정도 수치를 찍는 이유는 단 하나, 사람들이 이 모드를 받으러 온 게 아니라 다른 모드가 끌고 왔기 때문입니다.

내 모드팩에 왜 있나 — Roughly Enough Items(REI), Cloth Config, Polymorph 같은 모드가 Architectury 위에서 만들어졌습니다. 셋 중 하나라도 들어 있으면 Architectury API는 자동으로 함께 깔립니다. 특히 REI는 아이템 검색·레시피 조회를 담당하는 모드라 키친싱크 모드팩의 사실상 기본 구성품이고, 그래서 Architectury도 함께 기본 구성품이 됩니다.

빼면 어떻게 되나 — 이 모드를 지우면 게임이 조용해지는 게 아니라 REI를 포함한 의존 모드들이 로딩 단계에서 멈추거나 크래시합니다. 반대로 Architectury만 남기고 다른 모드를 다 지우면 인게임에서는 정말 아무 일도 일어나지 않습니다. UI도, 아이템도, 명령어도 없습니다. 라이브러리 모드가 원래 그렇습니다.

🕒 이 모드는 언제 쓰는가

직접 설치할 일은 거의 없습니다. 모드팩을 쓰고 있다면 이미 들어 있습니다. 수동으로 모드를 추가하다가 'Architectury API required' 또는 'Missing dependency: architectury' 메시지를 만났을 때만 받으면 됩니다.

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

REI·Cloth Config·Polymorph가 들어간 모드팩이라면 어디서든 로딩 시점에 관여합니다. DarkRPG를 비롯한 현대 키친싱크·RPG 모드팩 대부분이 여기에 해당합니다.

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

라이브러리 모드라 '시작하기'라 할 것이 없습니다. 실제로 필요한 건 설치 확인과 버전 대조뿐입니다.

1단계 — 이미 있는지 확인

인스턴스의 mods 폴더에서 architectury로 검색합니다. 모드팩을 설치했다면 대개 이미 있습니다. 파일명은 architectury-<버전>-<로더>.jar 형태입니다.

2단계 — 없다면, 로그가 시키는 버전을 받습니다

Missing dependency 계열 메시지에는 보통 요구 버전이 함께 적혀 있습니다. 최신 버전이 아니라 로그에 적힌 버전을 CurseForge 또는 Modrinth에서 받습니다. 받을 때 확인할 것은 두 가지입니다.

마인크래프트 버전 (예: 1.21.1)
로더 (fabric / forge / neoforge / quilt)

3단계 — 그대로 둡니다

설정할 것도, 켜고 끌 것도 없습니다. REI가 열리면 정상 작동 중입니다.

문제가 계속되면

latest.log에서 architectury를 검색해 version mismatch·incompatible 같은 단어가 함께 나오는지 봅니다. 나온다면 버전 문제이고, 나오지 않는데도 크래시한다면 Architectury가 아니라 그것을 호출한 모드 쪽을 봐야 합니다.

💡 플레이 팁

로더와 MC 버전을 둘 다 맞춰야 합니다: 파일명에 로더와 버전이 들어 있습니다(예: architectury-x.x.x-neoforge.jar). Fabric 인스턴스에 NeoForge 빌드를 넣으면 이름이 같아도 로드되지 않습니다.
메이저 버전이 마인크래프트 버전에 묶여 있습니다: Architectury의 메이저 버전은 MC 버전마다 다릅니다. 의존 모드가 특정 메이저 버전을 요구하는 경우가 있으니, 크래시 로그에 적힌 버전을 그대로 받는 게 가장 빠릅니다.
설정 파일을 찾지 마세요: 플레이어가 조정할 옵션이 없습니다. config 폴더를 뒤져도 손댈 것이 없는 게 정상입니다.
모드팩을 업데이트했다면 이 모드부터 봅니다: 업데이트 후 REI가 사라졌거나 게임이 안 켜지면, 다른 모드보다 Architectury 버전이 어긋났을 가능성이 큽니다.

⚠️ 자주 헷갈리는 부분

• 설치해도 아무 변화가 없습니다 — 고장이 아닙니다. 이 모드는 다른 모드가 호출할 때만 의미가 있고, 단독으로는 인게임 콘텐츠를 하나도 추가하지 않습니다.
• 이름은 같지만 로더별 빌드가 다릅니다 — Fabric·Forge·NeoForge·Quilt용 jar가 각각 따로 배포됩니다. '멀티 로더 지원'은 개발자가 코드를 한 번만 짜도 된다는 뜻이지, jar 하나가 모든 로더에서 돌아간다는 뜻이 아닙니다.
• JEI를 쓴다고 필요 없는 건 아닙니다 — JEI 자체는 Architectury와 무관하지만, 같은 모드팩의 다른 모드가 요구하면 어차피 들어옵니다. 'JEI 팩이니까 지워도 되겠지'가 흔한 오해입니다.

❓ 자주 묻는 질문

설치한 적이 없는데 모드 목록에 있습니다. 지워도 되나요?

지우지 마세요. 모드팩이나 다른 모드가 의존성으로 함께 설치한 것입니다. REI·Cloth Config·Polymorph 중 하나라도 쓰고 있다면 Architectury API를 지우는 순간 그 모드들이 로딩에 실패합니다. 용량도 몇 MB 수준이라 남겨서 손해 볼 것이 없습니다.

Architectury API만 깔면 뭐가 달라지나요?

아무것도 달라지지 않습니다. 새 아이템도, UI도, 명령어도 추가되지 않습니다. 이 모드는 다른 모드가 호출하는 코드 묶음이라, 호출하는 모드가 없으면 말 그대로 아무 일도 하지 않습니다.

다운로드 8,500만 회면 엄청 인기 있는 모드 아닌가요?

Modrinth 기준 85,041,399회가 맞지만, 이 수치는 인기도보다 의존성 전파를 보여주는 숫자에 가깝습니다. 사람들이 이 모드를 받으러 온 게 아니라, REI 같은 모드를 설치할 때 런처가 자동으로 함께 받아간 횟수가 대부분입니다. 라이브러리 모드의 다운로드 수는 대체로 이런 성격입니다.

Forge 빌드를 Fabric에 넣었는데 왜 안 되나요?

모드 이름이 같아도 jar는 로더별로 다릅니다. '멀티 로더 지원'은 개발자가 코드를 한 번만 작성하면 된다는 뜻이지, 하나의 jar가 모든 로더에서 돌아간다는 뜻이 아닙니다. 파일명의 -fabric / -forge / -neoforge / -quilt 부분을 인스턴스 로더와 맞춰야 합니다.

Balm이나 CreativeCore 같은 다른 라이브러리와 충돌하지 않나요?

충돌하지 않습니다. 서로 하는 일이 다릅니다 — Architectury는 로더 간 브리지, Balm은 BlayTheNinth 모드들의 공용 코드, CreativeCore는 CreativeMD 모드들의 공용 코드입니다. 라이브러리가 여러 개 깔려 있는 것은 모드팩이 잘못됐다는 신호가 아니라 모드가 많다는 신호입니다.