部分上传
bug
parent
ef4addef1f
commit
1f0e6ece51
|
|
@ -8,7 +8,7 @@
|
||||||
- 配置:
|
- 配置:
|
||||||
|
|
||||||
- [定义](images/adv/def_02.png):
|
- [定义](images/adv/def_02.png):
|
||||||
``` xml
|
```xml
|
||||||
<module name = "item">
|
<module name = "item">
|
||||||
<bean name = "Item">
|
<bean name = "Item">
|
||||||
<var name = "batch_usable" type = "bool" />
|
<var name = "batch_usable" type = "bool" />
|
||||||
|
|
@ -19,9 +19,10 @@
|
||||||
## float 类型
|
## float 类型
|
||||||
|
|
||||||
- 新增一个 float 类型字段，掉落概率 drop_prob.
|
- 新增一个 float 类型字段，掉落概率 drop_prob.
|
||||||
- 
|
- 配置:
|
||||||
|
|
||||||
- [定义](images/adv/def_04.png):
|
- [定义](images/adv/def_04.png):
|
||||||
``` xml
|
```xml
|
||||||
<module name = "item">
|
<module name = "item">
|
||||||
<bean name = "Item">
|
<bean name = "Item">
|
||||||
<var name = "drop_prob" type = "float" />
|
<var name = "drop_prob" type = "float" />
|
||||||
|
|
@ -32,29 +33,70 @@
|
||||||
## 列表类型 list,int
|
## 列表类型 list,int
|
||||||
|
|
||||||
- 我们新增一个字段， 宝箱的随机抽取道具列表 random_item_ids。
|
- 我们新增一个字段， 宝箱的随机抽取道具列表 random_item_ids。
|
||||||
- 
|
- 配置:
|
||||||
- 
|
|
||||||
|
- [定义](images/adv/def_06.png)
|
||||||
|
```xml
|
||||||
|
<module name = "item">
|
||||||
|
<bean name = "Item">
|
||||||
|
<var name = "random_item_ids" type = "list, int" />
|
||||||
|
</bean>
|
||||||
|
</module>
|
||||||
|
```
|
||||||
|
|
||||||
## 向量类型 vector3
|
## 向量类型 vector3
|
||||||
|
|
||||||
- vector3 有三个字段 float x, float y, float z, 适合用于表示坐标之类的数据。
|
- vector3 有三个字段 float x, float y, float z, 适合用于表示坐标之类的数据。
|
||||||
- 我们新增一个 spawn_location 字段，表示物品产生的场景位置。
|
- 我们新增一个 spawn_location 字段，表示物品产生的场景位置。
|
||||||
- 
|
- 配置:
|
||||||
- 
|
|
||||||
|
- [定义](images/adv/def_08.png):
|
||||||
|
```xml
|
||||||
|
<module name = "item">
|
||||||
|
<bean name = "Item">
|
||||||
|
<var name = "spawn_location" type = "vector3" />
|
||||||
|
</bean>
|
||||||
|
</module>
|
||||||
|
```
|
||||||
|
|
||||||
## 枚举类型
|
## 枚举类型
|
||||||
|
|
||||||
- 道具有品质，白绿蓝紫橙。 虽然可以直接填 1-5 这几个数据，但不直观，而且对程序非常不友好。
|
- 道具有品质，白绿蓝紫橙。 虽然可以直接填 1-5 这几个数据，但不直观，而且对程序非常不友好。
|
||||||
- 有一种更优雅的方式是定义枚举。
|
- 有一种更优雅的方式是定义枚举。
|
||||||
- 
|
- [枚举定义](images/adv/def_09.png)
|
||||||
|
|
||||||
|
```xml
|
||||||
|
<enum name = "EQuality">
|
||||||
|
<var name = "WHITE" alias = "白" value = "1">
|
||||||
|
<var name = "GREEN" alias = "绿" value = "2">
|
||||||
|
<var name = "BLUE" alias = "蓝" value = "3">
|
||||||
|
<var name = "PURPLE" alias = "紫" value = "4">
|
||||||
|
<var name = "ORANGE" alias = "橙" value = "5">
|
||||||
|
</enum>
|
||||||
|
```
|
||||||
|
|
||||||
- 之前用 bean 来定义结构，我们引入的新的 tag “enum” 来定义 枚举。
|
- 之前用 bean 来定义结构，我们引入的新的 tag “enum” 来定义 枚举。
|
||||||
- enum 的 name 属性表示 枚举名。
|
- enum 的 name 属性表示 枚举名。
|
||||||
- 如果生成 c#代码的话，会生成 cfg.item.Equality 类。
|
- 如果生成 c#代码的话，会生成 cfg.item.Equality 类。
|
||||||
- <var name=”xxx” alias=”xx” value=”xx”/> 定义检举项。
|
- `<var name=”xxx” alias=”xx” value=”xx”/>` 定义检举项。
|
||||||
- 其中 name 为必填项，不可为空，也不能重复。
|
- 其中 name 为必填项，不可为空，也不能重复。
|
||||||
- alias 是可选项，枚举项别名。
|
- alias 是可选项，枚举项别名。
|
||||||
- value 是枚举值，主要给程序使用。
|
- value 是枚举值，主要给程序使用。
|
||||||
- 
|
- [完整用法](images/adv/def_10.png)
|
||||||
|
```
|
||||||
|
<module name = "item">
|
||||||
|
<enum name = "EQuality">
|
||||||
|
<var name = "WHITE" alias = "白" value = "1">
|
||||||
|
<var name = "GREEN" alias = "绿" value = "2">
|
||||||
|
<var name = "BLUE" alias = "蓝" value = "3">
|
||||||
|
<var name = "PURPLE" alias = "紫" value = "4">
|
||||||
|
<var name = "ORANGE" alias = "橙" value = "5">
|
||||||
|
</enum>
|
||||||
|
<bean name = "Item">
|
||||||
|
<var name = "quality" type = "EQuality">
|
||||||
|
</bean>
|
||||||
|
</module>
|
||||||
|
```
|
||||||
- excel 表中，想表达一个枚举值，既可以用检举项 name,也可以用枚举项的 alias，但不能是相应的整数值。
|
- excel 表中，想表达一个枚举值，既可以用检举项 name,也可以用枚举项的 alias，但不能是相应的整数值。
|
||||||
- 注意！如果想引用其他模块定义的 enum 或者 bean, type 里必须指定全名。比如 type=”mall.TradeInfo” 。
|
- 注意！如果想引用其他模块定义的 enum 或者 bean, type 里必须指定全名。比如 type=”mall.TradeInfo” 。
|
||||||
- 
|
- 
|
||||||
|
|
@ -137,49 +179,51 @@
|
||||||
2. show_info 下一行，填上 子字段名 （顺序不重要）
|
2. show_info 下一行，填上 子字段名 （顺序不重要）
|
||||||
- 我们称之为多级标题头，通过多级标题头的方式，可以精确定位深层次字段的列。方便策划填。
|
- 我们称之为多级标题头，通过多级标题头的方式，可以精确定位深层次字段的列。方便策划填。
|
||||||
|
|
||||||
|
|
||||||
## 单例表
|
## 单例表
|
||||||
* 不是所有数据都是 类似map 这样的多记录结构。有些配置只有一份，比如 开启装备系统的最小角色等级。 这些数据 所在的表，也只有一个记录。称之为 单例表。
|
|
||||||
* 我们创建一个单例表，来存放这些数据。
|
- 不是所有数据都是 类似 map 这样的多记录结构。有些配置只有一份，比如 开启装备系统的最小角色等级。 这些数据 所在的表，也只有一个记录。称之为 单例表。
|
||||||
定义如下：
|
- 我们创建一个单例表，来存放这些数据。
|
||||||
|
定义如下：
|
||||||
数据如下：
|
|
||||||
|
数据如下：
|
||||||
|
|
||||||
|
|
||||||
## 横表与纵表
|
## 横表与纵表
|
||||||
* 之前介绍的表都是 面向行，沿着行方向填写数据。有时候我们希望 以列为方向填写。
|
|
||||||
* 比如 上面的单例表。 如果改成一行一个字段，看起来会更清楚。 我们引入纵表支持。
|
- 之前介绍的表都是 面向行，沿着行方向填写数据。有时候我们希望 以列为方向填写。
|
||||||
* 定义不变，但 excel 的填法有区别，数据如下：
|
- 比如 上面的单例表。 如果改成一行一个字段，看起来会更清楚。 我们引入纵表支持。
|
||||||
* 
|
- 定义不变，但 excel 的填法有区别，数据如下：
|
||||||
|
- 
|
||||||
|
|
||||||
## 可空变量
|
## 可空变量
|
||||||
* 有时候会有一种变量，我们希望它 功能生效时填一个有效值，功能不生效里，用一个值来表示。 例如 int 类型，常常拿0或者-1作无效值常量。 但有时候，0或-1也是有效值时，这种做法就不生效了。或者说 项目组内 有时候拿0，有时候拿-1作无效值标记，很不统一。我们借鉴 sql及 c#,引入 可空值概念，用null表达空值。
|
|
||||||
* 我们为Item 添加 min_use_level 字段，类型为 int? 当填有效值时，使用时要检查等级，否则不检查。
|
- 有时候会有一种变量，我们希望它 功能生效时填一个有效值，功能不生效里，用一个值来表示。 例如 int 类型，常常拿 0 或者-1 作无效值常量。 但有时候，0 或-1 也是有效值时，这种做法就不生效了。或者说 项目组内 有时候拿 0，有时候拿-1 作无效值标记，很不统一。我们借鉴 sql 及 c#,引入 可空值概念，用 null 表达空值。
|
||||||
* 定义如下
|
- 我们为 Item 添加 min_use_level 字段，类型为 int? 当填有效值时，使用时要检查等级，否则不检查。
|
||||||
|
- 定义如下
|
||||||
* 数据如下
|
|
||||||
|
- 数据如下
|
||||||
|
|
||||||
|
|
||||||
## datetime 类型
|
## datetime 类型
|
||||||
* 时间是常用的数据类型。Luban特地提供了支持。
|
|
||||||
填写格式为 以下4种。
|
- 时间是常用的数据类型。Luban 特地提供了支持。
|
||||||
* yyyy-mm-dd hh:mm:ss 如 1999-08-08 01:30:29
|
填写格式为 以下 4 种。
|
||||||
* yyyy-mm-dd hh:mm 如 2000-08-07 07:40
|
- yyyy-mm-dd hh:mm:ss 如 1999-08-08 01:30:29
|
||||||
* yyyy-mm-dd hh 如 2001-09-05 07
|
- yyyy-mm-dd hh:mm 如 2000-08-07 07:40
|
||||||
* yyyy-mm-dd 如 2003-04-05
|
- yyyy-mm-dd hh 如 2001-09-05 07
|
||||||
* 为Item 新增一个 失效时间字段 expire_time 。
|
- yyyy-mm-dd 如 2003-04-05
|
||||||
定义如下:
|
- 为 Item 新增一个 失效时间字段 expire_time 。
|
||||||
|
定义如下:
|
||||||
数据如下:
|
|
||||||
|
数据如下:
|
||||||
|
|
||||||
|
|
||||||
## convert 常量替换
|
## convert 常量替换
|
||||||
* 游戏里经常会出现一些常用的类似枚举的值，比如说 升级丹的id,在很多地方都要填，如果直接它的道具id,既不直观，也容易出错。 Luban 支持常量替换。
|
|
||||||
* 对于需要常量替换的字段，添加 convert=”枚举类”。 如果填写的值是 枚举名或者别名，则替换为 相应的整数。否则 按照整数解析。
|
|
||||||
*
|
|
||||||
定义如下:
|
|
||||||
|
|
||||||
数据如下:
|
|
||||||
|
|
||||||
* 添加了convert 的字段，既可以填 convert指向的枚举类里的一个合法枚举名，也可以是其他整数。
|
|
||||||
|
|
||||||
|
- 游戏里经常会出现一些常用的类似枚举的值，比如说 升级丹的 id,在很多地方都要填，如果直接它的道具 id,既不直观，也容易出错。 Luban 支持常量替换。
|
||||||
|
- 对于需要常量替换的字段，添加 convert=”枚举类”。 如果填写的值是 枚举名或者别名，则替换为 相应的整数。否则 按照整数解析。
|
||||||
|
- 定义如下:
|
||||||
|
|
||||||
|
数据如下:
|
||||||
|
|
||||||
|
- 添加了 convert 的字段，既可以填 convert 指向的枚举类里的一个合法枚举名，也可以是其他整数。
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue