SuperAPI AI 工具集

godot-multiplayer

编程与开发

查看项目

更新于 10-15 21:49

技能介绍

用途:为 Godot 4.7 游戏加入网络多人功能,包括通过 ENet 主持或加入房间、调用 RPC、按节点分配权限,以及跨端自动生成与同步节点。不适用于本地分屏、底层 TCP/UDP/WebSocket 协议或 HTTP 请求;存档持久化应使用 save-systems。

主要能力:创建 ENetMultiplayerPeer 并调用 create_server(port, max) 或 create_client(ip, port),赋值给 multiplayer.multiplayer_peer;服务器 ID 恒为 1,客户端获得随机正整数 ID。监听 multiplayer 的 peer_connected(id)、peer_disconnected(id)、connected_to_server、connection_failed、server_disconnected 信号。用 @rpc(...) 定义 RPC,通过 Callable 的 rpc() 广播或 rpc_id(peer_id) 单发,内部用 multiplayer.get_remote_sender_id() 获取发送者。用 set_multiplayer_authority(id) 分配节点权限,用 is_multiplayer_authority() 限制输入与 RPC。用 MultiplayerSpawner 自动实例化场景、MultiplayerSynchronizer 同步指定属性,并可通过 set_visibility_for 控制可见范围。

使用方式:先建立 peer 并赋值,再连接信号;RPC 方法需在所有运行该脚本的端保持相同声明,Godot 会校验脚本内全部 @rpc 方法的校验和,不匹配会静默出错。默认 @rpc 为 authority,客户端调用会被忽略,需设 any_peer;用 call_local 让同时是玩家的主机也执行。节点路径需跨端一致,建议用 MultiplayerSpawner 或 add_child(node, true) 生成同名节点。断开时设 multiplayer.multiplayer_peer = OfflineMultiplayerPeer.new()。

限制与注意:始终把客户端输入视为不可信,服务器保持权威,只接收意图并在服务端校验后再广播结果;不要让客户端直接设置生命值、位置、命中判定等权威状态。@rpc 方法必须位于 Node 派生类,不能放在普通 Resource/RefCounted 上;RPC 不序列化 Object/Callable,只能传整数、字符串、数组、字典、PackedArray 等普通数据。Android 导出预设需添加 INTERNET 权限,否则网络被阻断。更多 MultiplayerSpawner 配置、传输模式/通道、SceneMultiplayer 认证、大厅骨架与专用服务器导出说明见 references/replication-and-rpc.md。相关技能:godot-nodes-scenes、godot-signals-groups、godot-export。