Khác với Java Edition nơi người chơi tự cài mod vào máy, server Minecraft Bedrock có cơ chế hay hơn: add-on và resource pack có thể được “ép” đồng bộ tự động xuống máy của người chơi ngay khi họ kết nối, miễn là server cấu hình đúng. Bài viết này đi qua từng bước cụ thể để admin tự tay thiết lập, không cần phụ thuộc người chơi tự tải file bên ngoài.
Bước 1: Phân biệt rõ hai loại gói trước khi bắt đầu
Add-on Bedrock thực chất gồm hai phần tách biệt: behavior pack (gói hành vi, chứa logic — ví dụ loot table, entity mới, hàm tùy biến) và resource pack (gói tài nguyên, chứa texture, model, âm thanh). Một add-on hoàn chỉnh thường cần cả hai đi kèm nhau; chỉ cài behavior pack mà thiếu resource pack tương ứng có thể khiến vật thể mới hiển thị sai hoặc vô hình.
Bước 2: Kiểm tra và chuẩn hóa file manifest.json
Mỗi pack bắt buộc có file manifest.json ở thư mục gốc, khai báo UUID duy nhất, số phiên bản (định dạng ba số như [1,0,0]) và phần mô tả tên hiển thị. Lỗi thường gặp nhất khi add-on không hoạt động trên server là hai pack khác nhau bị trùng UUID — điều này xảy ra khi người dùng copy thư mục pack cũ rồi chỉnh sửa tên mà quên đổi UUID, khiến server hoặc client không phân biệt được hai gói là khác nhau.
Bước 3: Đặt pack vào đúng thư mục server
Trên Bedrock Dedicated Server, behavior pack được đặt trong thư mục behavior_packs và resource pack trong resource_packs, nằm ngang cấp với world đang chạy. Mỗi pack là một thư mục con riêng chứa đúng cấu trúc file gốc, không nén lại thành .zip ở bước này.
Bước 4: Khai báo trong world_behavior_packs.json và world_resource_packs.json
Đây là bước nhiều người bỏ sót nhất. Chỉ đặt file vào thư mục chưa đủ — server cần được “chỉ tay” biết world nào áp dụng pack nào, thông qua hai file cấu hình nằm trong thư mục world: world_behavior_packs.json và world_resource_packs.json. Nội dung khai báo gồm pack_id (chính là UUID trong manifest) và version khớp đúng với số phiên bản đã khai báo. Nếu UUID hoặc version sai lệch dù chỉ một ký tự, server sẽ âm thầm bỏ qua pack mà không báo lỗi rõ ràng, khiến nhiều admin mất hàng giờ debug.
Bước 5: Khởi động lại server và kiểm tra log
Sau khi hoàn tất cấu hình, khởi động lại toàn bộ server (không chỉ reload world). Theo dõi log khởi động — nếu pack được nạp thành công, log thường hiển thị tên và UUID của pack trong phần liệt kê tài nguyên. Nếu không thấy xuất hiện, quay lại kiểm tra bước 2 và 4 trước tiên vì đây là hai nguồn lỗi phổ biến nhất.
Những vấn đề thường gặp và cách xử lý
- Người chơi vào server nhưng không thấy thay đổi gì: thường do client đã cache phiên bản pack cũ. Yêu cầu người chơi thoát hoàn toàn game và vào lại, đôi khi cần xóa cache resource pack trong phần cài đặt.
- Server báo lỗi “pack not found” dù file vẫn còn trong thư mục: kiểm tra lại đường dẫn tương đối trong file cấu hình — một số bản server nhạy với chữ hoa/chữ thường trên hệ điều hành Linux.
- Add-on hoạt động trên world test nhưng lỗi khi copy sang world chính: rất có thể world chính chưa có file
world_behavior_packs.jsontương ứng, cần khai báo lại riêng cho từng world vì cấu hình này không tự động áp dụng toàn server.
Lưu ý về thứ tự ưu tiên khi dùng nhiều pack cùng lúc
Khi server có nhiều add-on chạy song song, thứ tự liệt kê trong file cấu hình quyết định pack nào được áp dụng sau sẽ ghi đè lên pack áp dụng trước nếu có xung đột tài nguyên trùng tên. Một mẹo thực tế: luôn đặt các pack “nền” (thay đổi lớn về gameplay) lên trước, và các pack “tinh chỉnh nhỏ” (như texture lẻ, âm thanh phụ) ở cuối danh sách để tránh việc tinh chỉnh nhỏ vô tình bị ghi đè mất.
Kiểm tra tương thích phiên bản trước khi triển khai rộng
Add-on được viết cho một khoảng phiên bản Minecraft PE nhất định, khai báo qua trường min_engine_version trong manifest. Khi Mojang phát hành bản cập nhật lớn, engine đôi khi thay đổi cách xử lý script hoặc entity, khiến add-on cũ không còn chạy đúng hoặc bị server âm thầm vô hiệu hóa để tránh crash. Vì vậy, trước khi ép toàn bộ người chơi dùng một add-on mới, nên test trên world riêng với vài tài khoản, kiểm tra kỹ các cơ chế cốt lõi như sinh vật mới, item tùy biến và tương tác block hoạt động ổn định trên đúng phiên bản server hiện tại rồi mới áp dụng đại trà.
Làm đúng theo trình tự năm bước trên, add-on sẽ tự động đồng bộ xuống máy mọi người chơi ngay khi họ kết nối — không cần hướng dẫn tải file thủ công, không cần lo người chơi dùng nhầm phiên bản pack, và quan trọng nhất là giữ được tính đồng nhất trải nghiệm cho toàn bộ cộng đồng server.