← Blog

Game Godot nhiều người chơi mà không cần tự chạy máy chủ game

· Hibira

Chúng tôi làm add-on Hibira bằng GDScript thuần cho Godot 4: phòng, trò chuyện và đồng bộ vị trí người chơi, chạy được cả khi xuất ra web. Vì sao chúng tôi làm, cách nó hoạt động, và bản demo chạy được trong năm phút.

Một hôm, có người trong nhóm hỏi: "Godot có hỗ trợ giao thức Pusher không?"

Câu trả lời là không. Godot 4 có sẵn WebSocket và cả một bộ API nhiều người chơi cấp cao, nhưng cả hai đều mặc định bạn tự chạy máy chủ game, hoặc để một người chơi làm chủ phòng. Với nhiều nhóm nhỏ, đây chính là chỗ chế độ nhiều người chơi bị tắc: game đã làm xong, nhưng giờ phải học cách dựng máy chủ, mở cổng, xử lý NAT, rồi còn trả tiền hằng tháng cho một cái máy mà không biết sẽ có bao nhiêu người chơi.

Chúng tôi muốn một cách khác: trong game chỉ đặt một client, kết nối tới một dịch vụ thời gian thực được vận hành sẵn, và để dịch vụ đó chuyển tiếp phòng, danh sách người đang online và tin nhắn giữa người chơi. Vì vậy chúng tôi làm add-on Hibira cho Godot. Nó viết hoàn toàn bằng GDScript, không cần phần mở rộng native, nên chạy được trên mọi nền tảng Godot xuất ra được, kể cả web.

Cùng một phòng: bên trái là người chơi trên Godot, bên phải là người chơi trên trình duyệt.
Cùng một phòng: bên trái là người chơi trên Godot, bên phải là người chơi trên trình duyệt.

Game nhiều người chơi quy mô nhỏ thực sự cần gì

Không phải game nhiều người chơi nào cũng là game bắn súng. Khi nhìn các game indie và tác phẩm game jam quanh mình, phần nhiều người chơi chủ yếu là những thứ sau:

  • Sảnh và phòng: tạo phòng, nhận mã, gửi cho bạn bè, chờ mọi người bấm "Sẵn sàng".
  • Ai đang online: trong phòng có ai, ai vừa vào, ai đã rời, ai là chủ phòng.
  • Trò chuyện: kể cả dòng "người kia đang nhập…".
  • Đồng bộ nhẹ: vị trí của mọi người trong game hợp tác, ai bấm trước trong game party, nước đi tiếp theo trong game theo lượt.

Điểm chung là tin nhắn đều nhỏ, và tốc độ cần có là "nhanh theo cảm nhận của con người", chứ không phải nhanh tới từng mili giây như game bắn súng. Những việc này hợp với một kết nối WebSocket cùng mô hình "kênh", đúng thế mạnh của giao thức Pusher.

Vì sao chọn giao thức Pusher

Giao thức Pusher đã được dùng hơn mười năm và mô hình rất đơn giản: client đăng ký kênh, máy chủ hoặc client khác gửi sự kiện vào kênh đó. Với game, phần hữu ích là kênh presence:

  • Backend của bạn ký mỗi lượt đăng ký, nên bạn quyết định ai được vào phòng nào.
  • Kênh cho mọi người biết danh sách thành viên hiện tại, ai vào và ai ra.
  • Người chơi có thể gửi client event trực tiếp cho nhau, và máy chủ gắn user_id của người gửi vào từng sự kiện.

Điểm cuối là quan trọng nhất. user_id do máy chủ gắn chứ không phải client tự điền, nên khi nhận được "người chơi A đã di chuyển tới đây", bạn biết chắc nó đến từ người chơi A. Phần đồng bộ vị trí bên dưới được xây trên chính bảo đảm này.

Một lợi ích khác: cùng giao thức thì web và game nói chuyện được với nhau. SDK sảnh chờ cho web của chúng tôi, @hibira-io/lobby, dùng cùng bộ sự kiện, nên người chơi Godot và người chơi trình duyệt có thể ngồi chung một phòng như ảnh ở trên.

Cách hoạt động

Game GodotHibiraClient
yêu cầu ký
Backend của bạnký kênh presence bằng app secret
Game GodotHibiraClient
WebSocket
Hibiraphòng, danh sách thành viên, chuyển tiếp sự kiện
WebSocket
Người chơi khácGodot hoặc trình duyệt
Game chỉ kết nối tới Hibira; backend của bạn chỉ lo việc ký

