# OhMyGame: làm game bằng AI trong một ứng dụng duy nhất — hướng dẫn cài đặt và dùng

> OhMyGame là ứng dụng máy tính mã nguồn mở (Apache-2.0) giúp bạn mô tả một game rồi để AI thiết kế, vẽ, viết code, chơi thử và xuất bản thành link. Ứng dụng không kèm sẵn mô hình AI, bạn phải tự kết nối nhà cung cấp hoặc công cụ như Claude Code. Cài bản dựng sẵn cho Windows hoặc Mac khá dễ, chỉ cần tải về và chạy.

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

OhMyGame là một ứng dụng mã nguồn mở để làm game bằng AI, chạy ngay trên máy của bạn. Bạn mô tả game mình muốn, và "agent" trong ứng dụng sẽ viết tài liệu thiết kế, tạo hình ảnh, viết code, chạy thử game để kiểm tra, rồi đăng lên một đường link để người khác mở chơi trên trình duyệt.

Điểm làm mình thấy đáng chú ý là mọi thứ nằm chung một chỗ. Thông thường làm game cần một công cụ viết code, một công cụ vẽ, một công cụ làm âm thanh, một công cụ làm video... OhMyGame gom tài liệu thiết kế, hình ảnh, video, mô hình 3D và âm thanh lên cùng một "canvas" (bảng làm việc) ngay cạnh code. Bạn đỡ phải nhảy qua lại giữa năm sáu ứng dụng.

Repo phù hợp với người muốn thử làm game mà không giỏi lập trình, chủ shop muốn làm một game nhỏ để quảng bá, hoặc lập trình viên mới muốn có "trợ lý làm game" chạy bằng chính key AI của mình. Hiện repo có khoảng 2172 sao và 273 fork, giấy phép Apache-2.0. Tác giả ghi rõ dự án đang ở giai đoạn beta, nên có thể còn lỗi vặt.

```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/âm thanh, viết code, chơi thử và đăng game lên một đường link.
- stars | 2.2k
- lang | TypeScript
- license | Apache-2.0
```

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

### Để agent làm game giúp 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. Lợi ích thực tế: bạn không phải copy code qua lại giữa khung chat và trình soạn thảo, và không phải tự chạy thử từng lần.

### Một canvas cho mọi tài nguyên
Bạn có thể tạo hình ả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 để dùng trong game. Mọi thứ ở một chỗ nên dễ tìm lại và dễ quản lý.

### Đăng game lên một đường link
Game xuất bản thành link, ai cũng mở chơi được trên trình duyệt, và có thể xuất 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 sẵn, bạn không cần tự dựng máy chủ.

### 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. README nêu các plugin đi kèm cho Godot, Unity, Unreal Engine, Blender, Aseprite, Tiled, và các nền tảng như WeChat, Douyin Mini Games. Bạn cũng có thể tự viết plugin.

### Dùng agent và mô hình của riêng bạn
OhMyGame 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. README nói là không tính credit 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.

### Loại game nên bắt đầu
README 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 engine bất kỳ. Game web có thể là nhiều người chơi, từ cờ bài đến đấu trường thời gian thực.

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

- **Hệ điều hành:** bản tải sẵn có cho macOS (chip Apple silicon) và Windows (x64). Mac Intel và Linux mới nằm trong kế hoạch, chưa có.
- **Mô hình AI:** OhMyGame không kèm mô hình. Lần mở đầu tiên bạn phải kết nối một nhà cung cấp, hoặc một công cụ coding agent bạn đang dùng. Trang hướng dẫn "first run" trên website dự án nói về bước này.
- **Tài khoản:** chỉ cần khi bạn muốn đăng game (publish).
- **Nếu build từ mã nguồn:** cần Bun 1.4.2 trở lên và Node.js 22.19 trở lên, cùng Git để tải repo.
- **Phần cứng:** tư liệu không nêu yêu cầu cấu hình hay GPU.

```note
OhMyGame dùng key AI của chính bạn, nên chi phí gọi mô hình (tạo ảnh, video, code) sẽ tính vào tài khoản nhà cung cấp mà bạn kết nối. Hãy theo dõi mức dùng trên trang của nhà cung cấp, và đừng dán key vào nơi công khai.
```

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

Có hai cách: tải bản dựng sẵn (dễ nhất, nên chọn nếu bạn không viết code) hoặc build từ mã nguồn (cho dev).

```steps
- Tải ứng dụng | Vào trang tải của OhMyGame, chọn bản Mac hoặc Windows
- Cài và mở | Chạy file cài đặt, chấp nhận cảnh báo SmartScreen trên Windows nếu có
- Kết nối mô hình | Lần đầu mở, nối một nhà cung cấp hoặc coding agent bạn đã có
- Tạo dự án | Mô tả game bằng câu chữ thường để agent bắt đầu
- (Tuỳ chọn) Build từ mã nguồn | Dùng git, bun cho người muốn tự chạy bản dev
```

