运行步骤

May 24, 2026 · View on GitHub

  1. IDE安装

    使用Rider2024.3(更新到最新版),需要安装以下内容:

    • windows上用visual studio安装最新的.Net8, mac请用homebrew安装.Net8跟powershell 7,注意不是windows自带的powershell
    • 不支持VS,新人用VS搞出各种问题请不要来问我,我也没用过VS,后期搞熟了可以自己改用VS
  2. 该分支必须使用Unity2022.3.62(初学者请在此版本用熟后再切换其他版本)

  3. 整个过程请开启全局翻墙,否则各种unity包 nuget包下载不下来,报memerypack等错误

  4. 注意一定要clone一个新的工程!clone一个新的工程!clone一个新的工程!重要的事情说三遍!!!

  5. 在项目根目录执行 pwsh ./Scripts/Initialize-Project.ps1 这样会完成初始化

  6. 启动UnityHub,打开(Open) -> 选中'ET'文件夹所在目录后打开工程

  7. 打开工程后,点击Unity菜单 -> Edit -> Preferences -> External Tools,点击下拉框'External ScriptEditor'选择Rider,Generate .csproj files for要勾选前两个

  8. 点击Unity菜单 Assets->Open C# Project,这里由于修改了rider插件,会自动打开ET.sln

  9. 刚clone下来,unity打开可能会有些报错,注意先确保安装了il2cpp。

  10. 编译整个ET.sln, 注意要翻墙,否则可能nuget包下载不下来,导致编译出错(翻墙后如果还有报错解决不了可以尝试先用VS打开ET.sln编译一次后再回到Rider重新编译一次)

  11. Unity中, 然后双击Packages/ET.StateSync/Scenes/Init场景,点击Play(▶)即可运行

  12. 独立启动服务器,右键UnityHub,以管理员身份运行UnityHub,然后启动Unity(没有管理员启动是不行的,因为服务端要开启http服务,普通权限开不了), 停止Unity Play,点开Unity菜单->ET->Loader->Server Tools->Start Server(Single Process),这样就单独启动了服务端。GlobalConfig中把CodeMode改成Client,点击Unity Play,登录。如果还是连接不上报10037错误,注意看ET/Logs目录,看有没有Error日志。 如果要用rider启动服务器,rider也必须用管理员权限启动 注意一定要用 netsh http delete urlacl 命令删除掉所有自己添加的urlacl,具体使用方法请谷歌 客户端注意要打开cn.etetet.loader/Resources/GlobalConfig, 把CodeMode换成Client

  13. 注意独立运行服务器的目录不再是Bin目录,而是Bin的上一层目录,也就是Unity目录,比如 dotnet.exe Bin/ET.App.dll --Console=1。用rider启动默认是在Bin目录,需要自己修改运行目录,去掉Bin

  14. 有问题请问ai解决

打包过程

  1. 点击HybridCLR -> Installer,点击安装,等待安装完成

  2. Unity菜单ET->Excel->ExcelExport导出Excel

  3. Unity菜单ET->WOW->ExportScriptableObject导出 技能 buff ai配置

  4. Unity中按下F6编译,注意,不能用IDE编译Model Hotfix,因为IDE编译的里面会引用UnityEditor,会导致出问题

  5. 点击HybridCLR -> Generate -> All

  6. 点击ET -> HybridCLR -> CopyAotDlls,这一步会把需要补充元数据的dll复制到'Assets/Bundles/AotDlls'目录

  7. 打开YooAsset -> AssetBundle Builder窗口,按照以下步骤操作:

    ①BuildPipeline : 'ScriptableBuildPipeline'

    ②BuildMode : 'IncrementalBuild'

    ③CopyBuildinFileOption : 'ClearAndCopyAll'

    ④点击'Click Build'

  8. ET.YooAssets/Resources YooConfig中 EPlayMode选择'HostPlayMode', 打开File->Build Profiles->点击Build,选择目录为Release

另:请自行研究YooAsset包管理库的使用方式(YooAsset官网)

热重载

  1. 若需要体验此功能,需要在Unity菜单 -> Edit -> Preferences -> General窗口的 'ScriptChangesWhilePlaying' 中 选择 'RecompileAfterFinishedPlaying'
  2. 运行后修改并编译代码,点击Unity菜单 -> ET -> Reload(或按快捷键F7)即可

注意事项:

一、常见出错原因:

  1. 中文目录
  2. Rider或VS没有更新到最新版本
  3. Rider或VS没有安装相关组件
  4. 没安装.Net8
  5. 没编译服务端所有工程
  6. Unity版本不兼容
  7. Win7用户,没有特别设置
  8. 如果打包报错缺少"StreamingAsset",自己在 'ET/Unity/Assets' 下新建一个 StreamingAsset 文件夹即可