Citadel | MC Mod Wiki

📖 소개

Citadel은 AlexModGuy(sbom_xela)가 자신의 모드들을 돌리기 위해 만든 라이브러리입니다. 여러 모드가 같은 코드를 반복해서 갖고 있을 이유가 없으니, 공통으로 쓰는 부분을 따로 떼어 낸 것입니다. Alex's Mobs, Alex's Caves, Ice and Fire: Dragons, Rats — 이 작가의 모드가 모드팩에 하나라도 들어 있으면 Citadel도 함께 들어옵니다.

무엇을 담당하는가. 바닐라 마인크래프트의 렌더링·AI 코드는 좀비 수준의 몹을 기준으로 만들어져 있습니다. 캥거루가 뛰면서 주머니 속 새끼를 내밀거나, 용이 날개를 접으며 착지하거나, 거대한 몹의 몸통이 부위별로 따로 움직이는 동작은 바닐라가 제공하는 도구만으로는 다루기 번거롭습니다. Citadel은 그런 몹을 만들기 위한 애니메이션·모델·AI 유틸리티, 그리고 여러 모드가 공유하는 설정·네트워크 처리 코드를 제공합니다.

혼자 설치하면 아무 일도 일어나지 않습니다. 새 몹도, 아이템도, 블록도 추가되지 않습니다. Citadel이 하는 일은 전부 다른 모드가 호출할 때만 의미가 있습니다. 반대로 이걸 빼면 위 모드들은 실행되지 않고 시작 단계에서 크래시합니다.

로더 지원 범위를 먼저 보세요. Citadel은 Forge와 NeoForge만 지원하고 Fabric 빌드가 없습니다. Alex's Mobs를 Fabric 인스턴스에 넣으려다 막히는 이유가 대부분 여기 있습니다. Modrinth 기준 1,360만 회 이상 다운로드되었고, 1.14.4부터 1.21.1까지의 버전을 지원합니다.

설정이 하나 있습니다. 청크가 생성될 때 추가되는 엔티티 수의 배율(chunkGenSpawnModifier, 기본 1.0)입니다. 0이면 청크 생성 시 엔티티가 추가되지 않고, 2면 두 배가 됩니다. 제작자 주석도 "동물을 스폰 목록에 많이 추가하는 모드들에 유용하다"고 밝히는데, Citadel을 요구하는 Alex's Mobs 계열이 정확히 그런 모드입니다. 야생 동물이 지나치게 많다고 느껴지면 여기서 줄이면 됩니다.

🕒 이 모드는 언제 쓰는가

직접 설치할 일은 없습니다. Alex's Mobs·Alex's Caves·Ice and Fire·Rats 중 하나를 넣는 순간 함께 필요해지고, 모드팩이라면 이미 들어 있습니다.

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

Alex's Mobs나 Alex's Caves가 들어간 모드팩이면 어디든 있습니다. 생물 다양성을 늘리는 콘텐츠 팩, RPG 팩, 탐험 위주 팩 대부분이 해당합니다.

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

Citadel에는 진행할 내용이 없습니다. 실제로 필요한 건 설치 상태 확인과, 문제가 생겼을 때 어디를 볼지 아는 것입니다.

1. 있는지 확인

mods 폴더에서 citadel을 검색합니다. Alex's Mobs나 Alex's Caves가 있는데 Citadel이 없다면, 게임은 애초에 켜지지 않았을 것입니다.

2. 로더가 맞는지 확인

Forge 또는 NeoForge여야 합니다. Fabric 인스턴스에 Alex 시리즈를 얹으려고 한 상황이라면, 여기서 계획을 바꿔야 합니다 — 대체 빌드가 없습니다.

3. 버전 짝 맞추기

의존 모드를 수동으로 업데이트했다면 Citadel도 같은 시점의 빌드로 맞춥니다. 로딩 중 발생하는 오류의 상당수가 이 불일치에서 나옵니다.

그 다음은 그냥 두면 됩니다. Alex's Mobs의 몹을 만나는 것이 Citadel이 정상 작동한다는 증거입니다.

