Framework
MrCrayfish가 자기 모드들을 여러 모드 로더에서 함께 돌리려고 만든 라이브러리입니다. Controllable·Goblin Traders·Golden Hopper·Mighty Mail 등이 필수 의존성으로 요구합니다.
📖 소개
Framework를 빼면 이 라이브러리를 요구하는 MrCrayfish 모드가 로드되지 않습니다. 모드 로딩 단계에서 의존성 누락으로 걸리고, 게임은 오류 화면에서 멈춥니다. 저장소의 의존성 선언(neoforge.mods.toml)을 기준으로 Framework를 필수로 요구하는 모드는 Controllable(컨트롤러 지원), Goblin Traders, MrCrayfish's Furniture Mod: Refurbished, Mighty Mail, Golden Hopper입니다. 모드팩에서 이 중 하나라도 보인다면 Framework는 지울 수 없습니다.
이 모드가 하는 일 — 저장소 설명은 "멀티로더 마인크래프트 모드 개발용 도구를 제공하는 라이브러리"입니다. MrCrayfish는 같은 모드를 Forge·NeoForge·Fabric에서 각각 유지하는 대신, 로더마다 다른 부분(레지스트리 등록 방식, 네트워크 패킷, 이벤트 훅, 설정 파일 처리)을 Framework 뒤로 감추고 모드 본체는 한 벌만 씁니다. 저장소가 common·forge·neoforge·fabric 모듈로 나뉘어 있는 구조가 그대로 그 설계입니다. 플레이어에게 보이는 콘텐츠는 없습니다. 블록도 아이템도 GUI도 추가하지 않습니다.
Configured와 헷갈리기 쉽습니다. 게임 안에서 모드 설정을 GUI로 바꿔 주는 모드는 Configured이고, Framework는 그 아래에서 설정 값을 정의·동기화하는 쪽입니다. 실제로 Configured는 Framework를 선택적(optional) 의존성으로 선언합니다. 즉 Configured는 Framework 없이도 켜지지만, Framework가 함께 있으면 Framework 기반 모드의 설정까지 Configured 화면에서 편집할 수 있게 됩니다. 반대로 Catalogue(모드 목록 화면)는 Framework에 의존하지 않습니다.
모드팩에서 마주쳤다면 그냥 두면 됩니다. CurseForge가 의존성으로 자동으로 끌어오고, 설정할 것도 없으며, 사용자가 조작할 화면도 없습니다. GitHub 저장소는 2021년 11월에 개설되었고, 현재 multiloader/1.18.2부터 multiloader/1.21.11까지의 브랜치가 유지되고 있습니다. 라이선스는 LGPL-2.1입니다.
🕒 이 모드는 언제 쓰는가
직접 쓰는 모드가 아닙니다. Controllable·Goblin Traders·Furniture Mod: Refurbished 등 Framework를 요구하는 MrCrayfish 모드가 있으면 이미 함께 설치되어 있습니다.
📦 어떤 모드팩에서 중요한가
MrCrayfish 모드가 들어간 대형 모드팩에서 뒤에서 돌아갑니다. 가구·컨트롤러 지원·소규모 편의 모드가 섞인 팩에서 자주 보입니다.
🚀 시작 가이드 — 첫 30분 동안 해야 할 것
모드팩을 플레이하는 중이라면 할 일이 없습니다. Framework는 이미 설치되어 있고, 화면도 설정도 없습니다.
의존성 오류를 보고 왔다면 어떤 모드가 Framework를 요구하는지부터 확인하십시오. Controllable, Goblin Traders, MrCrayfish's Furniture Mod: Refurbished, Mighty Mail, Golden Hopper가 대표적입니다. 그 모드의 요구 버전과 설치된 Framework 버전이 맞는지 보면 대개 원인이 나옵니다.
직접 모드를 조합하는 경우, 마인크래프트 버전과 로더(Forge·NeoForge)가 일치하는 Framework 빌드를 받아야 합니다. 로더별 파일이 따로 배포됩니다.
💡 플레이 팁
- 설정할 것이 없습니다. Framework는 콘텐츠도 UI도 없는 라이브러리입니다. 조정할 항목이 있다면 그건 Framework가 아니라 그 위에 얹힌 MrCrayfish 모드의 설정입니다.
- 의존성 오류가 나면 버전 범위를 보십시오. MrCrayfish 모드는
versionRange로 최소 Framework 버전을 지정합니다. 모드만 최신으로 올리고 Framework를 그대로 두면 로딩 단계에서 걸립니다. 두 개를 함께 갱신하십시오. - 이름이 같은 다른 모드가 있습니다. 'Framework'라는 이름을 쓰는 모드는 여럿입니다. 받을 때 제작자가 MrCrayfish인지 확인하십시오.
- 모드팩이 알아서 처리합니다. CurseForge에서 Controllable 같은 모드를 받으면 Framework가 자동으로 따라옵니다. 별도로 찾아 넣을 필요가 없습니다.
- Framework만 지우는 시도는 무의미합니다. 용량을 아끼려고 라이브러리를 빼는 것은 도움이 되지 않습니다. 크기도 작고, 빼면 그 위의 모드가 모두 죽습니다.
⚠️ 자주 헷갈리는 부분
- • Framework와 Configured는 다른 모드입니다. 설정을 눈으로 보고 바꾸는 화면은 Configured가 제공합니다. Framework는 그 설정 값이 정의되고 서버·클라이언트 간에 동기화되는 층입니다. Configured는 Framework를 선택적 의존성으로 둘 뿐이라 Framework 없이도 동작합니다.
- • 단독 설치는 의미가 없습니다. Framework만 넣은 월드는 바닐라와 똑같습니다. 이 모드를 요구하는 MrCrayfish 모드가 함께 있어야 비로소 역할이 생깁니다.
❓ 자주 묻는 질문
Framework를 지워도 되나요?
Controllable, Goblin Traders, MrCrayfish's Furniture Mod: Refurbished, Mighty Mail, Golden Hopper 중 하나라도 있다면 안 됩니다. 이 모드들은 Framework를 필수 의존성으로 선언하고 있어서, 지우면 게임이 실행되지 않습니다. MrCrayfish 모드가 전혀 없다면 지워도 아무 일도 없습니다.
Framework만 설치하면 뭐가 달라지나요?
아무것도 달라지지 않습니다. 콘텐츠도 UI도 없는 개발용 라이브러리입니다. 다른 모드가 이 위에 얹힐 때만 의미가 있습니다.
Configured와 같은 모드인가요?
다릅니다. Configured는 설정을 GUI로 편집하는 모드이고, Framework는 그 아래에서 설정을 정의·동기화하는 라이브러리입니다. Configured는 Framework를 선택적 의존성으로만 두기 때문에 Framework 없이도 켜지며, 둘이 함께 있으면 Framework 기반 모드의 설정까지 Configured에서 다룰 수 있습니다.