### Tải bản dựng sẵn
Trang chủ dự án (ohmygame.ai) có nút tải cho Mac (Apple silicon) và Windows (x64). Các bản cũ và ghi chú phát hành nằm ở mục Releases trên GitHub của repo. README chưa ghi lệnh cài cho bản này, vì đây là file cài đặt thông thường: bạn tải về rồi mở như mọi phần mềm khác. Hướng dẫn chi tiết nằm ở trang docs/install trên website dự án.

Với Windows, README cho biết bản này chưa được ký mã (code-signed), nên SmartScreen có thể hiện cảnh báo ở lần cài đầu. Nếu bạn tải từ đúng trang chính thức của dự án, bạn có thể chọn tiếp tục theo cách Windows cho phép.

### Kết nối mô hình ở lần mở đầu
Ứng dụng không có sẵn mô hình. Khi mở lần đầu, bạn kết nối một nhà cung cấp (nhập key của bạn) hoặc một coding agent bạn đã dùng, như Claude Code, Codex, OpenCode. Bạn cần làm bước này, nếu không agent sẽ không có gì để chạy. Cách làm chi tiết xem ở trang "first run" trong docs của dự án.

### Build từ mã nguồn (dành cho dev)
Bạn cần cài sẵn Bun và Node.js đúng phiên bản như phần trên. Mở terminal (PowerShell trên Windows, Terminal trên Mac), rồi chạy:

```bash
git clone https://github.com/WhiteTowerAI/ohmygame.git
cd ohmygame
bun install --frozen-lockfile
```

- `git clone` tải mã nguồn về máy, `cd ohmygame` vào thư mục vừa tải.
- `bun install --frozen-lockfile` cài các thư viện cần thiết đúng theo file khoá của repo.

Sau đó chạy một trong hai lệnh:

```bash
bun run dev            # web renderer + local daemon
bun run dev:desktop    # or the Electron app
```

Lệnh thứ nhất chạy giao diện web cùng tiến trình nền cục bộ, lệnh thứ hai chạy bản ứng dụng Electron. Chỗ người mới hay vấp: phải đứng trong thư mục `ohmygame` khi chạy lệnh `bun`, nếu không sẽ báo không tìm thấy dự án. README cho biết bản build từ mã nguồn không gửi dữ liệu telemetry. Muốn biết về nhánh, kiểm tra và cấu hình cloud tuỳ chọn thì xem file CONTRIBUTING.md trong repo.

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

Tư liệu không mô tả một lệnh kiểm tra riêng. Cách hợp lý nhất để biết đã chạy được:

- Với bản tải sẵn: ứng dụng mở lên được và màn hình "first run" cho bạn kết nối nhà cung cấp hoặc coding agent.
- Với bản build từ mã nguồn: `bun run dev` chạy xong không báo lỗi và bạn mở được giao diện; hoặc `bun run dev:desktop` bật lên cửa sổ ứng dụng Electron.
- Thử một yêu cầu nhỏ, ví dụ "làm một game rắn săn mồi đơn giản", rồi xem khung xem trước có chạy game không. Nếu có, bạn đã cài thành công.

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

### Chủ shop làm game nhỏ để thu hút khách
Bạn bán đồ handmade và muốn có một game mini cho khách chơi trên trang của mình. Hãy chọn game web, mô tả ngắn gọn, ví dụ:

```text
Làm game xếp hình 2D chủ đề cửa hàng đồ gốm, nhạc nhẹ, chơi được trên điện thoại. Có điểm số và nút chơi lại.
```

Agent soạn thiết kế, tạo hình, viết code và cho bạn xem trước. Bạn góp ý thêm bằng câu chữ thường. Xong thì xuất bản thành link và gửi cho khách. Lưu ý: muốn đăng bạn cần tài khoản.

> Mô tả game bằng lời thường, để agent làm và tự chơi thử, bạn chỉ việc góp ý.
>
> — Ông T

### Nhân viên văn phòng làm game đào tạo nội bộ
Bạn muốn một trò hỏi đáp vui để nhân viên mới ôn quy trình. Hãy chọn loại truyện tương tác hoặc game web, đưa nội dung câu hỏi cho agent, yêu cầu dạng thẻ bài hoặc đố vui nhiều câu. Kết quả là một game mở được bằng link. Bạn nên tự đọc lại nội dung xem đúng quy trình chưa, vì AI có thể diễn đạt sai.

### Lập trình viên mới thử dựng prototype
Bạn đã có Claude Code, Codex hoặc OpenCode. Hãy chạy OhMyGame trên chính agent đó, để agent viết game Phaser hoặc Three.js, trong khi bạn xem code và khung xem trước cạnh nhau. Cách này giúp bạn học cách một game web được tổ chức mà không phải bắt đầu từ trang trắng.

