# OhMyGame: làm game bằng AI từ ý tưởng đến link chơi — hướng dẫn cài đặt và dùng

> OhMyGame là ứng dụng desktop mã nguồn mở (Windows x64 và Mac chip Apple) giúp một người làm game với AI. Bạn mô tả game, agent sẽ thiết kế, làm hình ảnh, viết code, chơi thử và xuất bản thành link. Cài bằng bản tải sẵn khá dễ, nhưng bạn phải tự kết nối một nhà cung cấp mô hình AI bằng key của mình.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-10-15 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/ohmygame-lam-game-bang-ai-huong-dan-cai-dat

OhMyGame là một ứng dụng mã nguồn mở giúp bạn làm game bằng AI ngay trong một cửa sổ duy nhất. Bạn mô tả game muốn làm, agent sẽ viết tài liệu thiết kế, tạo hình ảnh, viết code, tự chơi thử xem có chạy không, rồi xuất bản thành một đường link ai cũng mở được.

Repo này hợp với người muốn thử làm game mà không có cả một đội: lập trình viên mới, chủ shop muốn làm một game nhỏ để quảng bá, hay người làm nội dung muốn có game tương tác. Điểm đáng giá nhất là mọi thứ nằm chung một chỗ: tài liệu thiết kế, ảnh, video, 3D, âm thanh và code cùng nằm trên một canvas, thay vì rải ra năm sáu ứng dụng khác nhau.

Hiện repo có khoảng 2154 sao và 272 fork, dùng giấy phép Apache-2.0, viết chủ yếu bằng TypeScript. Tác giả ghi rõ đây là bản beta, nên bạn có thể gặp lỗi vặt. Mình sẽ chỉ bạn cách cài và dùng, kèm những chỗ người mới hay vấp.

```repo
- repo | WhiteTowerAI/ohmygame
- kind | Ứng dụng
- desc | OhMyGame là ứng dụng mã nguồn mở để làm game bằng AI: thiết kế, tạo hình ảnh, viết code, tự chơi thử và xuất bản thành link cho người khác chơi.
- stars | 2.2k
- lang | TypeScript
- license | Apache-2.0
```

## OhMyGame làm được gì

Mình tóm các tính năng chính theo lợi ích bạn nhận được.

- **Agent làm game thay bạn.** Agent soạn tài liệu thiết kế, viết code, chạy game trong khung xem trước trực tiếp, rồi tự chơi thử. Khi có chỗ hỏng, nó thử sửa. Bạn đỡ phải qua lại giữa trình soạn code và trình duyệt để kiểm tra từng chút một.
- **Một canvas cho mọi tài nguyên.** Bạn có thể tạo ảnh, video, mô hình 3D, hoạt ảnh, giọng nói, hiệu ứng âm thanh và nhạc bằng AI, rồi sắp xếp ngay trên một canvas, sẵn sàng đưa vào game.
- **Xuất bản thành link.** Game chơi được ngay trên trình duyệt và hiện trong mục Community của dự án. Với game nhiều người chơi, phòng chơi, đăng nhập, lưu tiến trình và bảng xếp hạng đi kèm theo mô tả của tác giả.
- **Mở rộng bằng plugin.** Plugin có thể dạy agent kỹ năng mới, thêm công cụ, thêm bảng điều khiển và loại dự án. Các plugin đi kèm hỗ trợ Godot, Unity, Unreal Engine, Blender, Aseprite, Tiled, và các nền tảng như WeChat và Douyin Mini Games. Bạn cũng có thể tự viết plugin.
- **Dùng agent của chính bạn.** OhMyGame chạy được trên Claude Code, Codex hoặc OpenCode, hoặc trên hơn 40 nhà cung cấp mô hình bằng key riêng của bạn. Không có credit tính theo mỗi lần chạy. Chiều ngược lại cũng được: bạn dùng canvas, tạo media và chơi thử từ agent của mình qua MCP.

Về loại game, tác giả khuyên bắt đầu với **game web** (Phaser, Three.js, React Three Fiber). Ngoài ra có **truyện tương tác** (visual novel, phim tương tác) và **game tổng quát** dùng bất kỳ engine hay stack nào. Game web có thể chơi nhiều người, từ cờ bài đến đấu trường thời gian thực, mà bạn không cần tự dựng server.

## Cần chuẩn bị gì

Theo tư liệu, bạn cần:

