Kỹ thuật & AI

Inkline Town: kiểm thử game mô phỏng mà không cần trình duyệt

Inkline Town là game xây thị trấn mã nguồn mở, minh họa cách phát lại lệnh của người chơi để tái hiện lỗi mô phỏng ngoài trình duyệt.

Tóm tắt

  • Inkline Town cho lập trình viên một mẫu để kiểm thử luật chơi mà không cần mở trình duyệt.
  • Ghi lại seed, lệnh của người chơi và bước áp dụng để tái hiện một lỗi mô phỏng.
  • Dùng kiểm thử trên trình duyệt cho thao tác đặt công trình, góc nhìn 3D và giao diện điện thoại.
Inkline Town: kiểm thử game mô phỏng mà không cần trình duyệt

Người chơi báo xe chở gỗ đứng yên, nhưng khi bạn tải lại bản đồ thì xe chạy bình thường. Inkline Town minh họa cách ghi lại seed và các lệnh của người chơi để tái hiện tình huống, rồi kiểm tra luật vận chuyển ngay ngoài trình duyệt.

Inkline Town giúp làm gì?

Ritmo ECS chạy mô phỏng theo bước cố định. Giao diện, bot và bộ kiểm thử gửi lệnh qua cùng một hàng đợi, còn PixiJS 3D đọc trạng thái để vẽ. Muốn tái hiện lỗi, hãy giữ seed, thiết lập ban đầu và bước áp dụng từng lệnh. Tài liệu phát triển

Khi nào đáng dùng?

Tham khảo cách tách lớp này khi sản xuất, tồn kho và vận chuyển ảnh hưởng lẫn nhau. Với demo chủ yếu để thử góc nhìn hoặc nét vẽ, chi phí dựng thêm các lớp có thể lớn hơn phần cần kiểm chứng. Repo dùng Apache-2.0. Giấy phép Inkline Town

Cách thử và kiểm tra kết quả

Chuẩn bị cho AI agent một seed, tuyến đường nối trại đốn gỗ với xưởng cưa và một tình huống cần kiểm tra, chẳng hạn cắt đường trước khi xe nhận hàng. Ghi rõ thay đổi tồn kho bạn kỳ vọng sau một số bước cố định.

  1. Chạy ca vận chuyển hai lần với cùng thiết lập và lệnh. So tồn kho và trạng thái xe ở cùng bước mô phỏng.
  2. Bỏ đoạn đường nối rồi chạy lại. Kiểm thử phải nhận ra thay đổi về giao hàng.
  3. Kiểm tra thao tác trong trình duyệt khi cần xác nhận đặt công trình, góc nhìn 3D hoặc giao diện điện thoại. Dùng pnpm check:browser sau khi mở dev server. Hướng dẫn chạy kiểm thử

Đánh giá mã nguồn và tài liệu tại commit aa7dbe0 ngày 20/11/2026. HubCom chưa áp dụng kiến trúc này trong dự án khách hàng.

Thuật ngữ trong bài (5)
Inkline Town
Game xây thị trấn 3D chạy trên trình duyệt, có mã nguồn công khai.
Ritmo ECS
Thư viện tổ chức các đối tượng trong game thành thực thể và thành phần dữ liệu. Các hệ thống đọc hoặc cập nhật dữ liệu đó theo luật chơi.
PixiJS 3D
Thư viện dựng cảnh 3D mà Inkline Town dùng để vẽ thị trấn.
Headless
Chạy mô phỏng trực tiếp từ mã để kiểm thử mà không cần mở giao diện.
Seed
Giá trị đầu vào để tạo lại cùng bản đồ khi giữ nguyên cấu hình tạo bản đồ.

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

Có thể chơi Inkline Town ngay trên web không?

Có. Tác giả cung cấp bản chơi trên trình duyệt tại inkline.typeonce.games. Bản lưu nằm trên thiết bị.

Có cần PixiJS 3D để kiểm thử luật chơi không?

Phần mô phỏng có chế độ headless. Dùng trình duyệt khi cần kiểm tra thao tác và phần hiển thị.

Seed có đủ để phát lại một ván không?

Để phát lại diễn biến, cần giữ cả thiết lập ban đầu, lệnh của người chơi và bước áp dụng từng lệnh.

Nguồn tham khảo

Trao đổi cùng HubCom ↗