73 lines
2.9 KiB
Markdown
73 lines
2.9 KiB
Markdown
# 快速上手
|
||
|
||
|
||
## 准备工作
|
||
1. 安装 .net 5 dsk
|
||
1. 下载luban_examples项目
|
||
|
||
下载项目 [luban_examples](https://github.com/focus-creative-games/luban_examples)。
|
||
项目中包含测试配置、最新的luban_client&luban_server工作以及大量的示例项目。为方便起见，后续提及到的文件，默认都指这个项目中的文件。
|
||
|
||
1. 设置全局环境变量
|
||
|
||
set_global_envs.bat 脚本文件，它会设置全局环境变量 LUBAN_SERVER_IP 为 127.0.0.1。如果你在其他机器上部属luban.server，可以将LUBAN_SERVER_IP改为相应地址。
|
||
1. 启动luban.server
|
||
|
||
运行 run_luban_server.bat 脚本文件，启动luban.server程序。由于luban工具使用client/server的工作
|
||
模块，必须有一个运行中的luban.server程序，才能完成生成工作，**请保持luban.server持续运行**。
|
||
|
||
新手测试时可以在本机启动luban.server，实际开发中，建议**一个项目部属一个luban.server**。
|
||
|
||
|
||
## 创建起始的游戏配置目录结构
|
||
1. 创建配置根目录
|
||
创建一个目录来存放所有游戏配置相关的文件。假设目录名为 Config（名字随意）。 目录下将包含数据目录、定义文件目录、检查脚本、高级自定义检查工程。
|
||
1. 在Config目录下创建数据目录Datas(名字随意)。将来用于存放所有游戏原始数据文件。
|
||
1. 在Config目录下创建定义目录Defines(名字随意)。目录下将包含根定义及各个模块子定义文件。
|
||
1. 在Defines目录下创建\_\_root__.xml 文件。文件内容如下：
|
||
```xml
|
||
<root>
|
||
<topmodule name="cfg"/> 额外的顶层命名空间
|
||
|
||
<group name="c" default="1"/> client 分组
|
||
<group name="s" default="1"/> server 分组
|
||
<group name="e" default="1"/> editor分组
|
||
|
||
<import name="."/> 从当前目录导入所有子模块定义文件
|
||
|
||
<service name="server" manager="Tables" group="s"/> 输出目标 server，包含s分组的表和字段
|
||
<service name="client" manager="Tables" group="c"/> 输出目标 client，包含c分组的表和字段
|
||
<service name="all" manager="Tables" group="c,s,e"/> 输出目标 editor，包含c,s,e分组的表和字段
|
||
</root>
|
||
```
|
||
|
||
也可以直接拷贝 luban_examples项目的 config/Defines/\_\_root__.xml。
|
||
|
||
1. 在配置根目录下，创建 check.bat，内容如下：
|
||
|
||
```bat
|
||
set WORKSPACE=..
|
||
set GEN_CLIENT=%WORKSPACE%\Tools\Luban.Client\Luban.Client.exe
|
||
set CONF_ROOT=%WORKSPACE%\DesignerConfigs
|
||
set DEFINE_FILE=%CONF_ROOT%\Defines\__root__.xml
|
||
|
||
<luaban.client.exe的路径> -h %LUBAN_SERVER_IP% -j cfg --^
|
||
-d Defines\__root__.xml^
|
||
--input_data_dir Datas ^
|
||
--output_data_dir output_data ^
|
||
--gen_types data_bin ^
|
||
-s all ^
|
||
--export_test_data
|
||
pause
|
||
|
||
```
|
||
|
||
执行 check.bat，如果输出最后为
|
||
```
|
||
== succ ==
|
||
```
|
||
表明命令行是正确的。
|
||
|
||
## 创建第一个表
|
||
|
||
# 进阶 |