- **Hệ điều hành:** macOS chip Apple silicon hoặc Windows x64. Mac Intel và Linux mới nằm trong kế hoạch, chưa có bản chính thức.
- **Một mô hình AI:** OhMyGame không kèm sẵn mô hình. Lần mở đầu tiên, bạn phải kết nối một nhà cung cấp mô hình hoặc một coding agent bạn đã dùng (như Claude Code, Codex, OpenCode). Hướng dẫn nằm ở trang first-run trong tài liệu của dự án.
- **Tài khoản:** chỉ cần khi bạn muốn xuất bản game. Dùng để làm game trên máy thì README không yêu cầu tài khoản.
- **Nếu build từ mã nguồn:** Bun 1.4.2 trở lên và Node.js 22.19 trở lên. `package.json` cũng yêu cầu Node từ 22.19.0.

README không nêu yêu cầu phần cứng như GPU hay dung lượng RAM, nên mình không đoán ở đây.

```note
Key API là chìa khóa trả tiền của bạn ở nhà cung cấp mô hình. Đừng gửi key cho người khác, đừng dán lên nhóm chat. Vì OhMyGame dùng key của bạn, chi phí sẽ tính theo nhà cung cấp bạn chọn, hãy xem bảng giá của họ trước khi cho agent chạy nhiều lượt.
```

## Cài đặt từng bước

Có hai đường: tải bản cài sẵn (dễ nhất, hợp với người mới) hoặc build từ mã nguồn (hợp với lập trình viên). Mình viết cả hai.

```steps
- Tải bản cài | Lấy bản cho Mac (Apple silicon) hoặc Windows (x64) từ trang tải của dự án
- Cài và mở app | Cài như phần mềm bình thường, chấp nhận cảnh báo SmartScreen trên Windows nếu có
- Kết nối mô hình | Lần mở đầu, nối một nhà cung cấp mô hình hoặc coding agent bạn đang dùng
- Hoặc build từ mã nguồn | Clone repo, cài phụ thuộc bằng Bun, chạy dev
```

### Tải bản cài sẵn

Vào trang chủ ohmygame.ai, mục tải về, chọn bản cho Mac (Apple silicon) hoặc Windows (x64). Bản cũ và ghi chú phát hành có trong mục Releases của repo trên GitHub.

README không ghi thêm các bước cài chi tiết cho bản tải sẵn. Nếu bạn vướng, hãy xem trang install trong tài liệu của dự án (ohmygame.ai/docs/install).

Lưu ý cho người dùng Windows: bản Windows chưa được ký số (code-signed), nên lần cài đầu Windows SmartScreen có thể hiện cảnh báo. Đây là điều tác giả đã báo trước. Chỉ tiếp tục nếu bạn tải từ đúng trang chính thức của dự án.

### Kết nối mô hình khi mở lần đầu

App không kèm mô hình nên chưa kết nối thì agent chưa làm được gì. Làm theo màn hình first-run: chọn một nhà cung cấp mô hình và dán key của bạn, hoặc chọn một coding agent bạn đã cài sẵn. Chi tiết từng nhà cung cấp nằm trong trang models và first-run của tài liệu, README không liệt kê cụ thể nên mình không ghi thêm.

### Build từ mã nguồn (dành cho lập trình viên)

Bạn cần Bun 1.4.2+ và Node.js 22.19+ trước. Mở terminal (PowerShell hoặc Terminal), rồi chạy:

```bash
git clone https://github.com/WhiteTowerAI/ohmygame.git
cd ohmygame
bun install --frozen-lockfile
bun run dev            # web renderer + local daemon
bun run dev:desktop    # or the Electron app
```

Giải thích từng lệnh:

- `git clone ...` tải mã nguồn về máy, `cd ohmygame` đi vào thư mục vừa tải. Mọi lệnh sau phải chạy trong thư mục này, đây là chỗ người mới hay quên.
- `bun install --frozen-lockfile` cài các phụ thuộc đúng theo file khóa `bun.lock`, không tự đổi phiên bản.
- `bun run dev` chạy phần giao diện web cùng một daemon cục bộ.
- `bun run dev:desktop` chạy bản ứng dụng Electron. Bạn chọn một trong hai, tùy muốn xem bằng web hay bằng app desktop.

Theo README, bản build từ mã nguồn không gửi telemetry. Về nhánh, kiểm tra và thiết lập cloud tùy chọn, xem file CONTRIBUTING.md trong repo. Repo có file `.env.example` với các biến cấu hình như `CLOUD_API_URL`, `OHMYGAME_FFMPEG_PATH`, nhưng README không bảo bạn bắt buộc phải điền khi chỉ muốn chạy thử, nên đừng sửa nếu chưa cần.

## Kiểm tra đã chạy được chưa

