| <colbgcolor=#dbb000,#c9a800><colcolor=#fff> Fabric API | |
| | |
| 개발 | FabricMC |
| 분류 | 모드 라이브러리 |
| 기반 로더 | Fabric Loader |
| 지원 버전 | 1.14 ~ |
| 라이선스 | Apache 2.0 |
| 관련 사이트 | |
| 다운로드 | |
1. 개요
Fabric API는 Fabric 기반 모드 개발에 필요한 공통 API와 이벤트 훅을 제공하는 라이브러리 모드이다.Fabric는 Forge와 다르게 Loader와 API가 분리되어 있다. Loader는 모드 로드 및 최소한 모딩 기능(Access Wideners, Mixin 등)을 제공하고 API는 모드에서 공통적으로 사용하는 API 및 이벤트 처리를 제공한다. 그래서 Loader만 설치하면 게임 실행은 가능하지만 대부분의 Fabric 모드들은 Fabric API를 사용하기 때문에 함께 넣어줘야 한다.[1] 일반 모드들처럼 JAR 파일로 배포되며 .minecraft\\mods 폴더에 넣으면 된다.
2. 제공 기능
- 이벤트 훅 — 블록 상호작용, 엔티티 스폰, 서버 틱 등 다양한 게임 이벤트에 콜백을 등록할 수 있는 API.
- 네트워킹 API — 서버-클라이언트 간 커스텀 패킷 송수신 지원.
- 렌더링 API — 커스텀 렌더링 파이프라인 구성 지원.
- 레지스트리 API — 블록, 아이템, 엔티티 등 게임 오브젝트를 등록하는 표준적인 방법 제공.
- JSON 데이터 주입 — 모드에 포함된 리소스·데이터 파일을 게임에 주입하는 기능.
- 공통 유틸리티 — 모드 개발에서 반복적으로 필요한 공통 헬퍼 모음.
3. 설치 방법
- FabricMC 공식 사이트에서 Fabric Installer를 다운로드해 실행한다.
- 설치 대상 마인크래프트 버전과 Loader 버전을 선택한 뒤 Install을 클릭한다.
- 마인크래프트 런처에 Fabric 프로필이 생성되면 Loader 설치는 완료다.
- CurseForge 또는 Modrinth에서 사용 중인 마인크래프트 버전에 맞는 Fabric API .jar 파일을 별도로 다운로드한다.
- .minecraft/mods 폴더에 Fabric API .jar 파일과 사용할 모드 .jar 파일을 함께 넣는다.
- 마인크래프트 런처에서 Fabric 프로필로 실행한다.
Fabric Loader와 Fabric API는 별개의 파일이다. Loader 설치만으로는 대부분의 Fabric 모드가 동작하지 않으니 반드시 마인크래프트 버전에 맞는 Fabric API를 함께 설치해야 한다.
4. 여담
마인크래프트 1.19.2를 기점으로 Fabric API의 mod ID가 fabric에서 fabric-api로 변경되었다. 이 버전 이전 환경으로 모드를 백포팅하는 경우 fabric.mod.json의 depends 항목을 맞게 수정해야 한다.Fabric API는 마인크래프트 버전마다 별도의 빌드가 존재하므로, 자신이 사용 중인 마인크래프트 버전에 맞는 Fabric API를 설치해야 한다.
5. 관련 문서
[1] 그러다보니 오랫동안 포지를 사용했다가 패브릭으로 넘어간 유저들은 Loader만 설치하고 모드들을 넣고 실행시켰다가 오류가 발생한 것을 보고 당황하는 경우가 많다.