AI - Revision history

Ongo: Fix erronous description of the double as an "integer" and add the full-length common computer science names of the data types with shortened names, mostly for new programmers who want to learn more.

2025-12-08T00:41:17Z

Fix erronous description of the double as an "integer" and add the full-length common computer science names of the data types with shortened names, mostly for new programmers who want to learn more.

Fireball541: oh whoops, forgot the descriptions of visibility.get()/child.visibility.get()

2025-08-19T06:29:04Z

oh whoops, forgot the descriptions of visibility.get()/child.visibility.get()

Fireball541: hopefully included everything the AI has (someone PLEASE double check)

2025-08-19T06:24:59Z

hopefully included everything the AI has (someone PLEASE double check)

Show changes

Archercatneo4: Add signatures for worker APIs

2024-11-09T12:21:47Z

Add signatures for worker APIs

Archercatneo4: Move all actions into the tables

2024-11-09T12:04:54Z

Move all actions into the tables

Show changes

Archercatneo4: Add all Tower Testing APIs

2024-11-09T11:36:18Z

Add all Tower Testing APIs

Show changes

Archercatneo4: Begin to split the "all APIs" table into multiple tables

2024-11-08T17:37:04Z

Begin to split the "all APIs" table into multiple tables

Show changes

Archercatneo4: Begin to reformat the AI page

2024-11-07T17:57:40Z

Begin to reformat the AI page

Show changes

Archercatneo4: Add more information on AI vs workers and add reference to machine learning (F7)

2024-11-07T16:33:52Z

Add more information on AI vs workers and add reference to machine learning (F7)

Blueturbo47: actually fixed table

2024-04-15T17:16:19Z

actually fixed table

@@ Line 50: / Line 50: @@
 |-
 |double
-|A integer that allows decimal precision. Can be positive or negative.
+|A number that allows decimal precision [a [[wikipedia:Floating-point_arithmetic|floating-point number]]]. Can be positive or negative.
 |3.2, 0.29, -10.2, 7.9999993
 |0.0
@@ Line 56: / Line 56: @@
 |-
 |int
-|A number that does not allow decimal precision. Can be positive or negative.
+|A number that does not allow decimal precision [an [[wikipedia:Integer_(computer_science)|integer]]]. Can be positive or negative.
 |20, 69, 420, -1029, 0
 |0
@@ Line 68: / Line 68: @@
 |-
 |bool
-|A binary value that can either be true or false.
+|A binary value that can either be true or false [a [[wikipedia:Boolean_data_type|boolean]] value].
 |true, false
 |false

@@ Line 343: / Line 343: @@
 |Evaluates <code>number1</code> and <code>number2</code> and returns the smaller of the two as a result of this function.
 |-
 |Random: [Int/Double]
 |<code>number rnd(lower, upper)</code>
 |Returns a random number between <code>lower</code> (inclusive) and <code>upper</code> (inclusive). If the second smaller is lower than the first then the first value will always be returned.
@@ Line 430: / Line 430: @@
 |String: Index Of
 |<code>int index(string str, string substr, int start)</code>
 |Returns the index of the first occurrence of string <code>substr</code> within the string <code>str</code>. Search starts at index <code>start</code> whereas 0 represents the beginning of the string.
 |-
 |String: Length
@@ Line 764: / Line 764: @@
 |-
 |Factory: Machine Input Count
 |<code>double machine.item.count(string machine)</code>
 |Returns the number of items currently inside the machine with the ID <code>machine</code>.
 |-
 |Factory: Machine Input
 |<code>string machine.item(string machine)</code>
 |Returns the ID of the item currently inside the [[Factory]] machine with the ID <code>machine</code>.
 |-
 |Factory: Find ID
@@ Line 1,119: / Line 1,119: @@
 |Sets the sprite inside the window with the id <code>windowId</code> of the button/image with the id <code>elementId</code> to <code>spriteId</code>.
 |-
-|Window: Get Visibility
+|Window: Is Visible
-|<code>bool visibility.get(string windowId)</code>
+|<code>bool visibility.get(string windowID)</code>
+|Returns true if the window with ID <code>windowID</code> is visible.
 |-
 |Window: Set Visibility
