Bạn vừa hoàn thành một tựa game Unity tâm huyết và muốn chia sẻ nó với cả thế giới một cách nhanh chóng và miễn phí? GitHub Pages chính là giải pháp hoàn hảo. Tuy nhiên, quá trình deploy game WebGL từ Unity lên đây thường gặp một lỗi phổ biến liên quan đến file nén. Bài viết này sẽ hướng dẫn bạn toàn bộ quy trình một cách chi tiết và cách khắc phục triệt để lỗi đó.
Bước 1: Build Game Unity với Thiết lập Chuẩn cho GitHub Pages
Đây là bước quan trọng nhất và là nơi hầu hết mọi người gặp lỗi. Lỗi phổ biến nhất là game không thể tải được trên trình duyệt do GitHub Pages không xử lý đúng các file được Unity nén lại. Giải pháp là chúng ta sẽ yêu cầu Unity **không nén file** khi build.
Hãy làm theo các bước sau:
- Mở lại project Unity của bạn.
- Vào menu File → Build Settings....
- Đảm bảo bạn đã chọn Platform là WebGL. Nếu chưa, hãy chọn và nhấn "Switch Platform".
- Ở góc dưới bên trái, nhấn vào nút Player Settings.... Cửa sổ Project Settings sẽ mở ra.
- Trong cửa sổ Project Settings, chọn tab Player ở bên trái.
- Tìm đến mục Publishing Settings và mở rộng nó ra.
- Bên trong đó, bạn sẽ thấy một tùy chọn tên là Compression Format.
- Giá trị của nó hiện tại đang là
BrotlihoặcGzip. Hãy nhấp vào đó và đổi nó thànhDisabled.
Bước quan trọng nhất: Tắt chế độ nén (Compression Format = Disabled).
Sau khi đã tắt nén, quay lại cửa sổ Build Settings và nhấn Build. Chọn một thư mục trống để chứa các file game được build ra. Unity sẽ tạo ra một file `index.html` và một thư mục `Build`.
Bước 2: Chuẩn bị Kho lưu trữ (Repository) trên GitHub
- Tạo một kho lưu trữ public mới trên GitHub. Đặt tên bất kỳ bạn muốn, ví dụ: `my-unity-game`.
- Vào trang kho lưu trữ vừa tạo, chọn tab Settings.
- Ở menu bên trái, chọn Pages.
- Trong mục "Build and deployment", dưới phần "Source", hãy chọn Deploy from a branch.
- Dưới phần "Branch", đảm bảo bạn đã chọn nhánh `main` (hoặc `master`) và thư mục là `/ (root)`. Nhấn Save.
Cấu hình GitHub Pages để deploy từ nhánh chính.
Bước 3: Tải File Game Lên và Tận hưởng Thành quả
- Quay lại trang chính của kho lưu trữ.
- Nhấn vào nút Add file → Upload files.
- Kéo và thả **toàn bộ** các file và thư mục (bao gồm `index.html` và thư mục `Build`) mà Unity đã tạo ở Bước 1 vào khu vực upload.
- Đợi quá trình upload hoàn tất, sau đó nhấn Commit changes.
Bây giờ, hãy đợi vài phút cho GitHub Actions tự động deploy trang của bạn. Bạn có thể truy cập lại mục Settings → Pages để xem link trang game của mình (thường có dạng `https://your-username.github.io/your-repository-name/`).
Chúc mừng! Bạn đã deploy thành công game Unity của mình lên web. Lỗi không tải được game sẽ biến mất và giờ đây bạn có thể gửi link cho bất kỳ ai để trải nghiệm sản phẩm của mình.