Small Update 1.0.4

Patch Notes 1.0.4

Added in-game Documentation

• New icon to make it easier to find:

• Document the location property .biomass for the biomass available to trees at that location. That's been in the language but we missed the documentation page.

• More details and examples in the hover box for many commands.

Text Scripting Command Options

There are a bunch of settings on commands in the visual scripting with no equivalent option in the text scripting. We've added a new syntax that allows adding options to the end of a command:

<command> <expression> : option <expression> option <expression> ...

New Options

• Go To Heading: let's you control what direction a drone is facing at the end of a goto command: goto <location> : heading <north/south/east/west/forward/backward/left/right>
  Forward, backward, left, and right are relative to the starting heading.

• Place Beacon Role
  place beacon : role <entity set>
  The entity set specifies and the role for the beacon and optionally the team:
  place beacon : role [Quarry]
  Sets the role; the team matches the team of the drone or surveyor that placed the beacon.
  place beacon : role [Quarry].team(red)
  Sets both the role and the team.

• Place Beacon Size
  place beacon : size <location>
  Sets the size of the placed beacon up to 25x25. Place Beacon allows multiple options so you can, for instance, set the role, filter, and size in one command.
  Example
  place beacon : size (5, 5)
  Creates a 5x5 beacon with the drone at the center.

• Place Beacon Filter
  place beacon : filter <item set>
  Example
  place beacon : filter ironore + limestone.1
  set the filter to Iron Ore and and the Limestone I variant.

• Place Beacon Empty
  place beacon : empty <hide/delete>
  Sets the hide when empty or delete when empty options on the beacon.

• Signal To
  signal to : <entity>
  Sends a signal to a specific entity.
  signal to : <entity set>
  Sends a signal to all entities in a role or role+team.
  Example
  signal mine to : [Miner].onteam(red)
  sends the signal mine to all drones with the Miner role on team red.

Other new Text Scripting Features

• Location function lets you construct locations with expressions.
  Example
  goto location(this.location.x + #.number * 5, @.location.y)

• Location.withx(), Location.withy()
  Lets you construct a location by replacing a component of another location.
  Example
  goto this.location.withx([Quarry].nearest.location.x)

• Location.biomass
  Returns the amount of biomass available to a tree if planted in that location.

• Location.plantable
  Returns and item set of seeds that can grow at that location.

• deletebeacon <entity>
  Surveyor command to delete a beacon.

Bug Fixes

• Text script team names are now case insensitive.

• Allow goto near/high/low/random point of a surveyor in a text script.

I am also still working on my text scripting playthrough of the game. The latest video shows scripting conveyors with item sets and requests. This'll be an ongoing series with a focus on how the elements of scripting work together.