本文仅供参考，个人翻译
如果有哪些地方出现了错误请务必告知我

---

这里对下文做出几个约定:

• 所有数据类型均不翻译
  
• 不提供样例代码
  
• 翻译顺序为文档顺序，并非文档左侧快捷位置

类型->对象 位置->'/game'

• name
  类型->string
  模式的名字
  
• level
  类型->number
  当前'1'表示基础场, '2'表示高级场
  
• season
  类型->string
  当前的值为"alpha"
  
• ticksLimit
  类型->number
  游戏刻限制
  
• cpuTimeLimit
  类型->number
  游戏每刻的CPU的实际处理时间限制(除了第一刻)
  
• cpuTimeLimitFirstTick
  类型->number
  游戏第一刻CPU实际时间的限制

类型->类拓展自GameObject类 位置->'game/prototypes/game-object'
游戏对象的基本原型，所有对象和类都继承自该类

• my
  类型->boolean
  表示是否为你所有的工地
  
• progress
  类型->number
  当前施工进度
  
• progressTotal
  类型->number
  建造结构所需要的建造总进度
  
• structure
  类型->Structure
  完成建造时所建造的结构
  
• remove()
  移除该工地

类型->类 位置->'game/path-finder'
一个容器包含了自定义导航花费的数据。如果 CostMatrix 中存在一个非零值，那么这个值将会被使用并取代默认的地形花费

• constructor()
  创建一个新的各处为 0 的 CostMatrix
  
• set(x, y, cost)
  在 CostMatrix 中设置一个位置的花费
  
  参数

  类型

  描述

  x

  number

  在游戏中的X坐标

  y

  number

  在游戏中的Y坐标

  cost

  number

  位置的花费。必须是整数。如果花费为 0 则将使用该位置地形贴图的数值。如果花费大于等于 255 则将表示为不可通过
• get(x, y)
  在 CostMatrix 中取得一个位置的花费
  
  参数

  类型

  描述

  x

  number

  在游戏中的X坐标

  y

  number

  在游戏中的X坐标
• clone()
  复制一个 CostMatrix 到一个新的 CostMatrix 中，并返回新的 CostMatrix

类型->类拓展自GameObject类 位置->'game/prototypes/creep'
爬虫是你的单位。爬虫可以移动、收集资源、建造结构、攻击其他爬虫和做到其他动作。每个爬虫都包含至多 50 个如下表所列的身体模块：

• body
  类型->array
  一个数组用于描述爬虫的身体组件，每个元素都包含以下原型：
  
  • type: string (包含一个身体模块类型)
    
  • hits: number (这个身体模块所剩余的结构点数)
• fatigue
  类型->number
  运动疲劳值。如果这个值大于 0 那么这个爬虫将不能移动
  
• hits
  类型->number
  当前该爬虫的结构点数
  
• hitsMax
  类型->number
  该爬虫的最大结构点数
  
• my
  类型->boolean
  表示是否为你所有的爬虫
  
• store
  类型->Store
  一个 Store 对象，表示爬虫所携带的货物
  
• attack(target)
  近距离攻击其他爬虫或是结构。需要 ATTACK 身体模块。如果该目标在一个堡垒中，那么将会攻击堡垒。目标必须在爬虫相邻的方格内
  
  参数

  类型

  描述

  target

  Creep Structure

  目标对象
  将会返回以下代码
  
  OK

  0

  该操作被成功安排

  ERR_NOT_OWNER

  -1

  该爬虫不归你所有

  ERR_INVALID_TARGET

  -7

  目标不是一个有效的攻击目标

  ERR_NOT_IN_RANGE

  -9

  目标太远

  ERR_NO_BODYPART

  -12

  该爬虫没有 ATTACK 身体模块
• build(target)
  使用所携带的资源在目标工地进行建造。需要 WORK 和 CARRY 身体模块。目标必须在 3 格以内
  
  参数

  类型

  描述

  target

  ConstructionSite

  目标工地
  将会返回以下代码
  
  OK

  0

  该操作被成功安排

  ERR_NOT_OWNER

  -1

  该爬虫不归你所有

  ERR_NOT_ENOUGH_RESOURCES

  -6

  爬虫没有足够的资源

  ERR_INVALID_TARGET

  -7

  目标不是一个有效的建造目标，或该结构不能被建在那里(可能是因为那里有一个障碍)

  ERR_NOT_IN_RANGE

  -9

  目标太远

  ERR_NO_BODYPART

  -12

  该爬虫没有 WORK 身体模块