-|<code>void visibility.set(string windowId, bool visible)</code>
+|<code>void visibility.set(string windowID, bool visible)</code>
-|Set the window with id <code>windowId</code> to visible if <code>visible</code> is true. Otherwise it will be hidden.
+|Set the window with id <code>windowID</code> to visible if <code>visible</code> is true. Otherwise it will be hidden.
 |-
-|Window: Get Child Visibility
+|Window: Is Child Visible
-|<code>bool child.visibility.get(string windowId, string childElementId)</code>
+|<code>bool child.visibility.get(string windowID, string childElementID)</code>
+|Returns true if the child of window <code>windowID</code> with ID <code>childElementID</code> is visible.
 |-
 |Window: Set Child Visibility
-|<code>void child.visibility.set(string windowId, string childElementId, bool visible)</code>
+|<code>void child.visibility.set(string windowID, string childElementID, bool visible)</code>
-|Set child of window with id <code>windowId</code> with id <code>childElementId</code> to visible if <code>visible</code> is true. Otherwise window will be hidden.
+|Set child of window with id <code>windowID</code> with id <code>childElementID</code> to visible if <code>visible</code> is true. Otherwise window will be hidden.
 |-
 |Window: Set Position

@@ Line 418: / Line 418: @@
 !Function Signature
 !Description
 |-
+|
 |<code>bool isopen(string: window)</code>
 |Returns true if the [[Buildings]] window is active and visible on the screen. (ex: [[Tower Testing]] is open)
 |-
+|
@@ Line 434: / Line 442: @@
 |<code>double resource(string currency)</code>
