Searchables
다른 모드가 GUI에 검색창·필터·자동 완성을 붙일 때 쓰는 헬퍼 라이브러리입니다. Jaredlll08이 만들었고, Controlling 같은 모드가 이 라이브러리를 요구합니다.
📖 소개
Searchables는 모드 개발자용 라이브러리입니다. 게임에 아이템이나 블록을 추가하지 않고, 다른 모드가 자기 화면에 검색창을 붙일 때 필요한 코드를 대신 제공합니다. 제작자 페이지 설명 그대로 옮기면 "컴포넌트 단위로 요소를 검색·필터링하는 헬퍼 메서드와 내장 자동 완성 기능"이 전부입니다.
왜 내 모드 폴더에 있나요. 대부분은 Controlling 때문입니다. Controlling은 키 설정 화면에 검색창을 넣어 주는 모드인데, 모든 배포판이 Searchables를 필수 의존성으로 요구합니다. Emotecraft는 선택 의존성으로 잡고 있습니다. 즉 Searchables는 본인이 직접 고른 모드가 아니라, 다른 모드가 끌고 들어온 부속품일 가능성이 높습니다.
JEI 때문이 아닙니다. Searchables를 JEI(Just Enough Items)의 검색 기능과 묶어서 설명하는 글이 많은데, Modrinth의 JEI 버전 목록에는 Searchables 의존성이 없습니다. JEI 검색창은 JEI가 자체적으로 구현합니다. Searchables를 지웠는데 JEI 검색이 멀쩡하다면 그게 정상입니다.
빼면 무슨 일이 생기나요. Searchables를 요구하는 모드가 하나라도 있으면 게임이 아예 안 켜집니다. 로더가 의존성 누락으로 시작 단계에서 멈추고, 크래시 로그에 searchables 이름이 찍힙니다. 반대로 Searchables만 남기고 Controlling을 지우면 Searchables는 그냥 아무 일도 하지 않는 상태로 남습니다.
기본 정보. 라이선스는 MIT, Fabric·Forge·NeoForge 빌드가 각각 있고 1.16.5부터 1.21.11까지 지원합니다. Modrinth 기준 누적 다운로드는 32,064,190회로, 라이브러리 모드로서는 상위권입니다. GitHub 저장소는 2023년에 열렸습니다.
🕒 이 모드는 언제 쓰는가
직접 설치할 일은 거의 없습니다. Controlling처럼 Searchables를 필수로 요구하는 모드를 넣을 때 함께 들어오며, 모드팩에 이미 있다면 그대로 두면 됩니다.
📦 어떤 모드팩에서 중요한가
Controlling이 들어간 모드팩이라면 어디든 함께 있습니다. 커스텀 인스턴스를 직접 조립할 때, 모드 하나를 지우고 나서 정리한다고 라이브러리까지 지우면 시작이 막히는 지점이기도 합니다.
🎮 플레이 체감 변화
게임 안에서 체감되는 부분은 없습니다. 굳이 찾자면 키 설정 화면 위쪽에 붙은 검색창에 글자를 칠 때 그 뒤에서 도는 코드입니다.
🚀 시작 가이드 — 첫 30분 동안 해야 할 것
설치·확인은 1분이면 끝납니다.
1. 어떤 모드가 요구하는지 본다. 크래시 로그에 searchables가 찍혔다면 그 위아래에 요구한 모드 이름이 함께 나옵니다. 대부분 Controlling입니다.
2. 로더와 버전을 맞춰 받는다. Modrinth 또는 CurseForge에서 인스턴스의 마인크래프트 버전·로더에 맞는 파일을 mods 폴더에 넣습니다.
3. 그대로 둔다. 설정할 것도, 확인할 것도 없습니다. 게임이 정상적으로 켜지면 그걸로 끝입니다.
💡 플레이 팁
- 정리한다고 지우지 마세요 — 모드 폴더를 손으로 정리할 때 이름만 보고 지우기 쉬운 파일입니다. Controlling 같은 모드가 남아 있으면 게임이 시작조차 안 됩니다. 라이브러리는 의존하는 모드를 먼저 확인하고 건드리세요.
- 설정 파일이 없습니다 — config 폴더에 Searchables 항목이 생기지 않고, 켜고 끌 옵션도 인게임 화면도 없습니다. 없다고 잘못 설치된 게 아닙니다.
- 로더에 맞는 빌드가 따로 있습니다 — Fabric·Forge·NeoForge 빌드가 별개로 배포됩니다. 수동 설치라면 로더와 마인크래프트 버전을 둘 다 맞춰야 합니다. 모드팩에 포함된 경우에는 이미 맞춰져 있습니다.
- 다른 라이브러리와 부딪히지 않습니다 — Bookshelf, Balm, Architectury와 역할이 겹치지 않습니다. 한 인스턴스에 라이브러리가 열 개 넘게 깔려 있어도 정상입니다.
⚠️ 자주 헷갈리는 부분
- • JEI의 검색창이 Searchables 덕분이라는 설명은 틀렸습니다 — JEI는 Searchables를 요구하지 않습니다. 둘 다 '검색'을 다룬다는 이유로 묶여서 설명되는 경우가 많지만, 실제 필수 의존은 Controlling 쪽입니다.
- • 설치했는데 게임에 아무 변화가 없습니다 — 정상입니다. 다른 모드가 호출해야 의미가 생기는 코드 묶음이라, 단독으로 넣으면 말 그대로 아무 일도 하지 않습니다. JEI에서 검색해도 나오지 않습니다.
❓ 자주 묻는 질문
Searchables만 설치하면 뭐가 추가되나요?
아무것도 추가되지 않습니다. 아이템·블록·화면 어느 것도 생기지 않습니다. 다른 모드가 검색창과 자동 완성을 만들 때 가져다 쓰는 코드만 들어 있습니다.
어떤 모드가 실제로 이걸 요구하나요?
Controlling이 필수 의존성으로 요구합니다(키 설정 화면 검색창). Emotecraft는 선택 의존성으로 잡고 있습니다. JEI는 요구하지 않습니다 — 자주 나오는 오해입니다.
지워도 되나요?
요구하는 모드가 하나도 없다면 지워도 게임은 켜집니다. 하나라도 있으면 시작 단계에서 의존성 누락으로 멈춥니다. 모드팩에 포함된 파일이라면 그냥 두는 편이 안전합니다.