Lua AI Legacy Methods Howto - Revision history

Celtic Minstrel: Use syntax highlighting

2022-11-11T03:48:06Z

Use syntax highlighting

Celtic Minstrel: /* Lua AI Setup */ Use syntax highlighting

2022-11-11T03:43:29Z

Lua AI Setup: Use syntax highlighting

← Older revision		Revision as of 03:43, 11 November 2022
Line 16:		Line 16:
	Unlike Formula AI and the default ''cpp'' AI, Lua AI requires an engine to be defined (this is obsolete). Specifically, it does not work in [modify_side]. Here is an example of such an [ai] tag:		Unlike Formula AI and the default ''cpp'' AI, Lua AI requires an engine to be defined (this is obsolete). Specifically, it does not work in [modify_side]. Here is an example of such an [ai] tag:

	<~~div style~~=~~"height: 250px; overflow:auto"~~>		<syntaxhighlight lang=wml>
	[ai]		[ai]
	version=10710		version=10710
Line 55:		Line 55:
	[/stage]		[/stage]
	[/ai]		[/ai]
	</~~div~~>		</syntaxhighlight>

	Note that a lot of this is simply setting up the default ''main_loop'' stage and candidate actions. The important non-default lines are:		Note that a lot of this is simply setting up the default ''main_loop'' stage and candidate actions. The important non-default lines are:
Line 66:		Line 66:

	The remaining custom lines are setting up the custom candidate actions at the end of the code, which call the ''move_unittype_eval()'' and ''move_unittype_exec()'' functions. These are defined in the ''luaai-demo_engine.lua'' file that is included in the [engine] tag:		The remaining custom lines are setting up the custom candidate actions at the end of the code, which call the ''move_unittype_eval()'' and ''move_unittype_exec()'' functions. These are defined in the ''luaai-demo_engine.lua'' file that is included in the [engine] tag:
	<~~div style~~=~~"height: 250px; overflow:auto"~~>		<syntaxhighlight lang=lua>
	return {		return {
	init = function(ai)		init = function(ai)
Line 123:		Line 123:
	end		end
	}		}
	</~~div~~>		</syntaxhighlight>

	These functions set up and return a Lua table called ''luaai_demo'' which contains two functions ''move_unittype_eval()'' and ''move_unittype_exec()''. These are the evaluation and execution functions that are called by the custom AI candidate actions.		These functions set up and return a Lua table called ''luaai_demo'' which contains two functions ''move_unittype_eval()'' and ''move_unittype_exec()''. These are the evaluation and execution functions that are called by the custom AI candidate actions.

Mattsc: Add 'see also' link

2016-02-25T14:17:45Z

Add 'see also' link

← Older revision		Revision as of 14:17, 25 February 2016
Line 369:		Line 369:
	shows all the default Lua AI functions -- assuming that the ''ai'' variable has been initialized.		shows all the default Lua AI functions -- assuming that the ''ai'' variable has been initialized.


			'''See also:''' [[Wesnoth_AI]]
	[[Category:AI]]		[[Category:AI]]

Mattsc: Some changes to introduction

2016-02-23T19:57:48Z

Some changes to introduction

← Older revision		Revision as of 19:57, 23 February 2016
Line 2:		Line 2:
	\|'''Warning'''		\|'''Warning'''
	\|-		\|-
	\|This page describes some of the old methods available for setting up Lua AI functionality. They are still working and described here because quite a bit of existing code still uses them. ~~It is~~, ~~however, generally not recommended to use these methods for new code any more. Use those described at~~ [[Creating_Custom_AIs]] instead.		\|This page describes some of the old methods available for setting up Lua AI functionality. They are still working and described here because quite a bit of existing code still uses them. However, [[Creating_Custom_AIs\|a new method]] is now available for this and should be used instead for new AI development.
	Also note that this page is not being updated any more.		Also note that this page is not being updated any more.
	\|}		\|}

	~~This page is meant as a practical guide how to set up and test~~ Lua AI functionality in a scenario. It does not give a complete description of Lua or Lua AI. See [[LuaAI]] or [[LuaWML]] for that. Make sure you have read [[General RCA AI Howto]] as a basic understanding of the purpose of AI engines, stages and candidate actions is assumed here.		==Lua AI Setup==

	Also note that we do not explain all the different ways of setting things up here. Instead, we focus on one specific method that works reasonably well. Using variations thereof will hopefully be straightforward once the principles are understood.		This page is meant as a practical guide for setting up and testing Lua AI functionality in a scenario. It does not give a complete description of Lua or Lua AI. See [[LuaAI]] or [[LuaWML]] for that. Also note that we do not explain all the different ways of setting things up here. Instead, we focus on one specific method that works reasonably well. Using variations thereof will hopefully be straightforward once the principles are understood.

	~~==Lua AI Setup==~~

	Setting up a Lua AI requires the definition of a Lua AI engine in the [side] tag and one or more stages executing the individual AI actions. We restrict ourselves here to the example of using the default ''main_loop'' stage with its candidate actions.		Setting up a Lua AI requires the definition of a Lua AI engine in the [side] tag and one or more stages executing the individual AI actions. We restrict ourselves here to the example of using the default ''main_loop'' stage with its candidate actions.

