Luban+Unity使用，看这一篇文章就够了_unity luban

视频教学：新手快速入门Luban+Unity使用_哔哩哔哩_bilibili

接入

dotnet：浏览要下载的所有 .NET 版本| .NET

Luban示例项目：https://github.com/focus-creative-games/luban_examples

Luban Next版 Releases版：https://github.com/focus-creative-games/luban/releases

Luban Unity包：https://github.com/focus-creative-games/luban_unity

视频中的项目地址：ZSG2001/LubanTest

Luban官方文档

在Unity项目根目录下，创建一个LubanConfig文件夹，来存放Luban相关的内容

把示例文件夹中的MiniTemplate文件夹复制一份到上一步创建的LubanConfig文件夹中

Luban示例项目：https://github.com/focus-creative-games/luban_examples

检查Datas和output两个文件夹中的内容

Datas中只留这三张表，output下的东西全部删除即可

将最新版的Luban（一个名称为Luban的文件夹）放到MiniTemplate文件夹下

Luban Next版 Releases版：https://github.com/focus-creative-games/luban/releases

在Unity的Packages文件夹下，创建一个文件夹来存放Luban Unity包的内容

Luban Unity包下载完成后，将里面除docs外的文件复制到前面创建的文件夹下

Luban Unity包：https://github.com/focus-creative-games/luban_unity

在Unity中，将unsafe打勾

配表

luban.config文件中指明了数据从哪里读取

此处代表从Datas文件夹下读取

我们在Datas文件夹下创建表即可

表的基本格式如下：

var代表字段名，Type代表字段类型，group是分组，有client，server和all（默认不填也是）

##代表注释

然后填入数据即可

在数据配表不复杂的情况下，直接使用自动导表

具体规则如下，简言之，就是在表名前加#，如果涉及文件夹嵌套，也是如此，luban会自动处理

生成数据

配好的数据

选择图中的文件，设置命令行

命令行详解

注意：

1. 这里的文件定位都是基于gen.bat
2. 除最后一行外，其余命令行要用^结尾，功能类似分隔符

图中的内容依次为：

工作区：主要是用于文件的定位，此处表示gen.bat的上两级文件夹

D:\\Unity_Project\\1.Teach\\Test\\LubanConfig\\MiniTemplate\\gen.bat，结果就是D:\\Unity_Project\\1.Teach\\Test\\

Luban DLL文件的位置：此处是在%WORKSPACE%\\LubanConfig\\MiniTemplate\\Luban\\Luban.dll

luban conf的位置：也就是下图这个文件，此处是与gen.bat同级，所以填一个点就行

d代表生成的数据目标

c代表生成的代码目标

conf 代表Config的位置

两个output分别表示数据和代码的输出路径

然后双击这个文件，自动执行生成

生成的内容

使用数据

此处将Json数据放在Resources文件夹下，

生成的代码为cs-newtonsoft-json或者cs-simple-json，并放在Scripts下

set WORKSPACE=..\\..set LUBAN_DLL=%WORKSPACE%\\LubanConfig\\MiniTemplate\\Luban\\Luban.dllset CONF_ROOT=.dotnet %LUBAN_DLL% ^ -t all ^ -d json ^ -c cs-newtonsoft-json ^//改为cs-simple-json即可 --conf %CONF_ROOT%\\luban.conf ^ -x outputDataDir=%WORKSPACE%\\Assets\\Resources\\Data ^ -x outputCodeDir=%WORKSPACE%\\Assets\\Scripts\\Codepause

using cfg;using Newtonsoft.Json.Linq;using UnityEngine;public class DataMgr : MonoBehaviour{ private void Start() { var tables = new Tables(LoadTable); foreach (var data in tables.TbPerson.DataList) { print(data); } } private JArray LoadTable(string table_name) { var textAsset = Resources.Load(\"Data/tbperson\"); return JArray.Parse(textAsset.text); }}

using cfg;using SimpleJSON;using UnityEngine;public class DataMgr : MonoBehaviour{ private void Start() { //传入一个参数为string类型，返回值为xxx类型（由具体的代码类型决定）的方法 var tables = new Tables(LoadTable); //数据类里面实现了字典和列表两个容器，可以自由使用 //得到字典容器中指定键的数据 print(tables.TbPerson.Get(1001)); //得到列表容器中指定位置的数据 print(tables.TbPerson.DataList[0]); //遍历字典或列表容器中的数据 foreach (var data in tables.TbPerson.DataList) { print(data); } } private JSONNode LoadTable(string table_name) { //读取配置的数据 var textAsset = Resources.Load(\"Data/tbperson\"); //返回数据 return JSONNode.Parse(textAsset.text); }}

路径中点和斜杠的作用

1. 表示当前目录

• 作用：. 代表程序或命令当前所在的目录，常用于相对路径中省略完整路径的书写。
• 示例：

• • ./file.txt → 当前目录下的 file.txt 文件。

2. 表示上级目录（双点 ..）

• 作用：.. 指向当前目录的直接父目录，用于向上导航。
• 示例：

• • ../config.ini → 父目录中的 config.ini 文件。

• 示例：

• • ./src/../config → 先进入 src，再返回上级，等效于 ./config。
  • ../../lib → 向上返回两级后进入 lib 目录。

..\\.. 此处表示gen.bat的上两级文件夹

D:\\Unity_Project\\1.Teach\\Test\\LubanConfig\\MiniTemplate\\gen.bat，结果就是D:\\Unity_Project\\1.Teach\\Test\\