Add-on có bốn phần chính:

  • HibiraClient: client giao thức Pusher v7 xây trên WebSocketPeer có sẵn của Godot. Nó lo kết nối, đăng ký, ping/pong, tự kết nối lại và đăng ký lại sau khi rớt mạng.
  • HibiraChannel: một kênh. bind() để nghe sự kiện, trigger() để gửi client event, và kênh presence có thêm danh sách thành viên cùng các signal khi có người vào hoặc ra.
  • HibiraRoom: biến kênh presence thành phòng chơi với chỗ ngồi, chủ phòng, trạng thái sẵn sàng, cài đặt phòng, đuổi người chơi, bắt đầu game, cùng trò chuyện có hiển thị đang nhập.
  • HibiraSync: node mới trong 0.2.0. Đặt nó dưới một nhân vật, vị trí của nhân vật sẽ hiện trên màn hình của mọi người chơi khác.

App secret không bao giờ nằm trong game. Ai cũng có thể giải nén một game đã xuất, nên việc ký phải diễn ra trên backend của bạn, y hệt như với pusher-js hay Laravel Echo. Nếu bạn đã có bản web, endpoint xác thực hiện có dùng được ngay.

HibiraSync: gắn vào là đồng bộ

Nhu cầu phổ biến nhất trong game hợp tác là "cho người khác thấy tôi đang ở đâu". Chúng tôi muốn việc đó chỉ cần một node. Trong player.tscn, thêm một HibiraSync dưới CharacterBody2D, đặt tên kênh là presence-match-1 và các thuộc tính cần đồng bộ là position và rotation, rồi tạo từng người chơi như sau:

func spawn(user_id: String) -> void:
	var p := PLAYER.instantiate()
	p.name = user_id
	p.get_node("HibiraSync").owner_id = user_id # ai điều khiển nó
	add_child(p)

Phía sau có vài việc diễn ra:

  • Chỉ chủ sở hữu mới di chuyển được. Mỗi node có một owner_id. Giá trị đến từ người khác sẽ bị bỏ qua, điều làm được nhờ máy chủ gắn user_id.
  • Cả cảnh là một tin nhắn. Mọi node được đồng bộ trên cùng một kênh được gộp thành một client event mỗi tick, mặc định 8 lần mỗi giây. Hibira giới hạn client event ở 10 lần mỗi giây cho mỗi kết nối, nên dù cảnh đồng bộ bao nhiêu node cũng không vượt giới hạn.
  • Chỉ gửi giá trị thay đổi. Nhân vật đứng yên thì không gửi gì; khi có người mới vào phòng, mọi giá trị được gửi lại cho họ.
  • Giá trị nhận được di chuyển mượt mà. Áp dụng thẳng 8 lần cập nhật mỗi giây sẽ khiến nhân vật giật cục. Vì vậy giá trị nhận được trở thành mục tiêu, và nhân vật tiến lại gần một chút mỗi khung hình, có nội suy phù hợp cho góc và quaternion.
Game của người chơi AHibiraGame của người chơi Bclient-hibira-sync{"s": {"A/Player": {"position": [...]}}}cùng sự kiện đókèm user_id: "A"Người chơi B kiểm tra user_id là chủ sở hữu node, rồi mới cho nhân vật di chuyển mượt tới vị trí mới
Những gì diễn ra trong một tick
Playground: hai cửa sổ trình duyệt trong cùng một phòng, mỗi bên điều khiển một chấm, và chấm của bên kia đuổi theo một cách mượt mà.

Cần nói rõ: HibiraSync hợp với game party, game hợp tác và board game, những game "chơi giữa bạn bè". Mỗi người chơi toàn quyền điều khiển nhân vật của mình. Đây không phải netcode do máy chủ quyết định, nên game đối kháng cần chống gian lận vẫn phải để máy chủ phân xử.

Bắt đầu trong năm phút

  1. Tải addons/hibira từ GitHub, đặt vào thư mục addons/ của dự án, rồi bật Hibira Realtime trong Project → Project Settings → Plugins.
  2. Mở addons/hibira/demo/playground.tscn và nhấn F6. Không cần cài đặt gì, nó kết nối tới app demo công khai của chúng tôi và tạo một phòng có mã bốn chữ cái.
  3. Trong Debug → Customize Run Instances, đặt số instance là 2 rồi chạy lại để thấy hai chấm di chuyển trong cùng một phòng.

