{"repo":"HinataYoki/YokiFrame","free":true,"listed":false,"github":"https://github.com/HinataYoki/YokiFrame","clone":"git clone https://github.com/HinataYoki/YokiFrame.git","description":"YokiFrame 是一个 C# 游戏框架 默认提供了 Unity 与 Godot 的引擎支持，提供架构分层、事件系统、状态机、对象池、资源管理、UI 工具和编辑器扩展，帮助开发者构建更清晰的游戏项目。","language":"C#","stars":261,"topics":["architecture","csharp","game-framework","godot","unity","unity-framework","framework","ai","godot-addon"],"license":"MIT","category":"game-templates","readme_excerpt":"YokiFrame 面向 Unity 与 Godot .NET 的跨引擎 C# 游戏框架 --- 📖 简介 YokiFrame 是一套用同一份 C# 业务代码同时支撑 Unity 2022.3+ 与 Godot .NET 的跨引擎游戏框架。它把游戏开发中最常见的基础工作拆成一组可独立组合的 Kit：组织业务服务、传递事件、管理状态、编排流程、加载资源、播放音频、保存数据、处理本地化和搭建 Unity UI。业务规则写在纯 C# Core 中，引擎 API、生命周期与默认后端由各自的宿主 Adapter 提供，因此换引擎不换业务代码。 ✨ 核心特性 - 🚀 跨引擎 - 同一套 C# 业务代码，Unity 与 Godot .NET 通用，宿主差异由 Adapter 隔离 - 🧩 Kit 即插即用 - 每个 Kit 可独立引入、组合或移除，按需取用 - 🛠️ 统一工具链 - Avalonia Workbench 可视化观测、 yoki CLI 脚本化操作、Installer 一键安装 - ⚙️ 可选依赖解耦 - UniTask、YooAsset、DOTween、Luban、Nino 等按需接入，不引入不依赖 - 🧹 零初始化仪式 - 无全局初始化入口，默认后端在第一次真实调用时惰性创建 - 🔍 可观测性 - FileBridge 命令协议与共享内存遥测，为编辑器与 AI 工具提供可靠的诊断通道 --- 📚 目录 - 快速开始 - 核心模块 - 工具链 - 项目结构 - 系统要求 - 文档导航 - 贡献与支持 --- 🚀 快速开始 环境要求 环境 要求 ------ ------ Unity 2022.3 或更高 Godot 4.x .NET（当前开发与验证基线为 4.7，不支持非 .NET Godot） 工具链 Windows / macOS / Linux，构建 Workbench 与 yoki 时需 .NET 10 SDK 业务代码 C# 9.0 兼容语法 安装：Unity 1. 打开 Window Package Manager ，点击 + ，选择 Add package from git URL 。 2. 输入： 3. 等待导入和编译完成。 安装：Godot .NET 从完整 YokiFrame 源码包根目录运行对应脚本，传入 Godot 项目路径： Linux / macOS 使用同目录下的 install-godot.sh 或 install-godot.command 。脚本会构建 Runtime 并打开 Installer 图形界面，在 Installer 中选择 Godot local 、确认 plan 并执行 apply 即可。安装完成后请关闭并重新打开 Godot 项目，让编辑器重新扫描已生成的托管程序集。 💡 提示 ：构建失败时查看 Installer 返回的 dotnet 编译输出；详细说明见 故障排查。 交给 AI 安装 不想手动操作时，直接把本仓库地址（或本地源码包目录）和“安装 YokiFrame”一起交给 AI 即可。AI 会自动完成编译、Runtime 构建、安装计划与结果校验，详细流程见 AI 安装指引。 写一个流程 用一个例子串联起框架最常见的四件事：定义架构、注册服务、发布/订阅事件、编排异步流程。 GameArchitecture.Interface 第一次访问时创建架构并初始化服务。事件订阅由订阅方注销；仍在运行的动作由创建它的业务 owner 调用 Cancel() 。更多生命周期约定见","default_branch":null,"files":null,"tree":[],"storefront":"/r/HinataYoki","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/HinataYoki/YokiFrame/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}