Fabric API là thư viện nền mà phần lớn mod Fabric gọi tới; tự nó không thêm gì vào game, nhưng thiếu nó thì hàng trăm mod khác báo lỗi ngay lúc khởi động. Cài Fabric Loader xong, việc đầu tiên là thả Fabric API đúng phiên bản 26.3 vào thư mục mods. Bài này nói rõ khi nào cần, cách chọn đúng số bản và lỗi hay gặp. Kiểm tra trên Java 26.3, ngày 5/11/2026.
Fabric API làm gì, vì sao gần như mod nào cũng cần?
Fabric Loader (thứ bạn cài bằng trình cài đặt Fabric) chỉ làm một việc: nạp mod vào game. Nó cố tình giữ thật nhỏ để không bị hỏng mỗi lần Minecraft ra bản mới. Mọi thứ mod cần dùng chung, như đăng ký vật phẩm mới, thêm công thức chế tạo, bắt sự kiện người chơi đập khối, đồng bộ dữ liệu giữa server và client, được gom vào Fabric API để các mod không phải viết lại. Vì thế một mod thêm nội dung (vũ khí, mob, chiều không gian) gần như chắc chắn cần Fabric API; mod chỉ chỉnh hiệu năng hay giao diện thì có thể không.
Fabric API cập nhật rất dày: riêng cho 26.3 đã có 9 bản từ tháng 9 tới nay, bản mới nhất 0.165.2 ra ngày 3/11/2026. Số sau dấu cộng trong tên file (+26.3) là phiên bản Minecraft mà file đó dành cho, và phải khớp tuyệt đối với bản game bạn đang chạy.
Ai cần cài, ai không?
| Bạn định cài | Cần Fabric API? |
|---|---|
| Mod thêm nội dung: Create (bản Fabric), Farmer’s Delight, Biomes O’ Plenty, Waystones… | Có, gần như luôn luôn |
| Mod tiện ích: Xaero’s Minimap, JEI, Mod Menu, Cloth Config | Có |
| Mod hiệu năng: Sodium, Lithium, Entity Culling | Không, chạy được không cần |
| Iris Shaders | Không, nhưng nhiều shader pack kèm mod phụ thì cần |
| Litematica (kèm MaLiLib) | Không |
| Chơi server Fabric có mod bắt buộc | Server ghi gì cài nấy; thường có |
Không chắc thì cứ cài. Fabric API nhẹ (1,7 MB), không đổi gameplay, không tốn FPS đáng kể, và tránh được 90% lỗi khởi động khi bạn thêm mod sau này.
Cài trong 3 bước
- Cài Fabric Loader cho 26.3 bằng trình cài đặt chính thức, theo hướng dẫn cài mod bằng Fabric. Mở Launcher một lần bằng profile Fabric để game tạo thư mục
mods. - Ở ô tải bên phải trang này, chọn phiên bản game 26.3, loader Fabric, bấm Tải. Bạn nhận được file dạng
fabric-api-0.165.2+26.3.jar. - Chép file vào
%appdata%\.minecraft\mods(Windows). Không giải nén, không đổi tên. Mở game: trong menu Mods thấy dòng “Fabric API” là xong.
%appdata%.minecraftmods
Đừng nhầm Fabric API với Fabric Loader. Loader là trình cài đặt (file .exe hoặc .jar bạn chạy một lần, tạo profile trong Launcher). API là file .jar nằm trong thư mục mods. Thiếu cái nào game cũng báo lỗi, nhưng thông báo khác nhau: thiếu Loader thì không có profile Fabric để chọn; thiếu API thì game mở lên rồi hiện bảng “Incompatible mods found”.
Cài đặt nên chỉnh
Fabric API không có menu cài đặt và không cần chỉnh gì. Việc duy nhất đáng để ý là cập nhật kèm theo mod: khi một mod mới báo cần Fabric API bản cao hơn, tải bản mới nhất cho 26.3 ở ô bên phải, xóa file cũ trong mods rồi thả file mới vào. Hai file Fabric API cùng lúc làm game không khởi động được.
Mod đi kèm và mod xung đột
Bộ nền gọn cho một máy chơi Fabric 26.3 thường là Fabric API + Sodium + Lithium (hiệu năng) + Mod Menu (xem danh sách mod và bấm vào cấu hình) + Cloth Config (thư viện cấu hình nhiều mod cần). Từ bộ này thêm gì cũng được.
Iris Shaders Có bài hướng dẫn
Chạy shader (ánh sáng, bóng, nước đẹp) trên Fabric/NeoForge, dùng chung với Sodium. Nhận hầu hết…
Litematica Có bài hướng dẫn
Đặt bản vẽ công trình (schematic) mờ trong thế giới rồi xây theo từng khối. Mod…
Sodium Có bài hướng dẫn
Mod tăng FPS nổi tiếng nhất: viết lại cách game vẽ hình, máy yếu có thể…
Xung đột: Fabric API không chạy cùng mod viết cho Forge hay NeoForge (file .jar của Forge nằm trong thư mục mods sẽ làm Fabric văng lúc khởi động), và không dùng với OptiFine, vốn không phải mod Fabric. Quilt Loader đọc được Fabric API nhưng khuyên dùng Quilted Fabric API riêng của họ.
Lỗi hay gặp
“Incompatible mods found! Install fabric-api, any version”
Thông báo đúng nghĩa đen: một mod trong thư mục mods cần Fabric API mà chưa có. Bảng lỗi liệt kê tên mod đó ở dòng dưới. Tải Fabric API cho 26.3 thả vào mods là hết.
“Mod X requires version 0.16x or above of fabric-api”
Có Fabric API rồi nhưng bản cũ. Xóa file fabric-api cũ, tải bản mới nhất cho 26.3. Nếu mod đòi bản cao hơn bản mới nhất hiện có, mod đó được viết cho snapshot 26.4, không dùng được trên 26.3.
Game văng ngay sau logo Mojang, không hiện bảng lỗi
Thường do Fabric API sai phiên bản game (ví dụ file +26.2 chạy trên 26.3) hoặc hai bản Fabric API cùng nằm trong mods. Mở thư mục mods, giữ đúng một file fabric-api có đuôi +26.3. Vẫn văng thì đọc crash report theo bài Minecraft bị văng game.
Câu hỏi thường gặp
Fabric API có làm giảm FPS không?
Không đáng kể. Nó chỉ là tập hàm chờ mod khác gọi; game không có mod nào dùng tới thì gần như không chạy gì. Tụt FPS sau khi cài là do mod khác, không phải Fabric API.
Server cần cài Fabric API không?
Có, nếu server chạy Fabric và có mod cần nó. Thả cùng file .jar vào thư mục mods của server; phiên bản nên trùng với client để tránh lỗi đồng bộ.
Cần cài lại Fabric API khi lên 26.4 không?
Có. Mỗi bản Minecraft dùng một Fabric API riêng (đuôi +26.4). Khi 26.4 phát hành, tải lại Fabric API, và đợi các mod khác ra bản 26.4 rồi mới chuyển; chuyển sớm là mất mod.
Fabric API có bản cho Bedrock hay điện thoại không?
Không. Fabric chỉ tồn tại trên Java Edition. Trên Bedrock và Minecraft PE, “mod” là addon dạng .mcaddon, không liên quan tới Fabric.