Muốn thử ngay trên trình duyệt, hãy mở playground trực tuyến: đó chính là cảnh này được xuất cho web. Gửi cho bạn bè đường link kèm mã phòng, họ sẽ vào cùng phòng với bạn. Mỗi cửa sổ playground là một người chơi mới. Trong game của bạn, hai cửa sổ đăng nhập cùng một người dùng chỉ tính là một thành viên của phòng, nên hãy thử bằng hai tài khoản, ví dụ trên một trình duyệt khác hoặc cửa sổ ẩn danh.

Khi dùng app của riêng bạn, trước tiên hãy thiết lập trong trang quản lý Hibira: sao chép key ở Overview → Credentials của app (secret chỉ hiện một lần khi tạo app và chỉ nằm ở backend của bạn), bật Settings → Allow client events, và nếu xuất ra web thì thêm origin của trang, chẳng hạn https://yourname.itch.io, vào Settings → Allowed origins. Gói miễn phí không nhận *, và nếu thiếu origin thì trình duyệt không kết nối được. Endpoint xác thực ký kênh presence- như mọi backend tương thích Pusher; với Node, authorizeRoom() của @hibira-io/lobby làm sẵn việc đó.

Sau đó điền app key và endpoint xác thực vào mục Hibira trong Project Settings. Add-on thêm một autoload tên Hibira, tự kết nối khi game khởi động, và script nào cũng dùng được:

func _ready() -> void:
	var lobby := HibiraRoom.join(Hibira, "presence-room-ABCD", {"capacity": 4})
	lobby.message_received.connect(func(m): print(m.info.name, ": ", m.text))
	lobby.started.connect(func(data, _by): start_game(data))

Một ví dụ hoàn chỉnh: game phản xạ

Để chắc rằng các mảnh ghép thật sự tạo thành một game, chúng tôi làm một game phản xạ cho bốn người: danh sách phòng, bốn chỗ ngồi, chủ phòng, sẵn sàng, đuổi người chơi, trò chuyện trong phòng và năm vòng "thấy GO! thì bấm trước".

Danh sách phòng: tạo phòng, hoặc vào phòng của bạn bè bằng mã.
Danh sách phòng: tạo phòng, hoặc vào phòng của bạn bè bằng mã.
Trong game: khi chủ phòng bắt đầu, mỗi lần chạm là một client event trên kênh của phòng.
Trong game: khi chủ phòng bắt đầu, mỗi lần chạm là một client event trên kênh của phòng.

Game dùng cùng bộ sự kiện với ví dụ sảnh chờ trên web của chúng tôi, nên người chơi Godot và người chơi trình duyệt có thể chơi cùng nhau. Toàn bộ mã nguồn ở examples/godot-lobby.

Chi phí và giới hạn

  • Mỗi client event tính là một tin nhắn, dù bao nhiêu người nhận. Bốn người chơi năm vòng chỉ tốn vài chục tin nhắn. Gói miễn phí có 200.000 tin nhắn mỗi ngày, quá đủ cho bản mẫu và thử nghiệm nhỏ.
  • HibiraSync mặc định gửi tối đa 8 tin mỗi giây (chỉnh được trong Project Settings, tối đa 10), và chỉ gửi khi có thay đổi. Bốn người liên tục di chuyển dùng tối đa khoảng 110.000 tin nhắn mỗi giờ; lúc đứng yên thì không tính.
  • Ở gói miễn phí, dữ liệu của một sự kiện tối đa 4 KB (gói trả phí lớn hơn). HibiraSync chia các lô nhỏ hơn mức đó; hãy giữ các giá trị đơn lẻ, như một chuỗi dài, ở kích thước nhỏ.
  • Kênh presence chứa tối đa 100 thành viên, đủ cho các phòng. Với không gian lớn hơn, như một sảnh chờ hàng nghìn người, hãy dùng kênh thường kết hợp với phát sóng từ máy chủ.

Tiếp theo

Add-on đã có trên GitHub, và chúng tôi đã gửi lên Godot Asset Library. Tiếp theo, chúng tôi muốn thêm kênh mã hóa đầu cuối và đăng nhập người dùng (pusher:signin).

Nếu bạn đang làm game nhiều người chơi bằng Godot, hãy thử xem. Chúng tôi rất muốn nghe game của bạn cần gì.