Puzzles Lib
Fuzs의 모드들이 공통으로 쓰는 코어 라이브러리. 설정·네트워킹·이벤트·등록 같은 기반 시스템을 제공하고 Fabric·NeoForge 양쪽에서 같은 코드가 돌아가게 합니다.
📖 소개
Puzzles Lib는 모드 개발자 Fuzs가 자기 프로젝트들을 뒷받침하려고 만든 라이브러리입니다. 게임 콘텐츠는 전혀 추가하지 않고, 의존 모드들이 안정적으로 동작하는 데 필요한 기반 시스템 — 설정(config), 네트워킹, 이벤트, 등록(registration) — 을 공유 형태로 제공합니다.
크로스 로더가 목적입니다. Fabric과 NeoForge는 모드 API가 서로 다릅니다. Puzzles Lib는 그 차이를 흡수해 같은 모드가 두 로더에서 같은 방식으로 동작하도록 설계돼 있습니다. 다른 모드가 이 라이브러리를 의존성으로 걸어 두면 클라이언트와 서버 양쪽에 모두 설치해야 합니다.
Fabric에서는 추가 의존성이 있습니다 — Fabric API와 Forge Config API Port가 함께 필요합니다.
어떤 모드가 이걸 쓰나 — Fuzs 본인의 모드들입니다. Universal Bone Meal, Mob Plaques, Stylish Effects, Better Tridents, Armor Quick Swap, Convenient Effects, Block Runner, Fast Item Frames, Sheep Variety, Mindful Darkness, Forge Config Screens 등이 확인됩니다. 이 중 하나라도 모드팩에 있으면 Puzzles Lib도 함께 들어옵니다.
다른 작가들도 각자 자기 라이브러리를 따로 관리하기 때문에(예: Darkhax의 Bookshelf, shedaniel의 Architectury) 한 모드팩에 라이브러리가 여러 개 공존하는 것은 정상입니다. 라이선스는 MPL-2.0입니다.
🕒 이 모드는 언제 쓰는가
Fuzs의 모드가 모드팩에 하나라도 있으면 자동으로 함께 작동합니다.
📦 어떤 모드팩에서 중요한가
Universal Bone Meal·Mob Plaques·Stylish Effects 같은 Fuzs 모드가 포함된 모드팩.
🚀 시작 가이드 — 첫 30분 동안 해야 할 것
1단계 — 모드팩에 포함돼 있는지 확인. Fuzs 모드가 있으면 함께 들어 있습니다.
2단계 — 그대로 둡니다. 사용자가 설정할 것이 없습니다.
3단계 — 의존 모드(Universal Bone Meal 등)의 설정만 필요에 따라 조정합니다.
💡 플레이 팁
- 임의로 제거하지 마세요 — 이 라이브러리를 요구하는 Fuzs 모드들이 로드되지 않습니다.
- 서버에도 설치해야 합니다 — 의존 모드가 있으면 클라이언트와 서버 양쪽 모두에 필요합니다.
- Fabric이면 Fabric API + Forge Config API Port도 필요합니다 — 셋이 한 세트입니다.
⚠️ 자주 헷갈리는 부분
- • "아무 일도 안 일어나는 것"이 정상입니다 — 라이브러리라 게임 안에 아이템이나 블록이 없습니다.
- • Fuzs 모드가 없으면 의미가 없습니다 — 범용 라이브러리가 아니라 Fuzs 프로젝트를 위한 기반입니다.
❓ 자주 묻는 질문
어떤 모드가 Puzzles Lib를 필요로 하나요?
Fuzs가 만든 모드들입니다. Universal Bone Meal, Mob Plaques, Stylish Effects, Better Tridents, Armor Quick Swap, Forge Config Screens 등이 확인된 의존 모드입니다.
Fabric에서도 쓸 수 있나요?
됩니다. 다만 Fabric에서는 Fabric API와 Forge Config API Port가 추가로 필요합니다.
다른 라이브러리(Bookshelf·Architectury 등)와 충돌하나요?
충돌하지 않습니다. 작가별로 자기 라이브러리를 따로 두는 구조라 한 모드팩에 여러 개가 함께 깔리는 것이 일반적입니다.