• drop(resourceType, [amount])
  将资源扔在地上
  
  参数

  类型

  描述

  resourceType

  string

  一个 RESOURCE_* 常量

  amount[可选]

  number

  所要丢下的资源的数量。如果省缺则丢下所有可用的数量
  将会返回以下代码
  
  OK

  0

  该操作被成功安排

  ERR_NOT_OWNER

  -1

  该爬虫不归你所有

  ERR_NOT_ENOUGH_RESOURCES

  -6

  爬虫没有足够的资源

  ERR_INVALID_ARGS

  -10

  resourceType 不是一个正确的 RESOURCE_* 常量
• harvest(target)
  从资源点收集资源。需要 WORK 身体模块。如果爬虫有一个空的 CARRY 身体模块，那么收集的资源将会储存在爬虫内部，否则将会丢在地上。目标必须在爬虫相邻的方格内
  
  参数

  类型

  描述

  target

  Source

  目标资源点
  将会返回以下代码
  
  OK

  0

  该操作被成功安排

  ERR_NOT_OWNER

  -1

  该爬虫不归你所有

  ERR_NOT_ENOUGH_RESOURCES

  -6

  目标不包含可收集的资源

  ERR_INVALID_TARGET

  -7

  目标不是一个有效的资源目标

  ERR_NOT_IN_RANGE

  -9

  目标太远

  ERR_NO_BODYPART

  -12

  该爬虫没有 WORK 身体模块
• heal(target)
  治疗自身或其他爬虫。这将会修复目标爬虫受损的身体模块的功能并增大其结构点数。需要 HEAL 身体模块。目标必须在爬虫相邻的方格内
  
  参数

  类型

  描述

  target

  Creep

  目标爬虫
  将会返回以下代码
  
  OK

  0

  该操作被成功安排

  ERR_NOT_OWNER

  -1

  该爬虫不归你所有

  ERR_INVALID_TARGET

  -7

  目标不是一个有效的目标

  ERR_NOT_IN_RANGE

  -9

  目标太远

  ERR_NO_BODYPART

  -12

  该爬虫没有 HAEL 身体模块
• move(direction)
  让爬虫向指定方向移动一格。需要 MOVE 身体模块
  
  参数

  类型

  描述

  direction

  number

  下列的其中一个常量： TOP TOP_RIGHT RIGHT BOTTOM_RIGHT BOTTOM BOTTOM_LEFT LEFT TOP_LEFT 
  将会返回以下代码
  
  OK

  0

  该操作被成功安排

  ERR_NOT_OWNER

  -1

  该爬虫不归你所有

  ERR_INVALID_ARGS

  -10

  提供的方向不正确

  ERR_TIRED

  -11

  爬虫的疲劳值不是 0

  ERR_NO_BODYPART

  -12

  该爬虫没有 MOVE 身体模块
• moveTo(target, opts)
  寻找最优路线并向目标移动。需要 MOVE 身体模块
  
  参数

  类型

  描述

  target

  object

  可以是一个 GameObject 或是一个对象拥有 x 和 y 属性

  opts

  object

  一个对象包含额外的选项将会传递至'game/utils' findPath 函数
  将会返回以下代码
  
  OK

  0

  该操作被成功安排

  ERR_NOT_OWNER

  -1

  该爬虫不归你所有

  ERR_TIRED

  -11

  爬虫的疲劳值不是 0

  ERR_NO_BODYPART

  -12

  该爬虫没有 MOVE 身体模块
• pickup(target)
  捡起一个物品。需要 CARRY 身体模块。目标必须在爬虫相邻的方格或与爬虫在同一方格内
  
  参数

  类型

  描述

  target

  Resource

  目标对象
  将会返回以下代码
  
  OK

  0

  该操作被成功安排

  ERR_NOT_OWNER

  -1

  该爬虫不归你所有

  ERR_INVALID_TARGET

  -7

  目标不是一个有效的目标

  ERR_FULL

  -8

  爬虫不能再接收更多资源了

  ERR_NOT_IN_RANGE

  -9

  目标太远
• pull(target)
  帮助目标爬虫跟随该爬虫。目标爬虫移动所生成的疲劳值将会被转移到该爬虫上。需要 MOVE 身体模块。目标爬虫必须在爬虫相邻的方格内。该爬虫必须向其他方向移动，同时目标爬虫将会向该爬虫方向移动
  
  参数

  类型

  描述

  target

  Creep

  目标爬虫
  将会返回以下代码
  
  OK

  0

  该操作被成功安排

  ERR_NOT_OWNER

  -1

  该爬虫不归你所有

  ERR_INVALID_TARGET

  -7

  目标不是一个有效的目标

  ERR_NOT_IN_RANGE

  -9

  目标太远

