Fabric 모드

Fabric은 보통 새 Minecraft 버전을 빠르게 지원하는 가벼운 모드 로더예요. Codexe는 Fabric의 Loom 플러그인을 쓰는 완전한 Gradle 프로젝트를 생성해요.

#요청에 넣을 내용

• Minecraft 버전: "1.20.1용 Fabric", "1.21.1". 적지 않으면 1.20.1을 써요.
• 모드가 추가하는 것: 블록, 아이템, 엔티티, 명령어, 키 바인딩, HUD 요소. 동작을 정확하게 적으세요.
• 클라이언트와 서버: 클라이언트 전용(HUD, 키 바인딩)인지, 서버 전용인지, 둘 다인지 적으세요.
• 의존성: Fabric API는 포함돼요. 그 밖의 의존성(Cloth Config, Mod Menu…)은 이름을 적으세요.

A Fabric mod for 1.21.1: a "Magnet" item that pulls nearby dropped items to the player within 8 blocks while held in the offhand. Toggle with a keybind (default M). Crafting: iron ingots around a redstone block. English lang file and item model.

#Codexe가 생성하는 것

• build.gradle, gradle.properties(Minecraft, Yarn, 로더, Fabric API 버전), settings.gradle.
• 환경별로 나뉜 진입점(main, client)이 있는 fabric.mod.json.
• 기능에 필요하면 믹스인 설정과 클래스.
• 에셋: 언어 파일, 모델, 임시 텍스처.

#빌드 방식

• Codexe는 안정적인 Loom 릴리스로 버전을 고정해요(예전 -SNAPSHOT 버전은 Fabric 저장소에서 사라져 빌드를 깨뜨려요).
• 요청한 로더, Yarn, Fabric API 버전이 존재하지 않으면 Codexe가 그 Minecraft 버전에 실제로 있는 버전으로 바꿔요.
• Loom은 Gradle을 실행하려면 Java 21 런타임이 필요해요. 1.20.1 모드(Java 17 대상)라면 Codexe는 Gradle을 Java 21에서 실행하지만, 모드 자체는 여전히 Java 17용으로 컴파일돼요. JAR는 Java 17 서버에서 동작해요.

첫 모드 빌드는 더 오래 걸려요(몇 분 걸리는 경우가 많아요). Loom이 Minecraft와 매핑을 내려받기 때문이에요. 모드 빌드는 10분이 지나면 중단돼요.

#검증

모드는 준비됨이 되기 전에 컴파일되며, JAR에는 fabric.mod.json(또는 quilt.mod.json)이 들어 있어야 해요. 컴파일은 빌드된다는 것을 증명할 뿐, 충돌 없이 실행된다는 것을 증명하지는 않으니 클라이언트에서 테스트하세요.

#자주 생기는 문제