FormulaAI - Revision history

Egallager: move Howto to new "See Also" section

2023-04-07T15:21:39Z

move Howto to new "See Also" section

Egallager: "See Also" should be its own section

2023-04-07T15:21:05Z

"See Also" should be its own section

Celtic Minstrel: Delete information moved to Wesnoth Formula Language - note, this also removes some examples, some of which potentially could have been useful?

2016-03-10T05:22:48Z

Delete information moved to Wesnoth Formula Language - note, this also removes some examples, some of which potentially could have been useful?

Mattsc: Add 'see also' link

2016-02-25T14:16:14Z

Add 'see also' link

Mattsc at 04:27, 23 February 2016

2016-02-23T04:27:27Z

Mattsc at 04:25, 23 February 2016

2016-02-23T04:25:01Z

JaMiT: category change

2012-12-19T03:37:58Z

category change

AI: /* Available variables */

2012-07-25T01:22:06Z

‎Available variables

Mattsc: /* Summary : a typical AI turn */

2011-11-25T20:57:13Z

‎Summary : a typical AI turn

Mattsc: /* Syntax */

2011-11-25T20:52:23Z

‎Syntax

@@ Line 5: / Line 5: @@
 That applies to both the code and these wiki pages.
 |}
 == Overview ==
@@ Line 363: / Line 361: @@
 * [[Wesnoth_AI]]
 * [[FormulaAI/Replacing]]
 [[Category:AI]]

← Older revision		Revision as of 15:21, 7 April 2023
Line 360:		Line 360:


−	~~'''~~See ~~also:'''~~ [[Wesnoth_AI]]	+	==See Also==
		+	* [[Wesnoth_AI]]
		+	* [[FormulaAI/Replacing]]
		+
	[[Category:AI]]		[[Category:AI]]

@@ Line 204: / Line 204: @@
 Note that this means that you have to explicitely call "fallback" or set up the RCA AI ''main_loop'' stage specifically, if you want the C++ AI to finish your moves after a side-wide formula.  Also note that the stages are executed in the order in which they are put into the [ai] tag, not in the order of the above list.
-== Formula Basics ==
+== AI Formula Language ==
-Above example returns
+For a detailed coverage of the language itself, see [[Wesnoth Formula Language]]. This section covers some things specific to the use of the language in FormulaAI.
 === Overview ===
@@ Line 330: / Line 258: @@
 * ''map'' all the data about the map
-=== Built-in functions ===
+=== Functions ===
-=== Custom Functions ===
+* The formula language contains a large number of built-in functions which allow you to carry out all kinds of complex tasks. List of these functions, usage and simple examples can be found [[FormulaAI_Functions|here]].
-* You can define your own functions. A function is a formula which takes some inputs as parameters. Suppose we wanted to define a function that puts some value on a unit, we might add the following to the [ai] tag:
+* You can define your own functions in WML. A function is a formula which takes some inputs as parameters. Suppose we wanted to define a function that puts some value on a unit, we might add the following to the [ai] tag:
   [function]
@@ Line 371: / Line 298: @@
 allows us to access leader info by simply writing 'my_leader'
-* You can also use 'def' [[#Keywords|keyword]] to define custom functions
+=== Files and formulas ===
 You can easily split your formulas between different files and include them when necessary. For example:

@@ Line 422: / Line 422: @@
 creates a function sum taking two arguments and returns their sum.
 == Files and formulas ==
@@ Line 485: / Line 484: @@
 You should now have some nice highlighting and be able to easily navigate through formula, enjoy!
 [[Category:AI]]

@@ Line 5: / Line 5: @@
 That applies to both the code and these wiki pages.
 |}
 == Overview ==

← Older revision		Revision as of 04:25, 23 February 2016
Line 1:		Line 1:
		+	{\| class="wikitable" style="text-align: center;"
		+	\|'''Warning'''
		+	\|-
		+	\|Formula AI is still functional for the time being, but it is not maintained any more.
		+	That applies to both the code and these wiki pages.
		+	\|}
		+
	== Overview ==		== Overview ==

← Older revision		Revision as of 03:37, 19 December 2012
Line 476:		Line 476:
	You should now have some nice highlighting and be able to easily navigate through formula, enjoy!		You should now have some nice highlighting and be able to easily navigate through formula, enjoy!

−	[[Category:~~Development]]~~	+	[[Category:AI]]
−
−
−	~~[[Category:Development~~]]

@@ Line 295: / Line 295: @@
 * ''attacks'' a list of all possible attacks
-NOTE: this variable returns a list of all possible attacks (including attack combinations - attacking a single enemy unit with several units) , which is immediately treated as list of attack orders, which is evaluated (so, evaluation of this variable results in attacks being made). If you want to get the list without such evaluation, wrap it inside the array, "[attacks]". If you want to get the first attack, wrap it inside the array twice, "[[attacks[0]]"
+NOTE: this variable returns a list of all possible attacks (including attack combinations - attacking a single enemy unit with several units) , which is immediately treated as list of attack orders, which is evaluated (so, evaluation of this variable results in attacks being made). If you want to get the list without such evaluation, wrap it inside the array, "[attacks]". If you want to get the first attack, wrap it inside the array twice, "[[attacks[0]]]"
 * ''my_attacks'' a list of all possible attacks. It returns slightly different list then ''attacks''. I.e. when only two units (attacker and dedenter) are on the board ''attacks'' return one attack, from the position with the highest defence and ''my_attacks'' returns all 6 attacks from all adjacent tiles.

@@ Line 193: / Line 193: @@
 * Turn is ended.
-Note that this means that you have to explicitely call "fallback" if you want the C++ AI to finish your moves after a side-wide formula
+Note that this means that you have to explicitely call "fallback" or set up the RCA AI ''main_loop'' stage specifically, if you want the C++ AI to finish your moves after a side-wide formula.  Also note that the stages are executed in the order in which they are put into the [ai] tag, not in the order of the above list.
 == Formula Basics ==

@@ Line 138: / Line 138: @@
 ==== Syntax ====
-to add a new candidate move you should add '''[register_candidate_move]''' blocks within the '''[ai]''' block.
+To add a new candidate move to the RCA AI ''main_loop'' stage, use the following syntax:
-Each block will describe a candidate move and must have the following fields
+       [ai]
 * ''name'' : the name of this candidate block
@@ Line 146: / Line 176: @@
 * ''evaluation'' : a formula returning an integer. This number reflects how good the move is compared to other moves. Values of zero will mean the move is not a good idea and should be skipped
 * ''action'' : A formula that will be called if that candidate move is the best one
 ==== Candidate move types ====