FTB Library
FTB 팀의 모든 모드가 공유하는 토대 라이브러리입니다. FTB Quests·FTB Chunks·FTB Teams·FTB Ranks가 이것 없이는 로드되지 않으며, 사이드바와 `/ftblibrary nbtedit` 같은 실사용 도구도 여기서 나옵니다.
📖 소개
FTB Library를 빼면 FTB Quests, FTB Chunks, FTB Teams, FTB Ranks가 모두 로드에 실패합니다. 이들 모드는 FTB Library를 필수 의존성으로 선언하기 때문에, 파일 하나를 지우는 것으로 퀘스트 화면과 청크 청구 시스템과 팀 시스템이 한꺼번에 사라집니다. 크래시 로그에 ftblibrary가 보인다면 대개 이 의존 관계가 원인입니다.
왜 이런 모드가 따로 있나. FTB 팀은 서로 맞물려 돌아가는 모드를 여러 개 만듭니다. 퀘스트가 팀 단위로 진행되고, 청크 청구가 팀 소유로 기록되고, 권한이 팀·랭크에 따라 갈립니다. 이 모드들이 각자 팀 개념과 GUI와 설정 체계를 따로 들고 있으면 서로 어긋납니다. 그래서 공통 부분을 FTB Library 하나로 내려 둔 것입니다. 저장소 설명 그대로 "GUI 제작 라이브러리와 SNBT 같은 도구가 포함된, 모든 FTB 모드를 위한 공용 라이브러리"입니다.
안에 들어 있는 것. 소스 트리를 보면 역할이 그대로 드러납니다. sidebar(인벤토리 화면에 붙는 버튼 묶음), nbtedit(인게임 NBT 브라우저·편집기), config와 json5(사람이 읽을 수 있는 설정·데이터 형식), icon(아이템·텍스처 아이콘 처리), net(서버·클라이언트 통신), client의 GUI 위젯 모음. FTB Quests와 FTB Chunks의 화면이 서로 닮은 이유는 둘 다 이 위젯 묶음으로 그려지기 때문입니다.
사용자가 실제로 쓰게 되는 부분. 라이브러리치고는 드물게, 사용자 눈에 보이는 기능이 두 가지 있습니다. 하나는 인벤토리 화면 옆에 붙는 사이드바 버튼입니다. 퀘스트·청크 지도·팀 화면을 여는 통로가 여기이며, 다른 모드가 자기 버튼을 얹기도 합니다. 다른 하나는 /ftblibrary nbtedit 명령으로, 블록·엔티티·플레이어·손에 든 아이템의 NBT를 게임 안에서 열어 보고 고칠 수 있습니다. 서버 운영 중 망가진 데이터를 되살리거나 퀘스트가 왜 완료 처리되지 않는지 들여다볼 때 쓰는 도구입니다.
출처와 라이선스. GitHub 저장소는 2019년 11월에 개설되었고, 1.16부터 1.21.11까지의 브랜치가 유지되고 있습니다. 라이선스는 저장소의 LICENSE.md 기준 All Rights Reserved(저작권자 Feed The Beast Ltd)이며, README는 소스가 공개되어 있을 뿐 오픈소스 라이선스는 아니라고(visible source) 밝히고 있습니다. 기여하려면 CLA 서명이 필요합니다.
🕒 이 모드는 언제 쓰는가
FTB 모드(Quests·Chunks·Teams·Ranks)가 있으면 이미 설치되어 있습니다. 서버를 직접 운영한다면 /ftblibrary nbtedit은 알아 둘 만합니다.
📦 어떤 모드팩에서 중요한가
FTB Quests로 진행을 잡는 모드팩 전반에서 돌아갑니다. 퀘스트와 청크 청구가 있는 팩이라면 거의 예외 없이 포함되어 있습니다.
🎮 플레이 체감 변화
라이브러리 자체는 배경에 있지만, 인벤토리 옆 사이드바 버튼은 매일 누르게 됩니다. 퀘스트와 청크 지도로 들어가는 입구가 그 버튼이기 때문입니다.
🚀 시작 가이드 — 첫 30분 동안 해야 할 것
모드팩을 플레이하는 중이라면 이미 설치되어 있고, 손댈 것도 없습니다. 인벤토리를 열었을 때 옆에 붙어 있는 버튼들이 이 모드가 만든 사이드바이니, 거기서 퀘스트와 청크 지도를 여는 것부터 익히면 됩니다.
크래시 로그를 들고 왔다면 ftblibrary가 어떤 모드의 의존성으로 언급되는지 보십시오. FTB Quests나 FTB Chunks가 요구하는 버전과 설치된 FTB Library 버전이 어긋난 경우가 흔합니다. 런처에서 모드팩을 검증·복구하면 대개 정리됩니다.
서버를 운영한다면 명령어 두 개를 먼저 익히는 편이 좋습니다. /ftblibrary serverconfig로 서버 쪽 설정을 열고, 문제가 생긴 블록이나 플레이어 데이터는 /ftblibrary nbtedit으로 직접 들여다봅니다. 후자는 백업을 만든 뒤에 쓰십시오.
💡 플레이 팁
- 지우지 마십시오. FTB Quests·Chunks·Teams·Ranks가 전부 여기에 의존합니다. 하나라도 쓰고 있다면 FTB Library를 빼는 순간 게임이 로드되지 않습니다.
- 사이드바 버튼이 안 보이면 설정에서 켜십시오. 사이드바는 FTB Library가 그리는 것이고, 표시 여부는
/ftblibrary clientconfig에서 여는 클라이언트 설정에서 조정합니다. 버튼이 사라진 것은 대개 모드가 빠진 게 아니라 꺼져 있는 것입니다. /ftblibrary nbtedit은 운영자 도구입니다. 블록·엔티티·플레이어·손에 든 아이템의 NBT를 인게임 GUI로 열어 고칩니다. 강력한 만큼 잘못 만지면 되돌리기 어려우니, 손대기 전에 월드 백업을 두십시오.- 서버 설정과 클라이언트 설정은 따로입니다.
/ftblibrary serverconfig와/ftblibrary clientconfig가 서로 다른 화면을 엽니다. 멀티플레이에서 설정이 안 먹는다면 둘을 헷갈리고 있을 가능성이 큽니다. - 로더에 맞는 파일을 받아야 합니다. NeoForge용과 Fabric용 빌드가 따로 나갑니다. 수동으로 모드를 넣는다면 파일 이름의 로더 표기를 확인하십시오.
- FTB 모드는 버전을 함께 맞추십시오. FTB Quests만 최신으로 올리고 FTB Library를 두면 로딩에서 걸립니다. FTB 계열은 같은 시점의 빌드로 묶어서 갱신하는 편이 안전합니다.
⚠️ 자주 헷갈리는 부분
- • 설치했는데 새 아이템도 블록도 없습니다. 정상입니다. FTB Library는 콘텐츠 모드가 아닙니다. 눈에 보이는 것은 사이드바 버튼과 몇 개의 명령어뿐이고, 나머지는 다른 FTB 모드가 가져다 쓰는 코드입니다.
- • FTB Library와 FTB Quests는 다른 모드입니다. 퀘스트 내용·보상·진행 트리는 전부 FTB Quests와 모드팩 제작자가 만든 것입니다. FTB Library는 그 화면을 그리는 데 쓰이는 위젯과 데이터 형식을 제공할 뿐, 퀘스트를 하나도 추가하지 않습니다.
- • 범용 라이브러리가 아닙니다. Architectury나 Balm처럼 아무 모드나 가져다 쓰는 라이브러리와 달리, FTB Library는 FTB 팀의 모드를 위해 만들어졌습니다. FTB 모드가 하나도 없다면 이 모드는 거의 아무 일도 하지 않습니다.
- • 오픈소스는 아닙니다. GitHub에서 소스를 볼 수 있다고 해서 자유롭게 쓸 수 있는 것은 아닙니다.
LICENSE.md는 All Rights Reserved이고, 저작권자는 Feed The Beast Ltd입니다. README는 이를 visible source라고 표현합니다.
❓ 자주 묻는 질문
FTB Library를 지우면 어떻게 되나요?
FTB Quests, FTB Chunks, FTB Teams, FTB Ranks가 전부 로드에 실패합니다. 퀘스트 시스템과 청크 청구가 통째로 사라지고, 그 모드들이 필수 의존성으로 걸려 있어 게임 자체가 실행되지 않습니다. FTB 모드가 하나도 없다면 지워도 아무 변화가 없습니다.
어떤 모드가 FTB Library를 요구하나요?
FTB 팀이 만든 모드들입니다. FTB Quests(퀘스트), FTB Chunks(청크 청구·지도), FTB Teams(팀), FTB Ranks(권한·랭크)가 대표적입니다. 퀘스트가 있는 모드팩이라면 거의 확실히 들어 있습니다.
인벤토리 옆 사이드바 버튼은 뭔가요?
FTB Library가 그리는 사이드바입니다. 퀘스트·청크 지도·팀 화면으로 들어가는 입구이고, 다른 모드가 자기 버튼을 추가하기도 합니다. 보이지 않는다면 /ftblibrary clientconfig에서 여는 클라이언트 설정을 확인하십시오.
`/ftblibrary nbtedit`은 뭘 하는 명령인가요?
블록·엔티티·플레이어·손에 든 아이템의 NBT 데이터를 인게임 GUI로 열어 보고 수정하는 명령입니다(nbtedit block·entity·player·item). 서버 운영 중 데이터가 꼬였을 때 쓰는 복구·디버깅 도구이며, 잘못 수정하면 되돌리기 어려우니 백업 후 사용하십시오.
Forge와 Fabric 중 뭘 받아야 하나요?
모드팩이 쓰는 로더에 맞춰야 합니다. 현재 저장소는 NeoForge와 Fabric 모듈을 빌드하며, 예전 마인크래프트 버전대에서는 Forge 빌드가 배포되었습니다. 모드팩을 통해 설치하면 로더에 맞는 파일이 자동으로 들어옵니다.
📦 이 모드가 포함된 모드팩
HomeProject 2
거대 콘텐츠 모드 Eternal Tales(차원 9개·보스 20+·아이템 1,000)를 중심에 두고 겹치는 모드를 걸러내며 조립하는 1.20.1 Forge 커스텀 모드팩. 5단계 조립 레시피를 인터랙티브 체크리스트로 공개합니다.
🎯 어울리는 분 거대한 콘텐츠 모드 하나를 깊게 파고들며 차원·보스·광물 진행을 즐기고 싶은 분에게 맞습니다.
Home Project 1
3인 로컬 멀티를 위해 빈 프로필에서 직접 조립한 1.20.1 Forge 커스텀 모드팩. 보스·스킬트리·퀘스트 중심으로 73개를 5단계에 나눠 쌓은 조립 레시피를 인터랙티브 체크리스트로 공개합니다.
🎯 어울리는 분 보스전·스킬트리·3인 협동을 직접 구성해보고 싶은 분에게 맞습니다.