REMOTE PLAYTESTING

Thử chơi game trên Mac bằng iPhone.

Xem game Godot đang chạy trên iPhone và gửi thao tác chạm, kéo trở lại máy Mac.

Đã kiểm tra với Godot 4.7.2. Các phiên bản 4.x khác chưa được kiểm tra. Đây là bản đang phát triển; bản App Store chưa được phát hành.

Tải ứng dụng

App Store: đang chuẩn bị phát hành

Google Play: chưa phát hành, chưa có URL cửa hàng

Cần cả ứng dụng iPhone và addon trong dự án game

Chỉ cài ứng dụng iPhone là chưa đủ để kết nối. Hãy thêm và bật addon máy chủ miễn phí trong từng dự án game muốn điều khiển, rồi chạy game. Bạn cần máy Mac, Godot 4.7.2, ứng dụng iPhone tương thích và cùng một mạng LAN cho phép hai thiết bị liên lạc. Game chạy trên Mac; công cụ này không thay thế việc kiểm thử bản dựng iOS gốc.

Thiết lập lần đầu

Tải addon miễn phí

Tải ZIP addon máy chủ miễn phí từ Godot Asset Store, rồi giải nén addons/godot_remote vào dự án trò chơi. Bật SHINRIYO Remote Server for Godot 4 trong Project Settings → Plugins và chạy lại trò chơi.

Đã công bố ngày 28 tháng 10 năm 2026: phiên bản 4.0.0-dev được đánh dấu Unstable, với phiên bản Godot tối thiểu và tối đa đều là 4.7.2. README và tên hiển thị của plugin đã được thống nhất. Đây là addon phía trò chơi; trạng thái phát hành ứng dụng iPhone được nêu riêng.

GitHub

Tải mã nguồn bản phát triển. Sao chép toàn bộ thư mục godot4/addons/godot_remote vào thư mục addons/ của game.

Thư mục addons/ ở gốc kho mã là bản Godot 3 cũ. Không sao chép bản đó.

Bật plugin trong Godot

Mở dự án game. Trong Project Settings → Plugins, bật SHINRIYO Remote Server for Godot 4. Chạy game; nếu game đang chạy, hãy dừng và chạy lại.

Mở ứng dụng iPhone trên cùng mạng LAN

Kết nối Mac và iPhone vào cùng mạng LAN. Mở ứng dụng iPhone và cho phép truy cập Mạng cục bộ (Local Network).

Chọn game và kết nối

Chọn game đang chạy trong danh sách, rồi nhấn Connect. Địa chỉ được điền tự động. Nếu đã đặt mật khẩu máy chủ, hãy nhập cùng mật khẩu đó.

Your game/
├── project.godot
└── addons/
    └── godot_remote/
        ├── plugin.cfg
        ├── autoload.gd
        ├── server.gd
        └── …

Giữ nguyên tệp project.godot của game. Không cần thêm node. Cài addon cho từng dự án. Ứng dụng App Store chưa được phát hành; xem README nếu muốn tự dựng ứng dụng iPhone.

Thao tác sau khi kết nối

Chạm hoặc kéo trên hình ảnh game. Phần cài đặt sẽ ẩn sau khi kết nối: nhấn Settings để mở, Hide để quay lại và Disconnect để ngắt kết nối. Xoay ngang iPhone để xem game nằm ngang với kích thước lớn hơn. About / Licenses hiển thị bản quyền và giấy phép. Ứng dụng sẽ ngắt kết nối khi chuyển sang nền; hãy kết nối lại khi quay về.

Khắc phục sự cố kết nối

Cách đặt hoặc xóa mật khẩu kết nối?

Bật SHINRIYO Remote Server for Godot 4 trong dự án trò chơi trên Mac. Mở Project → Project Settings → General, bật Advanced Settings và tìm godot_remote/server. Đặt Password (godot_remote/server/password), rồi dừng và chạy lại trò chơi. Nhập cùng mật khẩu vào ô Password trên iPhone trước khi kết nối. Mặc định để trống và không cần mật khẩu. Để xóa, để trống thiết lập trên máy chủ, chạy lại trò chơi và xóa ô mật khẩu trên ứng dụng khách. Cần nhập lại mật khẩu sau khi mở lại ứng dụng. Kết nối và mật khẩu không được mã hóa; chỉ sử dụng mạng LAN đáng tin cậy.

Có thể tải addon từ cửa hàng chính thức của Godot không?

Godot Asset Store — SHINRIYO Remote Server for Godot 4. Đã công bố ngày 28 tháng 10 năm 2026: phiên bản 4.0.0-dev được đánh dấu Unstable, với phiên bản Godot tối thiểu và tối đa đều là 4.7.2. README và tên hiển thị của plugin đã được thống nhất. Đây là addon phía trò chơi; trạng thái phát hành ứng dụng iPhone được nêu riêng.

Không thấy plugin trong Godot

Kiểm tra tệp addons/godot_remote/plugin.cfg trong dự án game. Tránh lồng thư mục hai lần hoặc cài nhầm addon Godot 3 cũ.

Không thấy game trên iPhone

Bật plugin và chạy lại game. Kiểm tra quyền Mạng cục bộ và kết nối LAN. Wi-Fi dành cho khách có thể chặn liên lạc giữa các thiết bị. Tự động tìm kiếm hiện hỗ trợ máy chủ Mac và ứng dụng iPhone.

Thấy game nhưng không kết nối được

Kiểm tra mật khẩu, lỗi trên Mac và quyền truy cập của Godot qua tường lửa. Nếu thao tác cấp quyền làm hết thời gian chờ, hãy nhấn Connect lần nữa.

Có thể nhập địa chỉ thủ công không?

Nhập IP trong mạng LAN của Mac và cổng (mặc định 22766). Không nhập 127.0.0.1 trên iPhone vì địa chỉ đó trỏ đến chính iPhone.

Mac báo cannot listen

Có thể game khác đang dùng cùng cổng. Khi chạy nhiều game, đặt giá trị godot_remote/server/port khác nhau.

Cập nhật hoặc gỡ addon thế nào?

Dừng game, thay thư mục addon bằng phiên bản mới rồi chạy lại. Không có cập nhật tự động. Khi gỡ, tắt plugin trước rồi mới xóa thư mục.

Mã nguồn miễn phí và bản trả phí hỗ trợ phát triển

Mã nguồn và addon Mac được công khai miễn phí theo giấy phép MIT. Chúng tôi đang chuẩn bị bản App Store mua một lần, không cần tự dựng hoặc ký ứng dụng. Doanh thu hỗ trợ việc phát triển và bảo trì ứng dụng này, không phải khoản quyên góp cho Godot Engine hay tác giả gốc.

Liên hệ & Báo lỗi

Liên hệ qua GitHub Issues

Cần tài khoản GitHub. Vui lòng cung cấp phiên bản Godot, mẫu iPhone và phiên bản iOS, phiên bản ứng dụng, các bước tái hiện và thông báo lỗi.

Issues được công khai. Không đăng mật khẩu, thông tin ký ứng dụng, thông tin cá nhân hoặc tài nguyên game chưa công bố.