README không đưa ra một lệnh kiểm tra riêng, nên mình nói theo cách hợp lý nhất dựa trên mô tả:

- Với bản tải sẵn: app mở lên được và bạn đi qua được màn hình first-run, kết nối xong một nhà cung cấp mô hình.
- Với bản build từ mã nguồn: lệnh `bun run dev` hoặc `bun run dev:desktop` chạy không báo lỗi và giao diện (hoặc cửa sổ Electron) hiện ra.
- Thử nhanh: bảo agent làm một game web thật đơn giản và xem khung xem trước trực tiếp có chạy không. Nếu game hiện ra và agent trả lời, bạn đã sẵn sàng.

Nếu agent không trả lời gì, gần như chắc chắn là chưa kết nối mô hình hoặc key chưa đúng. Xem phần lỗi bên dưới.

## Dùng vào việc thật

Mình nêu vài tình huống bám đúng những gì repo mô tả. Các câu lệnh mẫu bên dưới là gợi ý để bạn gõ cho agent, không phải cú pháp đặc biệt của repo.

### Dev mới thử làm game web đầu tiên

Bạn là lập trình viên mới, chưa từng làm game. Tác giả khuyên bắt đầu với game web. Bạn gõ cho agent một yêu cầu rõ ràng, ví dụ:

```
Làm cho mình một game web đơn giản bằng Phaser: nhân vật nhảy qua chướng ngại vật, tính điểm theo thời gian sống sót. Soạn tài liệu thiết kế ngắn trước, rồi mới viết code.
```

Agent soạn tài liệu thiết kế, viết code, chạy trong khung xem trước và tự chơi thử. Nếu có lỗi, nó thử sửa. Bạn nhận được một game chạy thử được, kèm code để đọc và học.

> Bạn không cần năm ứng dụng khác nhau để làm một game nhỏ, chỉ cần một ý tưởng rõ ràng và một canvas.
>
> — Ông T

### Chủ shop làm game nhỏ để tặng khách

Bạn bán đồ handmade và muốn có một game đố vui hoặc bài lật hình có hình ảnh của shop để đăng lên trang bán hàng. Bạn mô tả game và phong cách hình ảnh, nhờ agent tạo ảnh trên canvas, rồi ghép vào game. Khi hài lòng, bạn xuất bản để có một link, chép link đó đưa vào bài đăng. Lưu ý: để xuất bản bạn cần có tài khoản, và game sẽ có thể hiện trong mục Community của dự án.

### Người viết truyện làm truyện tương tác

Bạn là người viết nội dung, muốn biến một câu chuyện có nhiều nhánh thành visual novel. Repo có loại dự án truyện tương tác (visual novel, phim tương tác, story game). Bạn đưa cốt truyện và các lựa chọn cho agent, nhờ nó tạo nhân vật, bối cảnh, giọng đọc và nhạc nền trên cùng canvas. Kết quả là một câu chuyện chơi được trên trình duyệt thay vì chỉ là văn bản.

### Dev dùng canvas từ agent đang có

Bạn đã quen Claude Code hoặc Codex và không muốn đổi thói quen. README nói bạn có thể dùng canvas, tạo media và chơi thử của OhMyGame từ agent của mình thông qua MCP. Cách cấu hình cụ thể README chưa ghi, hãy xem phần External agents trong thư mục `docs/` của repo hoặc trong tài liệu của dự án.

## Lỗi hay gặp và cách xử lý

### Agent không phản hồi hoặc báo lỗi xác thực

Nguyên nhân hay gặp nhất: chưa kết nối mô hình, hoặc dán sai key. Mở lại phần kết nối mô hình theo hướng dẫn first-run, kiểm tra key đã copy đủ và đúng nhà cung cấp, không thừa khoảng trắng.

### Windows hiện cảnh báo SmartScreen

Tác giả đã báo bản Windows chưa được ký số. Hãy đảm bảo bạn tải từ trang chính thức của dự án, rồi mới chọn tiếp tục cài. Nếu không yên tâm, bạn có thể build từ mã nguồn.

### `bun install` hoặc `bun run dev` báo lỗi khi build từ mã nguồn

Kiểm tra phiên bản. Dự án cần Bun 1.4.2+ và Node.js 22.19+. Kiểm tra bằng `node --version` và `bun --version`, nâng cấp nếu thấp hơn. Cũng kiểm tra bạn đang đứng đúng trong thư mục `ohmygame` khi chạy lệnh.

### Máy Mac Intel hoặc Linux không có bản cài

