EasyMultiplayer

Godot 4.x C# 局域网多人游戏插件。提供房间管理、UDP 广播发现、ENet 传输、断线重连、心跳检测、优雅退出等开箱即用的功能。

功能

• 房间管理 — Host 创建房间并广播，Client 自动发现并加入
• UDP 广播发现 — 局域网内自动发现房间，无需手动输入 IP
• ENet 传输层 — 基于 Godot 内置 ENet，可靠/不可靠消息均支持
• 心跳检测 — 定期 Ping/Pong，自动检测对端存活状态
• 断线重连 — 网络抖动时自动重连，Host 端保留重连窗口
• 优雅退出 — 主动退出前发送通知，对端可区分主动退出与意外断线
• 版本校验 — 连接时自动交换版本号，版本不匹配自动踢出
• 消息通道 — 逻辑通道隔离，支持发送速率限制

要求

• Godot 4.x（.NET / C# 版本）
• .NET 8+

安装

1. 将 addons/EasyMultiplayer/ 目录复制到你的项目 addons/ 下
2. 在 Godot 编辑器中启用插件：项目 → 项目设置 → 插件 → EasyMultiplayer → 启用
3. 将 EasyMultiplayer 节点（addons/EasyMultiplayer/Core/EasyMultiplayer.cs）添加为 Autoload： 项目 → 项目设置 → Autoload，路径填 res://addons/EasyMultiplayer/Core/EasyMultiplayer.cs，名称填 Net

快速开始

// 获取单例
var net = GetNode<EasyMultiplayer.Core.EasyMultiplayer>("/root/Net");
net.GameVersion = "1.0.0";

// 监听信号
net.ConnectionSucceeded += () => GD.Print("连接成功");
net.PeerJoined += (id) => GD.Print($"玩家加入: {id}");
net.PeerLeft += (id) => GD.Print($"玩家离开: {id}");

// 创建房间（Host）
net.CreateRoom("我的房间", "MyGame");

// 发现并加入房间（Client）
net.Discovery.RoomFound += (room) =>
{
    GD.Print($"发现房间: {room.Info.HostName} @ {room.HostIp}:{room.Info.Port}");
    net.JoinRoom(room.HostIp, room.Info.Port);
};
net.RoomClient.StartSearching();

// 发送消息
net.SendMessage(peerId, "chat", "Hello!");
net.BroadcastMessage("game_state", data);

// 优雅退出
net.GracefulDisconnect("quit");

API 概要

EasyMultiplayer（主入口）

信号

EasyMultiplayerConfig（可配置参数）

目录结构

addons/EasyMultiplayer/
├── Core/
│   ├── EasyMultiplayer.cs       # 主入口 Autoload 单例
│   ├── EasyMultiplayerConfig.cs # 配置资源
│   ├── ConnectionState.cs       # 连接状态枚举
│   └── MessageChannel.cs        # 消息通道
├── Discovery/
│   ├── IDiscovery.cs            # 发现层接口
│   └── UdpBroadcastDiscovery.cs # UDP 广播实现
├── Heartbeat/
│   └── HeartbeatManager.cs      # 心跳管理器
├── Room/
│   ├── RoomHost.cs              # 房间主机
│   ├── RoomClient.cs            # 房间客户端
│   └── RoomState.cs             # 房间状态
├── Transport/
│   ├── ITransport.cs            # 传输层接口
│   └── ENetTransport.cs         # ENet 传输实现
└── EasyMultiplayerPlugin.cs     # 编辑器插件入口

License

MIT License. See LICENSE.