Cloth Config API
모드 설정 화면을 표준화된 GUI로 통일해주는 코어 라이브러리. 많은 모드가 의존하지만 자체 콘텐츠는 없습니다.
📖 소개
Cloth Config API는 shedaniel이 개발한 모드 설정 GUI 라이브러리입니다. **혼자 깔면 거의 아무 변화가 없습니다** — 게임 안에 새 콘텐츠가 추가되지 않거든요. 대신 수많은 모드(특히 Fabric/Forge/NeoForge 양쪽에서 활동하는 모드들)가 자신들의 설정 화면을 일관된 모양으로 만들기 위해 Cloth Config를 의존성으로 요구합니다.
**Cloth Config API가 제공하는 핵심 — '통일된 설정 GUI'** — 마인크래프트 모드들은 보통 텍스트 파일 설정(`config/<mod>.toml`)을 직접 편집해야 합니다. 일반 플레이어에게는 직관적이지 않죠. Cloth Config는 그 자리를 인게임에서 키 입력·체크박스·드롭다운으로 편집 가능한 GUI로 만들어줍니다. 그 결과 텍스트 편집 없이 메뉴에서 설정을 바꿀 수 있어 접근성이 좋아지고, 모든 의존 모드가 비슷한 화면을 써서 시각적 일관성이 생기며, 일부 설정은 재시작 없이 즉시 반영됩니다.
**Forge/NeoForge에서는 다른 GUI 모드와 함께 작동** — Forge 환경에서는 MrCrayfish의 Configured 같은 모드가 비슷한 역할을 합니다. 두 모드가 함께 깔려 있어도 충돌하지 않고, 각각 다른 모드들의 설정을 처리합니다.
**DarkRPG에서의 역할** — Cloth Config에 의존하는 다른 모드들(REI·Roughly Enough Items 같은 인벤토리 UI 모드, 여러 Fabric 포팅 모드들 등)이 작동하기 위한 뒷받침입니다. 직접 인식되는 콘텐츠는 없지만, 다른 모드들의 설정 GUI가 깔끔하게 보이는 이유가 이 라이브러리예요. 11살 자녀에게는 '모드 설정을 깔끔하게 보여주는 도우미'라고 하면 충분합니다.
🕒 이 모드는 언제 쓰는가
Cloth Config 자체를 '쓸' 일은 없습니다. 의존하는 모드의 설정을 인게임에서 GUI로 편집할 때 그 화면 뒤에서 작동합니다.
📦 어떤 모드팩에서 중요한가
REI·Mod Menu 같은 UI 모드를 포함한 거의 모든 대형 모드팩에서 뒤에서 작동. 작은 모드팩에서도 한두 개 모드가 의존하는 경우가 많습니다.
🎮 플레이 체감 변화
플레이 중 직접 인식되지 않지만, '인게임 설정 메뉴가 보기 좋고 편하다'고 느껴지는 순간 Cloth Config가 작동하고 있는 것입니다.
🚀 시작 가이드 — 첫 30분 동안 해야 할 것
1단계 — 모드팩 포함 여부 확인. DarkRPG 같은 대형 모드팩에 보통 자동 포함. 직접 확인은 모드 목록에서 'Cloth Config' 검색.
2단계 — 그대로 두기. 라이브러리 모드는 손대지 않는 게 안전.
3단계 — 의존 모드 설정 GUI 활용. REI·Mod Menu 같은 모드의 인게임 설정 메뉴를 열어보면, 깔끔한 GUI로 설정 가능. 자녀에게 '여기서 키 설정 바꿀 수 있어'를 가르쳐주면 학습 효과.
다음 목표 — 모드 의존성 개념 이해. 자녀와 함께 '왜 어떤 모드 설정은 텍스트 파일이고 어떤 건 GUI일까?'를 설명하면서 모드 의존성 개념을 자연스럽게 학습.
💡 플레이 팁
- **임의 제거 금지**: 의존 모드들이 크래시. 모드팩 기본 포함 시 그대로 유지.
- **Fabric·Forge·NeoForge 빌드 다름**: 모드 로더별로 빌드가 다릅니다. 모드팩 기본 설치라면 자동 매칭.
- **Configured와 함께 사용 가능**: MrCrayfish의 Configured와 충돌하지 않습니다. 각각 다른 모드들의 설정을 처리.
- **일부 설정은 즉시 적용**: Cloth Config GUI에서 변경한 설정 중 일부는 게임 재시작 없이 즉시 반영됩니다(모드별로 다름).
- **오류 로그에서 종종 보임**: 다른 모드 오류 시 Cloth Config 이름이 로그에 노출될 수 있으나, 보통은 의존 모드의 호환성 문제.
⚠️ 자주 헷갈리는 부분
- • **'아무 일도 안 일어나는 모드'**: 라이브러리 특성. 게임 안 콘텐츠 변화 없는 게 정상.
- • **Configured와의 차이**: Cloth Config는 Fabric 출신의 범용 설정 GUI, Configured는 Forge 위주의 비슷한 도구. 두 모드 모두 모드팩에 들어 있을 수 있고 충돌하지 않습니다.
- • **'클로스(Cloth)' 이름이 헷갈릴 수 있음**: 직물·옷과 관련 없습니다. 이름은 'shedaniel'의 모드 시리즈 컨셉에서 온 것.
❓ 자주 묻는 질문
Cloth Config만 깔면 뭐가 추가되나요?
거의 아무것도 추가되지 않습니다. 라이브러리 모드라서, 다른 모드들의 설정 GUI 제공이 역할.
꼭 깔아야 하나요?
Cloth Config를 의존성으로 요구하는 모드가 모드팩에 있다면 필수. DarkRPG 같은 대형 팩에서는 보통 자동 포함.
Configured와 어떻게 다른가요?
Cloth Config는 Fabric 출신 GUI 라이브러리, Configured는 MrCrayfish의 비슷한 Forge 위주 도구. 둘은 충돌 없이 함께 사용 가능.
Fabric·Forge·NeoForge 모두 지원하나요?
네. 세 모드 로더 모두 지원. 본인 모드팩에 맞는 빌드가 자동으로 매칭.
오류 로그에 Cloth Config가 보이는데 문제인가요?
보통 Cloth Config 자체의 버그가 아니라 의존 모드의 호환성 문제. 의존 모드 설정·버전 먼저 점검.