Hiện bản tải sẵn chỉ có cho Mac Apple silicon và Windows x64. Intel Mac và Linux đang nằm trong lộ trình. Bạn có thể thử build từ mã nguồn, nhưng README không cam kết các nền tảng này chạy ổn.

### Chi phí tăng nhanh khi cho agent chạy nhiều lượt

Vì bạn dùng key riêng, mỗi lần agent tạo ảnh, video hay viết code đều tính tiền theo nhà cung cấp. Hãy bắt đầu với game rất nhỏ, theo dõi bảng chi phí của nhà cung cấp, và đặt giới hạn chi tiêu nếu họ có tùy chọn đó.

## Có nên dùng không

**Điểm mạnh.** OhMyGame gom cả quy trình làm game vào một app: thiết kế, tài nguyên, code, chơi thử, xuất bản. Nó mã nguồn mở theo Apache-2.0, dùng key của bạn, không tính credit theo lượt, hỗ trợ hơn 40 nhà cung cấp mô hình và các agent như Claude Code, Codex, OpenCode. Theo README, dự án và API key nằm trên máy bạn, prompt đi thẳng tới nhà cung cấp bạn chọn.

**Giới hạn.** Đây là bản beta, có thể có lỗi. Chưa có bản chính thức cho Mac Intel và Linux. Bản Windows chưa ký số. Bạn phải tự lo mô hình AI và chi phí. Bản phát hành chính thức có gửi dữ liệu sử dụng và báo lỗi, bạn có thể tắt trong Settings → About. Bản build từ mã nguồn thì không gửi telemetry.

**Khi nào chọn cách khác.** Nếu bạn cần một engine game chuyên nghiệp cho dự án lớn, hãy dùng thẳng Unity, Unreal hay Godot (OhMyGame có plugin hỗ trợ các engine này nhưng không thay thế chúng). Nếu bạn chỉ cần vài bức ảnh hay một đoạn nhạc, một công cụ tạo ảnh hoặc âm thanh đơn lẻ sẽ gọn hơn. Còn nếu bạn muốn thử làm game một mình, từ ý tưởng đến link chơi, đây là repo đáng thử.

## Câu hỏi thường gặp

### OhMyGame có miễn phí không?

Ứng dụng là mã nguồn mở theo giấy phép Apache-2.0 và README ghi là không tính credit theo mỗi lần chạy. Tuy vậy bạn phải dùng key của chính mình với nhà cung cấp mô hình, nên chi phí tính theo nhà cung cấp đó. Tên và logo OhMyGame không nằm trong giấy phép.

### OhMyGame chạy được trên Windows không?

Có, có bản Windows x64 để tải. Bản này chưa được ký số nên SmartScreen có thể cảnh báo ở lần cài đầu. Mac chạy chip Apple silicon có bản riêng, còn Mac Intel và Linux mới nằm trong lộ trình.

### Có cần GPU hay máy mạnh không?

README không nêu yêu cầu phần cứng, nên mình chưa có thông tin về GPU hay RAM tối thiểu. Phần AI chạy qua nhà cung cấp mô hình bạn chọn bằng key riêng. Muốn chắc hơn, bạn xem trang install trong tài liệu của dự án.

### Dữ liệu và API key của tôi có an toàn không?

Theo README, dự án và API key nằm trên máy bạn, prompt gửi thẳng tới nhà cung cấp bạn chọn, và chỉ cần tài khoản khi xuất bản. Bản phát hành gửi dữ liệu sử dụng và báo lỗi, bạn tắt được trong Settings → About. Bản build từ mã nguồn không gửi telemetry.

### Tôi dùng mô hình nào được?

OhMyGame không kèm sẵn mô hình. Bạn có thể chạy trên Claude Code, Codex hoặc OpenCode, hoặc trên hơn 40 nhà cung cấp mô hình bằng key của bạn. Danh sách cụ thể nằm ở trang models trong tài liệu của dự án.

### Tôi làm được loại game nào?

Game web (Phaser, Three.js, React Three Fiber) là nơi tác giả khuyên bắt đầu. Ngoài ra có truyện tương tác như visual novel và phim tương tác, và game tổng quát dùng bất kỳ engine nào. Game web có thể chơi nhiều người mà bạn không cần tự dựng server.

### Khác gì việc nhờ một coding agent viết game thông thường?

Coding agent thông thường chủ yếu viết code. OhMyGame thêm một canvas cho ảnh, video, 3D, âm thanh, cùng bước tự chơi thử và xuất bản thành link. Bạn cũng có thể dùng chính Claude Code, Codex hoặc OpenCode làm agent bên trong app.
