Board

Board 代表了游戏关卡，其中包括了许多关卡的特有属性，以及许多与关卡内元素交互的方法。

方法

以下是 LawnApp 的所有方法:

GetUpdateDelta

获取距离与上一逻辑帧过去的时间。

函数签名:

fun(self): number

返回值:

• 距离上一逻辑帧过去的时间（秒）

MousePressing

获取鼠标是否按住（暂停时不进行记录）。

函数签名:

fun(self): boolean

返回值:

• 鼠标是否按住

SetSun

将阳光修改为新的值。

函数签名:

fun(self, value: integer)

参数:

• value integer: 新的阳光值

GetZombies

获取场上所有的僵尸。

函数签名:

fun(self): table<integer, Zombie>

返回值:

• 一个表，键是僵尸的 id，值是 Zombie 实例

GetZombieById

通过僵尸 id 查询获取特定僵尸，如果没有此 id 的僵尸则返回 nil。

函数签名:

fun(self, id: integer): Zombie?

参数:

• id integer: 僵尸的 id

返回值:

• 如果此僵尸存在，返回 Zombie 实例，否则返回 nil

AddZombie

在特定行添加一只僵尸。

函数签名:

fun(self, zombie_type: integer, row: integer, from_wave: integer): Zombie

参数:

• zombie_type integer: 僵尸的类型 id
• row integer: 僵尸所在的行
• from_wave integer: 僵尸来自的波次

返回值:

• 返回创建僵尸的 Zombie 实例

AddCoin

添加一个掉落物

函数签名:

fun(self, pos: Vec2, coin_type: CoinType, coin_motion: CoinMotion): Coin

参数:

• pos Vec2: 掉落物的坐标
• coin_type CoinType: 掉落物类型
• coin_motion CoinMotion: 掉落物运动方式

返回值:

• 返回生成掉落物的 Coin 实例

PosToGridKeepOnBoard

将一个坐标转换为关卡内网格的坐标。且对于网格范围外的坐标，会转换为必定在网格内的网格坐标。

函数签名:

fun(self, pos: Vec2): Vec2

参数:

• pos Vec2: 原始坐标

返回值:

• 游戏关卡内网格坐标的 Vec2

GetPlants

获取场上所有的植物。

函数签名:

fun(self): table<integer, Plant>

返回值:

• 一个表，键是植物的 id，值是 Plant 实例

GetPlantById

通过植物 id 查询获取特定植物，如果没有此 id 的植物则返回 nil。

函数签名:

fun(self, id: integer): Plant?

参数:

• id integer: 植物的 id

返回值:

• 如果此植物存在，返回 Plant 实例，否则返回 nil

GetPlantByGrid

通过棋盘坐标获取对应格子中的所有植物。

函数签名:

fun(self, grid_pos: Vec2): table<integer, Plant>

参数:

• grid_pos Vec2: 关卡内棋盘坐标

返回值:

• 一个表，键是植物的 id，值是 Plant 实例

Explode

在特定位置产生一次特定效果的爆炸。

函数签名:

fun(self, pos: Vec2, radius: integer, flag: DamageFlag, sound: GameSound?, particle: Particle?)

参数:

• pos Vec2: 爆炸的坐标。
• radius integer: 爆炸的半径。作为参考，毁灭菇的爆炸半径是 250。
• flag DamageFlag: 爆炸伤害的类型。
• sound DamageFlag?: （可选）爆炸的音效。
• particle Particle?: （可选）爆炸的粒子效果。

AddPlant

在指定游戏棋盘位置种植一株植物。

无视种植条件。

函数签名:

fun(self, grid_pos: Vec2, seed_type: integer): Plant

参数:

• grid_pos Vec2: 游戏棋盘坐标。
• seed_type integer: 植物的种类。

返回值:

• 返回创建植物的 Plant 实例