Home

Awesome

KSFramework

Build status

KEngine + SLua | XLua | ILRuntime+ Framework = KSFramework

KSFramework是一个整合KEngine、SLua/XLua/ILRuntime 的Unity3D Asset Bundle开发框架，并为程序、美术、策划、运营提供辅助工具集。

Sponsor

KSFramework

维格表vika.cn，支持API的数据表，完美实时协同，可用于丝滑般的项目管理、游戏策划配置表、数据整理等1000+场景。

ShowCase(商业案例)

showcase 列表：https://github.com/mr-kelly/KSFramework/wiki

仙剑奇侠传4手游天域幻想巴清传少年剑影撞击女神七七捕鱼
命运抉择VR我的冒险屋Moba游戏
开发中

KSFramework

热重载是KSFramework的开发重点——在不重启游戏的前提下，重载代码、配置表可立刻看到修改效果，最大限度的提升开发、调试的速度，方便运营阶段热更新。

对于程序人员，可以使用AssetBundle加载与打包、脚本化的UI、配置表代码自动生成、下载更新等基础功能模块，大大减少游戏周边基础功能的工作量；

对于策划人员，使用Excel进行编辑，可以在编辑过程中添加注释、图标、预编译指令，KSFramework会根据配置内容自动生成代码供程序使用。

对于美术人员，只需将项目需要用到资源放到指定目录，将会自动的生成Asset Bundle；程序加载Asset Bundle跟Resources.Load一样方便。

对于运营人员，利用KSFramework的热重载特性，可以针对运营需求，在项目运行过程中配置表、脚本代码在用户无知觉的情况下进行热更新。

Quick Start

方式1，下载即用

以下方法任选其一：

方式2，从产品包安装

（这种方式获得的版本非最新版本），您可以从KSFramework Release页面下载最新版本的产品包。

解压后直接用Unity打开KSFramework目录，或直接双击场景KSFramework/Assets/Game.unity。

如遇到无法下载的网络问题, 备选下载站:

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打开无法运行，尝试以下方法：

  1. 重新生成Assetbundle，方法如下：点击菜单项 KEngine - AssetBundle - Bulld All

  2. 删除xLua、SLua、ILRuntime的生成代码，重新生成，不同Unity版本生成出来的代码有差异

  3. 如果前两步不能解决问题，请上传报错信息到issues。

KSFramework常见问题解答篇：https://mr-kelly.github.io/KSFramework/faq/

如果发现框架中存在的问题或有改进的地方，欢迎把你的修改pull request到仓库中，或提issues。

教程和文档

结构组成

KSFramework由KEngine和SLua结合组成

涉及第三方库