KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #developer-tools #cli #codex #claude-code #react #dsh-plugin #mcp #open-source #dsh #deepseek-harness

Fink-Framework

★ 90 Open GitHub ↗

Fink Framework是由Fink个人开发的供unity使用的轻量游戏框架。该框架提供了完整数据管线、对象池、事件系统、资源加载系统等诸多常用功能。

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">Fink-Framework</h1>
<p align="center">Fink Framework unity游戏框架</p>

<a href="https://github.com/finkkk/Fink-Framework/stargazers">
    <img src="https://img.shields.io/github/stars/finkkk/Fink-Framework?style=flat-square">
  </a>

<a href="https://github.com/finkkk/Fink-Framework/releases">
    <img src="https://img.shields.io/github/v/release/finkkk/Fink-Framework?label=Release&style=flat-square">
  </a>

<img src="https://img.shields.io/github/license/finkkk/Fink-Framework?style=flat-square&cacheSeconds=0">

</p>

---

# Fink Framework

**Fink Framework** 是一套面向 Unity 中小型游戏项目的 **模块化开发框架**。  
框架来源于长期的项目实践积累，涵盖 **数据驱动管线、UI 系统、资源加载、对象池、运行时工具链、调试可视化** 等核心能力，旨在为 Unity 项目提供 **稳定、高效、可维护** 的基础设施。

框架完全开源，可直接集成至任意 Unity 项目中。

---

# 文档地址（Documentation）

框架详细使用教程请查阅文档：
<p align="center">
  <a href="https://finkkk.cn/docs/fink-framework" target="_blank">
    📘查看完整文档
  </a>
</p>

---

## 1. 核心特性

### • 数据管线系统
支持 Excel → 自动生成 C# 数据类 → JSON → 加密二进制的完整流程。  
包含类型校验、字段 QA 检查、模板自动生成、灵活的解析逻辑与自定义 Converter 扩展机制。

### • UI 管理与多画布体系
内置多层级 Main UI、WorldSpace UI、VR HUD。  
支持异步加载、生命周期钩子、逻辑与表现分离、自动事件绑定等。

### • 资源加载系统
提供统一的同步/异步接口、内存缓存策略。  
采用provider插件前缀形式加载，支持 Resources、Editor、file、ab包、http(s)、和addressables等方式。

### • 可配置对象池系统
自动注册、预加载、复用上限、自动清理，并带有调试可视化布局。

### • 轻量事件系统
无任何额外依赖，适合中小规模系统的事件分发与监听。

### • 全局计时器管理
支持多计时器、间隔回调、受/不受 timeScale、对象池复用、唯一 ID 管理等。

### • 运行时工具链
包含输入管理、日志系统、数学工具、字符串处理、JSON 纠错与清洗、Gizmos 可视化调试等。

### • 场景管理与模块化工具链
提供场景切换器、Gizmos 调试器、自动单例（普通 + Mono）、编辑器扩展工具等。

整体框架结构清晰、模块解耦，可在项目初期作为稳定基础设施使用，也可在中后期根据需求灵活裁剪。

---

## 2. 下载与开源地址

**GitHub 源代码（主下载渠道）：**  
https://github.com/finkkk/Fink-Framework

其他下载镜像（可选）：

- **百度网盘（提取码 2333）：**  
 [点击下载](https://pan.baidu.com/s/1obZYHwBI4ZVnavCiCPE8BA?pwd=2333)

你可以在 GitHub Releases 中获取最新的 `unitypackage`，或通过上述镜像直接下载。

---

## 3. 联系方式

如需交流、反馈或合作，欢迎联系：

- **QQ：** 2217183968  
- **微信：** FLX2217183968  
- **博客：** https://finkkk.cn  
- **GitHub：** https://github.com/finkkk

你也可以在仓库 Issue 区或文章底部留言。

---

## 4. 框架信息

截止v0.3.0版本，本框架的代码量已经达到约15万行，功能丰富按需启用。

但目前仍不支持Unity 2021以前的版本，后续会持续向最新版兼容，但暂不考虑兼容旧版。

---

## 5. 致谢（Acknowledgements）

感谢以下项目与作者在本框架开发中提供的支持与启发：

* [**唐老狮 Unity 程序基础小框架课程**](https://www.yxtown.com/goods/show/32`)
  为整体架构设计、模块划分等核心思路提供了重要启发。
* [**Json.NET Converters（Wanzyee Studio）**](https://assetstore.unity.com/packages/tools/input-management/json-net-converters-simple-compatible-solution-58621)
  在 JSON 转换器体系和扩展思路方面给予了参考。
* [**Odin Serializer（MIT）**](https://github.com/TeamSirenix/odin-serializer)
  作为框架内置的开源序列化系统，为数据处理提供了强大支持。
* [**Cysharp/UniTask（MIT）**](https://github.com/Cysharp/UniTask)
  作为框架异步的重要基础，优化了资源加载、任务调度以及 Unity 中的异步管理等流程。
* [**ExcelDataReader（MIT）**](https://github.com/ExcelDataReader/ExcelDataReader)
  为框架的数据管线提供了可靠的 Excel 解析能力，使自动化配表流程得以顺畅实施。
* [**Newtonsoft.Json（MIT）**](https://github.com/JamesNK/Newtonsoft.Json)
  为框架中的 JSON 处理、配置导入、调试输出与数据透视提供了核心支持。
* **所有在社区中分享 Unity 技术与开源库的开发者们**
  你们的知识分享让本框架得以在更扎实的基础上构建与成长。

Fink-Framework

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README