• rangedAttack(target)
  远程攻击其他爬虫或是结构。需要 RANGED_ATTACK 身体模块。如果该目标在一个堡垒中，那么将会攻击堡垒。目标必须在爬虫 3 个方块之内
  
  参数

  类型

  描述

  target

  Creep Structure

  目标对象
  将会返回以下代码
  
  OK

  0

  该操作被成功安排

  ERR_NOT_OWNER

  -1

  该爬虫不归你所有

  ERR_INVALID_TARGET

  -7

  目标不是一个有效的攻击目标

  ERR_NOT_IN_RANGE

  -9

  目标太远

  ERR_NO_BODYPART

  -12

  该爬虫没有 RANGED_ATTACK/b] 身体模块[/th][/tr][/table]
  
• rangedHeal(target)
  远距离治疗其他爬虫。这将会修复目标爬虫受损的身体模块的功能并增大其结构点数。需要 HEAL 身体模块。目标必须在爬虫 3 个方块之内
  
  参数

  类型

  描述

  target

  Creep

  目标爬虫
  将会返回以下代码
  
  OK

  0

  该操作被成功安排

  ERR_NOT_OWNER

  -1

  该爬虫不归你所有

  ERR_INVALID_TARGET

  -7

  目标不是一个有效的目标

  ERR_NOT_IN_RANGE

  -9

  目标太远

  ERR_NO_BODYPART

  -12

  该爬虫没有 HAEL 身体模块
• rangedMassAttack()
  范围攻击 3 个方格以内的敌对爬虫或结构。需要 RANGED_ATTACK 身体模块。攻击造成的伤害取决于到目标的距离。友方单位不会受到伤害
  将会返回以下代码
  
  OK

  0

  该操作被成功安排

  ERR_NOT_OWNER

  -1

  该爬虫不归你所有

  ERR_NO_BODYPART

  -12

  该爬虫没有 RANGED_ATTACK/b] 身体模块[/th][/tr][/table]
  
• transfer(target, resourceType, [amount])
  通过爬虫运输资源到另一个对象。目标必须在爬虫相邻的方格内
  
  参数

  类型

  描述

  target

  Creep Structure

  目标对象

  resourceType

  string

  某一个 RESOURCE_* 常量

  amount[可选]

  number

  所选资源将被运输的量。如果省缺，将会运输所有可用的资源量
  将会返回以下代码
  
  OK

  0

  该操作被成功安排

  ERR_NOT_OWNER

  -1

  该爬虫不归你所有

  ERR_NOT_ENOUGH_RESOURCES

  -6

  该爬虫没有被给予足量的资源

  ERR_INVALID_TARGET

  -7

  目标不是一个有效的目标

  ERR_FULL

  -8

  目标不能接受更多资源

  ERR_NOT_IN_RANGE

  -9

  目标太远

  ERR_INVALID_ARGS

  -10

  resourceType 不是一个正确的 RESOURCE_* 常量
• withdraw(target, resourceType, [amount])
  从结构中取回资源。目标必须在爬虫相邻的方格内。多个爬虫可以同时从一个结构中取出资源。你的爬虫也可以从敌对结构中取出资源，只要其结构上方没有要塞即可
  
  参数

  类型

  描述

  target

  Creep Structure

  目标对象

  resourceType

  string

  某一个 RESOURCE_* 常量

  amount[可选]

  number

  所选资源将被运输的量。如果省缺，将会运输所有可用的资源量
  将会返回以下代码
  
  OK

  0

  该操作被成功安排

  ERR_NOT_OWNER

  -1

  该爬虫不归你所有

  ERR_NOT_ENOUGH_RESOURCES

  -6

  目标没有被给予足量的资源

  ERR_INVALID_TARGET

  -7

  目标不是一个有效的目标

  ERR_FULL

  -8

  爬虫的储存已满

  ERR_NOT_IN_RANGE

  -9

  目标太远

  ERR_INVALID_ARGS

  -10

  resourceType 不是一个正确的 RESOURCE_* 常量

类型->类 位置->'game/prototypes/game-object'
所有游戏对象的基本原型。所有的对象和类都继承了该类

• exists
  类型->boolean
  返回该对象是否还在游戏中存活。

此项目下无内容

--------- 2022.4.29 ---------
增添了对象的部分内容
修复了一些问题

--------- 2022.4.23 ---------
初次发布
翻译了对象的部分内容