机器翻译正文由机器翻译自项目原始文档（英文），排版经程序统一处理，可能存在偏差，请以原项目仓库为准。
K引擎 SLua | XLua | ILRuntime 框架 = KSFramework
KSFramework是一个整合KEngine、SLua/XLua/ILRuntime 的Unity3D Asset Bundle开发框架，并为程序、美术、策划、运营提供辅助工具集。
ShowCase(商业案例)
展示列表： https://github.com/mr-kelly/KSFramework/wiki
| 仙剑奇侠传4手游 | 天域幻想 | 巴清传 | 少年剑影 | 撞击女神 | 七七捕鱼 |
|---|---|---|---|---|---|
| 命运抉择VR | 我的冒险屋 | Moba游戏 | |||
| 开发中 |
KS框架
热重载是KSFramework的开发重点——在不重启游戏的前提下，重载代码、配置表可立刻看到修改效果，最大限度的提升开发、调试的速度，方便运营阶段热更新。
对于程序人员，可以使用AssetBundle加载与打包、脚本化的UI、配置表代码自动生成、下载更新等基础功能模块，大大减少游戏周边基础功能的工作量；
对于策划人员，使用Excel进行编辑，可以在编辑过程中添加注释、图标、预编译指令，KSFramework会根据配置内容自动生成代码供程序使用。
对于美术人员，只需将项目需要用到资源放到指定目录，将会自动的生成Asset Bundle；程序加载Asset Bundle跟Resources.Load一样方便。
对于运营人员，利用KSFramework的热重载特性，可以针对运营需求，在项目运行过程中配置表、脚本代码在用户无知觉的情况下进行热更新。
快速开始
方式1，下载即用
以下方法任选其一：
-
方法一：把源码git clone到本地（推荐）： https://github.com/mr-kelly/KSFramework.git
-
方法二：在项目页面点击 Clone or download 选择 Download ZIP
方式2，从产品包安装
（这种方式获得的版本非最新版本），您可以从KSFramework Release页面下载最新版本的产品包。
解压后直接用Unity打开KSFramework目录，或直接双击场景KSFramework/Assets/Game.unity。
如遇到无法下载的网络问题, 备选下载站:
- KSFramework Appveyor Artifacts: 包含每次提交的构建结果
- KSFramework OSChina镜像): 国内的镜像Git
Unity3D版本支持
| Unity3D版本 | 支持情况 | 备注 |
|---|---|---|
| Unity 4.X | 支持 | 请使用KEngine |
| Unity 5.x | 支持 | 部分版本的API有差异，建议使用5.3.7及以上版本 |
| Unity 2017 | 支持 | |
| Unity 2018 | 支持 | 2018.2.7f1已测试 |
| Unity 2019 | 支持 | 2019.3.7f1已测试 |
| Unity2020 | 支持 | Unity 2020.1.2f1已测试 |
如果是Unity 4.x建议使用KEngine
解决遇到的问题
下载后，如果运行出错，或者使用其它版本的Unity打开无法运行，尝试以下方法：
-
重新生成Assetbundle，方法如下：点击菜单项 KEngine - AssetBundle - Bulld All
-
删除xLua、SLua、ILRuntime的生成代码，重新生成，不同Unity版本生成出来的代码有差异
-
如果前两步不能解决问题，请上传报错信息到issues。
KSFramework常见问题解答篇：https://mr-kelly.github.io/KSFramework/faq/
如果发现框架中存在的问题或有改进的地方，欢迎把你的修改pull request到仓库中，或提issues。
教程和文档
- 常见问题解答：https://mr-kelly.github.io/KSFramework/faq/
- 查看完整文档
- 功能特性
- 策划指南：配置表的使用
- KSFramework: Unity3D开发辅助框架快速入门
- KEngine策划指南: 配置表格的编辑与编译
- KEngine: 资源的打包、加载、调试监控
- KSFramework常见问题：Lua脚本热重载，内存状态数据会不会丢失？
- KSFramework常见问题：Excel如何进行SVN协作、差异比较？
结构组成
涉及第三方库
- xLua 是一个针对 C#（Unity、.Net、Mono）的 Lua 编程解决方案，它支持 Android、iOS、Windows、Linux、OSX 等。，master 分支已默认使用 xLua
- SLua:基于Unity的Lua引擎，也可用于C#独立程序 在slua分支
- ILRuntime项目为基于C#的平台（例如Unity）提供了一个纯C#实现，快速、方便且可靠的IL运行时，使得能够在不支持JIT的硬件环境（如iOS）能够实现代码的热更新 ,在ILRuntime分支
- KEngine:AssetBundle打包加载框架 (作者自己开发的)
- TableML:表格标记语言，运行时与编译器 (作者自己开发的)
- 本文标题：KSFramework - QQ 群：538722494
- 本文链接：https://www.cn121.com/gameengine/mr-kelly-ksframework.html
- 原项目：mr-kelly/KSFramework 版权归原作者 mr-kelly 及贡献者所有
- 收录信息：本站于 2026-10-05 收录本项目，本页所列协议与仓库指标均为收录当时的状态；该日期之后原项目的版本更新与协议变更，本页不作同步。
- 开源协议：收录时本项目采用 Apache-2.0（查看 LICENSE 原文），本站译文为其衍生内容；使用、修改、分发请以该仓库 LICENSE 原文为准。本站对原文仅作排版与图片地址适配, 并保留原项目的 NOTICE 与署名要求。
- 站点出处：本文首发于 OneTwoOne，收录自 GitHub 开源项目 mr-kelly/KSFramework。
- 翻译说明：本页正文为人工智能生成内容——由机器翻译对原项目 README 初译、经程序校验排版，可能存在错漏，请以原项目文档为准。
- 引用声明：商业转载、第三方聚合或 AI 检索训练引用时，请务必保留以上来源出处、本文永久链接，以及原项目的版权声明与许可信息。
- 下架通道：若原项目此后变更或收紧了许可协议、或作者／权利人认为本站的收录方式（译文、排版适配、简介翻译等）超出其授权范围，请通过 xyd3302001@163.com 发送下架通知，并附上项目地址与本页链接。本站核实后将第一时间删除本页内容，或改为不复制原文的目录性收录；署名更正等其他要求可一并提出。