### Làm game nhiều người chơi cùng bạn bè
Nếu muốn một ván cờ hoặc bài chơi online, README nói game web có thể là nhiều người chơi, kèm phòng chơi, đăng nhập, lưu và bảng xếp hạng mà không cần máy chủ riêng. Bạn mô tả luật chơi, đăng lên link rồi gửi bạn bè cùng vào.

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

### Agent không phản hồi hoặc báo thiếu mô hình
Nguyên nhân thường gặp là chưa kết nối nhà cung cấp hay coding agent, vì OhMyGame không kèm mô hình. Hãy quay lại bước first run, kiểm tra key đã nhập đúng chưa và tài khoản nhà cung cấp còn hạn mức không.

### Windows hiện cảnh báo SmartScreen
Bản Windows chưa được ký mã nên cảnh báo này là điều tác giả đã nói trước. Chỉ tải từ trang chính thức của dự án hoặc mục Releases của repo, đừng tải từ nguồn lạ.

### Lệnh bun hoặc node báo sai phiên bản
Nếu build từ mã nguồn, kiểm tra lại bạn có Bun 1.4.2+ và Node.js 22.19+ không. Phiên bản thấp hơn dễ gây lỗi khi cài hoặc chạy. Cập nhật rồi chạy lại `bun install --frozen-lockfile`.

### Không tìm thấy dự án khi chạy bun run
Hầu như do terminal đang đứng sai thư mục. Hãy `cd ohmygame` rồi chạy lại lệnh.

### Game do AI viết bị lỗi hoặc chạy lạ
Đây là điều bình thường với công cụ beta. Hãy mô tả lỗi bằng câu chữ rõ ràng cho agent và yêu cầu sửa. Nếu lỗi nằm ở chính ứng dụng, bạn có thể báo ở mục Issues của repo.

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

**Điểm mạnh:** gom thiết kế, hình ảnh, âm thanh, code và xuất bản vào một ứng dụng; dùng được key và agent của bạn, không tính credit theo lần chạy; mã nguồn mở Apache-2.0; dữ liệu 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. Bản release có gửi dữ liệu sử dụng và báo cáo lỗi, bạn tắt được trong Settings → About.

**Giới hạn:** đang ở giai đoạn beta nên có thể còn lỗi; bản tải sẵn mới có cho Windows x64 và Mac Apple silicon; Windows chưa được ký mã; cần tự có key hoặc agent AI và chịu chi phí phía nhà cung cấp; muốn đăng game phải có tài khoản.

**Khi nào nên chọn cách khác:** nếu bạn cần chạy trên Linux hoặc Mac Intel thì hiện chưa có bản dựng sẵn. Nếu bạn muốn một game rất tinh chỉnh bằng engine chuyên dụng và đã quen quy trình riêng, bạn có thể dùng thẳng engine đó, dù repo cũng có plugin cho vài engine. Còn nếu muốn thử nhanh ý tưởng game mà không viết code, OhMyGame là lựa chọn đá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 nói không tính credit theo mỗi lần chạy. Tuy nhiên bạn dùng key của chính mình, nên chi phí gọi mô hình vẫn tính ở nhà cung cấp bạn chọn. 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 tải sẵn cho Windows (x64) và macOS (Apple silicon). Bản Windows chưa được ký mã nên SmartScreen có thể cảnh báo ở lần cài đầu. Mac Intel và Linux mới nằm trong kế hoạch.

### Cần GPU hay cấu hình mạnh không?

Tư liệu không nêu yêu cầu cấu hình hay GPU. Mô hình AI chạy qua nhà cung cấp hoặc coding agent mà bạn kết nối, nên chưa có thông tin về yêu cầu phần cứng cụ thể.

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

README cho biết dự án và API key nằm trên máy bạn, còn prompt đi thẳng tới nhà cung cấp bạn chọn. Bản release gửi dữ liệu sử dụng và báo cáo lỗi, có thể tắt trong Settings → About. Bản build từ mã nguồn không gửi telemetry.

### Cần cài gì thêm trước khi dùng?

Dùng bản tải sẵn thì chỉ cần tải về và kết nối một nhà cung cấp mô hình hoặc coding agent. Nếu build từ mã nguồn thì cần Bun 1.4.2+ và Node.js 22.19+. Tài khoản chỉ cần khi bạn muốn đăng game.

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

README nói game web (Phaser, Three.js, React Three Fiber) là nơi nên bắt đầu. Ngoài ra có truyện tương tác như visual novel, phim tương tác, và game tổng quát với engine bất kỳ. Game web có thể là nhiều người chơi, từ cờ bài đến đấu trường thời gian thực.

### Tôi có dùng Claude Code hay Codex được không?

Được. README nói OhMyGame 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. Bạn cũng có thể dùng canvas, tạo media và chơi thử từ agent của mình qua MCP.