💡 플레이 팁

Fabric 인스턴스에는 넣을 수 없습니다: Citadel은 Forge·NeoForge 전용이고 Fabric 빌드가 없습니다. Alex's Mobs를 Fabric에서 쓰려는 시도가 막히는 원인이 대체로 이것입니다.
임의로 지우지 마세요: Alex's Mobs·Alex's Caves·Ice and Fire·Rats가 모두 시작 단계에서 크래시합니다. 게임 중에 문제가 생기는 게 아니라 아예 켜지지 않습니다.
버전은 의존 모드에 맞춥니다: Alex's Mobs를 업데이트했다면 Citadel도 그에 맞는 버전이어야 합니다. 둘의 버전이 어긋나면 '메서드를 찾을 수 없다'는 식의 로딩 오류가 납니다.
야생 동물이 너무 많으면 chunkGenSpawnModifier를 낮추세요 — 청크 생성 시 추가되는 엔티티 수의 배율이고 기본값은 1.0입니다. 0으로 두면 아예 추가되지 않습니다.
크래시 로그에 Citadel이 보여도 원인은 보통 다른 곳입니다: Citadel의 코드를 거쳐 실행되기 때문에 스택 트레이스에 이름이 자주 등장합니다. Alex's Mobs·Alex's Caves 쪽의 버전과 설정을 먼저 확인하세요.

⚠️ 자주 헷갈리는 부분

• Alex's Mobs와 Citadel은 다른 모드입니다: Alex's Mobs가 실제 몹과 아이템을 추가하는 콘텐츠 모드이고, Citadel은 그 모드가 동작하기 위한 코드 기반입니다. Citadel만 깔면 몹은 하나도 늘어나지 않습니다.
• 이름이 같은 다른 것들과 무관합니다: 'Citadel'이라는 이름은 다른 게임·다른 소프트웨어에서도 쓰입니다. 여기서 말하는 Citadel은 AlexModGuy가 만든 마인크래프트 라이브러리 하나뿐입니다.

❓ 자주 묻는 질문

Citadel만 설치하면 뭐가 추가되나요?

아무것도 추가되지 않습니다. 몹도, 아이템도, 블록도 없습니다. Citadel은 AlexModGuy의 다른 모드들이 호출하는 코드 묶음이라서, 그 모드들이 함께 있어야만 의미가 있습니다.

어떤 모드가 Citadel을 필요로 하나요?

같은 작가(AlexModGuy)의 모드들입니다. Alex's Mobs, Alex's Caves, Ice and Fire: Dragons, Rats가 대표적입니다. 이 중 하나라도 모드팩에 들어 있으면 Citadel이 함께 있어야 하고, 없으면 해당 모드는 게임 시작 단계에서 크래시합니다.

Fabric에서 쓸 수 있나요?

쓸 수 없습니다. Citadel은 Forge와 NeoForge만 지원합니다. Fabric 빌드가 존재하지 않기 때문에, Alex's Mobs 계열을 Fabric 인스턴스에서 돌리는 방법도 없습니다. Forge나 NeoForge 인스턴스를 따로 만드는 수밖에 없습니다.

크래시 로그에 Citadel이 나오는데 이 모드가 문제인가요?

대부분 아닙니다. Alex's Mobs 같은 모드는 실행 경로가 Citadel의 코드를 거치기 때문에, 다른 모드에서 발생한 오류라도 스택 트레이스에 Citadel의 이름이 함께 찍힙니다. 로그에서 실제로 확인해야 할 것은 어떤 콘텐츠 모드가 호출을 시작했는지, 그리고 그 모드와 Citadel의 버전이 서로 맞는지입니다.

Alex's Mobs를 넣었더니 동물이 너무 많습니다.

Citadel 설정의 chunkGenSpawnModifier를 낮추면 됩니다. 청크 생성 시 추가되는 엔티티 수의 배율이고 기본값은 1.0, 0으로 두면 추가되지 않습니다. 이미 생성된 청크에는 적용되지 않습니다.