基于ET6框架的Unity C#双端(客户端+服务端)游戏框架,采用HybridCLR实现热更新,YooAssets实现资源热更新,提供了完整的AOI、战斗、UI、对话等框架。
基于ET6框架的Unity C#双端(客户端+服务端)游戏框架,采用HybridCLR实现热更新,YooAssets实现资源热更新,提供了完整的AOI、战斗、UI、对话等框架。
基于ET6框架的Unity C#双端(客户端+服务端)游戏框架,使用HybridCLR实现热更新,YooAssets实现资源热更新,提供了完整的AOI、战斗、UI、对话等框架。
| 技术 | 版本 | 说明 |
|---|---|---|
| Unity | 2020.3.48f1c1 | 使用C# 8语法 |
| .NET | 6.0 | 服务端运行时 |
| HybridCLR | 修改版(支持DLL reload) | C#热更新 |
| YooAssets | 1.2.4 | 资源热更新 |
| KCP | - | 网络传输层 |
| protobuf-net | - | 消息序列化 |
| MongoDB Bson | - | 数据序列化 |
| NLog | - | 服务端日志 |
| DOTween | 1.2.705 | 动画补间 |
| SuperScrollView | - | 无限滑动列表 |
| URP | 10.10.1 | 通用渲染管线 |
| TextMeshPro | 3.0.6 | UI文字渲染 |
…Client-Server.sln 包含以下工程分组:
| 工程 | 说明 |
|---|---|
| Unity.Model | 客户端Model层(数据定义,不依赖Unity引擎) |
| Unity.Hotfix | 客户端Hotfix层(逻辑实现,不依赖Unity引擎,可热更) |
| Unity.ModelView | 客户端ModelView层(数据定义,依赖Unity引擎) |
| Unity.HotfixView | 客户端HotfixView层(逻辑实现,依赖Unity引擎,可热更) |
| Unity.Mono | 非热更的Unity层(CodeLoader入口、原生模块) |
| Unity.ThirdParty | 第三方库(ETTask、LitJson、Mongo、protobuf-net、SuperScrollView) |
| Unity.Editor | 编辑器扩展 |
| Unity.Codes | 热更新代码集合(编译为单一DLL供HybridCLR加载) |
| YooAsset / YooAsset.Editor | YooAsset资源管理 |
| HybridCLR.Runtime / HybridCLR.Editor | HybridCLR热更新 |
| Unity.RenderPipelines.Universal.* | URP渲染管线 |
| Unity.TextMeshPro | 文字渲染 |
| 工程 | 说明 |
|---|---|
| Server.App | 服务端启动入口 |
| Server.Model | 服务端数据层 |
| Server.Hotfix | 服务端逻辑层(可热更) |
| 工程 | 说明 |
|---|---|
| Robot.App | 机器人启动入口 |
| Robot.Model | 机器人数据层 |
| Robot.Hotfix | 机器人逻辑层 |
| 工程 | 说明 |
|---|---|
| UnityEngine | UnityEngine接口定义(供服务端/机器人引用) |
| ShareLib | 共享代码库 |
| ETTask | ET异步框架 |
| 工程 | 说明 |
|---|---|
| Tools.App | 导表工具(ExcelExporter)、导协议工具(Proto2CS) |
| FileServer | CDN文件服务器 |
| Analyzer | 代码分析器(Roslyn Source Generator,用于自动注册) |
基于ET组件模式的UI框架,位于 Unity/Codes/Model/Module/UIManager 和 Unity/Codes/Hotfix/Module/UIManager。
双端AOI(Area of Interest)系统,位于 Unity/Codes/Model/Module/AOI(客户端)和 Server/Model/Module/AOI(服务端)。
AOITrigger:触发器基类OBBComponent:OBB(有向包围盒)碰撞检测完整的Skill + Buff战斗系统,位于 Unity/Codes/Model/Module/Battle,双端共用。
位于 Unity/Codes/ModelView/Module/Battle/SpellPreviewManagers:
服务端跨逻辑地图战斗Ghost系统,位于 Server/Model/Module/AOI/Ghost。
基于YooAssets的资源管理系统,位于 Unity/Codes/ModelView/Module/Resource 和 Unity/Assets/Mono/Module/YooAssets。
GalGame对话引擎,位于 Unity/Codes/ModelView/Demo/GalGame 和 Unity/Codes/HotfixView/Demo/GalGame。
Excel/[email protected]Excel/[email protected]Unity/Assets/Mono/Module/I18NExcel/[email protected]Excel/[email protected]、Excel/[email protected]Config/Recast/Tools/RecastNavExportor/克隆仓库
git clone 打开Unity项目
File → Open Project → Open,选中 Unity/ 文件夹编译客户端代码
Tools → BuildCode编译全量工程
Client-Server.sln导出配置表
cd Bin
dotnet Tools.dll --AppType=ExcelExporter导出协议
cd Bin
dotnet Tools.dll --AppType=Proto2CS启动服务端
cd Bin
dotnet Server.dll --Process=1 --Console=1或直接运行:
startwinserver.bat运行客户端
Scenes/Init 场景Excel/ 目录修改对应表格,重新导表并重启服务端运行 copyGame.bat,输入序号,会在同级目录创建带Junction链接的Unity副本,支持多开测试。
位于 Excel/ 目录,文件命名规则:
| 后缀 | 说明 | 示例 |
|---|---|---|
@cs |
客户端+服务端共享 | [email protected] |
@c |
仅客户端 | [email protected] |
@s |
仅服务端 | [email protected] |
@m |
地图配置 | [email protected] |
@i |
多语言 | [email protected] |
| 配置表 | 说明 |
|---|---|
| AIConfig | AI行为配置 |
| AttributeConfig | 属性配置 |
| BuffActionControlConfig | Buff行为控制配置 |
| BuffAttrConfig | Buff属性修改配置 |
| BuffBleedConfig | Buff流血配置 |
| BuffChantConfig | Buff吟唱配置 |
| BuffConfig | Buff主配置 |
| EffectConfig | 特效配置 |
| FormulaConfig | 公式配置 |
| GuidanceConfig | 引导配置 |
| I18NConfig | 多语言配置 |
| Map1AreaConfig / Map2AreaConfig | 地图区域配置 |
| MapSceneConfig | 地图场景配置 |
| RedDotConfig | 红点配置 |
| SceneConfig | 场景配置 |
| ServerConfig | 服务器配置 |
| SkillConfig | 技能配置 |
| SkillJudgeConfig | 技能判定配置 |
| SkillStepConfig | 技能步骤配置 |
| UIRouterConfig | UI路由配置 |
| UnitConfig | 单位配置 |
位于 Config/StartConfig/:
| 目录 | 说明 |
|---|---|
| Localhost | 本地开发配置 |
| Release | 发布配置 |
包含:StartMachineConfig(机器配置)、StartProcessConfig(进程配置)、StartSceneConfig(场景配置)、StartZoneConfig(区服配置)
| 命令 | 说明 |
|---|---|
dotnet Tools.dll --AppType=ExcelExporter |
导出全部配置表 |
win_startExcelExport.bat |
导出全部配置表 |
win_startAttrExport.bat |
导出属性配置 |
win_startAreaExport.bat |
导出区域配置 |
win_startI18NExport.bat |
导出多语言配置 |
win_startExportAll.bat |
导出全部 |
协议定义文件位于 Proto/ 目录:
| 文件 | 说明 |
|---|---|
| OuterMessage.proto | 客户端 ↔ 服务端通信协议 |
| InnerMessage.proto | 服务端内部进程间通信协议 |
| MongoMessage.proto | MongoDB存储消息定义 |
导出命令:
cd Bin
dotnet Tools.dll --AppType=Proto2CS或运行 Proto/win_startProtoExport.bat
主要协议:
| 命令 | 说明 |
|---|---|
--AppType=ExcelExporter |
导出配置表(xlsx → bytes) |
--AppType=Proto2CS |
导出协议(proto → C#) |
CDN文件服务器,用于资源热更新分发。
基于Roslyn Source Generator的代码分析器,自动生成系统注册代码,免去手动注册Event/Watcher/System的样板代码。
导航网格导出工具,在Unity编辑器中使用(Unity/Assets/Editor/Common/RecastNavDataExporter)。
# 方式一:Watcher模式(管理所有子进程)
startwinserver.bat
# 方式二:直接启动指定进程
cd Bin
dotnet Server.dll --Process=1 --Console=1# 发布
dotnet publish -r linux-x64 --no-self-contained --no-dependencies -c Release
# 运行
cd Bin
dotnet Server.dll --Process=1 --Console=1或直接运行 publishlinux64.bat
服务端运行时支持DLL热重载,通过控制台命令:
reloaddll # 重载热更新DLL
reloadconfig # 重载配置CodeLoader支持的加载模式:
| 模式 | 说明 |
|---|---|
| BuildIn | 使用内置AOT代码 |
| LoadDll | 从资源包加载热更DLL |
| Wolong | HybridCLR模式(加载DLL + AOT元数据补充) |
| LoadFromUrl | 从URL下载DLL(调试用) |
| Reload | 热重载模式(编辑器内热重载) |
| 类型 | 说明 | 参数 |
|---|---|---|
| Wait |
暂无开放 Issues,或尚未同步最近议题。