Searchables

다른 모드들이 검색·필터·자동 완성 기능을 구현할 때 쓰는 보조 라이브러리. JEI의 자동 완성·일부 모드의 인벤토리 검색 시스템에서 뒤에서 작동합니다.

📖 소개

Searchables는 **검색·필터링·자동 완성 시스템을 다른 모드들이 쉽게 구현하도록 도와주는** 라이브러리 모드입니다. 자체 콘텐츠 없이 "헬퍼 메서드"만 제공해서, 의존 모드들이 검색 UI를 빠르게 만들 수 있게 해줍니다.

제공하는 건 세 가지입니다. 아이템·블록·NPC 같은 컴포넌트를 이름·태그·속성으로 거르는 검색 로직, '불 타입만'·'인챈트된 것만' 식으로 결과를 좁히는 필터, 그리고 검색창에 타이핑하면 가능한 결과를 미리 제안하는 자동 완성입니다.

**의존하는 대표 모드** — **JEI(Just Enough Items)** 의 검색·자동 완성 일부, 모드팩의 인벤토리 검색 UI, 일부 NEAT한 UI 모드들. JEI가 깔린 거의 모든 모드팩에 함께 들어가 있을 가능성 큼.

**왜 별도 라이브러리로 분리됐나** — 검색·필터·자동 완성은 거의 모든 UI 모드가 필요로 하는 공통 기능. 각 모드 작가가 매번 다시 짜는 대신 표준 라이브러리에 위임하면 코드 중복이 사라지고, 모든 모드의 검색이 비슷한 방식이라 사용자 경험이 일관되며, 버그 수정이 여러 모드에 동시에 반영됩니다. Searchables는 그런 목적의 작은 도구.

**모드팩 사용자 입장에서** — Searchables 자체는 JEI에서 검색해도 결과 없고 게임 안 변화도 없습니다. 단 JEI 검색창에서 한 글자 치면 가능한 아이템들이 미리 나오는 자동 완성 같은 작은 편의가 이 라이브러리 덕분이라는 걸 알면 그 가치가 명확해져요.

11살 자녀와 함께 플레이할 때 자녀에게 따로 설명할 일은 없습니다. 자녀가 JEI에서 한국어로 "철"만 쳐도 관련 아이템들이 미리 나오는 게 이 모드 덕분일 수 있다는 정도.

🕒 이 모드는 언제 쓰는가

JEI 같은 의존 UI 모드가 모드팩에 포함된 경우 자동 작동. 사용자가 별도로 만질 일 없음.

📦 어떤 모드팩에서 중요한가

JEI가 들어간 거의 모든 모드팩에서 뒷받침. ATM10·DarkRPG·BMC4 같은 거의 모든 인기 모드팩에 자동 포함.

🎮 플레이 체감 변화

직접 체감되지 않지만 JEI 검색·자동 완성이 부드럽게 작동하는 데 기여. 자녀가 "철 다 보여줘" 한글 검색했을 때 즉시 결과 나오는 것 같은 작은 편의가 이 라이브러리 덕분.

🚀 시작 가이드 — 첫 30분 동안 해야 할 것

1단계 — 모드팩 포함 여부 확인. JEI 있는 모드팩이면 Searchables도 자동 포함 가능성 큼.

2단계 — 그대로 두기. 라이브러리 모드는 손대지 않는 게 정답.

3단계 — JEI 검색 기능 활용. JEI 검색창에서 한 글자 쳤을 때 자동 완성·필터가 부드럽게 작동하는 자체가 Searchables가 작동하고 있다는 증거.

다음 목표 — 모드 의존성 개념 이해. 자녀와 함께 "이 작은 라이브러리들이 다 모여서 큰 게임을 만든다" 식의 모드팩 생태계 학습.

💡 플레이 팁

  • **임의 제거 금지** — JEI 같은 의존 모드의 일부 기능이 안 됨. 모드팩 기본 포함이면 그대로 두기.
  • **별도 설정 없음** — 일반 플레이어가 만질 부분 없음. 자동 작동.
  • **JEI 자동 완성과 함께 작동** — JEI 검색창에 글자 치면 가능한 아이템 미리 보여주는 기능에 기여.
  • **Forge·NeoForge·Fabric 빌드 별개** — 본인 모드팩 로더에 맞는 버전 필요. 모드팩 기본 포함이면 자동 매칭.
  • **다른 라이브러리(Bookshelf·Architectury·Balm)와 충돌 없음** — 각각 다른 역할. 함께 깔리는 게 일반적.

⚠️ 자주 헷갈리는 부분

  • • **"아무 일도 안 일어남"이 정상** — 라이브러리 특성. 게임 안에서 새 콘텐츠 추가 안 함.
  • • **JEI 없으면 거의 무용지물** — JEI 같은 의존 UI 모드 없이는 단독 의미 적음. 모드팩에 JEI 없으면 Searchables도 거의 필요 없음.
  • • **다른 검색 라이브러리(Configured 등)와 헷갈리지 말 것** — Configured는 인게임 설정 GUI, Searchables는 검색·필터 헬퍼. 역할 다름.

❓ 자주 묻는 질문

Searchables만 깔면 뭐가 추가되나요?

거의 아무것도 추가되지 않습니다. 라이브러리 모드라 자체 콘텐츠 없고, JEI 같은 다른 모드들이 검색·필터·자동 완성 기능을 구현할 때 도구로 사용합니다.

어떤 모드들이 의존하나요?

**대표적으로 JEI(Just Enough Items)** 의 검색·자동 완성 일부. 그 외 모드팩의 인벤토리 검색 UI, NEAT한 UI 모드 일부도 사용. JEI가 깔린 거의 모든 모드팩에 자동 포함될 가능성 큼.

다른 라이브러리와 충돌하나요?

충돌하지 않습니다. Bookshelf·Architectury·Balm 같은 다른 라이브러리들과 다른 역할이라 5~10개 라이브러리가 한 모드팩에 함께 깔리는 게 일반적.

임의 제거 가능?

비추천. JEI 등 의존 모드의 일부 기능(자동 완성·필터)이 안 될 수 있어요. 모드팩에 자동 포함된 경우 그대로 두세요.

11살 자녀에게 어떻게 설명?

"JEI에서 검색할 때 자동 완성 도와주는 도구" 정도면 충분. 자녀가 JEI 한국어 검색 시 즉시 결과 나오는 게 자연스럽게 느껴지는 데 기여.

📦 이 모드가 포함된 모드팩

🔗 관련 모드