Bookshelf
DarkhaxDev의 모드들이 의존하는 핵심 라이브러리 모드. 직접 새 콘텐츠를 추가하진 않지만 많은 모드가 작동하려면 필수입니다.
📖 소개
Bookshelf는 DarkhaxDev(Tyler Hancock)가 2014년부터 개발·유지보수해 온 마인크래프트의 가장 오래된 코어 라이브러리 모드 중 하나입니다. 1.7.10 시절부터 지금까지 약 10년간 활발히 업데이트되고 있고, 1.21까지 Forge·NeoForge·Fabric 모두 지원합니다. **DarkhaxDev는 마인크래프트 모드 씬의 베테랑 모더로, Bookshelf를 비롯해 Dark Utilities·Enchantment Descriptions·Tool Stats·Pig Pen Cipher·Runelic·Tips·Max Health Fix 등 50개 이상의 모드를 만들고 유지해 온 작가**입니다. Bookshelf는 그 모든 모드들이 공유하는 도구상자 역할.
**왜 이런 라이브러리 모드가 필요한가** — 모드 개발자들이 자주 쓰는 도구·헬퍼·시스템(예: 등록 시스템·데이터 처리·이벤트 핸들링 등)을 중복 작성하지 않고 한곳(Bookshelf)에서 가져오기 위해서입니다. 그 결과 각 콘텐츠 모드의 코드 양이 줄어 모드 용량이 작아지고, Bookshelf 업데이트 한 번으로 의존 모드들이 모두 호환돼 유지보수가 단순해지며, 버그 수정도 한 번에 여러 모드에 반영되어 일관성이 유지됩니다. 모드팩 작가 입장에서는 'DarkhaxDev 모드 하나라도 들어 있으면 Bookshelf도 함께 들어가야 함'이라는 단순한 의존성 규칙.
**비슷한 코어 라이브러리와의 차이점** — Bookshelf는 **DarkhaxDev 작가 전용 라이브러리**라는 점이 핵심입니다. 비슷한 역할의 라이브러리로는 Architectury API(멀티 로더 통합), Balm(BlayTheNinth 작가), Citadel(Alex's Mobs/Caves 작가), CreativeCore(LittleTiles 작가), Framework(MrCrayfish 작가) 등이 있는데, 모두 각자 다른 작가의 모드들을 위한 도구상자입니다. 충돌 없이 함께 깔 수 있고, 실제로 대형 RPG 모드팩에는 이 모든 라이브러리가 동시에 들어가 있는 게 보통.
**DarkRPG에서의 역할** — DarkhaxDev의 다수 모드가 의존성을 갖기 때문에 자동으로 함께 포함됩니다. Enchantment Descriptions(마법 부여 툴팁 설명), Tool Stats(도구 능력치 표시), Tips(로딩 화면 팁), Max Health Fix(체력 동기화 버그 수정) 등이 모두 Bookshelf 위에서 작동. 직접 인식되는 콘텐츠는 없지만, 다른 모드들의 매끄러운 작동이 이 라이브러리 덕분.
11살 자녀에게 설명할 때는 **'게임 안에서는 안 보이지만, 다른 모드들이 잘 작동하도록 뒤에서 도와주는 도구상자'**라고 하면 가장 쉽습니다. 평범한 플레이에서는 의식할 일이 없고, 의식하게 되는 순간은 보통 모드 오류 메시지를 볼 때뿐입니다 — 그때도 보통 Bookshelf 자체의 문제가 아니라 의존 모드의 문제.
🕒 이 모드는 언제 쓰는가
Bookshelf 자체를 '쓸' 일은 없습니다. 의존하는 다른 DarkhaxDev 모드(Enchantment Descriptions·Tool Stats·Tips 등)가 깔려 있을 때 자동으로 작동합니다. 모드팩에 포함되어 있으면 그대로 두면 되고, 직접 모드팩에 DarkhaxDev 모드를 추가한다면 Bookshelf도 함께 다운로드해야 합니다. 다른 코어 라이브러리(Architectury·Citadel 등)와는 별개라 모두 함께 깔려 있을 수 있습니다.
📦 어떤 모드팩에서 중요한가
DarkhaxDev 모드(Enchantment Descriptions·Tool Stats·Dark Utilities 등)를 포함한 거의 모든 RPG·키친싱크 모드팩에서 뒤에서 작동합니다. DarkRPG·Better MC·ATM10·Cisco's Fantasy Medieval RPG 등 거의 대형 모드팩 전체에 들어 있다고 봐도 무방. 라이브러리이니 모든 분위기 팩에 무차별 적용됩니다 — RPG·자동화·바닐라+ 어느 쪽이든 DarkhaxDev 모드가 하나라도 들어 있으면 동반.
🎮 플레이 체감 변화
플레이 중에는 존재를 거의 인식하지 못합니다 — 좋은 라이브러리 모드의 정의입니다. 인식하게 되는 유일한 순간은 의존성 누락 오류 메시지가 뜰 때 — 예를 들어 'Enchantment Descriptions requires Bookshelf' 같은 메시지. 모드팩 설치자에게는 보이지만 플레이어에게는 거의 투명한 모드입니다. 11살 자녀가 마법 부여 툴팁의 설명을 읽고 있다면, 그 뒤에는 Bookshelf가 있는 셈.
🚀 시작 가이드 — 첫 30분 동안 해야 할 것
Bookshelf는 라이브러리 모드라 '시작'할 필요가 없습니다 — 모드팩에 자동으로 깔려 있으면 그대로 두면 됩니다. 그래도 의존성 개념을 한 번 짚어두면 후일 도움이 됩니다.
1단계 — 모드팩에 포함되어 있으면 그대로 두기 (1분)
DarkRPG 같은 대형 RPG 팩은 Bookshelf가 기본 포함되어 있습니다. 별도 행동 필요 없음.
- 모드 목록에서 'Bookshelf' 검색 → 있으면 그대로
- Catalogue가 깔려 있다면 모드 목록 옆 패널에서 작가가 'DarkhaxDev'로 표시됨
- 'Library' 카테고리에 속함
2단계 — 새 모드 추가 시 의존성 체크 (5분)
모드팩에 DarkhaxDev의 새 모드(예: Enchantment Descriptions)를 추가할 때.
- 그 모드의 CurseForge 페이지에서 'Dependencies' 섹션 확인
- 'Bookshelf' 또는 'BookshelfAPI'가 요구된다면 함께 다운로드
- Bookshelf 버전은 의존 모드와 같은 마인크래프트 버전·로더
- 함께 modlist에 추가하고 게임 재시작
3단계 — 오류 발생 시 버전 일치 확인 (필요할 때)
게임이 크래시되면 일단 Bookshelf 버전 점검.
- 모드 로더(Forge·NeoForge·Fabric)와 마인크래프트 버전에 맞는 Bookshelf인지 확인
- 보통은 모드팩 기본 설치가 정확함
- 의존 모드의 'requires Bookshelf v.X' 메시지가 뜨면 그 버전의 Bookshelf 다운로드
다음 목표
- 일상 플레이에서 Bookshelf를 신경 쓰지 않기 — 라이브러리의 좋은 모드는 '존재를 잊게 해주는 모드'입니다. 잘 작동하는 동안에는 의식할 필요 없고, 다른 모드들의 콘텐츠에 집중하세요.
- Enchantment Descriptions·Tool Stats 같은 의존 모드 활용 — 마법 부여 툴팁 읽기, 도구 능력치 비교 등 자녀와 함께 학습 도구로 활용
- 다른 코어 라이브러리 인식 — Architectury·Citadel·Balm 등도 비슷한 역할이라는 걸 알아두면 모드팩 구조 이해에 도움
- 자녀에게 의존성 개념 가르치기 — '이 모드가 작동하려면 저 모드가 필요해' 같은 시스템적 사고 학습에 좋음
💡 플레이 팁
- **임의로 제거하지 마세요** — Bookshelf를 제거하면 의존하는 모드들이 게임 시작 시 크래시됩니다. 모드팩에 포함되어 있으면 그대로 두세요. '잘 모르는 모드네' 싶어서 빼면 Enchantment Descriptions·Tool Stats 등이 함께 깨집니다.
- **버전 일치 중요** — Bookshelf는 마인크래프트 버전과 모드 로더(Forge·NeoForge·Fabric)별로 다른 빌드가 있습니다. 모드팩 기본 설치 그대로 두면 자동으로 맞춰져 있어요. 직접 추가할 때는 의존 모드의 호환 버전 확인 필수.
- **비공식 모드 추가 시 의존성 확인** — 모드팩에 새 DarkhaxDev 모드를 추가하려고 할 때 그 모드가 Bookshelf를 요구하는지 CurseForge 페이지에서 확인. 누락 시 크래시 발생. 'DarkhaxDev 작가 모드 = Bookshelf 의존성' 규칙 기억.
- **별도 설정 없음** — Bookshelf는 보통 설정 파일이 거의 없거나 매우 단순합니다. 일반 플레이어는 건드릴 일이 거의 없습니다. config 폴더에서 'bookshelf'로 시작하는 파일이 보여도 그대로 두는 게 안전.
- **오류 로그에서 자주 보임** — 다른 모드의 오류가 났을 때 로그에 Bookshelf 이름이 자주 등장합니다. 이건 보통 Bookshelf 자체의 버그가 아니라 다른 모드가 Bookshelf 기능을 호출하다가 문제를 일으킨 경우. Bookshelf만 보고 의심하지 말고, 그 라인 위쪽의 의존 모드 이름을 먼저 확인.
- **다른 코어 라이브러리와 공존 가능** — Architectury API·Citadel·Balm·CreativeCore·Framework 등 다른 작가의 라이브러리들과 충돌 없이 함께 깔립니다. 대형 모드팩에는 이 모든 라이브러리가 동시에 들어 있는 게 정상.
⚠️ 자주 헷갈리는 부분
- • **'아무 일도 안 일어나는 모드'** — 깔아도 게임 안에 변화가 없어서 '왜 깔았지?' 싶을 수 있지만, 다른 모드들이 작동하기 위한 도구상자입니다. 마치 컴퓨터에서 'Visual C++ 재배포 가능 패키지' 같은 시스템 라이브러리와 같은 역할.
- • **Forge·NeoForge·Fabric별 빌드가 다름** — 모드 로더가 다르면 Bookshelf도 다른 버전을 받아야 합니다. 모드팩이 자동으로 맞춰주니 직접 받을 일은 드물지만, 직접 모드를 추가할 때 주의.
- • **오류 로그에서 Bookshelf가 보인다고 Bookshelf 잘못은 아님** — 다른 모드 호출이 문제의 원인일 가능성이 큽니다. 'X mod called bookshelf.api.Y and failed'라는 오류는 X 모드의 문제이지 Bookshelf 문제가 아닌 게 보통.
❓ 자주 묻는 질문
Bookshelf만 깔면 뭐가 추가되나요?
**거의 아무것도 추가되지 않습니다.** Bookshelf는 라이브러리 모드라서, 자체적인 콘텐츠보다는 다른 모드들이 사용할 도구·기능을 제공합니다. 마치 컴퓨터에서 'Visual C++ 재배포 가능 패키지'를 깔아도 화면에 아무것도 안 보이지만 다른 프로그램이 작동하는 데 필수인 것과 같은 원리. 진짜 효과를 보려면 Enchantment Descriptions·Tool Stats·Dark Utilities 같은 DarkhaxDev 모드를 함께 깔아야 합니다.
꼭 깔아야 하나요?
**Bookshelf를 의존성으로 요구하는 모드가 모드팩에 있다면 필수입니다.** DarkRPG 같은 대형 팩에서는 보통 기본 포함되어 있어요 — Enchantment Descriptions(마법 부여 툴팁), Tool Stats(도구 능력치), Tips(로딩 화면 팁), Max Health Fix(체력 버그 수정) 등 자주 쓰는 QoL 모드들이 의존합니다. 자기가 사용 중인 모드 중 DarkhaxDev 작가 작품이 하나라도 있다면 Bookshelf도 필요.
Bookshelf를 제거하면 어떻게 되나요?
**Bookshelf를 의존하는 모드들이 게임 시작 시 크래시됩니다.** 임의 제거는 절대 비추천 — Enchantment Descriptions·Tool Stats 같은 모드가 'Bookshelf not found' 오류로 모두 깨집니다. 모드팩의 기본 설정 그대로 두는 게 안전. 정 빼고 싶다면 의존 모드들도 함께 제거해야 하는데, 그게 더 큰 손실이라 비추천.
Forge·NeoForge·Fabric 버전이 따로 있나요?
**네, 모드 로더별로 별도 빌드가 있고, 마인크래프트 버전에 따라서도 다릅니다.** 모드팩 기본 설치는 자동으로 맞춰져 있으니 그대로 두세요. 직접 추가할 때는 CurseForge·Modrinth에서 '본인 모드팩의 MC 버전 + 로더' 빌드를 골라 받습니다. 예: 1.21 NeoForge 팩이면 'Bookshelf 1.21 NeoForge' 빌드.
오류 로그에 Bookshelf가 자주 보이는데 문제인가요?
**꼭 그렇진 않습니다.** 다른 모드가 Bookshelf의 기능을 호출하다가 문제가 발생하면 로그에 Bookshelf 이름이 노출되는 경우가 많아요 — 예: 'X mod called bookshelf.api.Y and failed'라는 메시지는 X 모드의 문제이지 Bookshelf 자체 문제가 아님이 보통. 그 라인 위쪽의 의존 모드 이름을 먼저 확인하고, 그 모드를 검색해서 알려진 호환성 이슈가 있는지 확인하는 게 정석. Crash Assistant 같은 진단 도구도 도움됨.
