The Battle for Wesnoth Wiki - Recent changes [en]

DirectActionsWML

Shiki — Tue, 27 Oct 2026 00:04:40 GMT

[tunnel]: Add an example for delayed_variable_substitution

← Older revision		Revision as of 00:04, 27 October 2026
Line 570:		Line 570:
	* '''allow_vision''': (boolean, default: yes) {{DevFeature1.13\|6}} If no, vision through a tunnel is not possible. Note that in that case the tunnel cannot be used if the tunnel exit is under shroud (which previously was ''always'' the case).		* '''allow_vision''': (boolean, default: yes) {{DevFeature1.13\|6}} If no, vision through a tunnel is not possible. Note that in that case the tunnel cannot be used if the tunnel exit is under shroud (which previously was ''always'' the case).
	* '''pass_allied_units''': (boolean, default: yes) {{DevFeature1.13\|6}} If no, allied (including own) units on the exit hex block a tunnel.		* '''pass_allied_units''': (boolean, default: yes) {{DevFeature1.13\|6}} If no, allied (including own) units on the exit hex block a tunnel.
	* '''delayed_variable_substitution''' (boolean, default: yes): If yes, the WML block contained in this [tunnel] is not variable-substituted at execution time of the event where this [tunnel] is within. Instead, variables are substituted when the tunnel is used by a unit. See [[EventWML#Nested_Events]]		* '''delayed_variable_substitution''' (boolean, default: yes): If yes, the WML block contained in this [tunnel] is not variable-substituted at execution time of the event where this [tunnel] is within. Instead, variables are substituted when the tunnel is used by a unit. See [[EventWML#Nested_Events\|Nested_Events]]. For example, you should disable this, when this tag is used inside a [[ConditionalActionsWML#.5Bfor.5D\|for]] loop and you want to use the $i variable for the tunnel's coordinates.

	(Note: The tunnel tag can also be used inside the [[AbilitiesWML\|[teleport]]] ability, without remove= and id=).		(Note: The tunnel tag can also be used inside the [[AbilitiesWML\|[teleport]]] ability, without remove= and id=).

Screenshots

Pentarctagon — Mon, 26 Oct 2026 04:36:49 GMT

← Older revision		Revision as of 04:36, 26 October 2026
Line 1:		Line 1:
			== Wesnoth 1.20 ==

	== Wesnoth 1.18 ==		== Wesnoth 1.18 ==
	<center>		<center>

DirectActionsWML

Shiki — Sun, 25 Oct 2026 17:52:56 GMT

[remove_trait]: Can't remove must_have traits

← Older revision		Revision as of 17:52, 25 October 2026
Line 340:		Line 340:
	* [[StandardUnitFilter]]: All units on the map (but not the recall list) matching the filter have matching traits removed. Use no [filter] tag.		* [[StandardUnitFilter]]: All units on the map (but not the recall list) matching the filter have matching traits removed. Use no [filter] tag.
	* '''trait_id''': The id of the trait to be removed. See [[UnitsWML#.5Btrait.5D\|[trait]]].		* '''trait_id''': The id of the trait to be removed. See [[UnitsWML#.5Btrait.5D\|[trait]]].

			If the trait is a must_have trait for the unit_type, it will be re-added immediately at the end of the trait list.

	=== [remove_shroud] ===		=== [remove_shroud] ===

User:Knyghtmare

Knyghtmare — Wed, 21 Oct 2026 15:43:06 GMT

Maintainer

← Older revision		Revision as of 15:43, 21 October 2026
Line 23:		Line 23:
	===Maintainer===		===Maintainer===
	*Forward They Cried [FTC]		*Forward They Cried [FTC]
	*An Orcish Incursion [AOI]
	*The [https://wiki.wesnoth.org/Timeline_of_Ancient_Irdya_(Un-official) Dark Irdya Timeline] wiki page. I update this like every few months or so, after a new episode/sequel campaign is ready to be added into it.		*The [https://wiki.wesnoth.org/Timeline_of_Ancient_Irdya_(Un-official) Dark Irdya Timeline] wiki page. I update this like every few months or so, after a new episode/sequel campaign is ready to be added into it.

Template:Extension DPL

Maintenance script — Wed, 21 Oct 2026 15:10:39 GMT

Maintenance script deleted page Template:Extension DPL Removing obsolete content-inclusion template (no longer used starting with DynamicPageList4).

LotI Walkthrough-Part1-Chapter03

WarDead0 — Wed, 14 Oct 2026 21:42:49 GMT

Entering the Desert

← Older revision		Revision as of 21:42, 14 October 2026
Line 54:		Line 54:

	'''[Thrash]''' You can get away without recruiting/recalling, but it is a good chance to harvest some XP. And as WHU notes, you can now recruit mages, so it's a good time to take advantage of that. The enemies with the petrify attack are nearly invisible, so keep a close eye out for them. Petrify doesn’t seem to be curable except by potion? There are two items in SW part of map.		'''[Thrash]''' You can get away without recruiting/recalling, but it is a good chance to harvest some XP. And as WHU notes, you can now recruit mages, so it's a good time to take advantage of that. The enemies with the petrify attack are nearly invisible, so keep a close eye out for them. Petrify doesn’t seem to be curable except by potion? There are two items in SW part of map.

			'''[WD0]''' There are a lot of mostly L1 isolated units scattered around the desert, useful for increasing souleater count or giving experience to low-level units, although traversing the desert is usually slow for them. Possible Beelzebub monument at 43,39, east of the road over the first mountain range. Clear out all the nearby monsters first otherwise the flies will eat all that experience.

	==The Pit==		==The Pit==

LotI Walkthrough

WarDead0 — Tue, 13 Oct 2026 00:43:59 GMT

Antagonists: minor edits

EditingWesnoth

Ancestral — Sun, 11 Oct 2026 07:06:54 GMT

macOS: Path to add-ons is incorrect now. Not sure when it changed?

← Older revision		Revision as of 07:06, 11 October 2026
Line 74:		Line 74:
	==== macOS ====		==== macOS ====

			* <b>Recent versions of Wesnoth:</b> ~/Library/Containers/The Battle for Wesnoth/Data/Library/Application Support/Wesnoth_<version>
	* <b>Wesnoth 1.14.6 and later:</b> ~/Library/Containers/org.wesnoth.Wesnoth/Data/Library/Application Support/Wesnoth_<version>		* <b>Wesnoth 1.14.6 and later:</b> ~/Library/Containers/org.wesnoth.Wesnoth/Data/Library/Application Support/Wesnoth_<version>
	* <b>Older versions:</b> ~/Library/Application Support/Wesnoth_<version>		* <b>Older versions:</b> ~/Library/Application Support/Wesnoth_<version>

A Song of Fire Walkthrough

Whitestarmeow — Mon, 05 Oct 2026 09:15:35 GMT

← Older revision		Revision as of 09:15, 5 October 2026
Line 474:		Line 474:

	Scouting the eastern part of the map will trigger the appearance of a friendly Hannuk leader, Tarkyn, and two hostile leaders to the north and south of him. Make sure you are ready before doing this, because Tarkyn's death causes a defeat and the two enemy sides will overwhelm him quickly if you aren't nearby to reinforce. Myra can use the keeps in the outer edges of Tarkyn's fortress to recruit reinforcements if needed.		Scouting the eastern part of the map will trigger the appearance of a friendly Hannuk leader, Tarkyn, and two hostile leaders to the north and south of him. Make sure you are ready before doing this, because Tarkyn's death causes a defeat and the two enemy sides will overwhelm him quickly if you aren't nearby to reinforce. Myra can use the keeps in the outer edges of Tarkyn's fortress to recruit reinforcements if needed.

			'''[WSM]''' Some enemy leaders in exploring scenario spawn when we approach their castle. Tactically we may send some fast unit to occupy their spawn point to prevent them from recruiting. But doing so needs to read WML or play very slow/SL, it's not recommended.
			In current version, defeating ogre leader can retrieve about 200 gold. But we should still go upward after defeating the first leader.

	===S17 Ashes of the War===		===S17 Ashes of the War===
Line 479:		Line 482:

	This is a very easy XP gathering scenario, good for leveling Windsong savants/arbiters. Get some leveled dwarves and/or leveled furnace beasts and move everyone into the central mountains. The undead army will reach you at around dawn, and you can then demolish most of them during the day. Use Myra's soul explosion attack to finish off Assix, otherwise he'll just heal back to full.		This is a very easy XP gathering scenario, good for leveling Windsong savants/arbiters. Get some leveled dwarves and/or leveled furnace beasts and move everyone into the central mountains. The undead army will reach you at around dawn, and you can then demolish most of them during the day. Use Myra's soul explosion attack to finish off Assix, otherwise he'll just heal back to full.

			'''[WSM]''' You may also kill Assix by someone other than Myra to farm some XP.

	===S18 Besieged===		===S18 Besieged===
Line 486:		Line 491:

	The northeastern leader should come out to attack your units on the wall, so on turn 3 you should be able to kill him and most of his units. After that most of your units should rush south toward the other leader, because the western and central armies will be catching up since your units blocking the bridge are probably dead. Hold off the western forces with either some durable units (dwarvish lords/stone titans) or cannon fodder (Hannuk wood hunters have 70% defense in castles/villages, so with luck they can soak up some charioteer attacks), while some powerful veterans like dwarvish lords and lava behemoths force their way south to the last leader.		The northeastern leader should come out to attack your units on the wall, so on turn 3 you should be able to kill him and most of his units. After that most of your units should rush south toward the other leader, because the western and central armies will be catching up since your units blocking the bridge are probably dead. Hold off the western forces with either some durable units (dwarvish lords/stone titans) or cannon fodder (Hannuk wood hunters have 70% defense in castles/villages, so with luck they can soak up some charioteer attacks), while some powerful veterans like dwarvish lords and lava behemoths force their way south to the last leader.

			'''[WSM]''' You may also defeat the dragon leader to win this scenario.

	===S19 Fires of Hope===		===S19 Fires of Hope===
Line 508:		Line 515:

	Once you survive the first wave, the scenario becomes easier - the reinforcements which come later will be much weaker than the initial wave, and a large portion of them will have gone east to fight the mermen.		Once you survive the first wave, the scenario becomes easier - the reinforcements which come later will be much weaker than the initial wave, and a large portion of them will have gone east to fight the mermen.

			'''[WSM]''' The hills near (3, 43) is perfect defence terrain when using dwarves and stone titans. If you feel hard to fight drakes in vast plain, recruiting a bunch of Dwarvish Thunderguards and stone titans and hiding all units in the hill can be very easy to win.

	===S20 Ring of Fire===		===S20 Ring of Fire===
Line 517:		Line 526:

	Heading south past some simian enemies, you'll come to a large lake with some naga enemies and friendly mermen. There are three naga leaders: one in the northeast of the lake, on in the southeast, and one way in the south. There are some small keeps in the water where Myra can recall reinforcements such as water elementals or other flying units such as Windsong couriers. The ally is actually quite powerful and should do a good job weakening the enemies for you to finish off. It's possible to finish very early for a huge gold bonus.		Heading south past some simian enemies, you'll come to a large lake with some naga enemies and friendly mermen. There are three naga leaders: one in the northeast of the lake, on in the southeast, and one way in the south. There are some small keeps in the water where Myra can recall reinforcements such as water elementals or other flying units such as Windsong couriers. The ally is actually quite powerful and should do a good job weakening the enemies for you to finish off. It's possible to finish very early for a huge gold bonus.

			'''[WSM]''' I don't think this scenario very easy. Nagas inflict poison(to ally mermen leader) and have a nice evasion, most of our units cannot move very fast in water especially none of water element was trained in previous scenarios. So play with Windsong Couriers may be better.

	===S21 The Will of the Naiad===		===S21 The Will of the Naiad===
Line 542:		Line 553:

	The large forest in the southeast is perfect for Hannuk wood hunters and their advancements. The celestials are quite powerful so it helps to recruit some expendable wood hunters to slow as many units as possible. Dwarvish lords also have good forest mobility and are very durable, and as usual Myra can act as the ultimate blocking unit.		The large forest in the southeast is perfect for Hannuk wood hunters and their advancements. The celestials are quite powerful so it helps to recruit some expendable wood hunters to slow as many units as possible. Dwarvish lords also have good forest mobility and are very durable, and as usual Myra can act as the ultimate blocking unit.

			'''[WSM]''' Staying in ally's fort and wait celestials to fight with some minotaurs is considerable. Maybe some minotaur berserker would fight with them.

	===S24 The Sun Path===		===S24 The Sun Path===
Line 584:		Line 597:

	Once dawn/day comes you should easily wipe out most of the enemies - the human recruits do tremendous damage under Myra or Ravyan's leadership. Then you can split your army in half to take care of the two enemy leaders.		Once dawn/day comes you should easily wipe out most of the enemies - the human recruits do tremendous damage under Myra or Ravyan's leadership. Then you can split your army in half to take care of the two enemy leaders.

			'''[WSM]''' Humans are no longer recruitable in current version.

	===S28 Embers of War===		===S28 Embers of War===
Line 591:		Line 606:

	Try not to let your income go too negative, since next scenario is difficult so it will help to have good gold carryover. The southwestern orc leader will immediately flee when attacked.		Try not to let your income go too negative, since next scenario is difficult so it will help to have good gold carryover. The southwestern orc leader will immediately flee when attacked.

			'''[WSM]''' Ally leader would get out to attack if he can, we need to protect him well.

	===S29 Forging Alliances===		===S29 Forging Alliances===
Line 600:		Line 617:

	By turn 20 most of the enemies should be gone and your army can start heading south and splitting up to take out the enemy leaders. (It's not necessary to kill every leader but it's probably easier, to stop them from constantly recruiting.) Make sure to use Myra to finish off Ronak.		By turn 20 most of the enemies should be gone and your army can start heading south and splitting up to take out the enemy leaders. (It's not necessary to kill every leader but it's probably easier, to stop them from constantly recruiting.) Make sure to use Myra to finish off Ronak.

			'''[WSM]''' Although we can recruit orcs in this scenario, they will not follow Myra after all, and they fight bad when facing goblins. So I don't suggest recruiting any orc.

	===S30 Old Friends===		===S30 Old Friends===

WesnothTranslations

Elven — Sat, 03 Oct 2026 20:17:48 GMT

slovak

← Older revision		Revision as of 20:17, 3 October 2026
Line 39:		Line 39:
	\|-		\|-
	\| [[SerbianTranslation\|Serbian]] \|\| Vlastimir Krstonosic \|\| [mailto:krstonosicvlastimirATgmailDOTcom]		\| [[SerbianTranslation\|Serbian]] \|\| Vlastimir Krstonosic \|\| [mailto:krstonosicvlastimirATgmailDOTcom]
			\|-
			\| [[SlovakTranslation#Preklad\|Slovak]] \|\| Stanislav Hoferek \|\| [mailto:shoferek@gmail.com]
	\|-		\|-
	\| [[SpanishTranslation\|Spanish]] \|\| Sebastián Lecchini (Sebas38760) \|\| [mailto:sebas38760ATgmailDOTcom]		\| [[SpanishTranslation\|Spanish]] \|\| Sebastián Lecchini (Sebas38760) \|\| [mailto:sebas38760ATgmailDOTcom]
Line 74:		Line 76:
	\|-		\|-
	\| [[Scottish_Gaelic_Translation\|Scottish Gaelic]] \|\| GunChleoc \|\| [mailto:fiosAIGforamnagaidhligDOTnet]		\| [[Scottish_Gaelic_Translation\|Scottish Gaelic]] \|\| GunChleoc \|\| [mailto:fiosAIGforamnagaidhligDOTnet]
	\|-
	~~\| [[SlovakTranslation#Preklad\|Slovak]] \|\| Stanislav Hoferek \|\| [mailto:shoferek@gmail.com]~~
	\|-		\|-
	\| [[SwedishTranslation\|Swedish]] \|\| Alex Alowersson (fluxbird) \|\| [mailto:alexalowersonATgmailDOTcom]		\| [[SwedishTranslation\|Swedish]] \|\| Alex Alowersson (fluxbird) \|\| [mailto:alexalowersonATgmailDOTcom]

Micro Ais

Dalas120 — Sat, 03 Oct 2026 18:09:44 GMT

← Older revision		Revision as of 18:09, 3 October 2026
Line 1,225:		Line 1,225:

	* '''retreat_tod''' (string): This Micro AI will always retreat when badly outnumbered (e.g. 4-to-1 odds), but can also be configured to prioritize retreating at certain times of day. The following values are allowed:		* '''retreat_tod''' (string): This Micro AI will always retreat when badly outnumbered (e.g. 4-to-1 odds), but can also be configured to prioritize retreating at certain times of day. The following values are allowed:
	** '''daytime''': Useful when the AI's units are chaotic and/or its opponents are lawful.		** '''daytime''': Prefer retreating during daytime. Useful when the AI's units are chaotic and/or its opponents are lawful.
	** '''nighttime''': Useful when the AI's units are lawful and/or its opponents are chaotic.		** '''nighttime''': Prefer retreating during nighttime. Useful when the AI's units are lawful and/or its opponents are chaotic.
	** '''none''': (default) Never ~~prioritize retreating~~.		** '''none''': (default) Don't prefer retreating at any particular ToD, but still retreat when badly outnumbered.
			** '''never''': Never force a retreat. The default AI may still retreat to heal.

	* '''[filter_retreat_target]''': A Standard Unit Filter describing the unit(s) to retreat towards, and near which to prioritize engaging enemies. Defaults to all same-side leaders.		* '''[filter_retreat_target]''': A Standard Unit Filter describing the unit(s) to retreat towards, and near which to prioritize engaging enemies. Defaults to all same-side leaders.

Template:WML Tags

Octalot — Fri, 02 Oct 2026 20:37:22 GMT

Add filter_ability, link the experimental version to its renamed anchor

← Older revision		Revision as of 20:37, 2 October 2026
Line 97:		Line 97:
	[[EraWML\|era]],		[[EraWML\|era]],
	[[EventWML\|event]],		[[EventWML\|event]],
	[[StandardUnitFilter#~~filter_ability~~\|experimental_filter_ability]],		[[StandardUnitFilter#experimental_filter_ability\|experimental_filter_ability]],
	[[StandardUnitFilter#~~filter_ability_active~~\|experimental_filter_ability_active]],		[[StandardUnitFilter#experimental_filter_ability_active\|experimental_filter_ability_active]],
	[[AbilitiesWML#filter_specials\|experimental_filter_specials]],		[[AbilitiesWML#filter_specials\|experimental_filter_specials]],
	[[AnimationWML#short-extra\|extra_anim]];		[[AnimationWML#short-extra\|extra_anim]];
Line 110:		Line 110:
	[[UnitTypeWML#variation\|female]],		[[UnitTypeWML#variation\|female]],
	filter ([[FilterWML\|concept]], [[EventWML#.5Bfilter.5D\|event]]),		filter ([[FilterWML\|concept]], [[EventWML#.5Bfilter.5D\|event]]),
			[[StandardUnitFilter#filter_ability\|filter_ability]],
	[[StandardUnitFilter#filter_adjacent\|filter_adjacent]],		[[StandardUnitFilter#filter_adjacent\|filter_adjacent]],
	[[StandardLocationFilter#filter_adjacent_location\|filter_adjacent_location]],		[[StandardLocationFilter#filter_adjacent_location\|filter_adjacent_location]],

StandardUnitFilter

Octalot — Fri, 02 Oct 2026 20:35:14 GMT

Add anchor for [filter_ability], rename anchors for the experimental version

← Older revision		Revision as of 20:35, 2 October 2026
Line 61:		Line 61:
	* '''formula''': A formula using [[Wesnoth Formula Language]]. The <tt>self</tt> variable is set to the current $this_unit, and the formula should return a boolean. If it returns 0, the filter does not match. Otherwise, the filter does match. {{DevFeature1.13\|5}} If the filter has a secondary unit, the formula can access it using the <code>other</code> variable. Both the unit and the secondary unit are a '''unit object''', with keys documented [[#Wesnoth_Formula_Language\|below]]. Do not surround the formula in <code>$(...)</code>, since that will erase the <tt>self</tt> variable.		* '''formula''': A formula using [[Wesnoth Formula Language]]. The <tt>self</tt> variable is set to the current $this_unit, and the formula should return a boolean. If it returns 0, the filter does not match. Otherwise, the filter does match. {{DevFeature1.13\|5}} If the filter has a secondary unit, the formula can access it using the <code>other</code> variable. Both the unit and the secondary unit are a '''unit object''', with keys documented [[#Wesnoth_Formula_Language\|below]]. Do not surround the formula in <code>$(...)</code>, since that will erase the <tt>self</tt> variable.
	* '''lua_function''': the name of a [[LuaWML\|Lua]] function in the global environment that takes a unit as an argument and returns true if the given unit matches the filter. {{DevFeature1.13\|5}} Non-global functions can now be used here by building a dot-separated "path". Note that this is not actually interpreted as Lua code even though it superficially resembles it, so using a Lua keyword in the path will work, for example "my_filter_functions.goto" will correctly use the function which in actual Lua code would need to be referenced as <code>my_filter_functions["goto"]</code>.		* '''lua_function''': the name of a [[LuaWML\|Lua]] function in the global environment that takes a unit as an argument and returns true if the given unit matches the filter. {{DevFeature1.13\|5}} Non-global functions can now be used here by building a dot-separated "path". Note that this is not actually interpreted as Lua code even though it superficially resembles it, so using a Lua keyword in the path will work, for example "my_filter_functions.goto" will correctly use the function which in actual Lua code would need to be referenced as <code>my_filter_functions["goto"]</code>.
	* {{anchor\|~~filter_ability~~\|'''[experimental_filter_ability]'''}}: {{DevFeature1.17\|17}} [[StandardAbilityFilter]] matches if the unit has an ability with the given properties - eg, ''[experimental_filter_ability]affect_self=yes'' will match a unit with any ability with ''affect_self=yes''. {{DevFeature1.19\|5}} [experimental_filter_ability] deprecated, use [filter_ability] instead.		* {{anchor\|experimental_filter_ability\|'''[experimental_filter_ability]'''}}: {{DevFeature1.17\|17}} [[StandardAbilityFilter]] matches if the unit has an ability with the given properties - eg, ''[experimental_filter_ability]affect_self=yes'' will match a unit with any ability with ''affect_self=yes''. {{DevFeature1.19\|5}} [experimental_filter_ability] deprecated, use [filter_ability] instead.
	* {{anchor\|~~filter_ability_active~~\|'''[experimental_filter_ability_active]'''}}: {{DevFeature1.17\|17}} [[StandardAbilityFilter]] matches if the unit has an ''active'' ability with the given properties - eg, ''[experimental_filter_ability_active]affect_adjacent=yes'' will match a unit with any ''active'' ability with ''[affect_adjacent]''. The attributes checked are the same as for [experimental_filter_ability]. {{DevFeature1.19\|5}} [experimental_filter_ability_active] deprecated, use [filter_ability] instead.		* {{anchor\|experimental_filter_ability_active\|'''[experimental_filter_ability_active]'''}}: {{DevFeature1.17\|17}} [[StandardAbilityFilter]] matches if the unit has an ''active'' ability with the given properties - eg, ''[experimental_filter_ability_active]affect_adjacent=yes'' will match a unit with any ''active'' ability with ''[affect_adjacent]''. The attributes checked are the same as for [experimental_filter_ability]. {{DevFeature1.19\|5}} [experimental_filter_ability_active] deprecated, use [filter_ability] instead.
	* '''[filter_ability]''': {{DevFeature1.19\|5}} [[StandardAbilityFilter]] matches if the unit has anability with the given properties - eg, ''[filter_ability]affect_adjacent=yes'' will match a unit with any ability with ''[affect_adjacent]''.		* {{anchor\|filter_ability\|'''[filter_ability]'''}}: {{DevFeature1.19\|5}} [[StandardAbilityFilter]] matches if the unit has anability with the given properties - eg, ''[filter_ability]affect_adjacent=yes'' will match a unit with any ability with ''[affect_adjacent]''.
	** '''active''': if active=yes, matches if the unit has an ''active'' ability with the given properties, if active=no, matches if the unit has an ability with the given properties regardless of 'active' or not. '''active''' is false by default.		** '''active''': if active=yes, matches if the unit has an ''active'' ability with the given properties, if active=no, matches if the unit has an ability with the given properties regardless of 'active' or not. '''active''' is false by default.

CompatibilityBreakingChanges

Lhybrideur — Tue, 29 Sep 2026 09:41:15 GMT

Compatibility breaking (requires updates to work)

← Older revision		Revision as of 09:41, 29 September 2026
(One intermediate revision by the same user not shown)
Line 32:		Line 32:
	** ENABLE_NIGHTBLADE		** ENABLE_NIGHTBLADE
	* Parsing of << in quotes has been fixed. This means cases like '''key="<<"''' do not error anymore and cases like '''key="<<" {MACRO} ">>"''' now expand the macro.		* Parsing of << in quotes has been fixed. This means cases like '''key="<<"''' do not error anymore and cases like '''key="<<" {MACRO} ">>"''' now expand the macro.
			* Fire Guardian line images have been moved from units/monsters/ to units/monsters/fireghost/

	=== Deprecations (will continue to work for now) ===		=== Deprecations (will continue to work for now) ===

← Older revision		Revision as of 00:04, 27 October 2026
Line 570:		Line 570:
	* '''allow_vision''': (boolean, default: yes) {{DevFeature1.13\|6}} If no, vision through a tunnel is not possible. Note that in that case the tunnel cannot be used if the tunnel exit is under shroud (which previously was ''always'' the case).		* '''allow_vision''': (boolean, default: yes) {{DevFeature1.13\|6}} If no, vision through a tunnel is not possible. Note that in that case the tunnel cannot be used if the tunnel exit is under shroud (which previously was ''always'' the case).
	* '''pass_allied_units''': (boolean, default: yes) {{DevFeature1.13\|6}} If no, allied (including own) units on the exit hex block a tunnel.		* '''pass_allied_units''': (boolean, default: yes) {{DevFeature1.13\|6}} If no, allied (including own) units on the exit hex block a tunnel.
	* '''delayed_variable_substitution''' (boolean, default: yes): If yes, the WML block contained in this [tunnel] is not variable-substituted at execution time of the event where this [tunnel] is within. Instead, variables are substituted when the tunnel is used by a unit. See [[EventWML#Nested_Events]]		* '''delayed_variable_substitution''' (boolean, default: yes): If yes, the WML block contained in this [tunnel] is not variable-substituted at execution time of the event where this [tunnel] is within. Instead, variables are substituted when the tunnel is used by a unit. See [[EventWML#Nested_Events\|Nested_Events]]. For example, you should disable this, when this tag is used inside a [[ConditionalActionsWML#.5Bfor.5D\|for]] loop and you want to use the $i variable for the tunnel's coordinates.

	(Note: The tunnel tag can also be used inside the [[AbilitiesWML\|[teleport]]] ability, without remove= and id=).		(Note: The tunnel tag can also be used inside the [[AbilitiesWML\|[teleport]]] ability, without remove= and id=).

← Older revision		Revision as of 20:37, 2 October 2026
Line 97:		Line 97:
	[[EraWML\|era]],		[[EraWML\|era]],
	[[EventWML\|event]],		[[EventWML\|event]],
	[[StandardUnitFilter#~~filter_ability~~\|experimental_filter_ability]],		[[StandardUnitFilter#experimental_filter_ability\|experimental_filter_ability]],
	[[StandardUnitFilter#~~filter_ability_active~~\|experimental_filter_ability_active]],		[[StandardUnitFilter#experimental_filter_ability_active\|experimental_filter_ability_active]],
	[[AbilitiesWML#filter_specials\|experimental_filter_specials]],		[[AbilitiesWML#filter_specials\|experimental_filter_specials]],
	[[AnimationWML#short-extra\|extra_anim]];		[[AnimationWML#short-extra\|extra_anim]];
Line 110:		Line 110:
	[[UnitTypeWML#variation\|female]],		[[UnitTypeWML#variation\|female]],
	filter ([[FilterWML\|concept]], [[EventWML#.5Bfilter.5D\|event]]),		filter ([[FilterWML\|concept]], [[EventWML#.5Bfilter.5D\|event]]),
			[[StandardUnitFilter#filter_ability\|filter_ability]],
	[[StandardUnitFilter#filter_adjacent\|filter_adjacent]],		[[StandardUnitFilter#filter_adjacent\|filter_adjacent]],
	[[StandardLocationFilter#filter_adjacent_location\|filter_adjacent_location]],		[[StandardLocationFilter#filter_adjacent_location\|filter_adjacent_location]],

← Older revision		Revision as of 20:35, 2 October 2026
Line 61:		Line 61:
	* '''formula''': A formula using [[Wesnoth Formula Language]]. The <tt>self</tt> variable is set to the current $this_unit, and the formula should return a boolean. If it returns 0, the filter does not match. Otherwise, the filter does match. {{DevFeature1.13\|5}} If the filter has a secondary unit, the formula can access it using the <code>other</code> variable. Both the unit and the secondary unit are a '''unit object''', with keys documented [[#Wesnoth_Formula_Language\|below]]. Do not surround the formula in <code>$(...)</code>, since that will erase the <tt>self</tt> variable.		* '''formula''': A formula using [[Wesnoth Formula Language]]. The <tt>self</tt> variable is set to the current $this_unit, and the formula should return a boolean. If it returns 0, the filter does not match. Otherwise, the filter does match. {{DevFeature1.13\|5}} If the filter has a secondary unit, the formula can access it using the <code>other</code> variable. Both the unit and the secondary unit are a '''unit object''', with keys documented [[#Wesnoth_Formula_Language\|below]]. Do not surround the formula in <code>$(...)</code>, since that will erase the <tt>self</tt> variable.
	* '''lua_function''': the name of a [[LuaWML\|Lua]] function in the global environment that takes a unit as an argument and returns true if the given unit matches the filter. {{DevFeature1.13\|5}} Non-global functions can now be used here by building a dot-separated "path". Note that this is not actually interpreted as Lua code even though it superficially resembles it, so using a Lua keyword in the path will work, for example "my_filter_functions.goto" will correctly use the function which in actual Lua code would need to be referenced as <code>my_filter_functions["goto"]</code>.		* '''lua_function''': the name of a [[LuaWML\|Lua]] function in the global environment that takes a unit as an argument and returns true if the given unit matches the filter. {{DevFeature1.13\|5}} Non-global functions can now be used here by building a dot-separated "path". Note that this is not actually interpreted as Lua code even though it superficially resembles it, so using a Lua keyword in the path will work, for example "my_filter_functions.goto" will correctly use the function which in actual Lua code would need to be referenced as <code>my_filter_functions["goto"]</code>.
	* {{anchor\|~~filter_ability~~\|'''[experimental_filter_ability]'''}}: {{DevFeature1.17\|17}} [[StandardAbilityFilter]] matches if the unit has an ability with the given properties - eg, ''[experimental_filter_ability]affect_self=yes'' will match a unit with any ability with ''affect_self=yes''. {{DevFeature1.19\|5}} [experimental_filter_ability] deprecated, use [filter_ability] instead.		* {{anchor\|experimental_filter_ability\|'''[experimental_filter_ability]'''}}: {{DevFeature1.17\|17}} [[StandardAbilityFilter]] matches if the unit has an ability with the given properties - eg, ''[experimental_filter_ability]affect_self=yes'' will match a unit with any ability with ''affect_self=yes''. {{DevFeature1.19\|5}} [experimental_filter_ability] deprecated, use [filter_ability] instead.
	* {{anchor\|~~filter_ability_active~~\|'''[experimental_filter_ability_active]'''}}: {{DevFeature1.17\|17}} [[StandardAbilityFilter]] matches if the unit has an ''active'' ability with the given properties - eg, ''[experimental_filter_ability_active]affect_adjacent=yes'' will match a unit with any ''active'' ability with ''[affect_adjacent]''. The attributes checked are the same as for [experimental_filter_ability]. {{DevFeature1.19\|5}} [experimental_filter_ability_active] deprecated, use [filter_ability] instead.		* {{anchor\|experimental_filter_ability_active\|'''[experimental_filter_ability_active]'''}}: {{DevFeature1.17\|17}} [[StandardAbilityFilter]] matches if the unit has an ''active'' ability with the given properties - eg, ''[experimental_filter_ability_active]affect_adjacent=yes'' will match a unit with any ''active'' ability with ''[affect_adjacent]''. The attributes checked are the same as for [experimental_filter_ability]. {{DevFeature1.19\|5}} [experimental_filter_ability_active] deprecated, use [filter_ability] instead.
	* '''[filter_ability]''': {{DevFeature1.19\|5}} [[StandardAbilityFilter]] matches if the unit has anability with the given properties - eg, ''[filter_ability]affect_adjacent=yes'' will match a unit with any ability with ''[affect_adjacent]''.		* {{anchor\|filter_ability\|'''[filter_ability]'''}}: {{DevFeature1.19\|5}} [[StandardAbilityFilter]] matches if the unit has anability with the given properties - eg, ''[filter_ability]affect_adjacent=yes'' will match a unit with any ability with ''[affect_adjacent]''.
	** '''active''': if active=yes, matches if the unit has an ''active'' ability with the given properties, if active=no, matches if the unit has an ability with the given properties regardless of 'active' or not. '''active''' is false by default.		** '''active''': if active=yes, matches if the unit has an ''active'' ability with the given properties, if active=no, matches if the unit has an ability with the given properties regardless of 'active' or not. '''active''' is false by default.

← Older revision		Revision as of 00:43, 13 October 2026
(One intermediate revision by the same user not shown)
Line 28:		Line 28:

	==Recruitment, Traits, Advancement and Equipment==		==Recruitment, Traits, Advancement and Equipment==
	This is a long campaign so you should pay special attention to what units you want to advance and keep long term. Some unit types you can only recruit early on (like fencers and spearmen in Part I) so you might want to recruit a few extra in the hope of getting traits you want. Your recruits will come with the standard traits as well as possibly being ''loyal'' and/or ''highlander'' units (low chances). Some other characters you meet may have more unusual traits too, hovering your mouse over the trait will usually tell you what it does. Because gold carryover is often low (40%) it may be a good strategy is to not recruit or recall heavily at the start of a scenario but spend like crazy at the end in the hope of picking up characters with the premium ''highlander'' trait. I find gold usually not an issue after ~~a while~~ (just turn limits).		This is a long campaign so you should pay special attention to what units you want to advance and keep long term. Some unit types you can only recruit early on (like fencers and spearmen in Part I) so you might want to recruit a few extra in the hope of getting traits you want. Your recruits will come with the standard traits as well as possibly being ''loyal'' and/or ''highlander'' units (low chances). Some other characters you meet may have more unusual traits too, hovering your mouse over the trait will usually tell you what it does. Because gold carryover is often low (40%) it may be a good strategy to not recruit or recall heavily at the start of a scenario but spend like crazy at the end in the hope of picking up characters with the premium ''highlander'' trait. I find gold usually not an issue after the first few scenarios (just turn limits).

	The best generic trait for a unit to have is ''intelligent''. You will be keeping most units for many scenarios and advancing them a lot so the quicker this can happen the more sweet AMLA advancements a unit can achieve. The next best is probably ''strong'' (or ''dextrous'') as the ability to inflict more damage helps. Slow units (like dwarfs and trolls) benefit from ''quick'' instead of strong so they can keep up with the rest of your army. The ''loyal'' trait is probably overrated in my (WD0) opinion as some, particularly long scenarios, don't have any income or maintenance costs and most other scenarios are better to finish as quickly as possible. The least useful trait is ''resilient'' as it's benefits are really good for L1 units (and then equipment can replace such benefits). Obviously if you get a ''highlander'' you don't really care much what the other traits are.		The best generic trait for a unit to have is ''intelligent''. You will be keeping most units for many scenarios and advancing them a lot so the quicker this can happen the more sweet AMLA advancements a unit can achieve. The next best is probably ''strong'' (or ''dextrous'') as the ability to inflict more damage helps. Slow units (like dwarfs and trolls) benefit from ''quick'' instead of strong so they can keep up with the rest of your army. The ''loyal'' trait is probably overrated in my (WD0) opinion as some, particularly long scenarios, don't have any income or maintenance costs and most other scenarios are better to finish as quickly as possible. The least useful trait is ''resilient'' as it's benefits are really good for L1 units (and then equipment can replace such benefits). Obviously if you get a ''highlander'' you don't really care much what the other traits are.
Line 36:		Line 36:
	Finding equipment is the best way to strengthen a unit (or crafting items once you have found enough gems). Enemy units that die may randomly drop items (general units occasionally do but more likely in Part II and leaders usually always drop something) and some maps have special items placed (usually a random item). These found items may be equipped (if that unit type can use it) or stored. Stored items can be equipped in castle tiles (or during the first two turns of each scenario) except for 'limited (books) and potions that can be used any time. Some advancements make some equipped items seemingly redundant but the game currently supports the holding on to such items for continual benefit. For example, a pikeman can wield [[LotI_Items#The_Original_Trident_of_Storms_.E2.80.93_spear\|The Original Trident of Storms]], which gives them a ranged attack. If you advance these to a swordsman or halberdier they can no longer use the trident as a melee weapon but they retain the ranged attack. This can also be useful where items increase hitpoints, movement or resistances.		Finding equipment is the best way to strengthen a unit (or crafting items once you have found enough gems). Enemy units that die may randomly drop items (general units occasionally do but more likely in Part II and leaders usually always drop something) and some maps have special items placed (usually a random item). These found items may be equipped (if that unit type can use it) or stored. Stored items can be equipped in castle tiles (or during the first two turns of each scenario) except for 'limited (books) and potions that can be used any time. Some advancements make some equipped items seemingly redundant but the game currently supports the holding on to such items for continual benefit. For example, a pikeman can wield [[LotI_Items#The_Original_Trident_of_Storms_.E2.80.93_spear\|The Original Trident of Storms]], which gives them a ranged attack. If you advance these to a swordsman or halberdier they can no longer use the trident as a melee weapon but they retain the ranged attack. This can also be useful where items increase hitpoints, movement or resistances.

	A very interesting item you may find is a [[LotI_Items#Tome_of_Liches_.E2.80.93_limited\|Tome of Liches]]. If used by a unit they ~~will~~ be converted to a L3 Lich when they die (~~does not work on already undead units~~). This is an interesting way to advance a unit and a lich is very effective against the demons in Part II. The lich will also continue to hold any items they were carrying before conversion so you should equip items that have useful secondary abilities (such as a [[LotI_Items#Wretched_Defiler_.E2.80.93_craftable_as_any_weapon\|Wretched Defiler]] that adds 25% arcane resistance, particularly useful for undead, and [[LotI_Items#The_Essence_of_Magic_.E2.80.93_craftable_as_any_weapon\|The Essence of Magic]]). A unit that is converted to a lich retains their traits as well. The best unit to convert is the Snow Hunter as it is only ever L2 so is quickest to get to a lich via AMLA and wields two weapons (that it ~~will~~ hold on to). Note that only one such carried item shows up in the unit's equipment display but the hidden item's effects are still active (~~seeing~~ items in the recall list shows all items). Be careful of accidentally unequipping all items from units carrying this extra gear as you cannot re-equip it.		A very interesting item you may find is a [[LotI_Items#Tome_of_Liches_.E2.80.93_limited\|Tome of Liches]]. If used by a non-undead unit they can be converted to a L3 Lich when they die (after some necromancy advancements). This is an interesting way to advance a unit and a lich is very effective against the demons in Part II. The lich will also continue to hold any items they were carrying before conversion so you should equip items that have useful secondary abilities (such as a [[LotI_Items#Wretched_Defiler_.E2.80.93_craftable_as_any_weapon\|Wretched Defiler]] that adds 25% arcane resistance, particularly useful for undead, and [[LotI_Items#The_Essence_of_Magic_.E2.80.93_craftable_as_any_weapon\|The Essence of Magic]]). A unit that is converted to a lich retains their traits and legacy as well. The best unit to convert is the Snow Hunter as it is only ever L2 so is quickest to get to a lich via AMLA and wields two weapons (that it can hold on to). Note that only one such carried item shows up in the unit's equipment display but the hidden item's effects are still active (viewing items in the recall list shows all items). Be careful of accidentally unequipping all items from units carrying this extra gear as you cannot re-equip it.

	==Antagonists==		==Antagonists==
Line 46:		Line 46:
	\|\|Your rapid progress has caused your enemies to panic. Horribly desperate to stop your progress, they looked into ancient archives of forbidden lore and found a solution. They cast a spell that exploited a small weakness in the barrier separating Inferno, reached in and summoned one of its most horrid entities, Beelzebub. They made a pact so that the hellspawn would chase you. Fortunately, Beelzebub is not very good at pursuing.		\|\|Your rapid progress has caused your enemies to panic. Horribly desperate to stop your progress, they looked into ancient archives of forbidden lore and found a solution. They cast a spell that exploited a small weakness in the barrier separating Inferno, reached in and summoned one of its most horrid entities, Beelzebub. They made a pact so that the hellspawn would chase you. Fortunately, Beelzebub is not very good at pursuing.
	\|}		\|}
	This message appears after you have played for a while and the notice is there to inform you that on the next available scenario (not all scenarios) there will be a monolith to inspect. Choosing to touch the monument summons the demon and the first time you do so you are asked to provide a reason, although the result is always the same and there does not appear to be any different outcomes based on the option selected.		This message appears after you have played for a while and the notice is there to inform you that on the next available scenario (not all scenarios support Beelzebub, usually only ones where both your heroes are present) there will be a monolith to inspect. Choosing to touch the monument summons the demon and the first time you do so you are asked to provide a reason, although the result is always the same and there does not appear to be any different outcomes based on the option selected.

	Beelzebub starts at around ~~a L32 demon~~ with 200HP and high resistances ~~but actually it's attacks don't seem~~ so ~~bad (~~the ~~corrupted elves at the end of chapter 2 I find harder, some dragons are nasty and~~ you ~~encounter much, much tougher demons in Inferno)~~. Beelzebub's main threat comes from summoning flies. The flies are very difficult to hit (have 80% defense so need marksmanship, etc) and attack immediately with their 3×15 draining swarm attack so it's not uncommon for each lot of flies to inflict 30 damage per turn. The first time you meet the demon only one lot of flies is summoned per turn but this increases on subsequent meetings.		Beelzebub starts at around level 35 with 200HP and high resistances, so can be difficult to subdue. However the AI on Wesnoth from around 2024 means leaders rarely attack so you just need to be able to defend retaliation. Beelzebub's main threat comes from summoning flies. The flies are very difficult to hit (have 80% defense so need marksmanship, etc) and attack immediately with their 3×15 draining swarm attack so it's not uncommon for each lot of flies to inflict 30 damage per turn. The first time you meet the demon only one lot of flies is summoned per turn but this increases on subsequent meetings.

	Because of the high resistances Beelzebub has it can be difficult to destroy the demon, especially early on when you have little in the way of equipment or strong, advanced units. There is no resistance to lightning (offered by several items) so that, penetration or [[LotI_Abilities#trickery_.E2.80.93_dummy\|trickery]] is needed. But because the demon itself offers relatively little threat it can be used for farming experience as ~~each~~ attack nets ~~32XP~~, which is the same as killing a L4 unit every turn (by all six of your units surrounding Beelzebub)! The unit that eventually makes the kill of course gets ~~256XP~~ so make sure it is one you most need to advance; usually one of your leaders, or maybe loyal Mario (if you want to bother) or a Grand Knight (the standard unit that needs the most XP to advance).		Because of the high resistances Beelzebub has it can be difficult to destroy the demon, especially early on when you have little in the way of equipment or strong, advanced units. There is no resistance to lightning (offered by several items) so that, penetration or [[LotI_Abilities#trickery_.E2.80.93_dummy\|trickery]] is needed. But because the demon itself currently offers relatively little threat it can be used for farming experience as any feeble attack nets the experience of the level of the opponent, which the first time is the same as killing a L4 unit every turn (by all six of your units surrounding Beelzebub)! The unit that eventually makes the kill of course gets hundreds of XP so make sure it is one you most need to advance; usually one of your leaders, or maybe loyal Mario (if you want to bother) or a Grand Knight (the standard unit that needs the most XP to advance). If you have the fixed version of LotI, Beelzebub will be 5 levels higher the next time after a killing and spawn about 2 more flies. If you are able to farm the demon long enough it will advance by about 40 levels so your units get even more experience (and the killer will get over 600xp)! There might be a bug in that if you advance Beelzebub again it will drop back to the original level so you should make the kill when maxed.

	But it's not just experience to be gained as when Beelzebub is destroyed there is a massive drop of about 40 items! Because picking up these items is time-consuming (and sometimes you may have allies standing on them) it is often best to make this kill on the last turn of the scenario so that the items are automatically collected. In most scenarios Beelzebub is classed as an enemy leader so if your mission is to kill them all you can kill the others first. In some scenarios there may be a trader present and Beelzebub's flies will kill the trader so make any purchases first.		But it's not just experience to be gained as when Beelzebub is destroyed there is a massive drop of about 40 items! Because picking up these items is time-consuming (and sometimes you may have allies standing on them) it is often best to make this kill on the last turn of the scenario so that the items are automatically collected. In most scenarios Beelzebub is classed as an enemy leader so if your mission is to kill them all you can kill the others first. In some scenarios there may be a trader present and Beelzebub's flies will kill the trader so make any purchases first.

	Note that summoning Beelzebub is an option and it will return every available subsequent scenario until defeated (summoned or not). As hinted to by the text "your rapid progress", the appearance of the monument is determined by how quickly you complete scenarios. Technically it is based on how many turns you have saved as a fraction of the turn limits. For this reason your are better off to try and complete scenarios as quickly as possible, rather than wasting a few turns at the end to harvest a few xp from low level enemies. Some scenarios are however large and long (100+ turns) with many enemies so these should probably be fully ~~harvested~~ as you would get as much experience and dropped items as Beelzebub provides.		Note that summoning Beelzebub is an option and it will return every available subsequent scenario until defeated (summoned or not). As hinted to by the text "your rapid progress", the appearance of the monument is determined by how quickly you complete scenarios. Technically it is based on how many turns you have saved as a fraction of the turn limits. For this reason your are better off to try and complete scenarios as quickly as possible, rather than wasting a few turns at the end to harvest a few paltry XP from low level enemies. Some scenarios are however large and long (100+ turns) with many enemies so these should probably be fully exploited instead as you would get as much experience and dropped items as Beelzebub provides.

	==Chapter Guides==		==Chapter Guides==