给武侠RPG加一套新武功jynew的Mod与配置表玩法【免费下载链接】jynewJinYongLegend-like RPG Game Framework with full Modding support and 10 hours playable samples of game.项目地址: https://gitcode.com/GitHub_Trending/jy/jynew想给自己喜欢的武侠游戏加一名角色、一套武功却发现改一行数据都要翻遍工程目录jynew《群侠传启动》把人物、武功、物品这类游戏数据放在 Excel 配置表里把玩法逻辑放在 Lua 脚本里。你在 Mods 目录下搭一个新 Mod填几张表、写几段脚本就能做出自己的一段江湖故事。jynew 是什么一个可二次创作的武侠RPG框架jynew 是一个用 Unity 重制《金庸群侠传》的开源项目。它不只是游戏更是一套完整的游戏框架战棋回合制战斗、地图串接、技能动作、存档系统都已实现并且完整支持 Mod 开发。仓库自带三个可玩的样例 Mod——JYX2 复刻了金庸群侠传的完整流程SAMPLE 是一个约 3 小时的主线故事《渡城残魂传》xiastart_roguelike 则是自动战斗的肉鸽玩法 Demo。对 Mod 作者来说它解决的核心问题是你不需要理解整个游戏引擎只需要照着样例 Mod 的结构填数据、写脚本就能扩展游戏内容。从克隆到首次运行克隆仓库git clone https://gitcode.com/GitHub_Trending/jy/jynew安装 Unity 2020.3 LTSProjectVersion.txt 中有精确版本号用 Unity 打开jyx2/目录等待资源导入完成确认 modlist.txt 中列出的 Mod默认是jyx2和sample在 Unity 中直接 Play进入游戏主菜单选择样例 Mod 运行上手前先懂的概念Mod 就是一个目录。Mods 下每个子目录都是一个独立 Mod里面有ModSetting.assetMod 的入口配置、Configs/配置表、Lua/剧情与逻辑脚本、Skills/技能配置等文件夹。SAMPLE 是最适合照着抄的模板。数据用 Excel 填不用写代码。以 Mods/SAMPLE/Configs/武功.xlsx 为例A1 单元格填LuaConfigGen标记这是配置表B2 填表名如Skill第三行写字段类型L_number、L_string等第四行写字段名第五行开始是数据。游戏启动时框架会自动把它生成成 Lua 配置表加载进Jyx2.ConfigMgr脚本里直接读取。规则细节都写在 Mods/SAMPLE/Configs/README.md。Lua 脚本按模块注册。框架的总入口是 InitLuaScripts.lua模块名到文件路径的映射写在 LuaModuleList.lua。注册过的模块可以直接用Jyx2.GetModule(模块名)调用。这个机制是 Lua 侧热更新的基础也是 Mod 覆盖框架脚本的依据。实操走查给 SAMPLE Mod 新增一条武功配置目标在样例 Mod 的武功表里加一条新武功让游戏能读到它。动作打开 Mods/SAMPLE/Configs/武功.xlsx照现有格式在末尾加一行数据注意不要占用已存在的 Id在 Unity 编辑器中选中Mods/SAMPLE下的ModSetting文件在 Inspector 面板点击生成配置表按钮在 Lua 脚本中验证新数据是否可读结果配置表重新生成后新武功出现在 Lua 侧脚本里这样读取即可local configMgr Jyx2:GetModule(ConfigMgr) local skill configMgr.Skill[你的新Id] print(skill.Name) -- 输出新武功的名称如果打印出来的名称和你填的 Excel 一致说明这条配置已经生效后续的剧情和战斗逻辑都可以引用它了。扩展边界不改代码就能做的修改任意 Mod 的Configs/里的 Excel 表增删人物、武功、物品、商店数据在 Mod 根目录建LuaScripts/目录其中的同名 Lua 文件会覆盖框架里的对应脚本见 LuaScripts/README.md往 Mod 的 Skills/ 里添加技能配置文件复制整个 SAMPLE 目录作为新 Mod 的骨架改 modlist.txt 启用它必须进框架源码的情况需要新增 C# 侧的配置表访问接口要改 Scripts/LuaCore/LuaToCsBridge.cs 并重新编译要改战斗结算、地图加载等核心逻辑涉及 Scripts/GameBattle/ 等框架代码需要新的资源打包方式或启动流程要动 Editor/BuildTools/ 下的构建脚本避坑清单手工改了生成的 Lua 配置表游戏一启动就被还原→ 框架每次启动都会用 Excel 重新生成 Lua 表 → 只改 Excel改完点ModSetting上的生成配置表。新加的 Excel 表完全不生效→ A1 单元格没写LuaConfigGen标记文件被直接忽略 → 检查 A1格式对照 Configs/README.md。配置里有数据但脚本读不到→ Id 重复或该行 Id 以#开头被当作注释 → 保证每条数据的 Id 唯一且不带#。找不到可视化剧情编辑器→ 参考文章提到的节点式编辑器已从框架中移除见 Scripts/EventsGraph/README.txt→ 剧情逻辑直接用 Mod 里的 Lua 脚本编写样例见 Mods/SAMPLE/Lua/。下一步清单通读 Mods/SAMPLE/Configs/README.md掌握 Excel 配置表的全部字段规则对照 Mods/SAMPLE/ 的目录结构复制一份作为你的新 Mod 骨架阅读 LuaScripts/README.md理解模块注册与Jyx2全局表的使用方式用 LuaTestStarter.asset 在编辑器里单步调试你写的 Lua 脚本省去反复启动游戏【免费下载链接】jynewJinYongLegend-like RPG Game Framework with full Modding support and 10 hours playable samples of game.项目地址: https://gitcode.com/GitHub_Trending/jy/jynew创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考