+|
 |}
 {| class="wikitable"
@@ Line 778: / Line 782: @@
 !Function Signature
 !Description
 |-
 |Workers: Toggle Group
+|<code>void worker.toggleGroup(int group)</code>
 |Toggles the paused state of all workers in group <code>int group</code>. (Click on the parameter to see which color belongs to which group id.) Colors: White (0), Red (1), Blue (2), Green(3), Yellow (4), Magenta (5)
 |-
 |Workers: Pause Group
+|<code>void worker.pauseGroup(int group, bool paused)</code>
 |Sets the paused state of all workers in group <code>int group</code> to <code>bool value</code>. (Click on the parameter to see which color belongs to which group id.)
 |-
 |Workers: Toggle
+|<code>void worker.toggleName(string name)</code>
 |Toggles the paused state of all workers with name <code>str name</code>.
 |-
 |Workers: Pause
+|<code>void worker.pauseName(string name, bool paused)</code>
 |Sets the paused state of all workers with the name <code>str name</code> to <code>bool value</code>.
 |-
 |Workers: Assign Group
+|<code>void worker.assignGroup(string task, int subtask, int group)</code>
 |Assigns the task with id <code>str id</code> and optional parameter <code>int param</code> (0 is the leftmost) to all workers in group <code>int group</code>. (Click on the groups parameter to see which color belongs to which group.)
 |-
 |Workers: Assign
+|<code>void worker.assignName(string task, int subtask, string name)</code>
 |Assigns Task with ID <code>str id</code> and optional parameter <code>int param</code> (0 is the leftmost) to all workers with the name <code>str name</code>. [[Workers#Worker_Taskid.27s|TaskIDs]]
 |-
 |Workers: Set Name
+|<code>void worker.setName(int index, string name)</code>
 |Sets the name of the worker at index <code>int index</code> to <code>str name</code>.
 |-
 |Worker: Set Group
+|<code>void worker.setGroup(int index, int group)</code>
 |Sets the group of the worker at index <code>int index</code> (0 is the first worker) to the group with id <code>int id</code>.
 |}

@@ Line 1: / Line 1: @@
-The AI (short for "Artificial Intelligence") is a feature of the [[Headquarters]] that unlocks upon reaching [[Military Tier]] 4. It is an extremely versatile tool that allows the user to automate almost any task in the game. As of "v0.8.5 B1 - Workers!" (see [[Version history]]), [[Workers]] were added to the game as a "pre-AI automation system". According to the developers, Workers "can do exactly one specific task of your choice at a selected speed" so they aren't meant to take place of AI in any way, as AI is still more powerful in its capabilities.
+The facility AI (short for "Artificial Intelligence") is a feature of the [[Headquarters]] that unlocks upon reaching [[Military Tier]] 4 and finishing the associated software. It is an extremely versatile tool that allows the user to automate almost any task in the game.
-To use the AI you have to create AI scripts in the headquarters, or obtain import codes for scripts that other players have written.  For more information on learning how to create scripts, see [[Using the AI]]. For a list of available scripts, see the [https://github.com/cl1694/AI-Script-Compendium AI Script Compendium].
+Compared to workers, AI scripts are far more versatile as they can interact with almost every system in the game and even for systems for which there is no current APIs that the AI could use to interact it can always perform mouse clicks to simulate such behavior. This is currently limited as the AI can only click on in-game UI buttons so things like region [[artifacts]] must still be performed manually, additionally the AI cannot perform right or middle mouse clicks. However AI cannot run while the game is closed (or more accurately during the simulated time when opening a save file) or interact with buildings which are not open. Workers can do both of these things, appear before AI (MT1 rather than MT4) and are far simpler to use without community assistance so while AI may have more power to automate the game, neither is a replacement for the other.
 ==AI Scripts==
@@ Line 94: / Line 100: @@
 **Sets the sprite inside the window with the id <code>str identifier</code> of the button/image with the id <code>str id</code> to <code>str sprite</code>.
 *Window: Set Visibility
 **Set the window with id <code>str id</code> to visible if <code>bool condition</code> is true. Otherwise it will be hidden.
 *Window: Set Child Visibility
 **Set child of window with id <code>str id</code> with id <code>str id</code> to visible if <code>bool condition</code> is true. Otherwise window will be hidden.
 *Window: Set Position
 **Changes the position of the window with id <code>str id</code> to <code>vector x, y</code> based on the anchor of its root element. Per default the anchor is set to the center of the window and 0,0 represents the center of the screen.
@@ Line 102: / Line 108: @@
 **Destroys the window with the unique identifier <code>str id</code>.
 *Window: Destroy All
 **Destroys all active windows.
 *Tower: Use (Instantly)
 **Orders the Tower to use the [[Modules]] at slot <code>int slot</code> where slot 1 refers to the module at the very top of the skill menu. Entering an invalid slot will do nothing.
@@ Line 110: / Line 116: @@
 **Restarts the current [[Tower Testing]] run. Can only be can only be executing during or at the end of a run that took equal or longer than a second.
 *Tower: Exit
 **Exits the current Tower Testing run.
 *Software: Toggle
 **Enables software <code>software</code> if the condition <code>bool condition</code> is true or disables it if the condition is false.
 *Era: Disable Power
 **Tries to disable the era powers of <code>element</code> enemies by purchasing the according upgrade using xp.
@@ Line 118: / Line 124: @@
 **Attempts to upgrade the era <code>str (damage, health)</code> divider a total of <code>int x</code> times by using xp.
 *Infinity: Secure Module
 **Attempts to secure the module with id  <code>str id</code> to prevent enemies from mimicking it during the infinity phase.
 *Town: Open Window
 **Opens the <code>str building</code> window if <code>bool condition</code>is True, otherwise it will be closed. Opening or closing windows this way does not play the transition animation!
@@ Line 127: / Line 133: @@
 **Sets the paused state of all workers in group <code>int group</code> to <code>bool value</code>. (Click on the parameter to see which color belongs to which group id.)
 *Workers: Toggle
 **Toggles the paused state of all workers with name <code>str name</code>.
 *Workers: Pause
 **Sets the paused state of all workers with the name <code>str name</code> to <code>bool value</code>.
 *Workers: Assign Group
 **Assigns the task with id <code>str id</code> and optional parameter <code>int param</code> (0 is the leftmost) to all workers in group <code>int group</code>. (Click on the groups parameter to see which color belongs to which group.)
 *Workers: Assign
 **Assigns Task with ID <code>str id</code> and optional parameter <code>int param</code> (0 is the leftmost) to all workers with the name <code>str name</code>.

@@ Line 229: / Line 229: @@
 |509||10||2||1
 |-
-|4056||11||2||1
+|4056||11||2||2
 |-
-|32361||12||2||1
+|32361||12||2||2
 |-
-|2.5823e5||13||2||1
+|2.5823e5||13||2||2
 |-
 |2.0607e6||14||2||2