Caelus API
엘리트라 활공 판정을 아이템이 아닌 능력치(어트리뷰트)로 바꿔주는 코어 라이브러리입니다. 엘리트라를 장신구 슬롯에 착용하게 해주는 모드들이 여기에 의존합니다.
📖 소개
크래시 로그나 모드 목록에서 이 이름을 보고 들어왔다면, 먼저 알아야 할 것은 하나입니다. Caelus API를 의존성으로 요구하는 모드가 팩에 하나라도 들어 있으면, 이 파일을 지우는 순간 게임이 아예 실행되지 않습니다. 콘텐츠가 빠지는 게 아니라 시작 단계에서 의존성 누락으로 멈춥니다. 반대로 Caelus를 요구하는 모드가 없다면 이 모드만 남겨둬도 게임에는 아무 변화가 없습니다.
하는 일은 좁고 분명합니다. 바닐라 마인크래프트는 활공 가능 여부를 '가슴 슬롯에 엘리트라 아이템이 있는가'로 직접 검사합니다. Caelus는 이 검사를 엔티티 어트리뷰트 하나로 옮깁니다. 값이 0이면 활공 불가, 1 이상이면 활공 가능입니다. 바닐라 엘리트라 자체도 이 어트리뷰트를 쓰도록 교체되지만 체감 동작은 그대로입니다. 덕분에 다른 모드는 엘리트라 판정 코드를 뜯어고치는 대신 어트리뷰트에 수정치를 더하기만 하면 됩니다.
그래서 어떤 모드가 이걸 쓰냐면, 가슴 슬롯이 아닌 곳에서 활공을 부여하려는 모드들입니다. 대표적인 예가 Elytra Slot입니다. 엘리트라를 Curios·Trinkets·Accessories 계열 장신구 슬롯에 넣어 착용하게 해주는 모드인데, 그러면 가슴 칸이 비어서 갑옷을 그대로 입을 수 있습니다. 이 구조가 성립하려면 활공 판정이 가슴 슬롯에서 분리되어 있어야 하고, 그 분리를 담당하는 게 Caelus입니다. 제작자 TheIllusiveC4는 장신구 슬롯 표준인 Curios API를 만든 사람이기도 해서, 두 모드는 같은 팩에서 함께 보이는 경우가 많습니다.
다만 팩에 Caelus가 들어 있다는 사실만으로 뭔가 날 수 있게 되지는 않습니다. Caelus는 통로일 뿐이고, 어트리뷰트에 실제로 값을 넣어주는 모드와 아이템이 따로 있어야 합니다. 활공이 안 될 때 Caelus 설정을 뒤지는 것은 대개 헛수고이며, 활공을 제공하기로 되어 있는 그 모드 쪽을 봐야 합니다.
규모는 Modrinth 기준 누적 약 639만 회 다운로드입니다. 라이선스는 LGPL-3.0-or-later이고, Fabric·Forge·NeoForge 빌드가 각각 제공되며 마인크래프트 1.13.2부터 1.21.5까지 지원 범위가 이어져 있습니다.
🕒 이 모드는 언제 쓰는가
직접 쓸 일은 없습니다. 팩에 이미 들어 있으면 그대로 두고, 엘리트라를 장신구 슬롯에 착용하는 류의 모드를 직접 추가할 때만 함께 챙기면 됩니다.
📦 어떤 모드팩에서 중요한가
Curios 계열 장신구 슬롯을 쓰는 팩, 특히 Elytra Slot처럼 엘리트라를 장신구 칸으로 옮기는 모드가 들어간 구성에서 필요합니다.
🚀 시작 가이드 — 첫 30분 동안 해야 할 것
팩에 이미 있다면 아무것도 하지 마세요. 라이브러리 모드는 손대지 않는 것이 정상적인 사용법입니다.
직접 넣는 중이라면 넣으려는 모드의 배포 페이지에서 요구하는 Caelus 버전을 확인하고, 내 로더(Fabric·Forge·NeoForge)와 마인크래프트 버전에 맞는 파일을 받으세요.
동작을 확인하려면 Caelus가 아니라 활공을 제공하는 모드 쪽을 보면 됩니다. Elytra Slot을 쓰고 있다면 엘리트라를 장신구 칸에 넣고 가슴에는 갑옷을 입은 상태로 높은 곳에서 뛰어내려 보세요. 활공이 되면 정상입니다.
💡 플레이 팁
- 활공이 안 될 때 Caelus를 의심하는 것은 대개 순서가 틀렸습니다. 활공을 부여하기로 된 모드의 아이템이 제대로 장착됐는지, 그 모드 설정에서 해당 기능이 켜져 있는지를 먼저 확인하세요.
- 로더별로 파일이 다릅니다. Fabric·Forge·NeoForge 빌드가 따로 나오므로 팩과 다른 로더용 파일을 넣으면 로드되지 않습니다. 팩이 준 파일을 그대로 두는 것이 가장 안전합니다.
- 수동으로 모드를 추가하다 Caelus를 요구받았다면, 마인크래프트 버전뿐 아니라 요구 모드가 명시한 Caelus 메이저 버전까지 맞춰야 합니다. 버전이 어긋나면 로그에 Caelus 이름이 뜨지만 실제 원인은 버전 불일치입니다.
⚠️ 자주 헷갈리는 부분
- • Caelus를 깔았다고 날 수 있게 되는 것이 아닙니다. 활공 능력을 실제로 부여하는 아이템이나 능력은 다른 모드가 제공하고, Caelus는 그 값을 받아주는 자리만 만들어 둡니다.
- • Curios와 역할이 다릅니다. Curios는 장신구 슬롯이라는 '칸'을 만들고, Caelus는 활공 판정을 어트리뷰트로 바꿉니다. 두 모드는 같은 제작자 작품이고 자주 함께 쓰이지만, Curios가 Caelus를 요구하는 것은 아닙니다. 둘을 실제로 이어 붙이는 것은 Elytra Slot 같은 별도의 모드입니다.
- • 장신구 슬롯이 나오는 모드라고 해서 전부 Caelus를 쓰는 것은 아닙니다. 예를 들어 Artifacts는 장신구 모드지만 Caelus를 의존성으로 요구하지 않습니다. 어떤 모드가 Caelus를 필요로 하는지는 그 모드의 배포 페이지에 적힌 의존성 목록이 정답입니다.
- • 로그에 caelus가 찍혔다고 해서 Caelus가 고장 난 것은 아닙니다. 대개는 Caelus를 부르는 쪽 모드와의 버전·로더가 맞지 않아 호출이 실패한 흔적입니다.
❓ 자주 묻는 질문
Caelus API만 깔면 날 수 있나요?
아니요. Caelus는 활공 판정을 어트리뷰트로 바꿔 두는 역할만 합니다. 그 어트리뷰트를 실제로 올려주는 아이템이나 능력은 다른 모드가 제공해야 합니다. Caelus 단독으로는 게임에 보이는 변화가 없습니다.
지우면 어떻게 되나요?
이 모드를 의존성으로 요구하는 모드가 팩에 있다면 게임이 실행되지 않습니다. 기능이 조용히 빠지는 것이 아니라 시작 단계에서 의존성 누락으로 중단됩니다. 요구하는 모드가 하나도 없다면 지워도 게임 동작에는 차이가 없습니다.
엘리트라와 같이 쓸 수 있나요?
네. Caelus는 바닐라 엘리트라도 같은 어트리뷰트를 쓰도록 바꿔 두기 때문에 두 방식이 충돌하지 않습니다. 체감상 바닐라 엘리트라 동작은 그대로입니다.
어떤 모드가 Caelus를 필요로 하나요?
가슴 슬롯 밖에서 활공을 부여하려는 모드입니다. 확인된 대표 사례는 엘리트라를 장신구 슬롯에 착용시키는 Elytra Slot입니다. 장신구 모드라고 해서 모두 해당하지는 않으니, 각 모드의 배포 페이지에 적힌 의존성 목록으로 확인하는 것이 정확합니다.