Bookshelf
Darkhax의 오픈소스 라이브러리 모드. 여러 모드가 공유하는 코드 기반을 제공하며, 디버그 명령어와 데이터팩 기능도 일부 포함합니다.
📖 소개
Bookshelf는 Darkhax가 만든 오픈소스 라이브러리 모드입니다. 코드·프레임워크·유틸리티를 모아 둔 모음집이고, 많은 모드가 이 코드 기반 위에서 동작합니다. 1.7.10 시절부터 최신 버전까지 이어져 온 오래된 프로젝트이며, Forge·NeoForge·Fabric·Quilt를 모두 지원합니다.
라이브러리 모드가 왜 필요한가 — Bookshelf 같은 라이브러리를 쓰면 서로 무관해 보이는 모드들이 같은 코드 기반의 일부를 공유할 수 있습니다. 그만큼 개별 모드를 만드는 데 드는 시간과 노력이 줄고, 라이브러리 쪽 코드는 더 넓은 범위의 환경과 커뮤니티에서 검증되기 때문에 버그가 줄고 성능이 좋아지는 효과도 있습니다.
플레이어에게도 쓸모가 있습니다. 순수하게 개발자용만은 아닙니다.
- 디버그 명령어 — 예를 들어 /bookshelf hand로 손에 든 아이템의 ID를 확인할 수 있습니다.
- 데이터팩 기능 — 아이템을 소비하는 대신 내구도를 깎는 조합 레시피 같은, 바닐라에 없는 데이터팩 기능들이 추가됩니다.
모드 제작자용 기능으로는 JSON/네트워크/NBT 직렬화, 유틸리티 함수, 레지스트리 관리자, 새 레시피·재료·전리품 조건·전리품 수정자·아이템 프레디케이트 타입 등이 들어 있습니다.
실제 의존 관계 — Darkhax의 Enchantment Descriptions와 Dark Utilities는 (1.21.1 기준) Bookshelf를 필수 의존성으로 요구합니다. 다만 같은 모드들이 Prickle이라는 또 다른 Darkhax 라이브러리도 함께 요구하니, 직접 모드를 추가할 때는 CurseForge·Modrinth의 의존성 목록을 그대로 따르는 게 안전합니다.
🕒 이 모드는 언제 쓰는가
Bookshelf 자체를 '쓰는' 일은 거의 없습니다. 이걸 요구하는 모드가 깔려 있으면 자동으로 동작하고, 모드팩에 이미 포함되어 있으면 그대로 두면 됩니다. 다만 아이템 ID를 확인해야 할 때 /bookshelf hand는 실제로 유용합니다.
📦 어떤 모드팩에서 중요한가
Darkhax의 모드를 하나라도 포함한 모드팩이면 뒤에서 함께 돌아갑니다. 대형 모드팩은 보통 서로 다른 제작자의 라이브러리 모드를 여럿 동시에 포함하고 있으며, 그중 하나가 Bookshelf입니다.
🚀 시작 가이드 — 첫 30분 동안 해야 할 것
라이브러리 모드라 '시작'할 게 없습니다. 다만 두 가지는 알아 두면 좋습니다.
모드팩에 들어 있다면
그대로 두세요. 별도 설정이 필요 없습니다.
직접 모드를 추가한다면
Darkhax의 모드를 모드팩에 넣으려 할 때는 그 모드의 CurseForge/Modrinth 페이지에서 Dependencies 항목을 그대로 읽으세요. Bookshelf만 요구하는 경우도 있고, Prickle까지 함께 요구하는 경우도 있습니다. 그리고 마인크래프트 버전 + 로더 조합이 정확히 맞아야 합니다.
알아 두면 쓸모 있는 것
/bookshelf hand — 손에 든 아이템의 ID를 출력합니다. 레시피·설정 파일 작업을 할 때 편합니다.
💡 플레이 팁
- 임의로 제거하지 마세요 — Bookshelf를 요구하는 모드가 함께 깔려 있다면 게임이 시작되지 않습니다. 모드팩에 포함되어 있다면 그대로 두는 게 정답입니다.
/bookshelf hand로 아이템 ID 확인 — 손에 든 아이템의 ID를 바로 알려 줍니다. 레시피나 설정 파일을 손볼 때 쓸모가 있습니다.- Prickle도 함께 필요할 수 있습니다 — Darkhax의 최신 모드들은 Bookshelf 외에 Prickle이라는 라이브러리도 요구합니다. Bookshelf만 받고 끝내면 여전히 크래시가 납니다.
- 로더·버전별로 빌드가 다릅니다 — Forge·NeoForge·Fabric·Quilt, 그리고 마인크래프트 버전마다 빌드가 나뉩니다. 직접 받을 때는 의존 모드가 요구하는 정확한 조합을 고르세요.
⚠️ 자주 헷갈리는 부분
- • 깔아도 아무 일도 일어나지 않는 것처럼 보입니다 — 대부분 맞습니다. 다른 모드가 쓰라고 있는 코드 모음이니까요. 다만 디버그 명령어와 몇 가지 데이터팩 기능은 실제로 플레이어가 쓸 수 있습니다.
- • 로그에 Bookshelf가 보인다고 Bookshelf 탓은 아닙니다 — 다른 모드가 Bookshelf의 기능을 호출하다 문제를 일으키면 스택 트레이스에 Bookshelf 이름이 함께 찍힙니다. 호출한 쪽 모드부터 확인하세요.
❓ 자주 묻는 질문
Bookshelf만 깔면 뭐가 추가되나요?
거의 없습니다. 주로 다른 모드가 사용할 코드 모음입니다. 다만 플레이어가 직접 쓸 수 있는 기능도 조금 있습니다 — /bookshelf hand 같은 디버그 명령어와, 아이템을 소비하는 대신 내구도를 깎는 조합 레시피 같은 데이터팩 기능들입니다.
제거하면 어떻게 되나요?
Bookshelf를 필수 의존성으로 요구하는 모드가 함께 깔려 있다면 게임이 시작되지 않습니다. Darkhax의 Enchantment Descriptions와 Dark Utilities가 그런 예입니다. 모드팩 기본 구성 그대로 두는 게 안전합니다.
Bookshelf만 받으면 되나요?
아닐 수 있습니다. Darkhax의 최근 모드들은 Bookshelf 외에 Prickle이라는 라이브러리도 함께 요구합니다. 모드를 직접 추가한다면 해당 모드 페이지의 의존성 목록을 그대로 따라 받으세요.