Mattsc: /* A Few More Useful Tidbits */ update a link

2016-02-23T19:47:12Z

A Few More Useful Tidbits: update a link

← Older revision		Revision as of 19:47, 23 February 2016
Line 366:		Line 366:
	== A Few More Useful Tidbits ==		== A Few More Useful Tidbits ==

	* Setting up aspects and goals/targets is described at [[LuaAI~~#Aspects~~]] and not repeated here		* Setting up aspects and goals/targets is described at [[LuaAI]] and not repeated here
	* ''debug_utils'' from [http://forum.wesnoth.org/viewtopic.php?f=58&t=28320&start=45 Wesnoth Lua Pack] is a very powerful tool to analyze what is going on when something is not working as expected. It can be used to display the content of essentially any Wesnoth Lua data structure. As an example, the following command:		* ''debug_utils'' from [http://forum.wesnoth.org/viewtopic.php?f=58&t=28320&start=45 Wesnoth Lua Pack] is a very powerful tool to analyze what is going on when something is not working as expected. It can be used to display the content of essentially any Wesnoth Lua data structure. As an example, the following command:
	debug_utils.dbms(ai, false, "variable", false)		debug_utils.dbms(ai, false, "variable", false)

Mattsc: /* Adding / Deleting Stages and Candidate Actions */ Remove a section with content that is now available elsewhere (and not specific to Lua AI)

2016-02-23T19:45:25Z

Adding / Deleting Stages and Candidate Actions: Remove a section with content that is now available elsewhere (and not specific to Lua AI)

← Older revision		Revision as of 19:45, 23 February 2016
Line 363:		Line 363:

	where we assume that a ''my_ai:do_moves()'' function is defined in the engine. In that case, the only difference is that the evaluation functions are now not separated from the execution functions on the stage/candidate action level, but that both are taken care of by the ''do_moves()'' function.		where we assume that a ''my_ai:do_moves()'' function is defined in the engine. In that case, the only difference is that the evaluation functions are now not separated from the execution functions on the stage/candidate action level, but that both are taken care of by the ''do_moves()'' function.

	~~== Adding / Deleting Stages and Candidate Actions ==~~

	While the Lua AI engine needs to be defined at the beginning of the scenario in the [[SideWML\|[side]]] tag, stages and candidate actions can be added and removed at any time in the scenario. A large number of macros are available in [http://www.wesnoth.org/macro-reference.html#file:ai.cfg core/macros/ai.cfg] for this purpose.

	~~Here are two code examples of deleting candidate actions from the default RCA AI stage. The first is done right at the beginning during the side definition:~~

	~~[side]~~
	~~side=2~~
	~~{ai/aliases/stable_singleplayer.cfg}~~
	~~[ai]~~
	~~{MODIFY_AI_DELETE_CANDIDATE_ACTION 2 main_loop recruitment}~~
	~~{MODIFY_AI_DELETE_CANDIDATE_ACTION 2 main_loop move_leader_to_keep}~~
	~~[/ai]~~
	~~[/side]~~

	~~The second is done in an event:~~
	~~[side]~~
	~~side=2~~
	~~{ai/aliases/stable_singleplayer.cfg}~~
	~~[/side]~~
	~~[event]~~
	~~name=some_event~~
	~~{MODIFY_AI_DELETE_CANDIDATE_ACTION 2 main_loop recruitment}~~
	~~{MODIFY_AI_DELETE_CANDIDATE_ACTION 2 main_loop move_leader_to_keep}~~
	~~[/side]~~

	== A Few More Useful Tidbits ==		== A Few More Useful Tidbits ==

Mattsc: /* Using the Lua Stage */ update a link

2016-02-23T19:42:24Z

Using the Lua Stage: update a link

← Older revision		Revision as of 19:42, 23 February 2016
Line 344:		Line 344:
	== Using the Lua Stage ==		== Using the Lua Stage ==

	If the candidate action evaluation mechanism of the RCA AI stage is not needed, Lua AI moves can also be programmed in separate [[~~LuaAI~~#~~Stages~~\|Lua stages]], either in place of or in addition to the RCA AI stage:		If the candidate action evaluation mechanism of the RCA AI stage is not needed, Lua AI moves can also be programmed in separate [[Wesnoth_AI_Framework#Lua_stage\|Lua stages]], either in place of or in addition to the RCA AI stage:

	[stage]		[stage]

Mattsc: /* Behavior (Sticky) Candidate Actions */ remove a link which does not exist any more

2016-02-23T19:39:33Z

Behavior (Sticky) Candidate Actions: remove a link which does not exist any more

← Older revision		Revision as of 19:39, 23 February 2016
Line 310:		Line 310:
	== Behavior (Sticky) Candidate Actions ==		== Behavior (Sticky) Candidate Actions ==

	~~[[LuaAI#Behavior.28sticky.29_candidate_actions\|~~Behavior (Sticky) Candidate Actions]] (BCAs) are entirely equivalent to "normal" CAs except that they are specifically tied to a unit. As such, the BCA is removed when the unit dies. This has two advantages:		Behavior (Sticky) Candidate Actions (BCAs) are entirely equivalent to "normal" CAs except that they are specifically tied to a unit. As such, the BCA is removed when the unit dies. This has two advantages:
	# The BCA code does not need to include checks whether the unit exists		# The BCA code does not need to include checks whether the unit exists
	# No computation time is taken up for evaluating the BCA after the unit dies (although that is likely a very small amount of time saved)		# No computation time is taken up for evaluating the BCA after the unit dies (although that is likely a very small amount of time saved)

Mattsc: Remove a link to obsolete page

2016-02-23T17:27:01Z

Remove a link to obsolete page

← Older revision		Revision as of 17:27, 23 February 2016
Line 6:		Line 6:
	\|}		\|}

	This page is meant as a practical guide how to set up and test Lua AI functionality in a scenario. It does not give a complete description of Lua or Lua AI. See [[LuaAI~~]], [[LuaAI Functions~~]] or [[LuaWML]] for that. Make sure you have read [[General RCA AI Howto]] as a basic understanding of the purpose of AI engines, stages and candidate actions is assumed here.		This page is meant as a practical guide how to set up and test Lua AI functionality in a scenario. It does not give a complete description of Lua or Lua AI. See [[LuaAI]] or [[LuaWML]] for that. Make sure you have read [[General RCA AI Howto]] as a basic understanding of the purpose of AI engines, stages and candidate actions is assumed here.

	Also note that we do not explain all the different ways of setting things up here. Instead, we focus on one specific method that works reasonably well. Using variations thereof will hopefully be straightforward once the principles are understood.		Also note that we do not explain all the different ways of setting things up here. Instead, we focus on one specific method that works reasonably well. Using variations thereof will hopefully be straightforward once the principles are understood.

Mattsc: Update internal links

2016-02-23T17:22:57Z

Update internal links

← Older revision		Revision as of 17:22, 23 February 2016
Line 156:		Line 156:
	* The AI to be initialized, but the player having control of the side		* The AI to be initialized, but the player having control of the side
	* A right-click menu option to run Lua engine code		* A right-click menu option to run Lua engine code
	* Specific attention is needed if the [[~~Lua_AI_Howto~~#The_data_Variable\|''data'' variable]] is to be used		* Specific attention is needed if the [[#The_data_Variable\|''data'' variable]] is to be used

	=== Initializing the AI ===		=== Initializing the AI ===
Line 298:		Line 298:
	==== Setting up the ''data'' Variable ====		==== Setting up the ''data'' Variable ====

	Note that the [[~~Lua_AI_Howto~~#The_data_Variable\|''data'' variable]] is not set up in this testing environment, because it gets added by the engine to the '''local''' variable ''my_ai'' that is not available outside the engine. If ''data'' is needed, there are two ways of dealing with this:		Note that the [[#The_data_Variable\|''data'' variable]] is not set up in this testing environment, because it gets added by the engine to the '''local''' variable ''my_ai'' that is not available outside the engine. If ''data'' is needed, there are two ways of dealing with this:

	# Make ''my_ai'' a global variable for testing. This requires setting it up with 'my_ai = {}' in the preload event, and deleting the 'local' in front of ''my_ai'' in the engine definition as well as in the file '~add-ons/LuaAI_tests/lua_manual.lua' (or deleting it entirely from the latter).		# Make ''my_ai'' a global variable for testing. This requires setting it up with 'my_ai = {}' in the preload event, and deleting the 'local' in front of ''my_ai'' in the engine definition as well as in the file '~add-ons/LuaAI_tests/lua_manual.lua' (or deleting it entirely from the latter).