The Battle for Wesnoth Wiki - User contributions [en]

WesnothTranslations

2026-03-13T09:26:02Z

Egallager: /* Mailing List */ typo

== Translations ==

Wesnoth is currently being translated into the following languages. These languages are active, with maintainer.
{| class="wikitable"
|-
! Translation !! Maintainer !! Contact
|-
| [[AncientGreekTranslation|Ancient Greek]] || Mejri Ziad (Hermestrismi)|| [mailto:beja.comuneATgmailDOTcom]
|-
| [[ArabicTranslation|Arabic]] || Mejri Ziad (Hermestrismi)|| [mailto:beja.comuneATgmailDOTcom]
|-
| [[BengaliTranslation|Bengali]] || Subhraman Sarkar (LumiousE) || lumious_e on Discord
|-
| [[BulgarianTranslation|Bulgarian]] || Ivan Petrov (TheWhiteKnight) || [mailto:vankata_petrovATabvDOTbg]
|-
| [[CatalanTranslation|Catalan]] || Arnau Vàzquez Palma || [mailto:arnauvpATmurenaDOTio]
|-
| [[ChineseTranslation|Chinese]] || CloudiDust || [mailto:cloudidustATgmailDOTcom]
|-
| [[ChineseTaiwanTranslation|Chinese (Taiwan)]] || 楊綮銘 (Taiwan) || [mailto:steven2880ATgmailDOTcom]
|-
| [[CzechTranslation|Czech]] || Michal Žejdl || [mailto:lachimATemerDOTcz]
|-
| [[DutchTranslation|Dutch]] || Merijn de Vet || [mailto:merijndevetAThotmailDOTcom]
|-
| [[EnglishGBTranslation|English (GB)]] || Wedge009 || [mailto:wedge009ATwedge009DOTnet]
|-
| [[EnglishShawTranslation|English (Shaw)]] || Arc Riley || [mailto:ArcRileyATubuntuDOTcom]
|-
| [[Esperanto_translation|Esperanto]] || Mariano Street (mctpyt) || [mailto:mctpytATprotonDOTme]
|-
| [[FinnishTranslation|Finnish]] || Jaakko Saarikko (styxnix) || [mailto:jaakkoDOTsaarikkoATprotonmailDOTcom]
|-
| [[FrenchTranslation|French]] || demario || [mailto:wesnothfr-request@lists.tuxfamily.org?subject=subscribe mailing list]
|-
| [[GermanTranslation|German]] || Aaron Winter (Bitron) ||
|-
| [[HungarianTranslation|Hungarian]] || Berda Jenő (bigbilly) || [mailto:big4billyATgmailDOTcom]
|-
| [[IndonesianTranslation|Indonesian]] || Irsyad Musthafa || [mailto:sevennightmareATtutanotaDOTde]
|-
| [[ItalianTranslation|Italian]] || Antonio Rosella || [mailto:arosellaATyahooDOTcom]
|-
| [[JapaneseTranslation|Japanese]] || Hironori Fujimoto (RatArmy) || [mailto:broadbarredfirefishATgmailDOTcom]
|-
| [[KoreanTranslation|Korean]] || mistzone || [mailto:drier22ATgmailDOTcom]
|-
| [[LatinTranslation|Latin]] || Daniel Faustmann || [mailto:donnerstag.freitag213@gmail.com]
|-
| [[NorwegianTranslation|Norwegian]] || Bloodaxe || [mailto:bloodaxenor@protonmail.com]
|-
| [[PolishTranslation|Polish]] || ForPeace || [https://forums.wesnoth.org/viewtopic.php?f=7&t=3796 forum thread]
|-
| [[PortugueseTranslation|Portuguese Brazilian]] || Andrei Machado || [mailto:andreisp.machadoATyahooDOTcom]
|-
| [[PortugueseContinentalTranslation|Portuguese (European)]] || trewe || [mailto:sjrs456ATyahooDOTfr]
|-
| [[RussianTranslation|Russian]] || Artem Khrapov || ([[User:kabachuha|kabachuha]]) [mailto:artemkhrapov2001ATyandexDOTru]
|-
| [[Scottish_Gaelic_Translation|Scottish Gaelic]] || GunChleoc || [mailto:fiosAIGforamnagaidhligDOTnet]
|-
| [[SlovakTranslation#Preklad|Slovak]] || Stanislav Hoferek || [mailto:shoferek@gmail.com]
|-
| [[SpanishTranslation|Spanish]] || Sebastián Lecchini (Sebas38760) || [mailto:sebas38760@gmail.com]
|-
| [[SwedishTranslation|Swedish]] || Alex Alowersson (fluxbird) || [mailto:alexalowersonATgmailDOTcom]
|-
| [[TurkishTranslation|Turkish]] || Nilgün Belma Bugüner || [mailto:nilgunATbelgelerDOTorg]
|-
| [[UkrainianTranslation|Ukrainian]] || Oleksii Okhrimenko (lexa04) || Discord: amakri Email: [mailto:ohrimaleATgmailDOTcom]
|}

Currently inactive translations. If you wish to improve some of these languages (or one of the above maintainers is not responsive), contact Ivanovic on the [https://wiki.wesnoth.org/Support Wesnoth Discord channel].

{| class="wikitable"
|-
! Translation !! Maintainer !! Contact
|-
| [[AfrikaansTranslation|Afrikaans]] || None || N/A
|-
| [[BasqueTranslation|Basque]] || None || N/A
|-
| [[BurmeseTranslation|Burmese]] || None || N/A
|-
| [[CroatianTranslation|Croatian]] || None || N/A
|-
| [[DanishTranslation|Danish]] || None || N/A
|-
| [[GalicianTranslation|Galician]] || None || N/A
|-
| [[GreekTranslation|Greek]] || None || N/A
|-
| [[HebrewTranslation|Hebrew]] || None || N/A
|-
| [[IcelandicTranslation|Icelandic]] || None || N/A
|-
| [[IrishTranslation|Irish]] || None || N/A
|-
| [[LatvianTranslation|Latvian]] || None || N/A
|-
| [[LithuanianTranslation|Lithuanian]] || None || N/A
|-
| [[MarathiTranslation|Marathi]] || None || N/A
|-
| [[MacedonianTranslation|Macedonian]] || None || N/A
|-
| [[OldEnglishTranslation|Old English]] || None || N/A
|-
| [[RACVTranslation|RACV]] || None || N/A
|-
| [[RomanianTranslation|Romanian]] || None || N/A
|-
| [[SerbianTranslation|Serbian]] || None || N/A
|-
| [[SlovenianTranslation|Slovenian]] || None || N/A
|-
| [[SpanishLatinAmericanTranslation|Spanish (Latin American)]] || None || N/A
|-
| [[ValencianTranslation|Valencian]] || None || N/A
|-
| [[VietnameseTranslation|Vietnamese]] || None || N/A
|}

== Mailing List ==

There now is a mailing list dedicated to translation matters. It is mainly intended to be used for informing translation maintainers about important changes, to announce string freezes and other special things. Everyone is free to subscribe to this list.

* [https://groups.io/g/wesnoth-translations From February 2025]
* [https://listengine.tuxfamily.org/wesnoth.org/i18n/ List info, how to subscribe, and archives from April 2022]
* [https://mailman.wesnoth.org/pipermail/i18n/ Old list archives (up until April 2022)]

Please keep in mind that this list is not meant for discussing changes for one single translation but instead subjects which are relevant to all translations.

== See also ==

* [[WesnothTranslationsHowTo]]
* [[ImageLocalization]]
* [[GetText]]
* [http://gettext.wesnoth.org Translations statistics (stable)]
* [http://gettext.wesnoth.org/index.php?version=trunk&package=alloff Translations statistics (development)]
* [[GettextForTranslators#For_add-ons|Translating User Made Campaigns and add-ons]]
* [[SpellingMistakes]]
* [[CharactersStorys| Character descriptions for Translators (Spoiler Warning)]]
* [[Poetry of Wesnoth Translations]]

[[Category:Translations|*]]

DescentIntoDarkness

2025-08-18T21:55:00Z

Egallager: /* Saving Parthyn */ wikify

=== Campaign-level notes ===

:Descent into Darkness had a significant revision in version 1.14.7. This walkthrough is current as of version 1.16.6, so much of the advice here no longer applies to earlier versions.

==== Recruitment Strategy ====

Malin Keshar and Spectral Servant both have unique advancement paths in this campaign. When one of these units reaches its xp cap, you will be offered a choice of several possible "AMLA" upgrades, such as +1 melee damage, +1 ranged damage, or various special abilities, after which your xp will return to zero with a higher cap. Sometimes these AMLA advancements will be accompanied with a level increase and a significant boost in overall stats, and sometimes not. They will generally not be accompanied by healing to full hp. The exact xp requirements differ based on difficulty level and the order in which you select the upgrades. They can continue to accumulate AMLA upgrades after reaching lvl 3.
In total, these units will end up requiring much more xp to reach level 3 than an ordinary dark adept or ghost would, but they will also end up being far more powerful due to all the cumulative upgrades they get along the way. For example, in one playthrough on Hard difficulty Malin required a total of 105 xp to reach lvl 2, and another 313 xp to reach lvl 3. Spectral Servant took 50 xp to reach lvl 2 and another 264 to reach lvl 3.
This is a slight spoiler, but there will be a scenario toward the end of the campaign where Malin will need to fight a large number of enemies solo and then even more enemies with very few units to help him, so getting these two units, especially Malin, as powerful as possible is a good investment that you will need to start working on immediately. The Vitalize upgrade to Malin's melee weapon will also be very useful to help him survive better when fighting solo. At a key point Malin will need to tank a very large amount of arcane damage, so it is not wise to take too many of the upgrades that include the 'minor' cost of increasing vulnerability to arcane.

You'll be introduced to ''Walking Corpses'' very early on, and some tend to forget about them in favor of snazzy and more capable units - but never discount how their numbers can add up later on with the plague ability, especially when you want to protect those high-level specialist units of yours. They can level up to Soulless, but it is almost always more cost effective to just recruit fresh Walking Corpses in the next scenario rather than recalling a Soulless.

''Ghosts'' will be a useful part of your force - mostly when leveled up. Prefer them for recruitment even if initially they require some help from other units, and allocate enough experience to make them into Wraiths or Shadows. Both these units are useful in general when playing undead, but in this particularly campaign it is extremely beneficial to have at least 4 Shadows/Nightgaunts available for recall as soon as you can manage it.

''Bats'' are less useful in this campaign as in some other cases, as your Ghost-based units are just as mobile and not much slower; and sometimes invisible to boot.

''Dark Adepts'' are not available in this campaign, so your only option for ranged damage will be skeleton archers, Darken Volk, and Malin himself.

Darken Volk will accompany you in many of your scenarios. He starts at level 2, and getting him up to level 3 will be very helpful, given how limited your other options for ranged damage are.

Skeletons will be the backbone of your army. You will face some very scary orcish crossbowmen and human mages who can quickly wipe out your undead units with fire/arcane attacks, and skeletons and their advancements will be your best tools for taking them out asap to minimize the damage they can cause. Skeletons' high blade resistance also makes them very effective for going toe to toe with even lvl 3 orcish warlords.

=== Saving Parthyn ===
* Objective: Defend the fort for two nights
* (Alternative Objective: Kill the orcish leader)
* Lose if: Deaths of [[Malin Keshar|Malin]], [[Dela Keshar|Dela]], or Drogan, OR Orcs reach the outskirts of Parthyn
* Turns: 13
* Starting units: Malin Keshar, two Spearmen and a Bowman
* New Recruitment options: Walking Corpse (8 Gold).

Your starting level is a small section of the Abez, with a ford between the South and Northern side. Your starting fort is just to its south, the L2 Orc Warrior enemy leader's - slightly farther away to its north. To your west, Drogan occupies another fort.

The orc leader has more initial gold than you, and he will recruit some lvl 2 Crossbowmen, while you have only your 3 loyal lvl 1 units and lvl 0 Walking Corpses. So, you will have to play to your strengths, which are terrain, numbers, and the plague ability.

Make sure that your units occupy all of the favorable terrain on your side of the river and force the orcs to fight you from the water whenever possible. Rotate your walking corpses to the front during the night and save your loyal lawful units for daytime to maximize their damage output. Actually killing the enemy leader is extremely difficult on the highest difficulty, so you can play very defensively and let Drogan's reinforcements keep rushing past you to fight the orcs in the water. Since your units all have zero upkeep, you can still get a decent carryover by stealing all of your allies' villages in the first few turns and only recruiting ~8-10 Walking Corpses, which should be all you need if you play defensively and maximize your plague ability.

None of your loyal units will follow you to the next scenario, and even if you do level up a Walking Corpse, it will max out as a lvl 1 Soulless and will not be worth recalling later, so you should focus on getting Malin as many kills as possible. It will still be useful to kill a couple enemies with Walking Corpses in order to generate reinforcements with their Plague ability. Focus your Walking Corpses' attacks on the archers and crossbowmen, as it can be suicidal to have them directly attack grunts.

There are 3 objects on this map that trigger events. It will take the orcs several turns to reach you, so that will give you time to trigger all of them and also steal your allies' villages. The objects and their events are:

1. Book at 20.17 - If Malin steps on it, gives +4xp

2. White monolith at 30.15 - If Malin steps on it, gives +8xp

3. Sunken boat at 31.9 - If a Walking Corpse steps on it, gives a swimmer-type Soulless unit.

The Defeat condition says "Orcs reach the outskirts of Parthyn". Mechanically, the "outskirts of Parthyn" are defined as an invisible vertical line marked by the signpost at 17.16 (hexes 17.13 - 17.20). If any orcish unit steps on a hex on or left of that line, you will immediately lose. This still gives you a lot of wiggle room, as you can still win if the orcs overrun your starting keep, as long as you don't let them get as far west as the signpost.

=== A Peaceful Valley ===
* Objectives: Occupy all of the Goblin villages
* Lose if: Malin Keshar or Darken Volk die or time runs out
* Turns: 29/26/15 (easy/medium/hard)
* Starting units: Malin Keshar and Darken Volk
* New Recruitment options: Vampire Bat (13 Gold)

In this small map you are tasked with occupying a Goblin settlement. There are 6 total villages on the map, and you win the scenario the moment you own all of them, even if you have not yet defeated the enemy leader.

The settlement is guarded by an L2 Goblin Knight in the mid-North of the level, who recruits (Goblin) Wolf Riders, Goblin Impalers and Goblin Rousers. He's not too rich, but don't underestimate him.

The villages hold rather nasty surprises: 0 to 2 Goblins will spring out of each village you capture, ''including those that you recapture''. Thus the key is not to capture villages quickly, but rather to clear all defenders and kill the leader, allowing you to gang up on villages gradually. Ironically, this will allow you to capture all the villages more quickly than with a greedy approach.

One exception to this could be if you captured the last 2-3 villages with bats all on the same turn, thus winning the scenario suddenly without having to fight any of the remaining goblins. But since there are so few villages on this map, the early finish bonus is not that high, so the extra xp from killing all the goblins will probably be more valuable to you than a few extra gold in carryover.

In this level you will be able recruit Bats in addition to Walking Corpses. Bats are generally very useful creatures to have:
* They're effective scouts: Flying allows them to ignore otherwise-unfriendly terrain, and they have 8 (later 9) movement points.
* They're good at remote village capture
* While they aren't skirmishers, their mobility often makes it possible for them to fly around part of an enemy line and attack vulnerable units. They're similarly often able to flee to safety after having engaged.
* They're one of the few Undead-associated units which are not vulnerable to Arcane attacks.
... but in this scenario, they won't be useful to you: It's a small map, the villages are close rather than remote, and your L1 Vampire Bat will have a hard time with the spawning Goblin guards. You could theoretically recruit a Bat intending to just level it up for later recall, but there's XP to distribute elsewhere.

If not Bats, then - it's the Walking Corpse horde again. They'll be up against units with low HP and damage, so a few of them could even take out a Goblin, especially with some terrain advantage. Caution is still advised, though. You can easily lose several Walking Corpses trying to wear down a healthy Goblin Impaler at night. Also, the replenishment of your ranks by the dead Goblins is important here - snowball your forces. Finally, place Walking Corpses as cheap captured-village guards to prevent retaking by a convergence of the Goblin forces. You'll appreciate the irony of the dead Goblins continuing the same guard duty they were assigned to before, only this time on your behalf.

As you begin the level, Darken suggests you visit the swamp. Note that either Darken or Malin can do this, and it is usually easier to do it with Darken so that Malin can focus on recruiting the Walking Corpse horde. When Darken or Malin step onto a swamp hex, you'll be introduced to Ghouls - and get 3 of these for free. Get these into the line of fire ASAP, as your enemy has only melee attackers and you can quickly poison most of his army.

The enemy leader will send out an attack wave, starting to hit you by turn 3 or so. In fact, the Goblin Knight leader ''himself'' is likely to join this raid, despite it being out of sight of its fort - something you may not be used to from other campaigns. He'll likely retreat soon enough (even if he's not badly hurt), so don't focus on him. You should have many Walking Corpses to set up a defensive line along the edge of the forested region to the North-West of your fort - this will give you a terrain advantage. Alternatively, you could let the enemy units come further South, into the forest, buying an extra turn before they hit you for a better defensive bonus for them. Anyway, if you support your WCs with Malin and Volken you should be fine.

Your #1 focus in this scenario, like the last one, is feeding Malin xp. It will take a lot of kills to get him to level 2, but when you do he will get access to cold and arcane damage and a big damage output boost, which will make the next scenario much easier. Walking Corpses, ghouls, and bats will not be your most effective units later in the campaign, so all the xp from this level is best concentrated in Malin and Darken.

There is a key at 7.9 and a cage at 4.12. If you have Malin first step on the key and then the cage, you will get a Walking Corpse and a Soulless for free. However, you probably won't need them to win this scenario, and the turns spent triggering this event will be better spent getting kills for Malin.

Notes:
* Not all Goblin village hexes are on the grassy plain: There are 2 in the hills/Montains to the NW of the enemy leader's fort, one near your own fort (that one's revealed to you when you start out), and one that's very easy to miss to the North-East of the level, North of the Swamp. Make sure you plan your village sweep to include those.
* It's difficult to get through this level without the Ghouls, so don't wait too long before visiting the swamp

=== A Haunting in Winter ===
* Objectives: Reach the end of the cave
* Lose if: Malin Keshar dies
* Turns: no limit
* Starting units: Malin Keshar
* New Recruitment options: Ghoul (16 Gold)

This scenario is more a series of puzzles than a typical Wesnoth battle. Malin has to learn independence by fighting a variety of cave denizens with a few undead helpers.

The income on this level works in an unusual way. You are charged upkeep on your units as usual, but no matter how many villages you capture you never earn any income. This means you should spend all of your starting gold ASAP in the first 1-3 turns before it gets eaten up by your upkeep.

WARNING: SPOILERS AHEAD! This scenario is intended to be a long exploration/puzzle challenge, so this walkthrough will include the solutions to the puzzles. I will try to list them all out sequentially, so that readers can just read the solution to whatever puzzle they are stuck on, without spoiling the following ones.

1 - Young Ogres

There are 2 partially damaged young ogres south of you. Your best units against them will be ghouls, so first recruit 2 ghouls and then retreat so that Malin is out of their reach. The ogres will attack and poison themselves. The next turn, move your ghouls and immediately recruit more if you can afford it. There is no time limit and you have a very limited number of units, so it can be a good idea to play very passively , rotate your injured ghoul out of harm's way, and let poison do its work, rather than risking losing a ghoul by pressing the attack. On the third turn, spend whatever remains of your gold and try to kill one or both of the ogres with Malin if possible.

2 - Ogre

After you kill the young ogres, all of your units will automatically heal to full and a lvl 2 ogre will appear to the north. Again, your goal is to avoid losing any units and to feed Malin the xp. So place a ghoul in the convenient bottleneck, allow the ogre to attack it and become poisoned. Then rotate the ghoul out and send it to the villages to the southeast, and replace it with either another ghoul if the ogre isn't poisoned yet, or a skeleton if it is. Play passively, don't attack, just allow the ogre to attack your skeleton, rotate the other skeleton in to take it's place, and repeat until the ogre is at low enough hp for Malin to take it out.

3 - Mudcrawlers

All of your units heal to full again after the Ogre dies. Now you are faced with the most difficult challenge of this scenario, a swarm of giant mudcrawlers. Your goal is to take them out while losing as few of your skeletal undead as possible, which is difficult given their melee AND ranged impact attacks. They are very vulnerable to cold and arcane and very resistant to impact damage, so if you have managed to get Malin to level 2 he will tear right through them, and if not then you're going to have trouble.
There are two basic ways to tackle this challenge. The easier way, if Malin is far from level 2 and/or you came in with a low amount of gold and couldn't afford many ghouls, is to retreat into the western tunnel behind Darken Volk. Darken won't move, but if a mudcrawler steps next to him he will attack it, and his arcane/cold attacks are extremely effective. He will probably kill several of them outright, which is ok because he needs the xp to get to level 3 anyway, and you can steal the rest of his kills with skeletons or Malin.
The harder way is to use the bottleneck north of your keep to allow mudcrawlers to come onto hexes 21.11 or 20.11 one at a time, then wear them down with ghouls until they're at a low enough hp that a skeleton has a good chance of finishing them off in one attack. Then rotate your skeletons back to heal, rinse and repeat. You will lose a couple ghouls and maybe your skeleton archer, but ideally you will come out of it with both skeletons at least partway to leveling up.

4 - Mudcrawler Spawn Puzzle

You will notice that there are only a limited number of lvl 1 Giant Mudcrawlers, but that there is also one pesky lvl 0 mudcrawler that just keeps coming back. Every time you kill it, a new one spawns from the glyph at 26.5. To disable this spawn point, you must:
1. Have Malin step on the storm trident at 29.10

2. Have Malin step on the forest at 23.6

3. Have Malin step on the glyph at 26.5

You will receive an xp reward based on difficulty level, and the mudcrawlers will stop spawning.
Solving this puzzle is not necessary for finishing the scenario.

5 - Wolf pack

If you have enough skeletons and ghouls, this should be no problem. The wolves will trigger once you move any further west than the village at 10.4. Just position your skeletons and ghouls on good defensive terrain, poison everything you can, rotate your units back to heal, and try to farm kills for Malin and/or skeletons. Remember that there is no turn limit and you have poison, so time is on your side and you can afford to play very passively.

6 - Rat Spawn Puzzle

Just like the mudcrawlers, rats will continuously spawn from 8.7. Solving this puzzle is also not required to complete the level, but here are the steps:
1. Move Malin to the bottle at 2.2

2. Kill the scorpion at 8.9, then have Malin step on its corpse.

3. Move Malin to 8.7 (this can be difficult because of the rats respawning every turn, so just place Malin right behind an undead unit so that the unit can kill the rat and Malin can jump into its spot before it respawns.)

Again, you will get an xp reward based on difficulty level

7 - Ghost Training

Move Malin into the water at 5.11

ALTERNATE STRATEGY: The endlessly respawning mudcrawlers and rats on this level only provide 1 xp each when killed, but a very patient player can choose to farm them for as long as they want, which will of course make future levels easier. The way to exploit this maximally is with ghouls. Once they reach lvl 2 they gain the 'feeding' ability, and the endless supply of rats allows you to create a necrophage/ghast with hundreds of hp if you so desire, although Malin himself will start to get sick of it and complain at some point. This strategy is not at all required to beat the rest of the campaign, even on the hardest difficulty.

=== Spring of Reprisal ===
* Objectives: Either Defeat the Orc leaders, or move Malin Keshar to the end of the mountain pass
* Lose if: Malin Keshar or Darken Volk die, or time runs out
* Turns: 26
* Starting units: Malin Keshar and Darken Volk
* New Recruitment options: Skeleton, Skeleton Archer.

NOTE AS OF VERSION 1.14: Although this map itself has not changed much since the campaign was revamped in version 1.14, the rest of the campaign has changed in one very significant way: In the past, you could recruit and level up ghosts in the previous scenario, whereas now there is no way to start this scenario with shadows or wraiths. Many of the original strategies for this scenario were based on using shadows/wraiths as part of assassination teams to take out the orcish leaders. Assassination strategies might still be possible with only lvl 1 ghosts, but their low damage output and high cost makes these strategies less viable since the 1.14 update. I have kept the descriptions of these strategies at the end of this walkthrough entry, and I would be interested to hear if people have pulled them off post-1.14, but I will describe a more straightforward skeleton-based strategy.

Note that if you defeat both orc leaders, you win immediately and do not need to move Malin to the signpost.

The spring thaw is underway, which means the ice on the river is thin. Whenever a non-flying unit starts its turn on an ice hex, it will start to show cracks. The next time a non-flying unit starts its turn on an ice hex with cracks, it will die and the hex will change to deep water. Counterintuitively, this also applies to skeletons who have the submerge ability, explained as them getting stuck in the mud at the bottom of the river. You can take advantage of this by using your ghost/bat units to lure enemies onto the ice, or by having your skeletons step onto ice hexes to 'pre-crack' them, then stepping back off and inviting the orcs to take their place.

The only level 2 units your enemies will recruit in this scenario are Goblin Pillagers and Orcish Crossbowmen. These are very dangerous units for most of your undead due to their fire and impact attacks. Ghouls are useful in this scenario both because they are the least fire-vulnerable units you have access to, and because poisoning your enemies will encourage them to retreat back over the already-cracked ice in at attempt to reach villages, and hopefully fall through during the crossing. Mass skeletons are also a viable strategy, especially once you get some to lvl 2, because they can simply do enough damage to take these dangerous enemies out as quickly as possible. Large numbers of skeleton archers are less useful, even against the pillagers, as the nets will still do significant impact damage, and greatly slow down your attempts to kill them. And large numbers of bats and ghosts are not very useful because of their high cost, low hp, and vulnerability to fire.

The most straightforward strategy is to recruit mostly skeletons, maybe a ghoul or two, and recall your spectral servant and any skeletons with significant xp from last scenario. Set up a defensive line centered on the village at 16.13 (you can grab it with Darken Volk while your other units catch up). Prioritize taking out crossbowmen and archers, then pillagers, then grunts and wolf riders, and rotate your heavily wounded skeletons back to villages in your backfield to heal. You are ignoring the wolf riders and grunts at first because they use only melee blade attacks, so if they attack your skeletons you will hurt them more in retaliation damage due to your blade resistance, and if they attack your ghouls they will get poisoned, so you come out ahead either way with no effort. Save Darken Volk for his most important job, softening up Pillagers so your skeletons can finish them off.
You can leave Malin in his keep for a while to keep recruiting reinforcements, but he should get moving by turn 12 at latest if he wants to grab the book at 24.6 for an xp bonus and then make a run for the signpost. Avoid engaging with the southern orcish leader and just use your group of skeletons and Darken to clear a path for Malin. In those first 12 turns, focus on leveling up some skeletons to revenants or deathblades, and also stealing some kills with Spectral Servant.

Below are assassination based strategies that were confirmed to be successful pre-1.14:

Players have used different strategies with success...

'''Option 1, defeat in detail:''' This is probably the easiest plan, with the highest chance of success. Attack the southern orc first, then the northern orc. You can recruit/recall mostly Ghosts, Shadows, and Wraiths, supplemented by Vampire Bats. Ghosts and Bats can capture difficult to reach villages and move on, thus weakening your foes. Keep Malin Keshar and Darken Volk alive by hiding them in the mountains, which have two chokepoints. Either give them a small guard force or be prepared to redirect some of your leveled Ghosts to assist as needed.

'''Option 2, assassination:''' Kill both leaders at once. Recruit/recall almost exclusively Ghosts, Shadows, and Wraiths, and split them into two, one taskforce for each leader. A minimal strike force for one leader would be four Ghosts and two Shadows. Wait patiently across the river from the strongholds until darkness descends on turn 8. Then assassinate both leaders. If all goes well, the leaders will be dead by turn 9, for a nice gold bonus. Just in case it doesn't end so quickly, Malin Keshar and Darken Volk should have already been running into the deepest part of the southern mountains for safety. Exercise restraint with respect to capturing villages with bats or ghosts near the strongholds before the strike, as the enemy may divert units to intercept, which may interfere with your assassination plot.

'''Option 3, feint:''' Use ghosts to discourage the enemy from concentrating his forces at the lake. Sending a few ghosts over the mountains and river allows you to distract the computer into sending troops back to its base, because it interprets the closer enemies as a larger threat. By doing this, you can delay the southern orcs and meet the northern orcs at the lake. Just be careful, because if you distract them too long, they build up a substantial force (rather then sending troops in piecemeal like the computer usually does) which takes a while to cut through.

=== Schism ===
* Objectives: Defeat the Orc leaders
* Lose if: Malin Keshar or Darken Volk die or time runs out
* Turns: 37
* Starting units: Malin Keshar and Darken Volk

The objectives in this scenario are a little misleading; while there are 3 Orc leaders on the map, it is actually enough to defeat any two of them, as the third will retreat.

Your enemies start out with unusually low starting gold, but they each have a BASE income of +12 or +14, and this is a big map with lots of villages so in the first few turns their incomes will quickly reach +20 or more. This means that time is not on your side and this favors rush strategies.

The enemy leaders are not quite evenly spaced; the northwest and southwest leaders are closer to each other than either of them is to the northeast leader. So for the quickest finish, the simplest strategy is an all-out rush against the northwest leader, followed by immediately rushing the southwest leader, aiming to finish before the eastern leader's forces can even reach you. Mostly ignore villages/income, accept some casualties, aim for healing in form of leveling up skeletons, and try to funnel xp into your loyal units and leader as usual. Assuming that you have a couple lvl 2 units from last scenario, you should be able to finish by turn 10 for a truly massive early finish bonus.

The next scenario will be much easier if your loyal ghost (spectral servant/phantom/eidolon) is lvl 2, so focus on feeding him the necessary xp during this scenario. Remember that he has an unusual advancement process like Malin, so you will actually have to hit his xp cap multiple times before he properly levels.

Ghouls will be less useful than skeletons on this level, because you're playing so aggressively that you don't have time to wait around for poison to take effect, and higher immediate damage will serve you better. Don't be afraid to attack the lvl 3 orcish leaders directly with your skeletons, as your blade resistance will minimize their retaliation damage.

On lower difficulties or with a lot of carryover gold, you could try splitting your forces and trying to rush two leaders simultaneously. Which leaders you pick depends on your roster. Each enemy leader recruits a slightly different mix of units. All of them recruit grunts and archers, but they have these additional unit options that are unique to them:
Northwest: goblin spearman, orcish crossbowman, orcish warrior
Southwest: goblin pillager, wolf rider, goblin knight
Northeast: troll whelp, troll, troll rocklobber, orcish assassin

If your strongest units are skeletal undead, then you will want to avoid the northeast leader with all of his impact-using units. If you managed to level up several wraiths in the last scenario, then they can be very effective against all of the trolls and you might want to instead avoid the pillagers with their powerful fire attacks.

=== Return to Parthyn ===
* Objectives: Kill Drogan, then escape to the Northwest / Kill Orc Leader
* Lose if: Malin Keshar dies or any people from Parthyn die before Drogan
* Turns: 17
* Starting units: Malin Keshar and Spectral Servant/Phantom/Eidolon

Your first objective is to kill Drogan; if any other human unit dies before Drogan, you lose. This is much easier if both Malin and your loyal ghost (now "phantom") are at least lvl 2 already. In that case, you can just recruit 3 ghosts and attack drogan right in his keep. The enemy is very cautious and will not jump out into the river to attack ghosts, although they will do it for Malin. So just make sure Malin stays behind the loyal ghost until he's close enough to attack drogan directly.

If Malin and Spectral Servant/Phantom are not lvl 2, this direct attack method becomes more dicey, and you can instead try to lure drogan out of his keep by putting any unit without a ranged attack (e.g. skeleton, ghoul, bat) in range of him so that he will jump out and shoot his crossbow at it. Then you can surround him and take him out.

When you've taken out Drogan you discover that, oops, your sister and the people of Parthyn hate you anyway. The orcs then appear at turn 5, hostile to both you and your sister's forces. Also, your goal has changed: You can either run for the signpost at the northern edge of the map, or defeat the orcish leader. Note that you can now kill human units without losing the scenario.

You can essentially either play this scenario to optimize gold or xp for the next level:

Gold: If Malin and your loyal ghost were strong enough to take out Drogan with only 3 additional ghosts for backup, then Malin can just make a run for it without recruiting any more units, sacrificing any remaining ghosts to cover his retreat if necessary. You mostly likely came into this scenario with an enormous carryover from Schism, you only spent 57 gold total this scenario, and even 40 percent of what you have left will still give you a very healthy surplus for the next scenario (A Small Favor - I). Being able to recruit a lot of units in A Small Favor - I is huge, because those units will have to last you all the way through A Small Favor II and III. The best route for Malin's escape around the western edge of the mountain range that separates him from the orc leader. Since there's no early finish bonus, you can afford to dilly-dally for a few turns and let your ghosts steal some kills if no one is putting too much pressure on Malin at the signpost.

XP: You can just spend all that surplus gold from Schism here, recruit a huge army, let the orcs and humans soften each other up, then take them BOTH out, and hopefully get a bunch of lvl 2 and even lvl 3 units out of it, as well as getting Malin and your loyal ghost well on the way to lvl 3 themselves. This takes you in to A Small Favor with a smaller but more elite force. If you take this path, try to have at least one, ideally two Shadows by the end of this scenario, as they will be very useful for A Small Favor II and III.

There are several triggerable events on this map:

1. Malin steps on monolith on 14.9 - gain xp based on difficulty level.

2. Malin steps on book on 29.25 - gain xp based on difficulty level.

3. Malin steps on monolith at 19.24 (appears after Drogan's death) - gain xp based on difficulty level

4. Recall the swimmer-type Soulless you got from the special event in the first scenario (Sushi), and move it to the boat at 31.15 - gain special ability.

===A Small Favor - Part One===
* Objectives: Malin Keshar and Darken Volk enter Karae' manor, or Defeat General Taylor
* Lose if: Malin Keshar or Darken Volk die or time runs out
* Turns: 28/26/16 (easy/medium/hard)
* Starting units: Malin Keshar and Darken Volk

You start the level in the woods, near the outskirts of Tath. You're not actually going into the heart of the city - but the manor you want to infiltrate is on the inside of the guarded perimeter. It's night, and it's a safe area of Wesnoth, so there are few guards on duty and only a single officer in charge on call in a castle; that's General Taylor. The head trainer of the Tath city guard is having trouble sleeping apparently (maybe he has a nose for the undead?), and a couple of men who aren't manning the guard posts. Finally, the manor entrance proper is guarded by a couple of Mages.

It's not possible for Malin and Darken to get past the guards and reach the manor undetected - only an invisible unit get in between consecutive posts. Also, if even a single guard is alerted, he'll immediately sound the alarm - which will make General Taylor wake up a hefty contingent of guardsmen. Darken casts a spell which shortens all the guards' vision ranges, but the moment one of them spots one of your units, all of their vision ranges return to normal.

The level has many villages - most within the Tarth city borders, owned by the enemy, but some are owner-less, in the woods. Those you can just go ahead and capture. The enemy villages may be captured without alerting the guards only by invisible units.

As for the guards themselves - on Medium difficulty, you'll be facing Spearmen (L1) mostly, with some Pikemen (L2) and Heavy Infantrymen (L1), and the mages are an L1 and an L2, so light fare; on Hard it should still be, well, not that hard. The head trainer is a Lieutenant, and then there's the General and possibly his troops.

For this scenario, the time of day remains Night throughout, so your shadows/nightgaunts will be continually invisible and all of your units will be continually punching above their weight.

The most important aspect of this scenario is that whatever units you have on the map on the last turn are the units you will start with for A Small Favor Part II, and your surviving units from Part II will carry over to part III, but this will be your last chance to recruit until after Part III. So even if you employ a very non-confrontational strategy and don't NEED a lot of troops, you should still recall/recruit all the units you can in this scenario, as you will need them in Part II and III.

There are a few options that players have tried with success:

# '''Leader Assassination.''' Use several Shadows (or Nightgaunts) to assassinate the guard General; their Nightstalk ability gets them past the perimeter guards and directly to his castle. Take him out in one turn or two, or he will recruit heavily. Moreover, either the manor entrance watchmen, or some guards to the south of the castle, will be alerted. Thus it is somewhat risky to try this even with 3 Shadows.

# '''Spectre-acular Cover Action.''' For this course of actions, no Shadows are necessary. You can use about 6 Wraiths/Spectres and slip them around the north of the map, as near to the manor entrance as possible, while staying out of sight. Malin and Darken Volk should take the same route, but can't get as far as the Ghosts. Then take out as many enemies as you can with your Wraiths, targeting the Mages first, and rush towards the manor with your heroes. You should be inside before the battle gets ugly. But - remember to recruit what you'll need later on before leaving the woods.

# '''Bait and Ambush.''' Each guard will only leave its post to attack you if it can personally see you, and General Taylor doesn't actually recruit all that much. So, pick a lone guard to be the first you alert - and make sure you kill it on the first round of your attack. If you can do so with a couple of Shadows - all the better, since, you'll disappear on the next turn. Then let the enemy force come to you - yes, it seems Taylor will also not continue to recruit. After his force is gone, continue picking off one guard at a time, luring each of them away to where you have sufficient units to gang up on the poor soul. In some cases you could risk it and do 2 at a time. This strategy is more likely to work if you have a few higher-level units to recall.

#'''Party Crasher.''' If you went with the minimal recruitment strategy last scenario and came into this one with a lot of starting gold, you can just treat it as a straightforward battle and stage a frontal assault on General Taylor. Recall all of your best units, and as many ghosts as you can afford. Taylor will recruit a lot of HI-type units, so the arcane melee attacks will be helpful for taking them down, and you will NEED at least 1-2 shadows, ideally up to 4, for Part II, so this bloodbath is a good opportunity to level up some ghosts. A few skeleton archers might be useful here as well, as Taylor likes to recruit cavalry-type units as well, but skeletons can also wear them down well enough in the perpetual night.

 
Remember to stay safely out of sight as much as possible (Ctrl+V will show you the enemies' moves, and their sight range is +1 of that, just like their attack range).

===== Which units to bring into the manor? =====

Troubled Adept asks: "Dear Walkthrough authors: I have raised many units from the dead, and now as I'm about to embark on a field trip to this lovely cave, they're all pestering me to take them with me! Whatever should I do?"

Well, dear Troubled, remember that there are no villages in caves, which means no healing for your troops, except by leveling-up or if they have draining attacks. So Wraiths and Spectres are probably the most useful. Nightgaunts, and perhaps Shadows, are also useful in that their skirmishing ability allows them to move into the back of a narrow space and kill on the same turn as first being noticed; but - they're not as useful as outside, since the manor is lit so they'll be visible. You should have some units which can take a beating - either sacrificial L1s (e.g. Ghouls or Skeletons), or higher-HP ones (Necrophage, Revenant). It's particularly useful to have units which are close to leveling-up - even if they're otherwise not so useful - since you can have them up front at the end of a turn, take some damage, and then either heal immediately or with another kill. Skeletons are pretty good for this.

As for ''how many'' units to bring in - don't overdo it. On Medium difficulty, 7 or 8 reasonable units in addition to Malin and Darken should be enough. You will need that carry-over gold later, you see.

An interesting option for Parts 2 and 3 is to bring in a Walking Corpse or Soulless (if you don't have a Necromancer) - which allows you to make additional sacrificial units inside. If you're short on better units, this might not be such a bad idea. Remember than for the price of 2 recalls you get 5 corpses to start with...

Events that can be triggered in this Scenario:

1. Any unit moves onto whirlpool at 38.23 - hostile lvl 2 tentacle of the deep appears

2. Any unit moves to temple at 10.18 - get a special Soulless

3. Create a mounted-type Walking Corpse by killing a mounted unit with a plague attack, then move that WC to the Stables at 9.15 - Get a Chocobone

===A Small Favor - Part Two===
* Objectives: Defeat Mage Lady Karae then move through the northwest passage
* Lose if: Malin Keshar or Darken Volk die or time runs out
* Turns: 30/27/19 (easy/medium/hard)
* Starting units: Malin Keshar, Darken Volk and any units that survived the previous scenario

* Other: You can't recruit or recall; only the units from last scenario will be present
You start with the units you had on the map at the end of the last mission, but you don't have to pay their upkeep for this scenario (nor are there any villages, anyway). Since there are no villages, you won't be able to heal your units unless they have a drain attack. Any unit which does not move for a turn will still heal 2 hp as usual.

Anyway, your first task is to kill Karae, who is a Silver Mage and is put into one of the rooms at random. Each room is filled with mages of one variety or another. They won't leave the rooms of their own accord, although a couple of Swordsmen and other human units wander the halls, but these shouldn't be a big deal. The mages, however, can be quite deadly. Always make sure you have sufficient forces to wipe out at least three Red or White Mages before opening a door. (You open doors by placing a unit in front of the door). However, most rooms only have one or two Mages in it, and they may be level one Mages. The skirmishing of Shadows and Nightgaunts is useful in wiping out mages. If you let the mages counter-attack, you will risk losing one or more units. Head northwest with Malin and move on.

There doesn't seem to be any bonus for an early finish, so if you get the objective early, you can hold off and harvest some XP. The city guard will helpfully filter in a few units at a time, and you can just camp your whole army around the entrance and kill them each turn before they have a chance to move. The scenario ends when Darken OR Malin exit through the northwest passage, so you can just sent Darken that way and let Malin keep killing city guard until the very last turn. Your top xp priorities should be getting Malin and your loyal ghost across the lvl 3 threshold, and trying to get as many lvl 3 ghosts, nightgaunts or spectres, as possible.

There are a lot of objects scattered around this level, and many of them trigger dialogue, poems, etc, but the only one which has a mechanical effect is the amulet at 3.15 which will give Malin 10% cold resistance if he steps on it.

===A Small Favor - Part Three===
* Objectives: Find the book and then escape
* Lose if: Malin Keshar or Darken Volk die or time runs out
* Turns: 21/18/15 (easy/medium/hard)
* Starting units: Malin Keshar and any units that survived the previous scenario
* Other
** You can't recruit or recall; only the units from last scenario will be present
** You no longer control Darken Volk

Darken Volk will operate separately with an army of allied undead. Hmmm, in all previous missions you commanded him directly... could this be foreshadowing? Head to the northwest to grab the book. Then head to the northeast to exit.

City guard units will continue to arrive through the entrance, like last scenario.

There are 3 rooms in front of you, and then a big cavern beyond with the book towards the northwest section. The enemy mages can do enormous damage to your forces, but they don't move unless you put a unit in their attack range, so use your more expendable or sturdy units to bait them out one at a time and then quickly dispatch them. You can also have your units follow along behind Darken Volk's reckless forces and take out the enemy mages after his units take the big hits.

As with last time, after you get the book and clear out the enemies in the cavern, you can camp at the entrance for as long as you want to farm xp. As with last time, the top priorities are getting to lvl 3 for Malin and your loyal ghost, and getting as many other lvl 3's as possible, especially Nightgaunts and Specters.

The room furthest to the left is the 'armory', and if you have the right lvl 3 units you can have them pick up some of the weapons on the ground:

1. Have a Draug step on the axe at 27.9 - permanent +1 damage

2. Have a Banebow step on the bow at 29.9 - permanent +1 damage

3. Have a Chocobone step on the spear at 27.10 - permanent +2 damage

===Alone at Last===
* Objectives: Take the book from Darken Volk and bring it back to Malin's castle
* Lose if: Malin Keshar dies
* Turns: 35/32/29
* Starting units: Malin Keshar and loyal ghost
* Other: Ghosts and Bats (and the rest of their unit trees) cannot pick up the book

The situation is that you must take the book from Darken Volk, but two additional forces will appear in the middle of the battle, bent on killing both your army and Volk's, making the task more than a little difficult. When the battle reaches its peak, you probably won't have much money (and may have Malin away from a castle), and your forces will be outnumbered and at great disadvantage.

The two extra forces are:

# '''Sir Cadaeus the Paladin''' is bent on making both you and Darken Volk pay for your attack on the city of Tath:
#* Arrives on turn: 6.
#* Inital force: 1 Paladins, 1 Mage of Light (+ Cadaeus, a paladin who will attack units that enter his movement range but will always return to his keep to recruit)
#* Finances: (on Hard) 100 gold on arrival + 20 base income.
#* Recruits: mages, white mages, paladins, spearmen, heavy infantry

# '''Dela Keshar''' is making good on her word to climb up the ladder for inheritance.
#* Arrives on turn: 13.
#* Initial force: None.
#* Finances: (on Hard) 240 gold on arrival + 24 base income.
#* Recruits: Spearman,Bowman,Swordsman,Longbowman,Thug,Poacher,Footpad

Now, this is a small level, and there really isn't room for 4 forces on it... your castle is on the West of the level, slightly to the South; Darken Volk is on the East and slightly to the North. Cadaeus sets up camp in the South-Eastern edge, and Dela in the northeast corner. You and Darken are separated by a narrow river, which at some point widens to surround a small island; and there are two connecting bridges, although the crossing is not a big deal at most points.

Now, Cadaeus' forces are extremely dangerous. While there's not too many of his units, the Paladins and the Mage of Light are the Humans' Undead-killer units, and, indeed, will kill most of your units in a single turn at daytime. And - guess what? He arrives on the second night, so his forces will start hitting you and Volk during the third day. ... but here's your silver lining: Cadaeus will advance on Darken Volk first, unless you're very much in his way, and no less importantly, Volk's forces will attack Sir Cadaeus' - if you've not already engaged most of them by that time. Effectively, Volk could be a bit of an ally, albeit one which is trying to kill you.

When Dela shows up, you will have lost any land to which you can run and hide. On the other hand, at least you're better equipped to deal with her units, and she arrives at Dusk. The Parthynians (sigh)... poor judgement through and through.

Remember, though, that this level is not about defeating all enemy forces, nor even all enemy leaders. There are just two things you need to do, which are kill Darken Volk and bring the [https://en.wikipedia.org/wiki/MacGuffin McGuffin], uh, I mean the book, back to your castle. Note that '''not all units can carry the book'''. Indeed, it so happens that all the fast units can't be used: No Bats and no Ghosts (nor Shadow, Wraiths, Spectres and Nightgaunts). The fastest choices are Malin himself or a Deathblade; and even with one of these units it takes 4 long turns to make it back to your castle... while probably engaged in painful rear-guard combat.

A silver lining is that for the next level you don't really need extra money above the minimum starting gold, so you can at least splurge with recruitment.

For all the strategies below, it's important to remember that, on Hard, Darken Volk has a +32 BASE income, before any villages, so he will keep recruiting to the very end and is surprisingly resilient against even sir Cadeaus's forces.

At any rate, here are two proven strategies for clearing the level:

# '''Assasinate, Grab, Run.''' Recall several squads of units: Assasination squad: Nightgaunts and Shadows - less than 2+2 would probably not be enough) Book carrier squad: Malin or Deathblade to carry, Wraiths (escort only), Spectres (escort only), and slower units if you must - but not that many overall. Diversion/cannon fodder: Go cheap here and mostly recruit. The assassins will circle Volk's forces from the North and assassinate him. The carriers and escort make a run for it; along the way, don't get too deep into confrontation with Volk's forces - you have a book to grap after all - but you don't have to completely avoid them either. Try to have the diversion get close enough to Volk's troops to make them want to attack. Run back with _all_ the carriers and the escort once you get the book. You will lose units in rear guard action during the retreat, but you can at least try to choose which ones. Some assassins might need to lay down their (un)lives for the (dubious) cause.
# '''The Northern End Around.''' Summon all your good troops and move everyone almost all the way North. Try to avoid full engagement with Volk for as long as you can - which will not be easy, since his units should be making contact by Turn 4. Once Sir Cadaeus arrives, Volk's forces will shift attention Southwards, and you can start moving East (still being North of the river). As you do so, Dela will arrive close to your forces, where she will build a stronghold and recruit. You now turn the tables on her and surround her stronghold - thus preventing her troops from moving and her from recruiting. YOu know kill her recruits, then her self (this was not possible with older versions of Wesnoth, now it is.) Make sure you dispatch her quickly, or else Sir Cadaeus' forces will crash into your own after killing Volk. Now face Sir Cadaeus' assault wave, while send a few units. off South into the river, out again and to Volk's castle to get the book and take it back to your stronghold. A variant of this strategy is to send, during the first few turns, some units due South-East as a diversion, trying to pull Volk's attention Southward. This feint can use some Ghost, Bats, and possibly even Malin himself, as the enemy really likes to focus on him for some reason...
# '''Fast and Ugly.''' Recall everybody, from Draugs to Nightgaunts, as well as a couple extra ghosts if you can afford them, and attack Darken head-on with a coordinated assault, across the south bridge. His wraiths will the most dangerous units to you with their arcane attack, so prioritize taking them out with Eidolon/Malin, and just wear everyone else down with weight of numbers, Draugs softening up his units and shadows/nightgaunts finishing them off. Move into the forests and hills west of Darken's castle and start pressuring him from that direction while Sir Cadaeus hits him from the Southeast. Prioritize taking out paladins, as they will be the biggest pain in the butt during your retreat, but ignore most of the rest of cadaeus' forces to encourage him and Darken to duke it out. When you see your chance, grab the book with Malin and then run like hell. Know which units are expendable. For the next scenarios, you NEED at least 2 level-3 ghost-type units to survive, but you can afford to lose a lot of Draugs and other strong units here and still be able to finish the campaign. This gets you done as quickly as possible, and you probably never interact with Dela's units at all.

Whatever initial course you take, the end game is the same: you will need to retrieve the book with a nonflying unit and head west, back to your stronghold.

Grabbing villages after a few at the start won't help you in this scenario. You will likely end negative on gold.

If you decide you need more gold to play this scenario, you have to go all the way back three scenarios to [[#A_Small_Favor_-_Part_One|A Small Favor - Part One]]. There, one way to get gold is to use Shadows to steal the enemy's villages without him noticing. However, your first option above, the grab and run, should not require much gold.

The next scenario will demand a lot of Malin and Eidolon, so get them as much xp as possible here, and try to get Malin the Vitalize upgrade if he doesn't have it already.

Here are the events which can be triggered in this scenario:

1. Malin steps on monolith on 5.18 - gain xp based on difficulty level

2. Recall special Zombie Jaime (the one you got from the temple 3 scenarios ago) and move him to boat at 16.4 - gain special abilities

3. Malin steps on monolith at 23.14 that appears when Darken Volk dies - gain xp based on difficulty level

===Descent into Darkness===
* Objectives: Multiple
* Lose if: Mal Keshar is destroyed
* Turns: n/a
* Starting units: Mal Keshar

This is a massive scenario that will usually take 100+ turns. Like an intensified version of A Haunting in Winter, it is mostly Malin flying solo, with a few undead sidekicks showing up right at the end, and it plays more like a series of puzzles than a typical Wesnoth battle. The downside of this is that if Malin has not accumulated enough of the right upgrades by this point it may be simply unwinnable and require either replaying several earlier scenarios to get him up to speed or relying on a lot of save-reloading to win the tricky solo fights.

You will get a lot of xp in this level, and the upgrades you choose will be very important. Counterintuitively, the most useful upgrades will be melee focused, first getting the strongest vitalize effect you can up until you finish the ritual, and then increasing your melee damage as much as possible afterward. The upgrade to get your movement points up to 6 and the one that gives you quasi-leadership are also very helpful in the upcoming boss battle.

1 - The Flesh

Malin starts the ritual to become a lich, and he first must 'overcome the limitations of his flesh', symbolically represented by a bunch of zombies and ghouls. You are surrounded by 6 runes, 2 each of 3 types. Each type of rune gives one of the following bonuses,and you can find out experimentally which rune gives which bonus:
1. Lifeblood - heal 40hp every turn, or cure poison
2. Carapace - gain 40% to all resistances
3. Conscience - increase damage 50%

Don't bother exploring the area away from the runes, there is nothing to discover. You just need to kill the randomly spawning enemies until a Necrophage named The Flesh of Malin Keshar shows up. Once you defeat it, you move on to the next challenge. This is where vitalize becomes so critical, as you will be taking a LOT of unavoidable melee hits, and those little 2 hp boosts really add up. Get the upgraded 4hp version if you get the chance. The Lifeblood rune will be very useful here as you will probably be repeatedly poisoned by all the ghouls.

2 - The Bones

Same set up, same runes, but now a bunch of random skeletons and skeleton archers, followed by the Bones of Malin Keshar, represented by a Revenant. The Lifeblood rune will serve you well again here, and carapace is helpful too now that you don't need to worry about poison.

3 - The Soul

The hardest stage by far, and the one where good upgrade selection can help but bad luck can still take you down. You're facing ghosts, spectres, and a very chonky 70hp Spectre named The Soul of Malin Keshar. The Carapace rune, the vitalize upgrades, and not taking too many of the upgrades that make you more vulnerable to arcane damage will hopefully get you through this battle...un-alive.

4 - Regaining Strength

You made it! It turns out that day one of glorious un-death consists of alternately chasing and hiding from various vermin. You're in a big complicated cavern system infested with various bats, scorpions, and rats. You need to explore, find stuff you can use, and maximize your new drain attack to recover you hp.

The key to making an hp 'profit' from your drain attack is standing on good defensive terrain. Try to sit on castle or hill hexes and let the animals come to you, so that the probabilities favor you coming out of the fight with more hp than you went in. Vampire bats are often just a bad investment in this sense because they have such good defense on all terrain, and it can be better to just zap them and wait for a rat or scorpion to come along instead.

There is one Dread Bat at 2.23 that you should avoid until you have a robust amount of hp built up, and should absolutely zap rather than trying to melee.

As you explore, you'll get a sneak preview that SOMETHING very scary is in a keep at 17.7, so you will wisely avoid it for now and solve the various puzzles to prepare yourself for the next battle.

Here are the events you can trigger in the cavern:

1. Step on the treasure boxes on 4.19, 28.23, 27.6, and 4.26 - get gold depending on difficulty level

2. Potion puzzle: Step on the brazier at 21.18, then the ice at 15.18, then the flask at 15.22, then the water at 15.18 (formerly ice), then the flask of water at 14.18, then the altar at 6.15 - +1 ranged damage

3. Coffin puzzle: Step on the key at 2.1, then the coffin at 3.2, then the skeleton at 1.3, then the coffin at 3.2, then the brazier at 5.3, then the coffin at 3.2 - +2 melee damage

4. Reflection Pool: step in the water around 19.30 - preview of the enemy keep.

Hopefully by the time you've solved all the puzzles and killed all the little creatures, you have a decent supply of hp and are ready for the main event.

5 - Xanthric

Once you get too close to the keep, specifically once your sight range covers the keep tile itself, it will trigger the boss battle. Xanthric's stats and the number of minions he gets vary with difficulty level, but he's always a big problem. His ranged attack does an absurd amount of fire damage with the marksmanship ability to boot, and he has a strong impact melee attack as well. The lava around his lair all counts as illuminated, which shuts off your nightgaunt's invisibility. And his minions both have fire attacks which are very effective against your units AND they respawn from the lava the turn after you kill them. He also has a pet giant spider hanging out on a village at 13.6 just to make your life even harder.

The first step of your strategy should be carefully baiting out the spider before triggering Xanthric and the rest of his minions. If you haven't been able to get your hp to full from all the random animals, you can sneak around the west side of Xanthric's keep and sit on the village at 12.1 until you get to full. Then sneak back south, keeping just outside the range where you can see the keep tile, and sit on the village at 10.8. Here, the spider can see you, but xanthric cannot. So the spider will jump out and attack you, and you will fight back with your ranged attack. He will probably retreat to his village before you can kill him, but DO NOT chase him! If you do, you'll trigger Xanthric. Instead, just sit patiently on your village (no turn limit!) until he decides to attack you again. Eventually, you'll get a couple lucky magic attacks and kill him before he has a chance to retreat. Then you can heal to full and start the main event.

When you move close enough to see Xanthric on his keep, Eidolon and your other 2 strongest ghost-type units will appear next to you. This is why pouring xp into Eidolon and finishing Alone at Last with at least 2 lvl 3 ghost type units was so critical. A bunch of runes will also appear around Xanthric's keep, and you can step on one of them per turn to summon a random assortment of low level undead units to help you. Unfortunately, Xanthric's team also appears, a number of fire elementals dependent on difficulty, (on Hard, it's FIVE).

Xanthric's fire elementals will respawn every turn, so trying to fight them head on is not useful, but you can beat them with trickery. It's a very big map, the fire elementals have a huge movement cost over cave tiles, and as long as the original number of elementals are alive SOMEWHERE on the map, no new ones will spawn. So you can use Malin and your ghosts to lure the elementals south, always staying just out of their reach, all the way down to the signpost near the start of the level, then ditch them and race back north up a parallel tunnel. That will buy you 2-3 precious turns to fight Xanthric by himself.

Once it's just you and Xanthric, trigger one of the runes, ideally the one on the east side of his keep near the two bridges. If you keep all of your ghost type units entirely out of his reach, he will jump out to attack one of your random fodder units. Now you can dog-pile him with Eidolon, your two other ghosts, and Malin with his melee attack (using your ranged attack would do more damage, but he does so much fire damage in retaliation that it is extremely risky). If you don't want to risk Malin in a direct fight, you can keep Xanthric ZOC locked by your other units while Malin rushes to his keep and uses the gold from the treasure chests to recall some other heavy hitters to finish the job. You're going to lose some high level ghosts in this fight no matter what, unless you get extremely lucky, but the last scenario is not that hard and you are about to get a new minion to compensate you for your losses.

===Endless Night===
* Objectives: Defeat the foolish hero
* Lose if: Mal Keshar is destroyed
* Turns: Unlimited
* Starting units: Mal Keshar

And so we reach the conclusion of the campaign. We learn that Mal Keshar—formerly Malin—has become a somewhat powerful lich that has gained a reputation for himself for fighting the orc armies (and anyone who comes in his way) every summer.

For this reason, heroes of every race that has been victimized by Mal Keshar's troops follow him to his lair, wanting to finally put an end to his advances. In this scenario you will be fighting this ''foolish'' hero, which will be either an elf, a loyalist, an outlaw, a dwarf, or an orc, chosen at random. You will be fighting them in your cave, so you have some advantage, but every time you beat one of these heroes, the scenario will repeat itself and a new hero will come for you, with more gold on his side, so it will be increasingly difficult to fight their armies.

You can play this scenario as many times as you want to. You really have to beat only the first two heroes—on the third iteration Malin's death becomes one of the 'victory conditions'. When Malin is defeated by any subsequent hero, the victor will give a short monologue and the campaign will end. You also have the option of choosing to give away the book in hopes that the world will one day accept necromancy.

Your new skeleton dragon pet has his own series of AMLA upgrades, like Malin and Eidolon, which you can explore to your heart's content by eating Foolish Heroes.

If you want to take the 'give away the book' path, then just tuck Malin and a few of his friends into the little side cavern with the bottleneck at 20.27. The enemy will pile up outside the bottleneck,and eventually one of them will stumble onto the book.

[[Category:Campaigns]]
[[Category:Campaigns - Walkthroughs]]

Guide to UMC Content

2025-06-24T22:49:37Z

Egallager: /* Flight to Freedom */ bump 1.18 branch to 5.6.2

This is a guide to current-ish user-made content for players. It provides unfamiliar players with detailed information about campaigns (including story, completion, difficulty and playing style) as well as detailed information about eras. Feel free to edit this guide, as it is a wiki.

This list covers add-ons for the latest 3 stable releases (1.14, 1.16, and 1.18) of Wesnoth. There are archived versions of this page for [[Guide_to_UMC_Content/1.10|1.10]] and [[Guide_to_UMC_Content/1.12|1.12]].

For content creators who loved an add-on that hasn't been added to 1.14, 1.16, or 1.18 yet, and are wondering about taking it over, please ensure that its entry on the older (1.12 or 1.10) wiki page is up to date, add a link to the add-on's feedback thread in the forums, and generally do the tidy-up that doesn't need you to start changing the campaign, and then ask the old maintainer. (You should probably also wait a bit before assuming that a maintainer isn't already porting to 1.16 or 1.18).

If you are looking for even more campaigns, please see the links in at the bottom of this page.

== Instructions ==
When adding a campaign to the list, please place it in its alphabetically sorted location, ignoring any initial article ("A", "An", or "The").

=== Blueprint for Campaigns ===

* Description:

* Author:

* Maintainer: if not maintained by the author anymore.

* Status:
** Broken = Does not work at all
** Incomplete = Partially written, no progress
** WIP = Partially written, some progress
** Complete = Completely written, but buggy as well as potential balance issues.
** Finished = Completely written, minimal to no bugs, slight balance issues possible.

* Version campaign version on the add-ons server

* Length:

* Requirements: (only if needed)

* Difficulty:

Please note: Often campaigns introducing new mechanics are listed as expert level on the add-on server, here difficulty means the raw difficulty after the mechanics are understood.

** Unbalanced = If you can't beat the hard mode, it isn't necessarily unbalanced, but if the difficulty changes erratically from one scenario to the next and only people using the debug mode have seen the final, then it is.
** Easy
** Normal
** Hard

Please note: If you didn't play the campaign, write the difficulty written on the add-ons server.

* Style:

Please note: Many campaigns will feature more than one style. Please list the most significant ones. If you don't know which style is the campaign you are listing, don't write this.

** Skirmish = small to medium sized armies, your standard Wesnoth gameplay
** Dungeon = long and narrow tunnels (not every underground scenario is a dungeon, a dungeon isn't necessarily underground)
** RPG = role playing game elements such as talking with non-player-characters, item collection, dependency on a party of very few adventurers without or limited recruits
** Survival = being exposed to changing, spawning enemies while remaining on the same map
** Large Battle = large number of units on the battlefield, sizely maps
** Simulation = campaigns feat. terrain modification, alternative resources
** Boss battle = the challenge is to defeat a single powerful enemy unit
** Minigames = there are puzzles and minigames in the campaign that significantly differ from standard Wesnoth gameplay

* Faction/Era: Era for the whole campaign and more specifically the faction or unit composition you field.

* Custom units: Link to the unit tree for cases that don't feel sufficiently described by Faction / Era entry.

* Forum: Links to the feedback and development threads at forums.wesnoth.org

=== Blueprint for Eras ===

* Description:

* Author:

* Maintainer: if not maintained by the author anymore.

* Status 1.14/1.16/1.18:
** see the list of statuses in the campaign blueprint

* Faction Descriptions: Describe your individual factions here.

* Requirements: (only if needed)

* Forum: Links to the feedback and/or development threads at [https://forums.wesnoth.org/ forums.wesnoth.org].

== How to play for UMC factions ==

=== Southern Nations by Elvenisko ===
[[How_to_play_Death_Knights|Death Knights]] |
[[How_to_play_Southern_Drakes|Southern Drakes]] |
[[How_to_play_Southern_Dwarves|Southern Dwarves]] |
[[How_to_play_Southern_Elves|Southern Elves]] |
[[How_to_play_Southern_Mages|Southern Mages]] |
[[How_to_play_Southern_Mercenaries|Southern Mercenaries]] |
[[How_to_play_Southern_Orcs|Southern Orcs]] |
[[How_to_play_Southern_Swamplords|Southern Swamplords]] |
[[How_to_play_Southern_Nations|Comparison]] |
[https://units.wesnoth.org/1.17/Southern_Nations/en_US/era_southern.html All units (can be out of date)]

== Battle for Wesnoth 1.14 and newer ==

=== Campaigns ===

==== After the Storm ====

''Follow the journey of Galas and his band following the events of Invasion from the Unknown''

'''Author:''' shadowm/ShikadiQueen/Iris

'''Status:''' Finished, 0.10.11

'''Length:''' 3 episodes of 13 scenarios each, some of which are multi-part

'''Difficulty:''' Medium-hard

'''Style:''' Skirmish, Boss Battle, Dungeon

'''Faction/Era:''' Many custom units

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=32091]

'''GitHub:''' [//github.com/project-ethea/After_the_Storm]

'''Note:''' (vultraz) Long, very enjoyable campaign with great story. (Knyghtmare) The best UMC campaign ever!

'''[[Guide_to_UMC_Campaigns/Players_Reviews#After_the_Storm|Players’ Review(s)]]'''

====A Beastly Tale====

''When a small village is beset by troubles, its fate rests in the hands of a young woodsman and the animals he befriends.''

'''Author:''' GloccusV

'''Status:''' Complete

'''Version:''' 2.0.3

'''Length:''' 5 scenarios

'''Difficulty:''' Intermediate

'''Custom units:''' [//units.wesnoth.org/1.14/A_Beastly_Tale/en_US/A_Beastly_Tale.html Here]

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=41434&p=633612&hilit=A+Beastly+Tale#p579093 Here]

====A Song of the Winds====

''Every era has its heroes and heroines. Before the song of Myra, the odyssey of Akhen Wadjet and the aria of Tenma Yozora, there was the song of the winds that echoed in the mountains and halls at the heart of the Great Continent. Follow young Maat of Hiera'Shirsha and Prince Abhai of Garet-Desh in the war that set the stage for one of the greatest upheavals Irdya has ever witnessed.
(Prequel to the Dragon Trilogy)''

'''Author:''' revansurik

'''Status:''' Complete

'''Version:''' 1.0.0

'''Length:''' 43 scenarios (some of them dialogue-only)

'''Difficulty:''' Intermediate

'''Custom units:''' War of Legends + Custom factions

'''Forum:''' [//https://forums.wesnoth.org/viewtopic.php?f=8&t=53913 Here]

==== Bad Moon Rising ====

''An expedition to gather treasure from the cold north sets off compounding disaster.''

'''Author:''' Doofus-01

'''Status:''' Complete 1.10.0

'''Length:''' 20 scenarios

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Archaic Era

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=31348]

'''GitHub:''' [//github.com/doofus-01/wesnoth-Bad_Moon_Rising]

==== The Black Cross of Aleron ====

''A elvish school for druids comes under attack by goblins. It seems more than just a routine raid; is there something more sinister behind this attack? - In Beseiged Druids, you control Eärendil, the surviving teacher at the school, and the many and varied initiates. Not all of these are ordinary students; many have been experimenting with other forms of magic, while others are simply overachievers in some area of study. Unfortunately, they are not especially good at combat, at least initially. Together with a very small contingent of surviving guards, it is up to these students to save the island of Aleron from disaster.''

'''Author:''' Celtic Minstrel

'''Status:''' Complete 2.0.3

'''Length:''' 9 scenarios

'''Difficulty:''' Unbalanced

'''Style:''' Skirmish

'''Faction/Era:''' Default, Elves

'''[https://units.wesnoth.org/1.14/Black_Cross_of_Aleron/en_US/celmin-druid-siege.html Custom units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=37342

==== Danse Macabre ====

''Macabre is a rare zombie who has intelligence and will. What's he like? What's his purpose?''

'''Author:''' kamikaze

'''Maintainer:''' James_The_Invisible

'''Status:''' Completed, 1.3.2

'''Length:''' 12 scenarios

'''Difficulty:''' Unbalanced

'''Style:''' Large Battle

'''Faction/Era:''' Default, undead

'''[//units.wesnoth.org/1.14/Danse_Macabre/en_US/Danse_Macabre.html Custom units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=33745]

'''Note:''' While the campaign is playable on Wesnoth 1.14 without major issues, it is (still) in need of heavy re-balancing. Sadly, for various reasons I am not able to do it in near future but patches are always welcome, preferably in form of pull requests on [https://github.com/konecnyjakub/Danse_Macabre GitHub].

==== Dawn of Thunder ====

''A young elvish fighter is send to represent the Aethenwood at the Ka'lian. The adventure turns out to be bigger than expected.''

'''Author:''' Paulomat4

'''Maintainer:''' egallager

'''Status:''' [https://github.com/cooljeanius/dawn_of_thunder/issues/3 Incomplete], latest release on the BfW 1.16 add-on server is [https://github.com/cooljeanius/dawn_of_thunder/releases/tag/0.2.4 0.2.4].

'''Length:''' 18 scenarios

'''Difficulty:''' Challenging

'''Style:''' Skirmish, Large Battle, RPG-elements

'''Faction/Era:''' Default, Elves, Humans

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=39512 forums.wesnoth.org/viewtopic.php?f=8&t=39512]

==== A Fiery Birth ====

''A scholar of the Great Academy journeys to the land of the drakes to discover their secret origins.''

'''Author:''' Mathbrush

'''Status:''' Complete

'''Version:''' 1.2.0

'''Length:''' 9 scenarios

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=47861&p=623953 Here]

'''GitHub:''' [//github.com/brirush84/AFieryBirth]

==== The Final Exam ====

''Young mage Erika must find a magic book to become a true mage. But will it really be her final exam?''

'''Author:''' Elven

'''Status:''' Complete, 2.6.1

'''Length:''' 4 scenarios

'''Difficulty:''' Easy

'''Style:''' Skirmish, Minigames

'''Faction/Era:''' Default, Loyalists

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=23398]

'''Note:''' Short, easy campaign with varying objectives. Features female mage as leader.

==== [[FlightToFreedom|Flight to Freedom]] ====

''Flight to Freedom chronicles the story of the drake hero Malakar, and his desperate cross-country flight out of slavery.''

'''Authors:''' MadMax, Nova

'''Maintainer:''' egallager

'''Status:''' Complete

'''Length:''' 20 playable scenarios + 1 dialogue-only, for a total of 21 (may need an update now that the "B" branch has been reactivated)

'''Version:''' [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.2 5.4.2] (for BfW 1.16), or [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.5.0 5.5.0] (for BfW 1.17), or [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.6.2 5.6.2] (for BfW 1.18), or [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.7.3 5.7.3] (for BfW 1.19.9)

'''Difficulty:''' Expert

'''Style:''' Skirmish, Large Battle, Puzzle

'''Faction/Era:''' Drakes

'''Required Wesnoth version:''' 1.16+ or 1.17+ or 1.18+ or 1.19.8+

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=1887 Development], [//forums.wesnoth.org/viewtopic.php?t=40195 Feedback]

'''GitHub:''' [//github.com/cooljeanius/Flight_Freedom github.com/cooljeanius/Flight_Freedom]

==== Inky's Quest ====

''The Cuttlefish Campaign''

''Are the cuttlefish mere beasts or something more? What stories would they tell if they could speak? This story provides one possible answer. The easiest difficulty provides hints for novice players.''

'''Author:''' Telchin

'''Status:''' Complete

'''Length:''' 12 scenarios + story-only epilogue, for a total of 13

'''Version:''' 1.5.6

'''Difficulty:''' Easy

'''Style:''' Skirmish

'''Faction/Era:''' Custom units (cuttlefish, tentacles, giant clams...). Enemies use both default era units and custom ones.

'''[//units.wesnoth.org/1.14/Inky_Quest/en_US/Inky_Quest.html Custom Units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=32501]

==== Invasion from the Unknown ====

''Episode I - Seeking the Light: Long after the Fall, the last forest elves are forced to abandon their safe valley, and find themselves resorting to the dark means of necromancy in order to survive the perils and challenges of this new harsh world. May they finally free the Great Continent from its chaos, or perish in the foolish attempt of restoring peace and life to the lands.''

''Episode II - Armageddon: As the shadow of Chaos covers the entire continent, an assorted group of foolish heroes prepares a counter-attack to the Empire, with one unique goal in their minds: defeat the evil Emperor, whoever it is. Lead these courageous living and non-living warriors to victory, and rediscover lost secrets of the history.''

'''Author:''' shadowm/ShikadiQueen/Iris

'''Status:''' Finished, 2.1.9

'''Difficulty:''' Normal

'''Style:''' Skirmish, Dungeon, Boss battle

'''Faction/Era:''' Unique. You play Elves and Undead throughout the campaign.

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=43309]

'''GitHub:''' [//github.com/project-ethea/Invasion_from_the_Unknown]

'''Walkthrough:''' [[IftU Walkthrough]]

''[[Guide_to_UMC_Campaigns/Players_Reviews#Invasion_from_the_Unknown|Players’ Review(s)]]'''

==== Leader of the Drakes ====

''Leader of the drakes is killed. His son tries to defend homeland against the orcs. He choosed to ally with saurians, but other clans of drakes disagrees. Will fast and unexperienced Morin win against orcs and rebel drakes alike?''

'''Author:''' Elven

'''Status:''' Complete, 1.02b

'''Length:''' 3 scenarios

'''Difficulty:''' Easy/Medium

'''Style:''' Skirmish, Minigames

'''Faction/Era:''' Default, Drakes

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=53951&start=15]

'''Note:''' Short, easy campaign with simple objectives. Features Drake Glider as leader and modified Drake Burner with cold and slowing blade.

==== Legend of the Invincibles ====

'''''Part I: Shrouded in Darkness''' (5 chapters, 90 scenarios) - A pair of heroes, after stopping an orcish threat, are outcast into caves, where they have no other choice than to become liches in order to survive. They preserved their original appearance and moral principles, and fight in various skirmishes against evil (although using evil methods sometimes), until the Fall, when they are buried alive under the ashes of the third sun.''

'''''Part II: Into the Light''' (5 chapters, 110 scenarios) - Long after the Fall, the lich heroes awaken. Searching for more power, they manage to resurrect themselves as living beings, but this time more powerful and ridden of the evil within. But the evil from inside them did not cease to exist, and started a campaign to conquer the world. Stopping the campaign caused an even worse disaster...''

'''Author:''' Dugi

'''Status:''' Complete

'''Length:''' 200 (+8 talk-only) scenarios

'''Difficulty:''' Normal

'''Style:''' mostly Skirmish and Dungeon (all other styles are present as well, but less frequently)

'''Faction/Era:''' Elves, Loyalists, Undead, Dwarves; but they advance past their usual maximum level

'''Forum:''' [//r.wesnoth.org/t32384]

'''GitHub:''' [//github.com/Dugy/Legend_of_the_Invincibles]

'''[[Guide_to_UMC_Campaigns/Players_Reviews#Legends_of_the_Invincibles|Players’ Review(s)]]'''

'''Note:''' The most unique feature of this campaign is its RPG-like unit development system, enemies drop items units can use, leaders are stronger than most usual units and all units get AMLA (after maximum level advancement) after reaching their maximum level (that is also increased by a load of additional level 4 units).

==== A New Order ====

''The old kingdom of Wesnoth has fallen before barbarian hordes. The occupying barbarians are on the brink of civil war, the seeds of Wesnothian rebellion are kept alive by old legends, while bandits and Dunefolk mercenaries roam the land. Can Gawen Hagarthen unite these disparate factions against a common foe?''

''Note: This campaign contains mature themes, some of which may be unsuitable for children.''

'''Author:''' szopen

'''Maintainers:''' nemaara (Yumi), egallager

'''Status:''' Finished

'''Version:''' [https://github.com/nemaara/A_New_Order/releases/tag/1.7.0 1.7.0]

'''Length:''' Hard to say as it is non-linear; it is advertised as having 45 scenarios, but the numbering only goes up to 30 due to some of the scenarios being alternates to one another.

'''Requirements:''' Requires BfW 1.16+. Also uses the "Akladian Music" add-on.

'''Difficulty:''' Advertised as intermediate; could be considered hard, though.

'''Style:''' Mostly Skirmish, some Large Battle

'''Faction/Era:''' mostly various human factions (including the Dunefolk), with the addition of the Akladian faction of humans

'''[//units.wesnoth.org/1.16/A_New_Order/en_US/A_New_Order.html Custom Units]'''

'''Forum threads:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=6486&sid=2e644284f54e65736b4f1543b7098ef9 Development], [//forums.wesnoth.org/viewtopic.php?t=36183 Feedback], [//forums.wesnoth.org/viewtopic.php?t=6174 Original (older) art thread], [//forums.wesnoth.org/viewtopic.php?t=36074 Current art thread]

'''GitHub:''' [//github.com/nemaara/A_New_Order github.com/nemaara/A_New_Order]

'''Note:''' (Pyrophorus) Certainly one of the most mature and well designed campaign in add-ons. A must.

''' [[Guide_to_UMC_Campaigns/Players_Reviews#A_New_Order|Players’ Review(s)]]'''

==== The North Wind ====

''Wesnoth's army was occupied fighting Mal Ravanal in the East, but there were whisperings of an orcish attack in the north. Konrad II must send Deoran, now an experienced rider and commander, with a small band of knights to hold off the orcs....''

''This campaign features unique gameplay characteristics such as a lack of recruiting and a 24-turn time-of-day cycle.''

'''Author:''' aelius, Deusite; pyndragon

'''Status:''' WIP, 0.3.0

'''Length:''' 1 playable scenario, 6 intended

'''Difficulty:''' Normal

'''Style:''' RPG, Skirmish, Survival

'''Faction/Era:''' Loyalists

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=42854]

==== The Ravagers====

'''Description:''' ''The Ravagers'' is a tale of pure revenge. A tale of justice served cold, told in a flashback-style point-of-view narrative, by a ranger in the Inn at Weldyn.
The campaign includes many new exciting gameplay features, fun mechanics such as drinking, hundreds of custom units, and many more.

'''Author:''' WhiteWolf

'''Status:''' Finished*

'''Length:''' 25 playable scenarios + 2 scene scenarios

'''Requirements:''' Akladian Music Pack, Underness Music Pack

'''Difficulty:''' Intermediate

'''Style:''' Skirmish + RPG / Flashback narrative

'''Faction/Era:''' Humans, Elves, Ravagers(dark humans)

'''[//units.wesnoth.org/1.14/The_Ravagers/en_US/The_Ravagers.html Custom Units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=44930]

'''*Notes:''' The main storyline is complete, but there are unfinished side-missions that are still in development. The campaign is aimed to become finished with version 1.2.0.

==== Return from the Abyss ====

''After taking part to a disastrous expedition, Khafir and his men are lost and isolated from their people, thousands of miles away from home, bound by a pact sealed with a powerful dwarvish king. Help him escape from the depth of Irdya and finding his way back, in an adventure across two worlds during the rise of a sinister force in the Great Continent.''

'''Author:''' skeptical_troll

'''Status:''' finished

'''Length:''' 19 playable scenario + 10 story only

'''Difficulty:''' Hard

'''Style:''' Skirmish, Dungeon

'''Faction/Era:''' Dunefolk/Default

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=44545]

==== Rise of the Dunefolk ====

''Adventure of Siabbin and Helare from small village in desert, who step by step made the foundation of the Dunefolk nation. Play a stunning adventure against many enemies in different maps - from sandstorm to swampy areas and caves. Defeat powerful lich lord and train one of the best dark mages in the world of Wesnoth.''

'''Author:''' Elven

'''Status:''' Completed

'''Length:''' 11 scenarios

'''Difficulty:''' Medium

'''Style:''' Skirmish, Minigames, Survival

'''Faction/Era:''' Default, Dunefolk and dark mage

'''Note:''' enjoable gameplay with every map different. Enough experience to upgrade your units.

==== The Return of the Darks ====

''The Darks are a race which left Wesnoth in the ancient times and lives on Isles in the sky. But now the Magic wich helped them to move the Isles in Sky got lost and the isles are about to fall down. Rumion an adventurer goes to Wesnoth and searchs for something that could help them.''

'''Author:''' thvk

'''Status:''' WIP

'''Length:''' 4 playable scenario + 2 story only

'''Difficulty:''' Easy

'''Style:''' Skirmish

'''Faction/Era:''' Default + some self made units

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=52731]

==== Secrets of the Ancients ====

''From the Journal of Ardonna of Tarrynth:''

''It's unfair that we humans must die after so few years. Though this is the natural order, we need not embrace it! The lords on the Green Isle knew how to live forever. Pursuit of that knowledge was declared illegal by King Haldric I, but I believe it is worth the risk: If I can rediscover the secrets of the ancients, not only will I cheat death, I will become a hero to the whole continent!''

'''Author:''' beetlenaut

'''Status:''' Mainlined (this is now one of the campaigns that is downloaded with Wesnoth itself)

'''Length:''' 18 playable scenarios + 3 story only

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Undead/Default

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=40545]

'''Walkthrough:''' [[Secrets of the Ancients Walkthrough]]

==== Swamplings ====

''Banished by Yushnak the Ponderer, a tribe of lowly swamp goblins endure in the deadly mire of Pogo Bog. Four centuries before the founding of Wesnoth, this is the story of the goblins' struggle against the intrigues and betrayals of the greater races, and the rise of the first wolf rider.''

'''Author:''' John Rawlins (boru)

'''Status:''' Complete

'''Length:''' 17 scenarios

'''Version:''' 1.2.0i

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction:''' Goblins

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=41254]

'''[[Guide_to_UMC_Campaigns/Players_Reviews#Swamplings|Players’ Review(s)]]'''

==== The Dark Hordes ====

''Lead fugitive dark sorcerer Gwiti Ha’atel to mastery of the undead hordes.''

'''Author:''' Circon

'''Maintainer:''' Various

'''Status:''' Incomplete/WIP

'''Length:''' 15 scenarios done so far

'''Version:''' 0.1.2

'''Difficulty:''' Unbalanced

'''Style:''' Skirmish

'''Faction/Era:''' Default undead

'''[//units.wesnoth.org/1.10/The_Dark_Hordes/en_US/The_Dark_Hordes_1.html Custom Units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=16576&]

==== The Tale of Vaniyera ====

''The expansionist Lavinian Legion, led by the Imperator himself, has invaded the northern forests of the Sidhe, or Wild Elves. It is up to Leithan the Thunderblade and his advisor Vaniyera to push its armies back where they came from...''

'''Author:''' oreb, turin

'''Maintainer:''' UnwiseOwl

'''Status:''' Finished 0.11.0

'''Length:''' 5 scenarios

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Imperial Era, Sidhe.

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=37880]

'''Walkthrough''' There is a video-walkthrough by the campaign maintainer that begins [https://www.youtube.com/watch?v=dGM1bjImvkI&list=PLZorLYWvUD7VIhaXxKwzO8iQANlp_TaF0 here].

'''Note:''' As of August 2014, all previous issues raised about this campaign have been addressed. If you've not played this campaign since 1.4 or 1.10, in this humble maintainers opinion, it's worth another go.

==== To Lands Unknown ====

''This is the story of Mehir, the Summoner, and his journey to lands unknown.''

'''Author:''' inferno8

'''Status:''' Complete

'''Length:''' 20 scenarios, 4 dialogue only

'''Difficulty:''' Intermediate (Era of Magic)

'''Style''': Skirmish, Dungeon

'''Era:''' Era of Magic

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=31799]

'''GitHub:''' [//github.com/inferno8/wesnoth-To_Lands_Unknown]

'''[[Guide_to_UMC_Campaigns/Players_Reviews#To_Lands_Unknown|Players’ Review(s)]]'''

==== A Vision Blinded ====

''Defend the northern forest against what appeared like a routine orcish raid, and unravel the greater conspiracies that lie below its waves.''

'''Author:''' LemonTea

'''Maintainer:''' Adamant14

'''Status:''' Complete, 1.0.14

'''Length:''' 13 playable scenarios + 1 dialogue-only

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default, Elves (+ Trolls, Outlaws)

'''[//units.wesnoth.org/1.10/A_Vision_Blinded/en_US/A_Vision_Blinded.html Custom units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=23463]

=== Eras ===

[[Category:Campaigns|*]]
[[Category:Eras|*]]

==== '''Southern nations''' ====

[[How_to_play_Southern_Nations|Everything about southern nations, including how to play series]]

==== '''War of Legends''' ====

'''Description:''' A multiplayer era focused on the Dark Irdya Campaigns. Contains 15 factions.

'''Author:''' Tahsin Jahin Khalid (Lord-Knyghtmare)

'''Maintainer:''' Tahsin Jahin Khalid (Lord-Knyghtmare)

'''Status:''' Complete, new features being added for the 1.15.x version of the add-on

'''Factions:'''

# Aragwaithi
# Windsong
# Human Alliance
# Orcish Union
# Southerners (Desert Elves)
# Outlaws
# Elementals
# Undead
# Drakes
# Dark Legion
# Sylvans
# Minotaurs
# Vampires
# Dunefolk
# Knalgan Alliance

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=19&t=30087 Development and Feedback Thread]

'''GitHub:''' [//github.com/knyghtmare/War_of_Legends]

==== Era of Magic(EoMa) ====

'''Description:''' Aiming at using the whole potential of Battle of Wesnoth's graphic engine, the Era of Magic is considered to have a most amazing special effects and attack animations in the BfW game. There are 8 playable factions with fully animated units and tons of special effects contained in the era, and the stories of them are told in the campaign "To Lands Unknown".

'''Author:''' Inferno8

'''Maintainer:''' Inferno8

'''Status:''' Finished, 3.1

'''Faction Descriptions:'''

Sky Kingdom - powerful magi of all kinds. Their knowledge allows them to cast amazing spells and summon creatures like unstopable Golems or mysterious Mus. Masters of Elements and Gurus are one of the most powerful human beings in the Era.

Al-Kamija - these proud people are good warriors and spell casters of the desert. They use magical circles and scrolls to summon amazing creatures like Jinns or elementals from other dimension called Abyss. These creatures can't be poisoned, which is a great advantage.
(The campaign "To Lands Unknown" is mainly about the story of this faction)

Tharis - fearsome Tharis faction is very dangerous especially at night. Cruel people of Tharis with their black magic and dreadful monsters like Hydra can demolish everything standing on their way. Being so powerful in attack, Tharis have no healer, so they need to push forward at all costs.

Kharos - this strange name is the name of a beautiful country ruled by prophets of light. These peaceful people are masters of defense and support. Their formations of healers and Shielders assisted by Silver Warriors, who can teleport between friendly villages, are very hard to destroy.

Barbarians - the best in hand-to-hand combat. This multi-cultural society divided into Goblins, Orcs, Cyclops and Trolls with their own advantages and disadvantages can be hard opponent, but separately they are very weak.

Runemasters - these Dwarves use runic magic and equipment and are well known of their protection against magic. The Runemasters create steam machines like Gyrocopters, Robots and even mighty Mechanical Dragons. Units from this faction are very resistant but slow.

Dark Blood Alliance - this faction is composed of agile lizards, giant frogs, wyverns swallowing enemies and salamanders, which have developed to perfection the art of disguise. At the head of the community stand shamans known for their water magic, which is used in the fight as well as in healing.

Destroyers - a terrifying undead creations consisting of civilizations long gone...

'''Version:''' 1.1.1 (February 18th, 2015)

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=19&t=20039 Development and Feedback Thread]

'''GitHub:''' [//github.com/inferno8/wesnoth-Era_of_Magic]

==== Ageless Era ====

'''Description:''' Ageless Era is a compilation of the most popular eras and factions on the add-on server. It is more an era pack than an era.

'''Author:''' mnewton1, Ravana and various

'''Maintainer:''' Ravana

'''Status:''' Finished, 4.19

'''Unit Tree:''' [//units.wesnoth.org/1.12/Ageless_Era/en_US/Ageless%20Era.html Ageless Unit Tree (for 1.12)]

'''Factions List:''' Currently there are 91 factions in the era:

Default: Loyalist, Rebels, Northerners, Undead, Knalgan Alliance, Drakes, Khalifate

Extended Era: Loyalist, Sylvans, Dwarves, Outlaws, Northerners, Undead, Chaos, Dark Elves

Archaic Era: Khthon, Phantoms, Despair, Primeval, South-Seas, Ukians, Northern Orcs

Era of Four Moons: Highlanders, Imperialists, Sea States, Darklanders, Dalefolk, Freemen, Pygmies, Whites

Era of the Future: Welkin, Brungar

BEEM: Anakes, Calidonians, Wood Warriors

Custom Factions: Yokai, Dark Legion, Desert Elves, Steelhive, Frozen

Era of Myths: Celestials, Devlings, Elementals, Therians, Vampires, The Warg, Windsong

Feudal Era: Aragwaithi, Ceresians, Clockwork Dwarves, High Elves, Orcish Khaganates

Imperial Era: Arendians, Cavernei, Issaelfr, Lavinian Legion, Marauders, Orcei Gladiatores, Sidhe

Era of Strife: Eventide, Triththa, Free Saurians, Eltireans, Minotaurs

Era of Magic: Barbarians, Dark Blood Alliance, Sky Kingdom, Kharos, Runemasters, Al-Kamija, Tharis, Destroyers

Mercenaries Era: Highlanders, Enchanters, Avians, Slavers, Mercenaries, Equestrians, Emperor's Guard, Oracles, Holy Order, The Cult, Fanatics, Tribalists, Hive, Infernai, Refugees, Blight

'''Git:''' [https://github.com/ProditorMagnus/Ageless-for-1-11 Ageless-for-1-11] and also for 1.12 and [https://github.com/ProditorMagnus/Ageless-for-1-14 1.14]

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=19&t=25274 Development and Feedback Thread]

==== Imperial Era (IE) ====

'''Description:''' One of the oldest maintained user eras, the Imperial Era brings together seven different factions in a completely re-imagined setting, the world of Orbivm, a very lethal world indeed. The era contains both mainline and development versions of each faction and can be used to play five campaigns, each featuring a different race.

'''Author:''' Orbivm Project (but really Turin)

'''Maintainer:''' UnwiseOwl

'''Status:''' Complete, 0.23

'''Faction Descriptions:'''

# Lavinian Legion - Based on the Roman Legion, the Lavinians have strong, versatile melee units in the legionaries and a range of support classes sourced from amongst the Lavinian population and various subjugated races. The legion are strong in the plains but weak when fighting in forested areas. The Lavinians are featured in "Fall of Silvium".
# Sidhe - The Sidhe are a group of forest-dwelling elves whose focus is stealth and fleet movement. Their mages are able to channel the lightning itself, and their various other units move almost as fast. The Sidhe feature in "Tale of Vaniyera".
# Marauders - Based on the Germanic peoples that eventually conquered Rome (hint, hint), the Marauders are equally as at home in the hills, forests and swamps of their homeland. Their hard-hitting melee units are practicalyl unstoppable during the night-time. The Marauders are the stars of the "Alfhelm the Wise" campaign.
# Orcei Gentorum - The orcs have been captured gladiators slaving away in the Lavinian arenas for generations.The life of an orc in Orbivm is harsh and brutal, just like the orcs themselves. The tale of the uprising of one such group of Orcs is told in "Up from Slavery".
# Cavernei - The Cavernei are a dwarvish race with similarities to the mainline Knalgans, but with a greater emphasis on the military uses of runesmithing. They get a campaign too, in "Gali's Contract"
# Issaelfr - The frost elves live on the fringes of the habitable lands of Evrosia, the main continent of Orbivm, and have become inured to difficult conditions and tuned in to their Fae natures. They don't have a campaign yet, but you could always write one.
# Arendians - The Arendians are horse-lords living on the Western steppes of Evrosia. A life of constant battle has developed a military-focused society where warriors are trained from a young age. They used to have a campaign, but it fell into disrepair a very long time ago.

'''Wiki:''' [[Orbivm]]

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?t=37920 Development and Feedback Thread]

==== Lonely Era (LE) ====

'''Description:''' The Lonely Era is a new collection of six selected superior solitary sides with interesting and unusual abilities, traits and attributes.

It has been extensively revised and rebalanced over the last few years from the original era and the constituent factions.

'''Author:''' Atreides. Based on work by Shield, Desert_Shyde, Brilliand, Stern, Cloud, Grigistian, mikoc5, Stopsignal, The_Gnat, Minnakht.

'''Maintainer:''' Atreides

'''Status 1.16:''' Finished

'''Faction Descriptions:'''

1) Santa's Helpers are his Elves as well as animated pine trees. They are an updated faction based on the Merry Christmas Campaign. Beware of Elves bearing gifts though, the presents are very distracting. They are unique in not having standard levels, they each can gain up to 4 special abilities via AMLA but always remain at level 1. Of course there are also Flying Reindeer and Christmas Seals.

2) Gremlins are an all teleporting race of elusive ethereal creatures. Individually fragile they work together using their tremendous mobility to swarm and overwhelm their enemies. Their mages are perhaps the ultimate glass cannons but if you can somehow keep one alive long enough it might even get to level 5 and become immortal.

3) Vaeringjar are a Viking faction allied with Wolfkin. The vikings eschew ranged weapons as well as sissy ideas like dodging blows but are a very, very hardy lot. They also have a unique herbalist unit that can inspire berserker rage in adjacent vikings for a turn. The wolfkin are lithe and armed with bows and teeth on the other hand. They are also very agile in contrast to the vikings. As nocturnal hunters they are devastating at night and almost helpless in the day.

4) Avians are cold loving, water hating bipedal birds. Their hollow bones and feathers make them vulnerable to fire and blunt weapons. They are unique in having cheap level 0 healers. Unusually their leaders are not drawn from the ranks but form a separate class only selectable as leaders. Tamed Albatrosses to patrol the awful waters.

5) The Deep Ones - Slimy, slippery, blasphemous fish-frogs of the nameless design - living and horrible - have now been sighted on the edge of Wesnoth. Mutants who slowly evolve from human to monster these creatures are nothing to be trifled with! An all water faction they are quite capable of holding their own against the landlubbers.

6) Jephrifs live far up in the sky, miles above land. Away from even the most basic things most other races take for granted, such as solid ground, their society developed to be quite alien indeed. In recent times, jephrifs began descending from the skies to participate in combat against other races - apparently for their own amusement, seeing life as a game.

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?t=42630 Development and Feedback Thread]

== Additional info ==
See also:
* [[Player_UMC_Reviews|Player UMC Reviews]]
* [[:Category:User-made Campaigns - Walkthroughs|Walkthroughs for user-made campaigns]]
* [//r.wesnoth.org/t37476 forum thread] for this page
* [[Guide_to_UMC_Content/1.12|Guide to user-made content (UMC) for Battle for Wesnoth 1.12]]
* [[Guide_to_UMC_Content/1.10|Guide to user-made content (UMC) for Battle for Wesnoth 1.10]]
* [//r.wesnoth.org/t36733 thread discussing 1.8 UMC that wasn't ported to 1.10]
* [//r.wesnoth.org/t48086 thread discussing all UMC that hasn't been ported to 1.14]
* [//addons.wesnoth.org the addon server]

FlightToFreedom

2025-06-24T22:48:50Z

Egallager: add 5.6.2 for 1.18

<big>Flight to Freedom</big>


Last updated 3/24/25 (although before that, there have been multiple long stretches where it hadn't been updated, so much of the info on this page may still be out-of-date)

Flight to Freedom is a campaign featuring the Drakes. The hero, Malakar, and his tribe have been enslaved by humans,
and Malakar must free the tribe and take revenge on his oppressors.

Latest versions, depending on your Wesnoth version, are:

* [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.2 5.4.2] (for Wesnoth 1.16.x+)
* [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.5.0 5.5.0] (for Wesnoth 1.17.x+)
* [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.6.2 5.6.2] (for Wesnoth 1.18.x+)
* [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.7.3 5.7.3] (for Wesnoth 1.19.9+)

The forum thread is [http://www.wesnoth.org/forum/viewtopic.php?f=8&t=1887 here]. 
Made by MadMax, Nova 
Currently maintained by [[User:egallager|egallager]], although MadMax still contributes, too. 

== News ==

9/6/04: 
News started, not that I expect much to come up.

Artists wanted [http://www.wesnoth.org/forum/viewtopic.php?t=2996 here] for a new Kogw graphic. 
Announce your loyalty to the Drake cause [http://www.wesnoth.org/forum/viewtopic.php?t=2976 here]!

9/7/04 
I need feedback to keep improving. Keep it coming.

9/13/04: 
Revision 27 released, with many changes. A major update.

9/17/04: 
Poll updated. Redeclare your loyalties [http://www.wesnoth.org/forum/viewtopic.php?t=3132 here]!

9/19/04: 
Poll updated again. Prove yourself [http://www.wesnoth.org/forum/viewtopic.php?t=3143 here]! 
Campaign is on campaign server (requires CVS). Unless any major bugs arise before 0.8.5 is released, all future updates
will take place on the campaign server.

9/23/04 
revision 28 released on campaign server. Contains new drakes, Kogw graphic, and several balance changes. Requires CVS
or better 
Need attack/defense animations for Kogw graphic, need indoor time graphic (the picture under the map)

9/24/04 
revision 28.3 on campaign server. This is necessary for compatibility with CVS as of 9/24/04 (when the Drake Slave was
removed). Also has many bug fixes, including the bug that caused scenario 2 to hang.

9/26/04 
revision 28.4 on server. Bug fixes, balancing, additions to River of Skulls (credit Wesvoid), and an easter egg (not
telling you what, but I will say it's randomly activated in Endgame).

10/5/04 
revision 29 released. 1.4MB. Major changes: 
many bug fixes 
thunder spirit spawn animation 
debugger unit for testing and cheating 
improvements to Rebellion, Manor, Exodus 
new sound in the victory sequence 
new Drakes 
Note that there are some nasty engine bugs (Savannah #10569, #10570) that cause the recall list to disappear in Open
Ocean, and the campaign to quit altogether in Drake Escape. If anyone can help, I would very much appreciate it.

10/8/04 
New version. This changes the pier tiles to bridge, and it adds the Drake Hatchling back and the Drake Guard required
in scenario 21, fixing a major bug involving recruitment.

10/15/04 
New version. Bug in Drake Escape (#10570) worked around, but recall bug (#10569) is still at large. I also have made
Kogw level two, and gave him a level 3.

11/21/04 
New version released on campaign server. (2.2) 
Improvements:

switched to the x.x.x version system 
neutral birds actually fly 
in Drake Escape, Goblin Pillagers can pillage 
balancing changes to many scenarios 
bug fixes in Rebellion

1/3/05 
Update: 
version 2.4:

bug fix 
storyline images for Survival and Rebellion 
balancing improvements in Endgame

1/19/05 
Update: 
version 2.5:

changes to Manor 
a major bugfix

1/20/05 
Update: 
version 2.5.1

minor bugfix in Manor

2/3/05 
Update: 
version 2.6

maps use new terrains where appropriate 
scenarios set on Morogor now have their location denoted on a [http://gs295.sp.cs.cmu.edu/brennan/wercator/index.html Wercator]-
created map ([http://gs295.sp.cs.cmu.edu/brennan/wercator/maps/Peoples_in_Decline.jpg here]) 
balance changes to Manor, River of Skulls, Return to Morogor, Liberation, Endgame 
minor bugfixes

2/19/05 
Update: 
version 2.6.1

directory structure updated 
balance changes to Endgame 
0.8.11 compatibility

2/27/05 
Update: 
version 2.6.2

major bugfix to Blockade, should be possible to win now

4/13/05 
Update: 
version 2.7

scenarios updated for compatibility with 0.9 
varied dialogue improvements 
balancing to River of Skulls (removed village in chokepoint) 
scenarios take advantage of new [objectives] tag, changing objectives added 
maps now use river ford and ruin terrains

5/14/05 
Update: 
version 2.8

translated into German and Swedish 
WML syntax updated for 0.9.1 (involving translations) 
portrait for Kogw

6/10/05 
Update: 
version 2.9

WML updated for 0.9.2 
WML optimizations, separate copies of drake unit.cfgs no longer needed 
portrait for Malakar added 
balancing changes to Survival 
pngcrush run on all images 
rock golem image updated

6/22/05 
NOTE: This update breaks all in-game saves (NOT beginning-of-scenario saves) for the following scenarios: 
Southern Shore 
Open Ocean 
Landfall 
Blockade

Update: 
version 2.9.1

SHOULD be compatible with 0.9.2CVS 
missing newline at end of Flight_Freedom.cfg fixed 
FtF's Pirate Galleon does not override the in-game Pirate Galleon 
new graphics for the Driver 
balancing changes to Rebellion and Manor, Malakar has leadership in those scenarios

7/03/05 
Update: 
version 2.9.2

balancing change to River of Skulls, second chokepoint added parallel to the first 
mid-scenario objectives changes work properly now 
enemies in Survival do not recruit infinite numbers of units 
in Caravan, the caravan's movement points reflects its actual movement

11/02/05 
I know it's been overdue for over a month, but here it is. I've finally got the underground scenarios balanced, but there are so many changes (and so little time to debug) that I have had to release a beta. Hopefully, unless any major bugs are found, I'll finalize FtF 3.0 in a week.

In the meantime, PLEASE reply if you find any bugs.

12/2/05 
UPDATE: 
version 3.0

FtF 3.0 finally released!

Many changes across the board, far too many to list, but here are the major changes (including those of the 3.0 beta): 
storyline changes 
Rebellion enhanced 
underground scenarios balanced 
bug fixes, dialogue changes in Landfall

12/3/05 
UPDATE: 
version 3.0.1

game-killing bug in Landfall fixed (map was not sent)

3/23/06 
UPDATE: 
version 3.1

updated for 1.12+, not backward compatible (beginning-of-scenario saves will still work) 
new terrain added: dark tiles, from UtBS (replaces some dirt, sand in caves) 
maps updated for new terrain 
image references updated to reflect 1.12 directory structure 
terrain code for lava bridge changed to ` instead of ' to avoid conflict 
Skeletal Dragon, Watch Tower moved into FtF from EI, SoTBE (credit Hanno for alerting me to this) 
old wesnoth-8.ogg moved into FtF 
soundtracks updated for music changes/removals 
balancing changes to Underground, River of Skulls, Endgame 
unit .cfgs updated for 1.12 compatibility 
easter egg temporarily commented out, pending consideration 

NOTE: due to technical differences between the old code and the 1.12+ compatible code, I was forced to split the campaign into two distributions, which are on their respective campaign servers. Because of this, however, the translations will not be current until the branch is created on wescamp (so that translators can update it).

8/20/06 
3.2 is on the campaign server. It [i]should[/i] be (almost) fully compatible with 1.18, but I can't guarantee that every animation will work right. I have also made balancing changes up until Exodus (level 16), but the cave levels are still buggy. 
Any feedback is appreciated!

12/22/06 
Hosted on http://warhangel.ru/wesnoth/campaigns/Flight_Freedom_1_x.zip . Special thanks to warhangel for hosting this campaign. 

1/5/07 
FtF 3.3 uploaded.

NPC AI should be fixed 
naga, saurian animations are working, graphics from Marsh Era 
two attack icons added, one by Xan, the other from the Extended Era 
balancing changes to Manor, Underground, River of Skulls and Blockade 
Rockfall fixed with RedLTeut's patch 
other fixes and tweaks which I have forgotten about 

3/20/07 
FtF 4.0 released, for Wesnoth 1.3 and up only. 
compatible with new terrain system, will make cave roads passable 
Manor enhanced 
Survival edited, but cutscene not implemented yet 
several dialogue changes 
Landfall bridge collapse softened 
new graphic for the enslaved Malakar 
several bugfixes 
Drake Guerillas/Revolutionaries have visible spear overlay 
losing text added if Unforgiver is sunk and Kogw has not disembarked 

4/21/07 
version 4.1 released 
many new storyline images added 
many dialogue changes 
extra enemy added to Survival, to shorten it 
balancing changes to Pirate Schooner and Clipper 
all ships have reasonably fitting hit and die sounds 
Manor recruitment bug precluded 
cutscene code moved to separate file (a purely internal change) 
rain added to Open Ocean 
ships should have names 

6/14/07 
version 4.2 released 
dragon in Underground is now friendly 
River of Skulls rebalanced, map edited 
several bugfixes 
Blockade enhanced 
new Malakar and Kamalar graphics 
terrain error messages fixed 
FtF will sort properly in campaign menu 
ships now have names 
experience gained in Survival by Malakar will carry over to Rebellion 

NOTE: This will break saves of River of Skulls. Other saves will work, but they may use the old Malakar (which should work fine). 

7/6/07 
version 4.2.1 released, for Wesnoth 1.3.3+ 
bug fixes in Underground and River of Skulls 
Manor enhanced 
minor dialogue changes 
a few minor bug and potential bug fixes 

7/20/07 
version 4.2.2 released, for Wesnoth 1.3.4+ 
dialogue changes 
storyline graphics updated for new Malakar graphics 
new storyline graphics for Underground and Rockfall 
Caravan elves nerfed 
Drake Escape enhanced 
at least one bugfix 

8/3/07 
version 4.3 released, for Wesnoth 1.3.4+ 
changes (dialogue and other) to Rockfall, Betrayal, Hordes of the Foul Undead, Gate of Storms, Exodus, Blockade and Return to Morogor 
two scenarios added (Swamps of the Jamolar and Council of War), part of a possible branch (accessed from Survival) 
attainable objective added to Survival 
experimental wave animations in Rebellion 
minor bugfixes 
time over events added to some scenarios 
non-expendable player characters are spawned with hero icon 
balancing changes to Betrayal and Blockade 

8/23/07 
version 4.3.1 released, for Wesnoth 1.3.6+ 
new scenario, Forest of Nightmares (in second branch) 
enhancements to Manor, includes irrevenant's indoors time-of-day image 
several bugfixes 
thunder spirits in Landfall and Drake Escape will not spawn on first turn 
multi-hex fireball attack code implemented (not used yet) 
victory music added to victory events 
lava transitions fixed 

9/1/07 
version 4.3.2 released, for Wesnoth 1.3.7+ 
critical 1.3.7 compatibility bug fixed 
new scenario, Hafwyt (still not 100% finished) 
savegames of cave levels will not show snapshots 

10/22/07 
version 4.3.3 released, for Wesnoth 1.3.9+ 
unit WML updated to 1.3.8+ standard 
new scenario: Mountain Crypt (in second branch) 
bugfixes 
turn limit of Forest of Nightmares reduced to 25 
balancing changes 

1/20/08 
version 4.4 released, for Wesnoth 1.3.14+ 
headers and borders added to all maps 
two links added in secondary branch to main branch 
sword-and-shield narrator icon replaced 
new cutscenes 
Mountain Crypt darkness code revised 
bugfixes 

8/19/08 
version 4.5 released, for Wesnoth 1.4+ 
scenario 19, Liberation, completely rewritten 
dialogue changes 
user team names added, so that the status table will show the names of sides in a level 
bugfixes 
levels use new Wesnoth music when appropriate 

2/20/09 
version 4.6 released, for Wesnoth 1.5.6+ 
compatibility with Wesnoth 1.5 branch 
bugfixes 

7/25/21 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.3.3 5.3.3] released, for Wesnoth 1.14+ 
egallager's first release since taking over as maintainer 

5/18/22 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.0 5.4.0] released, for Wesnoth 1.16+ 
first release on the 1.16 add-on server 

11/27/22 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.1 5.4.1] released, for Wesnoth 1.16+ 
see release notes for full changelog 

1/27/24 
versions [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.2 5.4.2] and [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.5.0 5.5.0] released, for Wesnoth 1.16+ and Wesnoth 1.17+ respectively. 
see each of their release notes for full changelogs 

6/7/24 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.6.0 5.6.0] released, for Wesnoth 1.18+. 
see release notes for full changelog 

8/17/24 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.6.1 5.6.1] released, for Wesnoth 1.18+. 
see release notes for full changelog 

1/30/25 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.7.0 5.7.0] released, for Wesnoth 1.19.8+. 
see release notes for full changelog 

3/24/25 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.7.2 5.7.2] released, for Wesnoth 1.19.8+. 
see release notes for full changelog 

5/4/25 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.7.3 5.7.3] released, for Wesnoth 1.19.9+. 
see release notes for full changelog 

6/14/25 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.6.2 5.6.2] released, for Wesnoth 1.18+. 
see release notes for full changelog 

== See Also ==
* [[Guide_to_UMC_Content]]
* [[CampaignFlightFreedom]]

[[Category:Campaigns - Development]]

User:Egallager

2025-06-02T20:26:48Z

Egallager: add Wesnoth logo

[[File:Shield.png|right]]
== Introduction ==
Hi, I am Eric Gallager. I am from New Hampshire.

== Forums ==
I also go by [https://forums.wesnoth.org/memberlist.php?mode=viewprofile&u=219741 egallager] on the forums.
Here are links to the topics I've either started, or that are for campaigns I've taken over:
* [https://forums.wesnoth.org/viewtopic.php?f=8&t=53597 Son of the Black Eye: Easy Edition]
* [https://forums.wesnoth.org/viewtopic.php?f=8&t=53601 A Tale of Two Brothers With a Third Difficulty]
* [https://forums.wesnoth.org/viewtopic.php?f=8&t=47885 A Little Adventure]
* [https://forums.wesnoth.org/viewtopic.php?f=8&t=26800 The Earth's Gut]
* [https://forums.wesnoth.org/viewtopic.php?f=8&t=1887 Flight to Freedom]
* [https://forums.wesnoth.org/viewtopic.php?f=31&t=24967 The War of Terrador]
* [https://forums.wesnoth.org/viewtopic.php?f=8&t=6486 A New Order]
* [https://forums.wesnoth.org/viewtopic.php?f=8&t=39512 Dawn of Thunder]
* [https://forums.wesnoth.org/viewtopic.php?f=7&t=54568 Call for translators (for my add-ons in general)]
* [https://forums.wesnoth.org/viewtopic.php?f=6&t=54369 Discussion of a Japanese "Let's Play" introduction to Wesnoth]
* [https://forums.wesnoth.org/viewtopic.php?t=57132 Word association]
* [https://forums.wesnoth.org/viewtopic.php?t=57215 Mainlining popular UMC tracks]
* [https://forums.wesnoth.org/viewtopic.php?t=57225 Categorizing UMC music by moods]
* [https://forums.wesnoth.org/viewtopic.php?t=58854 Floods of Irdya]

== Elsewhere on the web ==
I go by [https://github.com/cooljeanius "cooljeanius"] on GitHub (it's an old handle), and keep the sources for many of my Wesnoth things on there:
* [https://github.com/cooljeanius/wesnoth_mods generalized mods collection]
* [https://github.com/cooljeanius/Son_Of_The_Black_Eye_Easy_Edition Son of the Black Eye: Easy Edition]
* [https://github.com/cooljeanius/Saving_Elensefar Saving Elensefar]
* [https://github.com/cooljeanius/dawn_of_thunder Dawn of Thunder]
* [https://github.com/cooljeanius/Two_Brothers_With_A_Third_Difficulty A Tale of Two Brothers With a Third Difficulty]
* [https://github.com/cooljeanius/The_War_of_Terrador The War of Terrador]
* [https://github.com/cooljeanius/A_New_Order A New Order] (with a separate repo, [https://github.com/cooljeanius/ANO_art ANO_art], for the raw art assets used for it)
* [https://github.com/cooljeanius/A_Little_Adventure A Little Adventure] (with a separate repo, [https://github.com/cooljeanius/ALA_art ALA_art], for the raw art assets used for it)
* [https://github.com/cooljeanius/The_Earths_Gut The Earth's Gut] (with a separate repo, [https://github.com/cooljeanius/TEG_art TEG_art], for the raw art assets used for it)
* [https://github.com/cooljeanius/Flight_Freedom Flight to Freedom]
* <s>[https://github.com/cooljeanius/Roboke Roboke]</s> (Archived)
I also use that handle elsewhere, such as on Wikipedia: [https://en.wikipedia.org/wiki/User:Cooljeanius https://en.wikipedia.org/wiki/User:Cooljeanius]

== This wiki ==
I have been editing (and intend to edit further) the following pages: [[ReferenceWML]], [[CharactersStorys]], [[Guide to UMC Content]], [[Glossary]], [[Maintenance tools]], [[Available Music]], and [[FlightToFreedom]].

Guide to UMC Content

2025-05-04T19:34:23Z

Egallager: /* Flight to Freedom */ version bump

This is a guide to current-ish user-made content for players. It provides unfamiliar players with detailed information about campaigns (including story, completion, difficulty and playing style) as well as detailed information about eras. Feel free to edit this guide, as it is a wiki.

This list covers add-ons for the latest 3 stable releases (1.14, 1.16, and 1.18) of Wesnoth. There are archived versions of this page for [[Guide_to_UMC_Content/1.10|1.10]] and [[Guide_to_UMC_Content/1.12|1.12]].

For content creators who loved an add-on that hasn't been added to 1.14, 1.16, or 1.18 yet, and are wondering about taking it over, please ensure that its entry on the older (1.12 or 1.10) wiki page is up to date, add a link to the add-on's feedback thread in the forums, and generally do the tidy-up that doesn't need you to start changing the campaign, and then ask the old maintainer. (You should probably also wait a bit before assuming that a maintainer isn't already porting to 1.16 or 1.18).

If you are looking for even more campaigns, please see the links in at the bottom of this page.

== Instructions ==
When adding a campaign to the list, please place it in its alphabetically sorted location, ignoring any initial article ("A", "An", or "The").

=== Blueprint for Campaigns ===

* Description:

* Author:

* Maintainer: if not maintained by the author anymore.

* Status:
** Broken = Does not work at all
** Incomplete = Partially written, no progress
** WIP = Partially written, some progress
** Complete = Completely written, but buggy as well as potential balance issues.
** Finished = Completely written, minimal to no bugs, slight balance issues possible.

* Version campaign version on the add-ons server

* Length:

* Requirements: (only if needed)

* Difficulty:

Please note: Often campaigns introducing new mechanics are listed as expert level on the add-on server, here difficulty means the raw difficulty after the mechanics are understood.

** Unbalanced = If you can't beat the hard mode, it isn't necessarily unbalanced, but if the difficulty changes erratically from one scenario to the next and only people using the debug mode have seen the final, then it is.
** Easy
** Normal
** Hard

Please note: If you didn't play the campaign, write the difficulty written on the add-ons server.

* Style:

Please note: Many campaigns will feature more than one style. Please list the most significant ones. If you don't know which style is the campaign you are listing, don't write this.

** Skirmish = small to medium sized armies, your standard Wesnoth gameplay
** Dungeon = long and narrow tunnels (not every underground scenario is a dungeon, a dungeon isn't necessarily underground)
** RPG = role playing game elements such as talking with non-player-characters, item collection, dependency on a party of very few adventurers without or limited recruits
** Survival = being exposed to changing, spawning enemies while remaining on the same map
** Large Battle = large number of units on the battlefield, sizely maps
** Simulation = campaigns feat. terrain modification, alternative resources
** Boss battle = the challenge is to defeat a single powerful enemy unit
** Minigames = there are puzzles and minigames in the campaign that significantly differ from standard Wesnoth gameplay

* Faction/Era: Era for the whole campaign and more specifically the faction or unit composition you field.

* Custom units: Link to the unit tree for cases that don't feel sufficiently described by Faction / Era entry.

* Forum: Links to the feedback and development threads at forums.wesnoth.org

=== Blueprint for Eras ===

* Description:

* Author:

* Maintainer: if not maintained by the author anymore.

* Status 1.14/1.16/1.18:
** see the list of statuses in the campaign blueprint

* Faction Descriptions: Describe your individual factions here.

* Requirements: (only if needed)

* Forum: Links to the feedback and/or development threads at [https://forums.wesnoth.org/ forums.wesnoth.org].

== How to play for UMC factions ==

=== Southern Nations by Elvenisko ===
[[How_to_play_Death_Knights|Death Knights]] |
[[How_to_play_Southern_Drakes|Southern Drakes]] |
[[How_to_play_Southern_Dwarves|Southern Dwarves]] |
[[How_to_play_Southern_Elves|Southern Elves]] |
[[How_to_play_Southern_Mages|Southern Mages]] |
[[How_to_play_Southern_Mercenaries|Southern Mercenaries]] |
[[How_to_play_Southern_Orcs|Southern Orcs]] |
[[How_to_play_Southern_Swamplords|Southern Swamplords]] |
[[How_to_play_Southern_Nations|Comparison]] |
[https://units.wesnoth.org/1.17/Southern_Nations/en_US/era_southern.html All units (can be out of date)]

== Battle for Wesnoth 1.14 and newer ==

=== Campaigns ===

==== After the Storm ====

''Follow the journey of Galas and his band following the events of Invasion from the Unknown''

'''Author:''' shadowm/ShikadiQueen/Iris

'''Status:''' Finished, 0.10.11

'''Length:''' 3 episodes of 13 scenarios each, some of which are multi-part

'''Difficulty:''' Medium-hard

'''Style:''' Skirmish, Boss Battle, Dungeon

'''Faction/Era:''' Many custom units

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=32091]

'''GitHub:''' [//github.com/project-ethea/After_the_Storm]

'''Note:''' (vultraz) Long, very enjoyable campaign with great story. (Knyghtmare) The best UMC campaign ever!

'''[[Guide_to_UMC_Campaigns/Players_Reviews#After_the_Storm|Players’ Review(s)]]'''

====A Beastly Tale====

''When a small village is beset by troubles, its fate rests in the hands of a young woodsman and the animals he befriends.''

'''Author:''' GloccusV

'''Status:''' Complete

'''Version:''' 2.0.3

'''Length:''' 5 scenarios

'''Difficulty:''' Intermediate

'''Custom units:''' [//units.wesnoth.org/1.14/A_Beastly_Tale/en_US/A_Beastly_Tale.html Here]

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=41434&p=633612&hilit=A+Beastly+Tale#p579093 Here]

====A Song of the Winds====

''Every era has its heroes and heroines. Before the song of Myra, the odyssey of Akhen Wadjet and the aria of Tenma Yozora, there was the song of the winds that echoed in the mountains and halls at the heart of the Great Continent. Follow young Maat of Hiera'Shirsha and Prince Abhai of Garet-Desh in the war that set the stage for one of the greatest upheavals Irdya has ever witnessed.
(Prequel to the Dragon Trilogy)''

'''Author:''' revansurik

'''Status:''' Complete

'''Version:''' 1.0.0

'''Length:''' 43 scenarios (some of them dialogue-only)

'''Difficulty:''' Intermediate

'''Custom units:''' War of Legends + Custom factions

'''Forum:''' [//https://forums.wesnoth.org/viewtopic.php?f=8&t=53913 Here]

==== Bad Moon Rising ====

''An expedition to gather treasure from the cold north sets off compounding disaster.''

'''Author:''' Doofus-01

'''Status:''' Complete 1.10.0

'''Length:''' 20 scenarios

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Archaic Era

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=31348]

'''GitHub:''' [//github.com/doofus-01/wesnoth-Bad_Moon_Rising]

==== The Black Cross of Aleron ====

''A elvish school for druids comes under attack by goblins. It seems more than just a routine raid; is there something more sinister behind this attack? - In Beseiged Druids, you control Eärendil, the surviving teacher at the school, and the many and varied initiates. Not all of these are ordinary students; many have been experimenting with other forms of magic, while others are simply overachievers in some area of study. Unfortunately, they are not especially good at combat, at least initially. Together with a very small contingent of surviving guards, it is up to these students to save the island of Aleron from disaster.''

'''Author:''' Celtic Minstrel

'''Status:''' Complete 2.0.3

'''Length:''' 9 scenarios

'''Difficulty:''' Unbalanced

'''Style:''' Skirmish

'''Faction/Era:''' Default, Elves

'''[https://units.wesnoth.org/1.14/Black_Cross_of_Aleron/en_US/celmin-druid-siege.html Custom units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=37342

==== Danse Macabre ====

''Macabre is a rare zombie who has intelligence and will. What's he like? What's his purpose?''

'''Author:''' kamikaze

'''Maintainer:''' James_The_Invisible

'''Status:''' Completed, 1.3.2

'''Length:''' 12 scenarios

'''Difficulty:''' Unbalanced

'''Style:''' Large Battle

'''Faction/Era:''' Default, undead

'''[//units.wesnoth.org/1.14/Danse_Macabre/en_US/Danse_Macabre.html Custom units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=33745]

'''Note:''' While the campaign is playable on Wesnoth 1.14 without major issues, it is (still) in need of heavy re-balancing. Sadly, for various reasons I am not able to do it in near future but patches are always welcome, preferably in form of pull requests on [https://github.com/konecnyjakub/Danse_Macabre GitHub].

==== Dawn of Thunder ====

''A young elvish fighter is send to represent the Aethenwood at the Ka'lian. The adventure turns out to be bigger than expected.''

'''Author:''' Paulomat4

'''Maintainer:''' egallager

'''Status:''' [https://github.com/cooljeanius/dawn_of_thunder/issues/3 Incomplete], latest release on the BfW 1.16 add-on server is [https://github.com/cooljeanius/dawn_of_thunder/releases/tag/0.2.4 0.2.4].

'''Length:''' 18 scenarios

'''Difficulty:''' Challenging

'''Style:''' Skirmish, Large Battle, RPG-elements

'''Faction/Era:''' Default, Elves, Humans

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=39512 forums.wesnoth.org/viewtopic.php?f=8&t=39512]

==== A Fiery Birth ====

''A scholar of the Great Academy journeys to the land of the drakes to discover their secret origins.''

'''Author:''' Mathbrush

'''Status:''' Complete

'''Version:''' 1.2.0

'''Length:''' 9 scenarios

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=47861&p=623953 Here]

'''GitHub:''' [//github.com/brirush84/AFieryBirth]

==== The Final Exam ====

''Young mage Erika must find a magic book to become a true mage. But will it really be her final exam?''

'''Author:''' Elven

'''Status:''' Complete, 2.6.1

'''Length:''' 4 scenarios

'''Difficulty:''' Easy

'''Style:''' Skirmish, Minigames

'''Faction/Era:''' Default, Loyalists

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=23398]

'''Note:''' Short, easy campaign with varying objectives. Features female mage as leader.

==== [[FlightToFreedom|Flight to Freedom]] ====

''Flight to Freedom chronicles the story of the drake hero Malakar, and his desperate cross-country flight out of slavery.''

'''Authors:''' MadMax, Nova

'''Maintainer:''' egallager

'''Status:''' Complete

'''Length:''' 20 playable scenarios + 1 dialogue-only, for a total of 21 (may need an update now that the "B" branch has been reactivated)

'''Version:''' [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.2 5.4.2] (for BfW 1.16), or [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.5.0 5.5.0] (for BfW 1.17), or [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.6.1 5.6.1] (for BfW 1.18), or [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.7.3 5.7.3] (for BfW 1.19.9)

'''Difficulty:''' Expert

'''Style:''' Skirmish, Large Battle, Puzzle

'''Faction/Era:''' Drakes

'''Required Wesnoth version:''' 1.16+ or 1.17+ or 1.18+ or 1.19.8+

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=1887 Development], [//forums.wesnoth.org/viewtopic.php?t=40195 Feedback]

'''GitHub:''' [//github.com/cooljeanius/Flight_Freedom github.com/cooljeanius/Flight_Freedom]

==== Inky's Quest ====

''The Cuttlefish Campaign''

''Are the cuttlefish mere beasts or something more? What stories would they tell if they could speak? This story provides one possible answer. The easiest difficulty provides hints for novice players.''

'''Author:''' Telchin

'''Status:''' Complete

'''Length:''' 12 scenarios + story-only epilogue, for a total of 13

'''Version:''' 1.5.6

'''Difficulty:''' Easy

'''Style:''' Skirmish

'''Faction/Era:''' Custom units (cuttlefish, tentacles, giant clams...). Enemies use both default era units and custom ones.

'''[//units.wesnoth.org/1.14/Inky_Quest/en_US/Inky_Quest.html Custom Units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=32501]

==== Invasion from the Unknown ====

''Episode I - Seeking the Light: Long after the Fall, the last forest elves are forced to abandon their safe valley, and find themselves resorting to the dark means of necromancy in order to survive the perils and challenges of this new harsh world. May they finally free the Great Continent from its chaos, or perish in the foolish attempt of restoring peace and life to the lands.''

''Episode II - Armageddon: As the shadow of Chaos covers the entire continent, an assorted group of foolish heroes prepares a counter-attack to the Empire, with one unique goal in their minds: defeat the evil Emperor, whoever it is. Lead these courageous living and non-living warriors to victory, and rediscover lost secrets of the history.''

'''Author:''' shadowm/ShikadiQueen/Iris

'''Status:''' Finished, 2.1.9

'''Difficulty:''' Normal

'''Style:''' Skirmish, Dungeon, Boss battle

'''Faction/Era:''' Unique. You play Elves and Undead throughout the campaign.

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=43309]

'''GitHub:''' [//github.com/project-ethea/Invasion_from_the_Unknown]

'''Walkthrough:''' [[IftU Walkthrough]]

''[[Guide_to_UMC_Campaigns/Players_Reviews#Invasion_from_the_Unknown|Players’ Review(s)]]'''

==== Leader of the Drakes ====

''Leader of the drakes is killed. His son tries to defend homeland against the orcs. He choosed to ally with saurians, but other clans of drakes disagrees. Will fast and unexperienced Morin win against orcs and rebel drakes alike?''

'''Author:''' Elven

'''Status:''' Complete, 1.02b

'''Length:''' 3 scenarios

'''Difficulty:''' Easy/Medium

'''Style:''' Skirmish, Minigames

'''Faction/Era:''' Default, Drakes

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=53951&start=15]

'''Note:''' Short, easy campaign with simple objectives. Features Drake Glider as leader and modified Drake Burner with cold and slowing blade.

==== Legend of the Invincibles ====

'''''Part I: Shrouded in Darkness''' (5 chapters, 90 scenarios) - A pair of heroes, after stopping an orcish threat, are outcast into caves, where they have no other choice than to become liches in order to survive. They preserved their original appearance and moral principles, and fight in various skirmishes against evil (although using evil methods sometimes), until the Fall, when they are buried alive under the ashes of the third sun.''

'''''Part II: Into the Light''' (5 chapters, 110 scenarios) - Long after the Fall, the lich heroes awaken. Searching for more power, they manage to resurrect themselves as living beings, but this time more powerful and ridden of the evil within. But the evil from inside them did not cease to exist, and started a campaign to conquer the world. Stopping the campaign caused an even worse disaster...''

'''Author:''' Dugi

'''Status:''' Complete

'''Length:''' 200 (+8 talk-only) scenarios

'''Difficulty:''' Normal

'''Style:''' mostly Skirmish and Dungeon (all other styles are present as well, but less frequently)

'''Faction/Era:''' Elves, Loyalists, Undead, Dwarves; but they advance past their usual maximum level

'''Forum:''' [//r.wesnoth.org/t32384]

'''GitHub:''' [//github.com/Dugy/Legend_of_the_Invincibles]

'''[[Guide_to_UMC_Campaigns/Players_Reviews#Legends_of_the_Invincibles|Players’ Review(s)]]'''

'''Note:''' The most unique feature of this campaign is its RPG-like unit development system, enemies drop items units can use, leaders are stronger than most usual units and all units get AMLA (after maximum level advancement) after reaching their maximum level (that is also increased by a load of additional level 4 units).

==== A New Order ====

''The old kingdom of Wesnoth has fallen before barbarian hordes. The occupying barbarians are on the brink of civil war, the seeds of Wesnothian rebellion are kept alive by old legends, while bandits and Dunefolk mercenaries roam the land. Can Gawen Hagarthen unite these disparate factions against a common foe?''

''Note: This campaign contains mature themes, some of which may be unsuitable for children.''

'''Author:''' szopen

'''Maintainers:''' nemaara (Yumi), egallager

'''Status:''' Finished

'''Version:''' [https://github.com/nemaara/A_New_Order/releases/tag/1.7.0 1.7.0]

'''Length:''' Hard to say as it is non-linear; it is advertised as having 45 scenarios, but the numbering only goes up to 30 due to some of the scenarios being alternates to one another.

'''Requirements:''' Requires BfW 1.16+. Also uses the "Akladian Music" add-on.

'''Difficulty:''' Advertised as intermediate; could be considered hard, though.

'''Style:''' Mostly Skirmish, some Large Battle

'''Faction/Era:''' mostly various human factions (including the Dunefolk), with the addition of the Akladian faction of humans

'''[//units.wesnoth.org/1.16/A_New_Order/en_US/A_New_Order.html Custom Units]'''

'''Forum threads:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=6486&sid=2e644284f54e65736b4f1543b7098ef9 Development], [//forums.wesnoth.org/viewtopic.php?t=36183 Feedback], [//forums.wesnoth.org/viewtopic.php?t=6174 Original (older) art thread], [//forums.wesnoth.org/viewtopic.php?t=36074 Current art thread]

'''GitHub:''' [//github.com/nemaara/A_New_Order github.com/nemaara/A_New_Order]

'''Note:''' (Pyrophorus) Certainly one of the most mature and well designed campaign in add-ons. A must.

''' [[Guide_to_UMC_Campaigns/Players_Reviews#A_New_Order|Players’ Review(s)]]'''

==== The North Wind ====

''Wesnoth's army was occupied fighting Mal Ravanal in the East, but there were whisperings of an orcish attack in the north. Konrad II must send Deoran, now an experienced rider and commander, with a small band of knights to hold off the orcs....''

''This campaign features unique gameplay characteristics such as a lack of recruiting and a 24-turn time-of-day cycle.''

'''Author:''' aelius, Deusite; pyndragon

'''Status:''' WIP, 0.3.0

'''Length:''' 1 playable scenario, 6 intended

'''Difficulty:''' Normal

'''Style:''' RPG, Skirmish, Survival

'''Faction/Era:''' Loyalists

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=42854]

==== The Ravagers====

'''Description:''' ''The Ravagers'' is a tale of pure revenge. A tale of justice served cold, told in a flashback-style point-of-view narrative, by a ranger in the Inn at Weldyn.
The campaign includes many new exciting gameplay features, fun mechanics such as drinking, hundreds of custom units, and many more.

'''Author:''' WhiteWolf

'''Status:''' Finished*

'''Length:''' 25 playable scenarios + 2 scene scenarios

'''Requirements:''' Akladian Music Pack, Underness Music Pack

'''Difficulty:''' Intermediate

'''Style:''' Skirmish + RPG / Flashback narrative

'''Faction/Era:''' Humans, Elves, Ravagers(dark humans)

'''[//units.wesnoth.org/1.14/The_Ravagers/en_US/The_Ravagers.html Custom Units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=44930]

'''*Notes:''' The main storyline is complete, but there are unfinished side-missions that are still in development. The campaign is aimed to become finished with version 1.2.0.

==== Return from the Abyss ====

''After taking part to a disastrous expedition, Khafir and his men are lost and isolated from their people, thousands of miles away from home, bound by a pact sealed with a powerful dwarvish king. Help him escape from the depth of Irdya and finding his way back, in an adventure across two worlds during the rise of a sinister force in the Great Continent.''

'''Author:''' skeptical_troll

'''Status:''' finished

'''Length:''' 19 playable scenario + 10 story only

'''Difficulty:''' Hard

'''Style:''' Skirmish, Dungeon

'''Faction/Era:''' Dunefolk/Default

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=44545]

==== Rise of the Dunefolk ====

''Adventure of Siabbin and Helare from small village in desert, who step by step made the foundation of the Dunefolk nation. Play a stunning adventure against many enemies in different maps - from sandstorm to swampy areas and caves. Defeat powerful lich lord and train one of the best dark mages in the world of Wesnoth.''

'''Author:''' Elven

'''Status:''' Completed

'''Length:''' 11 scenarios

'''Difficulty:''' Medium

'''Style:''' Skirmish, Minigames, Survival

'''Faction/Era:''' Default, Dunefolk and dark mage

'''Note:''' enjoable gameplay with every map different. Enough experience to upgrade your units.

==== The Return of the Darks ====

''The Darks are a race which left Wesnoth in the ancient times and lives on Isles in the sky. But now the Magic wich helped them to move the Isles in Sky got lost and the isles are about to fall down. Rumion an adventurer goes to Wesnoth and searchs for something that could help them.''

'''Author:''' thvk

'''Status:''' WIP

'''Length:''' 4 playable scenario + 2 story only

'''Difficulty:''' Easy

'''Style:''' Skirmish

'''Faction/Era:''' Default + some self made units

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=52731]

==== Secrets of the Ancients ====

''From the Journal of Ardonna of Tarrynth:''

''It's unfair that we humans must die after so few years. Though this is the natural order, we need not embrace it! The lords on the Green Isle knew how to live forever. Pursuit of that knowledge was declared illegal by King Haldric I, but I believe it is worth the risk: If I can rediscover the secrets of the ancients, not only will I cheat death, I will become a hero to the whole continent!''

'''Author:''' beetlenaut

'''Status:''' Mainlined (this is now one of the campaigns that is downloaded with Wesnoth itself)

'''Length:''' 18 playable scenarios + 3 story only

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Undead/Default

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=40545]

'''Walkthrough:''' [[Secrets of the Ancients Walkthrough]]

==== Swamplings ====

''Banished by Yushnak the Ponderer, a tribe of lowly swamp goblins endure in the deadly mire of Pogo Bog. Four centuries before the founding of Wesnoth, this is the story of the goblins' struggle against the intrigues and betrayals of the greater races, and the rise of the first wolf rider.''

'''Author:''' John Rawlins (boru)

'''Status:''' Complete

'''Length:''' 17 scenarios

'''Version:''' 1.2.0i

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction:''' Goblins

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=41254]

'''[[Guide_to_UMC_Campaigns/Players_Reviews#Swamplings|Players’ Review(s)]]'''

==== The Dark Hordes ====

''Lead fugitive dark sorcerer Gwiti Ha’atel to mastery of the undead hordes.''

'''Author:''' Circon

'''Maintainer:''' Various

'''Status:''' Incomplete/WIP

'''Length:''' 15 scenarios done so far

'''Version:''' 0.1.2

'''Difficulty:''' Unbalanced

'''Style:''' Skirmish

'''Faction/Era:''' Default undead

'''[//units.wesnoth.org/1.10/The_Dark_Hordes/en_US/The_Dark_Hordes_1.html Custom Units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=16576&]

==== The Tale of Vaniyera ====

''The expansionist Lavinian Legion, led by the Imperator himself, has invaded the northern forests of the Sidhe, or Wild Elves. It is up to Leithan the Thunderblade and his advisor Vaniyera to push its armies back where they came from...''

'''Author:''' oreb, turin

'''Maintainer:''' UnwiseOwl

'''Status:''' Finished 0.11.0

'''Length:''' 5 scenarios

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Imperial Era, Sidhe.

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=37880]

'''Walkthrough''' There is a video-walkthrough by the campaign maintainer that begins [https://www.youtube.com/watch?v=dGM1bjImvkI&list=PLZorLYWvUD7VIhaXxKwzO8iQANlp_TaF0 here].

'''Note:''' As of August 2014, all previous issues raised about this campaign have been addressed. If you've not played this campaign since 1.4 or 1.10, in this humble maintainers opinion, it's worth another go.

==== To Lands Unknown ====

''This is the story of Mehir, the Summoner, and his journey to lands unknown.''

'''Author:''' inferno8

'''Status:''' Complete

'''Length:''' 20 scenarios, 4 dialogue only

'''Difficulty:''' Intermediate (Era of Magic)

'''Style''': Skirmish, Dungeon

'''Era:''' Era of Magic

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=31799]

'''GitHub:''' [//github.com/inferno8/wesnoth-To_Lands_Unknown]

'''[[Guide_to_UMC_Campaigns/Players_Reviews#To_Lands_Unknown|Players’ Review(s)]]'''

==== A Vision Blinded ====

''Defend the northern forest against what appeared like a routine orcish raid, and unravel the greater conspiracies that lie below its waves.''

'''Author:''' LemonTea

'''Maintainer:''' Adamant14

'''Status:''' Complete, 1.0.14

'''Length:''' 13 playable scenarios + 1 dialogue-only

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default, Elves (+ Trolls, Outlaws)

'''[//units.wesnoth.org/1.10/A_Vision_Blinded/en_US/A_Vision_Blinded.html Custom units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=23463]

=== Eras ===

[[Category:Campaigns|*]]
[[Category:Eras|*]]

==== '''Southern nations''' ====

[[How_to_play_Southern_Nations|Everything about southern nations, including how to play series]]

==== '''War of Legends''' ====

'''Description:''' A multiplayer era focused on the Dark Irdya Campaigns. Contains 15 factions.

'''Author:''' Tahsin Jahin Khalid (Lord-Knyghtmare)

'''Maintainer:''' Tahsin Jahin Khalid (Lord-Knyghtmare)

'''Status:''' Complete, new features being added for the 1.15.x version of the add-on

'''Factions:'''

# Aragwaithi
# Windsong
# Human Alliance
# Orcish Union
# Southerners (Desert Elves)
# Outlaws
# Elementals
# Undead
# Drakes
# Dark Legion
# Sylvans
# Minotaurs
# Vampires
# Dunefolk
# Knalgan Alliance

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=19&t=30087 Development and Feedback Thread]

'''GitHub:''' [//github.com/knyghtmare/War_of_Legends]

==== Era of Magic(EoMa) ====

'''Description:''' Aiming at using the whole potential of Battle of Wesnoth's graphic engine, the Era of Magic is considered to have a most amazing special effects and attack animations in the BfW game. There are 8 playable factions with fully animated units and tons of special effects contained in the era, and the stories of them are told in the campaign "To Lands Unknown".

'''Author:''' Inferno8

'''Maintainer:''' Inferno8

'''Status:''' Finished, 3.1

'''Faction Descriptions:'''

Sky Kingdom - powerful magi of all kinds. Their knowledge allows them to cast amazing spells and summon creatures like unstopable Golems or mysterious Mus. Masters of Elements and Gurus are one of the most powerful human beings in the Era.

Al-Kamija - these proud people are good warriors and spell casters of the desert. They use magical circles and scrolls to summon amazing creatures like Jinns or elementals from other dimension called Abyss. These creatures can't be poisoned, which is a great advantage.
(The campaign "To Lands Unknown" is mainly about the story of this faction)

Tharis - fearsome Tharis faction is very dangerous especially at night. Cruel people of Tharis with their black magic and dreadful monsters like Hydra can demolish everything standing on their way. Being so powerful in attack, Tharis have no healer, so they need to push forward at all costs.

Kharos - this strange name is the name of a beautiful country ruled by prophets of light. These peaceful people are masters of defense and support. Their formations of healers and Shielders assisted by Silver Warriors, who can teleport between friendly villages, are very hard to destroy.

Barbarians - the best in hand-to-hand combat. This multi-cultural society divided into Goblins, Orcs, Cyclops and Trolls with their own advantages and disadvantages can be hard opponent, but separately they are very weak.

Runemasters - these Dwarves use runic magic and equipment and are well known of their protection against magic. The Runemasters create steam machines like Gyrocopters, Robots and even mighty Mechanical Dragons. Units from this faction are very resistant but slow.

Dark Blood Alliance - this faction is composed of agile lizards, giant frogs, wyverns swallowing enemies and salamanders, which have developed to perfection the art of disguise. At the head of the community stand shamans known for their water magic, which is used in the fight as well as in healing.

Destroyers - a terrifying undead creations consisting of civilizations long gone...

'''Version:''' 1.1.1 (February 18th, 2015)

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=19&t=20039 Development and Feedback Thread]

'''GitHub:''' [//github.com/inferno8/wesnoth-Era_of_Magic]

==== Ageless Era ====

'''Description:''' Ageless Era is a compilation of the most popular eras and factions on the add-on server. It is more an era pack than an era.

'''Author:''' mnewton1, Ravana and various

'''Maintainer:''' Ravana

'''Status:''' Finished, 4.19

'''Unit Tree:''' [//units.wesnoth.org/1.12/Ageless_Era/en_US/Ageless%20Era.html Ageless Unit Tree (for 1.12)]

'''Factions List:''' Currently there are 91 factions in the era:

Default: Loyalist, Rebels, Northerners, Undead, Knalgan Alliance, Drakes, Khalifate

Extended Era: Loyalist, Sylvans, Dwarves, Outlaws, Northerners, Undead, Chaos, Dark Elves

Archaic Era: Khthon, Phantoms, Despair, Primeval, South-Seas, Ukians, Northern Orcs

Era of Four Moons: Highlanders, Imperialists, Sea States, Darklanders, Dalefolk, Freemen, Pygmies, Whites

Era of the Future: Welkin, Brungar

BEEM: Anakes, Calidonians, Wood Warriors

Custom Factions: Yokai, Dark Legion, Desert Elves, Steelhive, Frozen

Era of Myths: Celestials, Devlings, Elementals, Therians, Vampires, The Warg, Windsong

Feudal Era: Aragwaithi, Ceresians, Clockwork Dwarves, High Elves, Orcish Khaganates

Imperial Era: Arendians, Cavernei, Issaelfr, Lavinian Legion, Marauders, Orcei Gladiatores, Sidhe

Era of Strife: Eventide, Triththa, Free Saurians, Eltireans, Minotaurs

Era of Magic: Barbarians, Dark Blood Alliance, Sky Kingdom, Kharos, Runemasters, Al-Kamija, Tharis, Destroyers

Mercenaries Era: Highlanders, Enchanters, Avians, Slavers, Mercenaries, Equestrians, Emperor's Guard, Oracles, Holy Order, The Cult, Fanatics, Tribalists, Hive, Infernai, Refugees, Blight

'''Git:''' [https://github.com/ProditorMagnus/Ageless-for-1-11 Ageless-for-1-11] and also for 1.12 and [https://github.com/ProditorMagnus/Ageless-for-1-14 1.14]

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=19&t=25274 Development and Feedback Thread]

==== Imperial Era (IE) ====

'''Description:''' One of the oldest maintained user eras, the Imperial Era brings together seven different factions in a completely re-imagined setting, the world of Orbivm, a very lethal world indeed. The era contains both mainline and development versions of each faction and can be used to play five campaigns, each featuring a different race.

'''Author:''' Orbivm Project (but really Turin)

'''Maintainer:''' UnwiseOwl

'''Status:''' Complete, 0.23

'''Faction Descriptions:'''

# Lavinian Legion - Based on the Roman Legion, the Lavinians have strong, versatile melee units in the legionaries and a range of support classes sourced from amongst the Lavinian population and various subjugated races. The legion are strong in the plains but weak when fighting in forested areas. The Lavinians are featured in "Fall of Silvium".
# Sidhe - The Sidhe are a group of forest-dwelling elves whose focus is stealth and fleet movement. Their mages are able to channel the lightning itself, and their various other units move almost as fast. The Sidhe feature in "Tale of Vaniyera".
# Marauders - Based on the Germanic peoples that eventually conquered Rome (hint, hint), the Marauders are equally as at home in the hills, forests and swamps of their homeland. Their hard-hitting melee units are practicalyl unstoppable during the night-time. The Marauders are the stars of the "Alfhelm the Wise" campaign.
# Orcei Gentorum - The orcs have been captured gladiators slaving away in the Lavinian arenas for generations.The life of an orc in Orbivm is harsh and brutal, just like the orcs themselves. The tale of the uprising of one such group of Orcs is told in "Up from Slavery".
# Cavernei - The Cavernei are a dwarvish race with similarities to the mainline Knalgans, but with a greater emphasis on the military uses of runesmithing. They get a campaign too, in "Gali's Contract"
# Issaelfr - The frost elves live on the fringes of the habitable lands of Evrosia, the main continent of Orbivm, and have become inured to difficult conditions and tuned in to their Fae natures. They don't have a campaign yet, but you could always write one.
# Arendians - The Arendians are horse-lords living on the Western steppes of Evrosia. A life of constant battle has developed a military-focused society where warriors are trained from a young age. They used to have a campaign, but it fell into disrepair a very long time ago.

'''Wiki:''' [[Orbivm]]

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?t=37920 Development and Feedback Thread]

==== Lonely Era (LE) ====

'''Description:''' The Lonely Era is a new collection of six selected superior solitary sides with interesting and unusual abilities, traits and attributes.

It has been extensively revised and rebalanced over the last few years from the original era and the constituent factions.

'''Author:''' Atreides. Based on work by Shield, Desert_Shyde, Brilliand, Stern, Cloud, Grigistian, mikoc5, Stopsignal, The_Gnat, Minnakht.

'''Maintainer:''' Atreides

'''Status 1.16:''' Finished

'''Faction Descriptions:'''

1) Santa's Helpers are his Elves as well as animated pine trees. They are an updated faction based on the Merry Christmas Campaign. Beware of Elves bearing gifts though, the presents are very distracting. They are unique in not having standard levels, they each can gain up to 4 special abilities via AMLA but always remain at level 1. Of course there are also Flying Reindeer and Christmas Seals.

2) Gremlins are an all teleporting race of elusive ethereal creatures. Individually fragile they work together using their tremendous mobility to swarm and overwhelm their enemies. Their mages are perhaps the ultimate glass cannons but if you can somehow keep one alive long enough it might even get to level 5 and become immortal.

3) Vaeringjar are a Viking faction allied with Wolfkin. The vikings eschew ranged weapons as well as sissy ideas like dodging blows but are a very, very hardy lot. They also have a unique herbalist unit that can inspire berserker rage in adjacent vikings for a turn. The wolfkin are lithe and armed with bows and teeth on the other hand. They are also very agile in contrast to the vikings. As nocturnal hunters they are devastating at night and almost helpless in the day.

4) Avians are cold loving, water hating bipedal birds. Their hollow bones and feathers make them vulnerable to fire and blunt weapons. They are unique in having cheap level 0 healers. Unusually their leaders are not drawn from the ranks but form a separate class only selectable as leaders. Tamed Albatrosses to patrol the awful waters.

5) The Deep Ones - Slimy, slippery, blasphemous fish-frogs of the nameless design - living and horrible - have now been sighted on the edge of Wesnoth. Mutants who slowly evolve from human to monster these creatures are nothing to be trifled with! An all water faction they are quite capable of holding their own against the landlubbers.

6) Jephrifs live far up in the sky, miles above land. Away from even the most basic things most other races take for granted, such as solid ground, their society developed to be quite alien indeed. In recent times, jephrifs began descending from the skies to participate in combat against other races - apparently for their own amusement, seeing life as a game.

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?t=42630 Development and Feedback Thread]

== Additional info ==
See also:
* [[Player_UMC_Reviews|Player UMC Reviews]]
* [[:Category:User-made Campaigns - Walkthroughs|Walkthroughs for user-made campaigns]]
* [//r.wesnoth.org/t37476 forum thread] for this page
* [[Guide_to_UMC_Content/1.12|Guide to user-made content (UMC) for Battle for Wesnoth 1.12]]
* [[Guide_to_UMC_Content/1.10|Guide to user-made content (UMC) for Battle for Wesnoth 1.10]]
* [//r.wesnoth.org/t36733 thread discussing 1.8 UMC that wasn't ported to 1.10]
* [//r.wesnoth.org/t48086 thread discussing all UMC that hasn't been ported to 1.14]
* [//addons.wesnoth.org the addon server]

FlightToFreedom

2025-05-04T19:32:12Z

Egallager: bump 1.19 version prereq

<big>Flight to Freedom</big>


Last updated 3/24/25 (although before that, there have been multiple long stretches where it hadn't been updated, so much of the info on this page may still be out-of-date)

Flight to Freedom is a campaign featuring the Drakes. The hero, Malakar, and his tribe have been enslaved by humans,
and Malakar must free the tribe and take revenge on his oppressors.

Latest versions, depending on your Wesnoth version, are:

* [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.2 5.4.2] (for Wesnoth 1.16.x+)
* [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.5.0 5.5.0] (for Wesnoth 1.17.x+)
* [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.6.1 5.6.1] (for Wesnoth 1.18.x+)
* [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.7.3 5.7.3] (for Wesnoth 1.19.9+)

The forum thread is [http://www.wesnoth.org/forum/viewtopic.php?f=8&t=1887 here]. 
Made by MadMax, Nova 
Currently maintained by [[User:egallager|egallager]], although MadMax still contributes, too. 

== News ==

9/6/04: 
News started, not that I expect much to come up.

Artists wanted [http://www.wesnoth.org/forum/viewtopic.php?t=2996 here] for a new Kogw graphic. 
Announce your loyalty to the Drake cause [http://www.wesnoth.org/forum/viewtopic.php?t=2976 here]!

9/7/04 
I need feedback to keep improving. Keep it coming.

9/13/04: 
Revision 27 released, with many changes. A major update.

9/17/04: 
Poll updated. Redeclare your loyalties [http://www.wesnoth.org/forum/viewtopic.php?t=3132 here]!

9/19/04: 
Poll updated again. Prove yourself [http://www.wesnoth.org/forum/viewtopic.php?t=3143 here]! 
Campaign is on campaign server (requires CVS). Unless any major bugs arise before 0.8.5 is released, all future updates
will take place on the campaign server.

9/23/04 
revision 28 released on campaign server. Contains new drakes, Kogw graphic, and several balance changes. Requires CVS
or better 
Need attack/defense animations for Kogw graphic, need indoor time graphic (the picture under the map)

9/24/04 
revision 28.3 on campaign server. This is necessary for compatibility with CVS as of 9/24/04 (when the Drake Slave was
removed). Also has many bug fixes, including the bug that caused scenario 2 to hang.

9/26/04 
revision 28.4 on server. Bug fixes, balancing, additions to River of Skulls (credit Wesvoid), and an easter egg (not
telling you what, but I will say it's randomly activated in Endgame).

10/5/04 
revision 29 released. 1.4MB. Major changes: 
many bug fixes 
thunder spirit spawn animation 
debugger unit for testing and cheating 
improvements to Rebellion, Manor, Exodus 
new sound in the victory sequence 
new Drakes 
Note that there are some nasty engine bugs (Savannah #10569, #10570) that cause the recall list to disappear in Open
Ocean, and the campaign to quit altogether in Drake Escape. If anyone can help, I would very much appreciate it.

10/8/04 
New version. This changes the pier tiles to bridge, and it adds the Drake Hatchling back and the Drake Guard required
in scenario 21, fixing a major bug involving recruitment.

10/15/04 
New version. Bug in Drake Escape (#10570) worked around, but recall bug (#10569) is still at large. I also have made
Kogw level two, and gave him a level 3.

11/21/04 
New version released on campaign server. (2.2) 
Improvements:

switched to the x.x.x version system 
neutral birds actually fly 
in Drake Escape, Goblin Pillagers can pillage 
balancing changes to many scenarios 
bug fixes in Rebellion

1/3/05 
Update: 
version 2.4:

bug fix 
storyline images for Survival and Rebellion 
balancing improvements in Endgame

1/19/05 
Update: 
version 2.5:

changes to Manor 
a major bugfix

1/20/05 
Update: 
version 2.5.1

minor bugfix in Manor

2/3/05 
Update: 
version 2.6

maps use new terrains where appropriate 
scenarios set on Morogor now have their location denoted on a [http://gs295.sp.cs.cmu.edu/brennan/wercator/index.html Wercator]-
created map ([http://gs295.sp.cs.cmu.edu/brennan/wercator/maps/Peoples_in_Decline.jpg here]) 
balance changes to Manor, River of Skulls, Return to Morogor, Liberation, Endgame 
minor bugfixes

2/19/05 
Update: 
version 2.6.1

directory structure updated 
balance changes to Endgame 
0.8.11 compatibility

2/27/05 
Update: 
version 2.6.2

major bugfix to Blockade, should be possible to win now

4/13/05 
Update: 
version 2.7

scenarios updated for compatibility with 0.9 
varied dialogue improvements 
balancing to River of Skulls (removed village in chokepoint) 
scenarios take advantage of new [objectives] tag, changing objectives added 
maps now use river ford and ruin terrains

5/14/05 
Update: 
version 2.8

translated into German and Swedish 
WML syntax updated for 0.9.1 (involving translations) 
portrait for Kogw

6/10/05 
Update: 
version 2.9

WML updated for 0.9.2 
WML optimizations, separate copies of drake unit.cfgs no longer needed 
portrait for Malakar added 
balancing changes to Survival 
pngcrush run on all images 
rock golem image updated

6/22/05 
NOTE: This update breaks all in-game saves (NOT beginning-of-scenario saves) for the following scenarios: 
Southern Shore 
Open Ocean 
Landfall 
Blockade

Update: 
version 2.9.1

SHOULD be compatible with 0.9.2CVS 
missing newline at end of Flight_Freedom.cfg fixed 
FtF's Pirate Galleon does not override the in-game Pirate Galleon 
new graphics for the Driver 
balancing changes to Rebellion and Manor, Malakar has leadership in those scenarios

7/03/05 
Update: 
version 2.9.2

balancing change to River of Skulls, second chokepoint added parallel to the first 
mid-scenario objectives changes work properly now 
enemies in Survival do not recruit infinite numbers of units 
in Caravan, the caravan's movement points reflects its actual movement

11/02/05 
I know it's been overdue for over a month, but here it is. I've finally got the underground scenarios balanced, but there are so many changes (and so little time to debug) that I have had to release a beta. Hopefully, unless any major bugs are found, I'll finalize FtF 3.0 in a week.

In the meantime, PLEASE reply if you find any bugs.

12/2/05 
UPDATE: 
version 3.0

FtF 3.0 finally released!

Many changes across the board, far too many to list, but here are the major changes (including those of the 3.0 beta): 
storyline changes 
Rebellion enhanced 
underground scenarios balanced 
bug fixes, dialogue changes in Landfall

12/3/05 
UPDATE: 
version 3.0.1

game-killing bug in Landfall fixed (map was not sent)

3/23/06 
UPDATE: 
version 3.1

updated for 1.12+, not backward compatible (beginning-of-scenario saves will still work) 
new terrain added: dark tiles, from UtBS (replaces some dirt, sand in caves) 
maps updated for new terrain 
image references updated to reflect 1.12 directory structure 
terrain code for lava bridge changed to ` instead of ' to avoid conflict 
Skeletal Dragon, Watch Tower moved into FtF from EI, SoTBE (credit Hanno for alerting me to this) 
old wesnoth-8.ogg moved into FtF 
soundtracks updated for music changes/removals 
balancing changes to Underground, River of Skulls, Endgame 
unit .cfgs updated for 1.12 compatibility 
easter egg temporarily commented out, pending consideration 

NOTE: due to technical differences between the old code and the 1.12+ compatible code, I was forced to split the campaign into two distributions, which are on their respective campaign servers. Because of this, however, the translations will not be current until the branch is created on wescamp (so that translators can update it).

8/20/06 
3.2 is on the campaign server. It [i]should[/i] be (almost) fully compatible with 1.18, but I can't guarantee that every animation will work right. I have also made balancing changes up until Exodus (level 16), but the cave levels are still buggy. 
Any feedback is appreciated!

12/22/06 
Hosted on http://warhangel.ru/wesnoth/campaigns/Flight_Freedom_1_x.zip . Special thanks to warhangel for hosting this campaign. 

1/5/07 
FtF 3.3 uploaded.

NPC AI should be fixed 
naga, saurian animations are working, graphics from Marsh Era 
two attack icons added, one by Xan, the other from the Extended Era 
balancing changes to Manor, Underground, River of Skulls and Blockade 
Rockfall fixed with RedLTeut's patch 
other fixes and tweaks which I have forgotten about 

3/20/07 
FtF 4.0 released, for Wesnoth 1.3 and up only. 
compatible with new terrain system, will make cave roads passable 
Manor enhanced 
Survival edited, but cutscene not implemented yet 
several dialogue changes 
Landfall bridge collapse softened 
new graphic for the enslaved Malakar 
several bugfixes 
Drake Guerillas/Revolutionaries have visible spear overlay 
losing text added if Unforgiver is sunk and Kogw has not disembarked 

4/21/07 
version 4.1 released 
many new storyline images added 
many dialogue changes 
extra enemy added to Survival, to shorten it 
balancing changes to Pirate Schooner and Clipper 
all ships have reasonably fitting hit and die sounds 
Manor recruitment bug precluded 
cutscene code moved to separate file (a purely internal change) 
rain added to Open Ocean 
ships should have names 

6/14/07 
version 4.2 released 
dragon in Underground is now friendly 
River of Skulls rebalanced, map edited 
several bugfixes 
Blockade enhanced 
new Malakar and Kamalar graphics 
terrain error messages fixed 
FtF will sort properly in campaign menu 
ships now have names 
experience gained in Survival by Malakar will carry over to Rebellion 

NOTE: This will break saves of River of Skulls. Other saves will work, but they may use the old Malakar (which should work fine). 

7/6/07 
version 4.2.1 released, for Wesnoth 1.3.3+ 
bug fixes in Underground and River of Skulls 
Manor enhanced 
minor dialogue changes 
a few minor bug and potential bug fixes 

7/20/07 
version 4.2.2 released, for Wesnoth 1.3.4+ 
dialogue changes 
storyline graphics updated for new Malakar graphics 
new storyline graphics for Underground and Rockfall 
Caravan elves nerfed 
Drake Escape enhanced 
at least one bugfix 

8/3/07 
version 4.3 released, for Wesnoth 1.3.4+ 
changes (dialogue and other) to Rockfall, Betrayal, Hordes of the Foul Undead, Gate of Storms, Exodus, Blockade and Return to Morogor 
two scenarios added (Swamps of the Jamolar and Council of War), part of a possible branch (accessed from Survival) 
attainable objective added to Survival 
experimental wave animations in Rebellion 
minor bugfixes 
time over events added to some scenarios 
non-expendable player characters are spawned with hero icon 
balancing changes to Betrayal and Blockade 

8/23/07 
version 4.3.1 released, for Wesnoth 1.3.6+ 
new scenario, Forest of Nightmares (in second branch) 
enhancements to Manor, includes irrevenant's indoors time-of-day image 
several bugfixes 
thunder spirits in Landfall and Drake Escape will not spawn on first turn 
multi-hex fireball attack code implemented (not used yet) 
victory music added to victory events 
lava transitions fixed 

9/1/07 
version 4.3.2 released, for Wesnoth 1.3.7+ 
critical 1.3.7 compatibility bug fixed 
new scenario, Hafwyt (still not 100% finished) 
savegames of cave levels will not show snapshots 

10/22/07 
version 4.3.3 released, for Wesnoth 1.3.9+ 
unit WML updated to 1.3.8+ standard 
new scenario: Mountain Crypt (in second branch) 
bugfixes 
turn limit of Forest of Nightmares reduced to 25 
balancing changes 

1/20/08 
version 4.4 released, for Wesnoth 1.3.14+ 
headers and borders added to all maps 
two links added in secondary branch to main branch 
sword-and-shield narrator icon replaced 
new cutscenes 
Mountain Crypt darkness code revised 
bugfixes 

8/19/08 
version 4.5 released, for Wesnoth 1.4+ 
scenario 19, Liberation, completely rewritten 
dialogue changes 
user team names added, so that the status table will show the names of sides in a level 
bugfixes 
levels use new Wesnoth music when appropriate 

2/20/09 
version 4.6 released, for Wesnoth 1.5.6+ 
compatibility with Wesnoth 1.5 branch 
bugfixes 

7/25/21 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.3.3 5.3.3] released, for Wesnoth 1.14+ 
egallager's first release since taking over as maintainer 

5/18/22 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.0 5.4.0] released, for Wesnoth 1.16+ 
first release on the 1.16 add-on server 

11/27/22 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.1 5.4.1] released, for Wesnoth 1.16+ 
see release notes for full changelog 

1/27/24 
versions [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.2 5.4.2] and [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.5.0 5.5.0] released, for Wesnoth 1.16+ and Wesnoth 1.17+ respectively. 
see each of their release notes for full changelogs 

6/7/24 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.6.0 5.6.0] released, for Wesnoth 1.18+. 
see release notes for full changelog 

8/17/24 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.6.1 5.6.1] released, for Wesnoth 1.18+. 
see release notes for full changelog 

1/30/25 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.7.0 5.7.0] released, for Wesnoth 1.19.8+. 
see release notes for full changelog 

3/24/25 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.7.2 5.7.2] released, for Wesnoth 1.19.8+. 
see release notes for full changelog 

5/4/25 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.7.3 5.7.3] released, for Wesnoth 1.19.9+. 
see release notes for full changelog 

== See Also ==
* [[Guide_to_UMC_Content]]
* [[CampaignFlightFreedom]]

[[Category:Campaigns - Development]]

FlightToFreedom

2025-05-04T19:31:00Z

Egallager: 5.7.3

<big>Flight to Freedom</big>


Last updated 3/24/25 (although before that, there have been multiple long stretches where it hadn't been updated, so much of the info on this page may still be out-of-date)

Flight to Freedom is a campaign featuring the Drakes. The hero, Malakar, and his tribe have been enslaved by humans,
and Malakar must free the tribe and take revenge on his oppressors.

Latest versions, depending on your Wesnoth version, are:

* [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.2 5.4.2] (for Wesnoth 1.16.x+)
* [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.5.0 5.5.0] (for Wesnoth 1.17.x+)
* [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.6.1 5.6.1] (for Wesnoth 1.18.x+)
* [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.7.3 5.7.3] (for Wesnoth 1.19.8+)

The forum thread is [http://www.wesnoth.org/forum/viewtopic.php?f=8&t=1887 here]. 
Made by MadMax, Nova 
Currently maintained by [[User:egallager|egallager]], although MadMax still contributes, too. 

== News ==

9/6/04: 
News started, not that I expect much to come up.

Artists wanted [http://www.wesnoth.org/forum/viewtopic.php?t=2996 here] for a new Kogw graphic. 
Announce your loyalty to the Drake cause [http://www.wesnoth.org/forum/viewtopic.php?t=2976 here]!

9/7/04 
I need feedback to keep improving. Keep it coming.

9/13/04: 
Revision 27 released, with many changes. A major update.

9/17/04: 
Poll updated. Redeclare your loyalties [http://www.wesnoth.org/forum/viewtopic.php?t=3132 here]!

9/19/04: 
Poll updated again. Prove yourself [http://www.wesnoth.org/forum/viewtopic.php?t=3143 here]! 
Campaign is on campaign server (requires CVS). Unless any major bugs arise before 0.8.5 is released, all future updates
will take place on the campaign server.

9/23/04 
revision 28 released on campaign server. Contains new drakes, Kogw graphic, and several balance changes. Requires CVS
or better 
Need attack/defense animations for Kogw graphic, need indoor time graphic (the picture under the map)

9/24/04 
revision 28.3 on campaign server. This is necessary for compatibility with CVS as of 9/24/04 (when the Drake Slave was
removed). Also has many bug fixes, including the bug that caused scenario 2 to hang.

9/26/04 
revision 28.4 on server. Bug fixes, balancing, additions to River of Skulls (credit Wesvoid), and an easter egg (not
telling you what, but I will say it's randomly activated in Endgame).

10/5/04 
revision 29 released. 1.4MB. Major changes: 
many bug fixes 
thunder spirit spawn animation 
debugger unit for testing and cheating 
improvements to Rebellion, Manor, Exodus 
new sound in the victory sequence 
new Drakes 
Note that there are some nasty engine bugs (Savannah #10569, #10570) that cause the recall list to disappear in Open
Ocean, and the campaign to quit altogether in Drake Escape. If anyone can help, I would very much appreciate it.

10/8/04 
New version. This changes the pier tiles to bridge, and it adds the Drake Hatchling back and the Drake Guard required
in scenario 21, fixing a major bug involving recruitment.

10/15/04 
New version. Bug in Drake Escape (#10570) worked around, but recall bug (#10569) is still at large. I also have made
Kogw level two, and gave him a level 3.

11/21/04 
New version released on campaign server. (2.2) 
Improvements:

switched to the x.x.x version system 
neutral birds actually fly 
in Drake Escape, Goblin Pillagers can pillage 
balancing changes to many scenarios 
bug fixes in Rebellion

1/3/05 
Update: 
version 2.4:

bug fix 
storyline images for Survival and Rebellion 
balancing improvements in Endgame

1/19/05 
Update: 
version 2.5:

changes to Manor 
a major bugfix

1/20/05 
Update: 
version 2.5.1

minor bugfix in Manor

2/3/05 
Update: 
version 2.6

maps use new terrains where appropriate 
scenarios set on Morogor now have their location denoted on a [http://gs295.sp.cs.cmu.edu/brennan/wercator/index.html Wercator]-
created map ([http://gs295.sp.cs.cmu.edu/brennan/wercator/maps/Peoples_in_Decline.jpg here]) 
balance changes to Manor, River of Skulls, Return to Morogor, Liberation, Endgame 
minor bugfixes

2/19/05 
Update: 
version 2.6.1

directory structure updated 
balance changes to Endgame 
0.8.11 compatibility

2/27/05 
Update: 
version 2.6.2

major bugfix to Blockade, should be possible to win now

4/13/05 
Update: 
version 2.7

scenarios updated for compatibility with 0.9 
varied dialogue improvements 
balancing to River of Skulls (removed village in chokepoint) 
scenarios take advantage of new [objectives] tag, changing objectives added 
maps now use river ford and ruin terrains

5/14/05 
Update: 
version 2.8

translated into German and Swedish 
WML syntax updated for 0.9.1 (involving translations) 
portrait for Kogw

6/10/05 
Update: 
version 2.9

WML updated for 0.9.2 
WML optimizations, separate copies of drake unit.cfgs no longer needed 
portrait for Malakar added 
balancing changes to Survival 
pngcrush run on all images 
rock golem image updated

6/22/05 
NOTE: This update breaks all in-game saves (NOT beginning-of-scenario saves) for the following scenarios: 
Southern Shore 
Open Ocean 
Landfall 
Blockade

Update: 
version 2.9.1

SHOULD be compatible with 0.9.2CVS 
missing newline at end of Flight_Freedom.cfg fixed 
FtF's Pirate Galleon does not override the in-game Pirate Galleon 
new graphics for the Driver 
balancing changes to Rebellion and Manor, Malakar has leadership in those scenarios

7/03/05 
Update: 
version 2.9.2

balancing change to River of Skulls, second chokepoint added parallel to the first 
mid-scenario objectives changes work properly now 
enemies in Survival do not recruit infinite numbers of units 
in Caravan, the caravan's movement points reflects its actual movement

11/02/05 
I know it's been overdue for over a month, but here it is. I've finally got the underground scenarios balanced, but there are so many changes (and so little time to debug) that I have had to release a beta. Hopefully, unless any major bugs are found, I'll finalize FtF 3.0 in a week.

In the meantime, PLEASE reply if you find any bugs.

12/2/05 
UPDATE: 
version 3.0

FtF 3.0 finally released!

Many changes across the board, far too many to list, but here are the major changes (including those of the 3.0 beta): 
storyline changes 
Rebellion enhanced 
underground scenarios balanced 
bug fixes, dialogue changes in Landfall

12/3/05 
UPDATE: 
version 3.0.1

game-killing bug in Landfall fixed (map was not sent)

3/23/06 
UPDATE: 
version 3.1

updated for 1.12+, not backward compatible (beginning-of-scenario saves will still work) 
new terrain added: dark tiles, from UtBS (replaces some dirt, sand in caves) 
maps updated for new terrain 
image references updated to reflect 1.12 directory structure 
terrain code for lava bridge changed to ` instead of ' to avoid conflict 
Skeletal Dragon, Watch Tower moved into FtF from EI, SoTBE (credit Hanno for alerting me to this) 
old wesnoth-8.ogg moved into FtF 
soundtracks updated for music changes/removals 
balancing changes to Underground, River of Skulls, Endgame 
unit .cfgs updated for 1.12 compatibility 
easter egg temporarily commented out, pending consideration 

NOTE: due to technical differences between the old code and the 1.12+ compatible code, I was forced to split the campaign into two distributions, which are on their respective campaign servers. Because of this, however, the translations will not be current until the branch is created on wescamp (so that translators can update it).

8/20/06 
3.2 is on the campaign server. It [i]should[/i] be (almost) fully compatible with 1.18, but I can't guarantee that every animation will work right. I have also made balancing changes up until Exodus (level 16), but the cave levels are still buggy. 
Any feedback is appreciated!

12/22/06 
Hosted on http://warhangel.ru/wesnoth/campaigns/Flight_Freedom_1_x.zip . Special thanks to warhangel for hosting this campaign. 

1/5/07 
FtF 3.3 uploaded.

NPC AI should be fixed 
naga, saurian animations are working, graphics from Marsh Era 
two attack icons added, one by Xan, the other from the Extended Era 
balancing changes to Manor, Underground, River of Skulls and Blockade 
Rockfall fixed with RedLTeut's patch 
other fixes and tweaks which I have forgotten about 

3/20/07 
FtF 4.0 released, for Wesnoth 1.3 and up only. 
compatible with new terrain system, will make cave roads passable 
Manor enhanced 
Survival edited, but cutscene not implemented yet 
several dialogue changes 
Landfall bridge collapse softened 
new graphic for the enslaved Malakar 
several bugfixes 
Drake Guerillas/Revolutionaries have visible spear overlay 
losing text added if Unforgiver is sunk and Kogw has not disembarked 

4/21/07 
version 4.1 released 
many new storyline images added 
many dialogue changes 
extra enemy added to Survival, to shorten it 
balancing changes to Pirate Schooner and Clipper 
all ships have reasonably fitting hit and die sounds 
Manor recruitment bug precluded 
cutscene code moved to separate file (a purely internal change) 
rain added to Open Ocean 
ships should have names 

6/14/07 
version 4.2 released 
dragon in Underground is now friendly 
River of Skulls rebalanced, map edited 
several bugfixes 
Blockade enhanced 
new Malakar and Kamalar graphics 
terrain error messages fixed 
FtF will sort properly in campaign menu 
ships now have names 
experience gained in Survival by Malakar will carry over to Rebellion 

NOTE: This will break saves of River of Skulls. Other saves will work, but they may use the old Malakar (which should work fine). 

7/6/07 
version 4.2.1 released, for Wesnoth 1.3.3+ 
bug fixes in Underground and River of Skulls 
Manor enhanced 
minor dialogue changes 
a few minor bug and potential bug fixes 

7/20/07 
version 4.2.2 released, for Wesnoth 1.3.4+ 
dialogue changes 
storyline graphics updated for new Malakar graphics 
new storyline graphics for Underground and Rockfall 
Caravan elves nerfed 
Drake Escape enhanced 
at least one bugfix 

8/3/07 
version 4.3 released, for Wesnoth 1.3.4+ 
changes (dialogue and other) to Rockfall, Betrayal, Hordes of the Foul Undead, Gate of Storms, Exodus, Blockade and Return to Morogor 
two scenarios added (Swamps of the Jamolar and Council of War), part of a possible branch (accessed from Survival) 
attainable objective added to Survival 
experimental wave animations in Rebellion 
minor bugfixes 
time over events added to some scenarios 
non-expendable player characters are spawned with hero icon 
balancing changes to Betrayal and Blockade 

8/23/07 
version 4.3.1 released, for Wesnoth 1.3.6+ 
new scenario, Forest of Nightmares (in second branch) 
enhancements to Manor, includes irrevenant's indoors time-of-day image 
several bugfixes 
thunder spirits in Landfall and Drake Escape will not spawn on first turn 
multi-hex fireball attack code implemented (not used yet) 
victory music added to victory events 
lava transitions fixed 

9/1/07 
version 4.3.2 released, for Wesnoth 1.3.7+ 
critical 1.3.7 compatibility bug fixed 
new scenario, Hafwyt (still not 100% finished) 
savegames of cave levels will not show snapshots 

10/22/07 
version 4.3.3 released, for Wesnoth 1.3.9+ 
unit WML updated to 1.3.8+ standard 
new scenario: Mountain Crypt (in second branch) 
bugfixes 
turn limit of Forest of Nightmares reduced to 25 
balancing changes 

1/20/08 
version 4.4 released, for Wesnoth 1.3.14+ 
headers and borders added to all maps 
two links added in secondary branch to main branch 
sword-and-shield narrator icon replaced 
new cutscenes 
Mountain Crypt darkness code revised 
bugfixes 

8/19/08 
version 4.5 released, for Wesnoth 1.4+ 
scenario 19, Liberation, completely rewritten 
dialogue changes 
user team names added, so that the status table will show the names of sides in a level 
bugfixes 
levels use new Wesnoth music when appropriate 

2/20/09 
version 4.6 released, for Wesnoth 1.5.6+ 
compatibility with Wesnoth 1.5 branch 
bugfixes 

7/25/21 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.3.3 5.3.3] released, for Wesnoth 1.14+ 
egallager's first release since taking over as maintainer 

5/18/22 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.0 5.4.0] released, for Wesnoth 1.16+ 
first release on the 1.16 add-on server 

11/27/22 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.1 5.4.1] released, for Wesnoth 1.16+ 
see release notes for full changelog 

1/27/24 
versions [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.2 5.4.2] and [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.5.0 5.5.0] released, for Wesnoth 1.16+ and Wesnoth 1.17+ respectively. 
see each of their release notes for full changelogs 

6/7/24 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.6.0 5.6.0] released, for Wesnoth 1.18+. 
see release notes for full changelog 

8/17/24 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.6.1 5.6.1] released, for Wesnoth 1.18+. 
see release notes for full changelog 

1/30/25 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.7.0 5.7.0] released, for Wesnoth 1.19.8+. 
see release notes for full changelog 

3/24/25 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.7.2 5.7.2] released, for Wesnoth 1.19.8+. 
see release notes for full changelog 

5/4/25 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.7.3 5.7.3] released, for Wesnoth 1.19.9+. 
see release notes for full changelog 

== See Also ==
* [[Guide_to_UMC_Content]]
* [[CampaignFlightFreedom]]

[[Category:Campaigns - Development]]

FlightToFreedom

2025-03-25T02:51:04Z

Egallager: update date

<big>Flight to Freedom</big>


Last updated 3/24/25 (although before that, there have been multiple long stretches where it hadn't been updated, so much of the info on this page may still be out-of-date)

Flight to Freedom is a campaign featuring the Drakes. The hero, Malakar, and his tribe have been enslaved by humans,
and Malakar must free the tribe and take revenge on his oppressors.

Latest versions, depending on your Wesnoth version, are:

* [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.2 5.4.2] (for Wesnoth 1.16.x+)
* [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.5.0 5.5.0] (for Wesnoth 1.17.x+)
* [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.6.1 5.6.1] (for Wesnoth 1.18.x+)
* [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.7.2 5.7.2] (for Wesnoth 1.19.8+)

The forum thread is [http://www.wesnoth.org/forum/viewtopic.php?f=8&t=1887 here]. 
Made by MadMax, Nova 
Currently maintained by [[User:egallager|egallager]], although MadMax still contributes, too. 

== News ==

9/6/04: 
News started, not that I expect much to come up.

Artists wanted [http://www.wesnoth.org/forum/viewtopic.php?t=2996 here] for a new Kogw graphic. 
Announce your loyalty to the Drake cause [http://www.wesnoth.org/forum/viewtopic.php?t=2976 here]!

9/7/04 
I need feedback to keep improving. Keep it coming.

9/13/04: 
Revision 27 released, with many changes. A major update.

9/17/04: 
Poll updated. Redeclare your loyalties [http://www.wesnoth.org/forum/viewtopic.php?t=3132 here]!

9/19/04: 
Poll updated again. Prove yourself [http://www.wesnoth.org/forum/viewtopic.php?t=3143 here]! 
Campaign is on campaign server (requires CVS). Unless any major bugs arise before 0.8.5 is released, all future updates
will take place on the campaign server.

9/23/04 
revision 28 released on campaign server. Contains new drakes, Kogw graphic, and several balance changes. Requires CVS
or better 
Need attack/defense animations for Kogw graphic, need indoor time graphic (the picture under the map)

9/24/04 
revision 28.3 on campaign server. This is necessary for compatibility with CVS as of 9/24/04 (when the Drake Slave was
removed). Also has many bug fixes, including the bug that caused scenario 2 to hang.

9/26/04 
revision 28.4 on server. Bug fixes, balancing, additions to River of Skulls (credit Wesvoid), and an easter egg (not
telling you what, but I will say it's randomly activated in Endgame).

10/5/04 
revision 29 released. 1.4MB. Major changes: 
many bug fixes 
thunder spirit spawn animation 
debugger unit for testing and cheating 
improvements to Rebellion, Manor, Exodus 
new sound in the victory sequence 
new Drakes 
Note that there are some nasty engine bugs (Savannah #10569, #10570) that cause the recall list to disappear in Open
Ocean, and the campaign to quit altogether in Drake Escape. If anyone can help, I would very much appreciate it.

10/8/04 
New version. This changes the pier tiles to bridge, and it adds the Drake Hatchling back and the Drake Guard required
in scenario 21, fixing a major bug involving recruitment.

10/15/04 
New version. Bug in Drake Escape (#10570) worked around, but recall bug (#10569) is still at large. I also have made
Kogw level two, and gave him a level 3.

11/21/04 
New version released on campaign server. (2.2) 
Improvements:

switched to the x.x.x version system 
neutral birds actually fly 
in Drake Escape, Goblin Pillagers can pillage 
balancing changes to many scenarios 
bug fixes in Rebellion

1/3/05 
Update: 
version 2.4:

bug fix 
storyline images for Survival and Rebellion 
balancing improvements in Endgame

1/19/05 
Update: 
version 2.5:

changes to Manor 
a major bugfix

1/20/05 
Update: 
version 2.5.1

minor bugfix in Manor

2/3/05 
Update: 
version 2.6

maps use new terrains where appropriate 
scenarios set on Morogor now have their location denoted on a [http://gs295.sp.cs.cmu.edu/brennan/wercator/index.html Wercator]-
created map ([http://gs295.sp.cs.cmu.edu/brennan/wercator/maps/Peoples_in_Decline.jpg here]) 
balance changes to Manor, River of Skulls, Return to Morogor, Liberation, Endgame 
minor bugfixes

2/19/05 
Update: 
version 2.6.1

directory structure updated 
balance changes to Endgame 
0.8.11 compatibility

2/27/05 
Update: 
version 2.6.2

major bugfix to Blockade, should be possible to win now

4/13/05 
Update: 
version 2.7

scenarios updated for compatibility with 0.9 
varied dialogue improvements 
balancing to River of Skulls (removed village in chokepoint) 
scenarios take advantage of new [objectives] tag, changing objectives added 
maps now use river ford and ruin terrains

5/14/05 
Update: 
version 2.8

translated into German and Swedish 
WML syntax updated for 0.9.1 (involving translations) 
portrait for Kogw

6/10/05 
Update: 
version 2.9

WML updated for 0.9.2 
WML optimizations, separate copies of drake unit.cfgs no longer needed 
portrait for Malakar added 
balancing changes to Survival 
pngcrush run on all images 
rock golem image updated

6/22/05 
NOTE: This update breaks all in-game saves (NOT beginning-of-scenario saves) for the following scenarios: 
Southern Shore 
Open Ocean 
Landfall 
Blockade

Update: 
version 2.9.1

SHOULD be compatible with 0.9.2CVS 
missing newline at end of Flight_Freedom.cfg fixed 
FtF's Pirate Galleon does not override the in-game Pirate Galleon 
new graphics for the Driver 
balancing changes to Rebellion and Manor, Malakar has leadership in those scenarios

7/03/05 
Update: 
version 2.9.2

balancing change to River of Skulls, second chokepoint added parallel to the first 
mid-scenario objectives changes work properly now 
enemies in Survival do not recruit infinite numbers of units 
in Caravan, the caravan's movement points reflects its actual movement

11/02/05 
I know it's been overdue for over a month, but here it is. I've finally got the underground scenarios balanced, but there are so many changes (and so little time to debug) that I have had to release a beta. Hopefully, unless any major bugs are found, I'll finalize FtF 3.0 in a week.

In the meantime, PLEASE reply if you find any bugs.

12/2/05 
UPDATE: 
version 3.0

FtF 3.0 finally released!

Many changes across the board, far too many to list, but here are the major changes (including those of the 3.0 beta): 
storyline changes 
Rebellion enhanced 
underground scenarios balanced 
bug fixes, dialogue changes in Landfall

12/3/05 
UPDATE: 
version 3.0.1

game-killing bug in Landfall fixed (map was not sent)

3/23/06 
UPDATE: 
version 3.1

updated for 1.12+, not backward compatible (beginning-of-scenario saves will still work) 
new terrain added: dark tiles, from UtBS (replaces some dirt, sand in caves) 
maps updated for new terrain 
image references updated to reflect 1.12 directory structure 
terrain code for lava bridge changed to ` instead of ' to avoid conflict 
Skeletal Dragon, Watch Tower moved into FtF from EI, SoTBE (credit Hanno for alerting me to this) 
old wesnoth-8.ogg moved into FtF 
soundtracks updated for music changes/removals 
balancing changes to Underground, River of Skulls, Endgame 
unit .cfgs updated for 1.12 compatibility 
easter egg temporarily commented out, pending consideration 

NOTE: due to technical differences between the old code and the 1.12+ compatible code, I was forced to split the campaign into two distributions, which are on their respective campaign servers. Because of this, however, the translations will not be current until the branch is created on wescamp (so that translators can update it).

8/20/06 
3.2 is on the campaign server. It [i]should[/i] be (almost) fully compatible with 1.18, but I can't guarantee that every animation will work right. I have also made balancing changes up until Exodus (level 16), but the cave levels are still buggy. 
Any feedback is appreciated!

12/22/06 
Hosted on http://warhangel.ru/wesnoth/campaigns/Flight_Freedom_1_x.zip . Special thanks to warhangel for hosting this campaign. 

1/5/07 
FtF 3.3 uploaded.

NPC AI should be fixed 
naga, saurian animations are working, graphics from Marsh Era 
two attack icons added, one by Xan, the other from the Extended Era 
balancing changes to Manor, Underground, River of Skulls and Blockade 
Rockfall fixed with RedLTeut's patch 
other fixes and tweaks which I have forgotten about 

3/20/07 
FtF 4.0 released, for Wesnoth 1.3 and up only. 
compatible with new terrain system, will make cave roads passable 
Manor enhanced 
Survival edited, but cutscene not implemented yet 
several dialogue changes 
Landfall bridge collapse softened 
new graphic for the enslaved Malakar 
several bugfixes 
Drake Guerillas/Revolutionaries have visible spear overlay 
losing text added if Unforgiver is sunk and Kogw has not disembarked 

4/21/07 
version 4.1 released 
many new storyline images added 
many dialogue changes 
extra enemy added to Survival, to shorten it 
balancing changes to Pirate Schooner and Clipper 
all ships have reasonably fitting hit and die sounds 
Manor recruitment bug precluded 
cutscene code moved to separate file (a purely internal change) 
rain added to Open Ocean 
ships should have names 

6/14/07 
version 4.2 released 
dragon in Underground is now friendly 
River of Skulls rebalanced, map edited 
several bugfixes 
Blockade enhanced 
new Malakar and Kamalar graphics 
terrain error messages fixed 
FtF will sort properly in campaign menu 
ships now have names 
experience gained in Survival by Malakar will carry over to Rebellion 

NOTE: This will break saves of River of Skulls. Other saves will work, but they may use the old Malakar (which should work fine). 

7/6/07 
version 4.2.1 released, for Wesnoth 1.3.3+ 
bug fixes in Underground and River of Skulls 
Manor enhanced 
minor dialogue changes 
a few minor bug and potential bug fixes 

7/20/07 
version 4.2.2 released, for Wesnoth 1.3.4+ 
dialogue changes 
storyline graphics updated for new Malakar graphics 
new storyline graphics for Underground and Rockfall 
Caravan elves nerfed 
Drake Escape enhanced 
at least one bugfix 

8/3/07 
version 4.3 released, for Wesnoth 1.3.4+ 
changes (dialogue and other) to Rockfall, Betrayal, Hordes of the Foul Undead, Gate of Storms, Exodus, Blockade and Return to Morogor 
two scenarios added (Swamps of the Jamolar and Council of War), part of a possible branch (accessed from Survival) 
attainable objective added to Survival 
experimental wave animations in Rebellion 
minor bugfixes 
time over events added to some scenarios 
non-expendable player characters are spawned with hero icon 
balancing changes to Betrayal and Blockade 

8/23/07 
version 4.3.1 released, for Wesnoth 1.3.6+ 
new scenario, Forest of Nightmares (in second branch) 
enhancements to Manor, includes irrevenant's indoors time-of-day image 
several bugfixes 
thunder spirits in Landfall and Drake Escape will not spawn on first turn 
multi-hex fireball attack code implemented (not used yet) 
victory music added to victory events 
lava transitions fixed 

9/1/07 
version 4.3.2 released, for Wesnoth 1.3.7+ 
critical 1.3.7 compatibility bug fixed 
new scenario, Hafwyt (still not 100% finished) 
savegames of cave levels will not show snapshots 

10/22/07 
version 4.3.3 released, for Wesnoth 1.3.9+ 
unit WML updated to 1.3.8+ standard 
new scenario: Mountain Crypt (in second branch) 
bugfixes 
turn limit of Forest of Nightmares reduced to 25 
balancing changes 

1/20/08 
version 4.4 released, for Wesnoth 1.3.14+ 
headers and borders added to all maps 
two links added in secondary branch to main branch 
sword-and-shield narrator icon replaced 
new cutscenes 
Mountain Crypt darkness code revised 
bugfixes 

8/19/08 
version 4.5 released, for Wesnoth 1.4+ 
scenario 19, Liberation, completely rewritten 
dialogue changes 
user team names added, so that the status table will show the names of sides in a level 
bugfixes 
levels use new Wesnoth music when appropriate 

2/20/09 
version 4.6 released, for Wesnoth 1.5.6+ 
compatibility with Wesnoth 1.5 branch 
bugfixes 

7/25/21 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.3.3 5.3.3] released, for Wesnoth 1.14+ 
egallager's first release since taking over as maintainer 

5/18/22 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.0 5.4.0] released, for Wesnoth 1.16+ 
first release on the 1.16 add-on server 

11/27/22 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.1 5.4.1] released, for Wesnoth 1.16+ 
see release notes for full changelog 

1/27/24 
versions [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.2 5.4.2] and [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.5.0 5.5.0] released, for Wesnoth 1.16+ and Wesnoth 1.17+ respectively. 
see each of their release notes for full changelogs 

6/7/24 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.6.0 5.6.0] released, for Wesnoth 1.18+. 
see release notes for full changelog 

8/17/24 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.6.1 5.6.1] released, for Wesnoth 1.18+. 
see release notes for full changelog 

1/30/25 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.7.0 5.7.0] released, for Wesnoth 1.19.8+. 
see release notes for full changelog 

3/24/25 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.7.2 5.7.2] released, for Wesnoth 1.19.8+. 
see release notes for full changelog 

== See Also ==
* [[Guide_to_UMC_Content]]
* [[CampaignFlightFreedom]]

[[Category:Campaigns - Development]]

FlightToFreedom

2025-03-25T02:50:09Z

Egallager: update for 5.7.2 release

<big>Flight to Freedom</big>


Last updated 1/30/25 (although before that, there have been multiple long stretches where it hadn't been updated, so much of the info on this page may still be out-of-date)

Flight to Freedom is a campaign featuring the Drakes. The hero, Malakar, and his tribe have been enslaved by humans,
and Malakar must free the tribe and take revenge on his oppressors.

Latest versions, depending on your Wesnoth version, are:

* [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.2 5.4.2] (for Wesnoth 1.16.x+)
* [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.5.0 5.5.0] (for Wesnoth 1.17.x+)
* [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.6.1 5.6.1] (for Wesnoth 1.18.x+)
* [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.7.2 5.7.2] (for Wesnoth 1.19.8+)

The forum thread is [http://www.wesnoth.org/forum/viewtopic.php?f=8&t=1887 here]. 
Made by MadMax, Nova 
Currently maintained by [[User:egallager|egallager]], although MadMax still contributes, too. 

== News ==

9/6/04: 
News started, not that I expect much to come up.

Artists wanted [http://www.wesnoth.org/forum/viewtopic.php?t=2996 here] for a new Kogw graphic. 
Announce your loyalty to the Drake cause [http://www.wesnoth.org/forum/viewtopic.php?t=2976 here]!

9/7/04 
I need feedback to keep improving. Keep it coming.

9/13/04: 
Revision 27 released, with many changes. A major update.

9/17/04: 
Poll updated. Redeclare your loyalties [http://www.wesnoth.org/forum/viewtopic.php?t=3132 here]!

9/19/04: 
Poll updated again. Prove yourself [http://www.wesnoth.org/forum/viewtopic.php?t=3143 here]! 
Campaign is on campaign server (requires CVS). Unless any major bugs arise before 0.8.5 is released, all future updates
will take place on the campaign server.

9/23/04 
revision 28 released on campaign server. Contains new drakes, Kogw graphic, and several balance changes. Requires CVS
or better 
Need attack/defense animations for Kogw graphic, need indoor time graphic (the picture under the map)

9/24/04 
revision 28.3 on campaign server. This is necessary for compatibility with CVS as of 9/24/04 (when the Drake Slave was
removed). Also has many bug fixes, including the bug that caused scenario 2 to hang.

9/26/04 
revision 28.4 on server. Bug fixes, balancing, additions to River of Skulls (credit Wesvoid), and an easter egg (not
telling you what, but I will say it's randomly activated in Endgame).

10/5/04 
revision 29 released. 1.4MB. Major changes: 
many bug fixes 
thunder spirit spawn animation 
debugger unit for testing and cheating 
improvements to Rebellion, Manor, Exodus 
new sound in the victory sequence 
new Drakes 
Note that there are some nasty engine bugs (Savannah #10569, #10570) that cause the recall list to disappear in Open
Ocean, and the campaign to quit altogether in Drake Escape. If anyone can help, I would very much appreciate it.

10/8/04 
New version. This changes the pier tiles to bridge, and it adds the Drake Hatchling back and the Drake Guard required
in scenario 21, fixing a major bug involving recruitment.

10/15/04 
New version. Bug in Drake Escape (#10570) worked around, but recall bug (#10569) is still at large. I also have made
Kogw level two, and gave him a level 3.

11/21/04 
New version released on campaign server. (2.2) 
Improvements:

switched to the x.x.x version system 
neutral birds actually fly 
in Drake Escape, Goblin Pillagers can pillage 
balancing changes to many scenarios 
bug fixes in Rebellion

1/3/05 
Update: 
version 2.4:

bug fix 
storyline images for Survival and Rebellion 
balancing improvements in Endgame

1/19/05 
Update: 
version 2.5:

changes to Manor 
a major bugfix

1/20/05 
Update: 
version 2.5.1

minor bugfix in Manor

2/3/05 
Update: 
version 2.6

maps use new terrains where appropriate 
scenarios set on Morogor now have their location denoted on a [http://gs295.sp.cs.cmu.edu/brennan/wercator/index.html Wercator]-
created map ([http://gs295.sp.cs.cmu.edu/brennan/wercator/maps/Peoples_in_Decline.jpg here]) 
balance changes to Manor, River of Skulls, Return to Morogor, Liberation, Endgame 
minor bugfixes

2/19/05 
Update: 
version 2.6.1

directory structure updated 
balance changes to Endgame 
0.8.11 compatibility

2/27/05 
Update: 
version 2.6.2

major bugfix to Blockade, should be possible to win now

4/13/05 
Update: 
version 2.7

scenarios updated for compatibility with 0.9 
varied dialogue improvements 
balancing to River of Skulls (removed village in chokepoint) 
scenarios take advantage of new [objectives] tag, changing objectives added 
maps now use river ford and ruin terrains

5/14/05 
Update: 
version 2.8

translated into German and Swedish 
WML syntax updated for 0.9.1 (involving translations) 
portrait for Kogw

6/10/05 
Update: 
version 2.9

WML updated for 0.9.2 
WML optimizations, separate copies of drake unit.cfgs no longer needed 
portrait for Malakar added 
balancing changes to Survival 
pngcrush run on all images 
rock golem image updated

6/22/05 
NOTE: This update breaks all in-game saves (NOT beginning-of-scenario saves) for the following scenarios: 
Southern Shore 
Open Ocean 
Landfall 
Blockade

Update: 
version 2.9.1

SHOULD be compatible with 0.9.2CVS 
missing newline at end of Flight_Freedom.cfg fixed 
FtF's Pirate Galleon does not override the in-game Pirate Galleon 
new graphics for the Driver 
balancing changes to Rebellion and Manor, Malakar has leadership in those scenarios

7/03/05 
Update: 
version 2.9.2

balancing change to River of Skulls, second chokepoint added parallel to the first 
mid-scenario objectives changes work properly now 
enemies in Survival do not recruit infinite numbers of units 
in Caravan, the caravan's movement points reflects its actual movement

11/02/05 
I know it's been overdue for over a month, but here it is. I've finally got the underground scenarios balanced, but there are so many changes (and so little time to debug) that I have had to release a beta. Hopefully, unless any major bugs are found, I'll finalize FtF 3.0 in a week.

In the meantime, PLEASE reply if you find any bugs.

12/2/05 
UPDATE: 
version 3.0

FtF 3.0 finally released!

Many changes across the board, far too many to list, but here are the major changes (including those of the 3.0 beta): 
storyline changes 
Rebellion enhanced 
underground scenarios balanced 
bug fixes, dialogue changes in Landfall

12/3/05 
UPDATE: 
version 3.0.1

game-killing bug in Landfall fixed (map was not sent)

3/23/06 
UPDATE: 
version 3.1

updated for 1.12+, not backward compatible (beginning-of-scenario saves will still work) 
new terrain added: dark tiles, from UtBS (replaces some dirt, sand in caves) 
maps updated for new terrain 
image references updated to reflect 1.12 directory structure 
terrain code for lava bridge changed to ` instead of ' to avoid conflict 
Skeletal Dragon, Watch Tower moved into FtF from EI, SoTBE (credit Hanno for alerting me to this) 
old wesnoth-8.ogg moved into FtF 
soundtracks updated for music changes/removals 
balancing changes to Underground, River of Skulls, Endgame 
unit .cfgs updated for 1.12 compatibility 
easter egg temporarily commented out, pending consideration 

NOTE: due to technical differences between the old code and the 1.12+ compatible code, I was forced to split the campaign into two distributions, which are on their respective campaign servers. Because of this, however, the translations will not be current until the branch is created on wescamp (so that translators can update it).

8/20/06 
3.2 is on the campaign server. It [i]should[/i] be (almost) fully compatible with 1.18, but I can't guarantee that every animation will work right. I have also made balancing changes up until Exodus (level 16), but the cave levels are still buggy. 
Any feedback is appreciated!

12/22/06 
Hosted on http://warhangel.ru/wesnoth/campaigns/Flight_Freedom_1_x.zip . Special thanks to warhangel for hosting this campaign. 

1/5/07 
FtF 3.3 uploaded.

NPC AI should be fixed 
naga, saurian animations are working, graphics from Marsh Era 
two attack icons added, one by Xan, the other from the Extended Era 
balancing changes to Manor, Underground, River of Skulls and Blockade 
Rockfall fixed with RedLTeut's patch 
other fixes and tweaks which I have forgotten about 

3/20/07 
FtF 4.0 released, for Wesnoth 1.3 and up only. 
compatible with new terrain system, will make cave roads passable 
Manor enhanced 
Survival edited, but cutscene not implemented yet 
several dialogue changes 
Landfall bridge collapse softened 
new graphic for the enslaved Malakar 
several bugfixes 
Drake Guerillas/Revolutionaries have visible spear overlay 
losing text added if Unforgiver is sunk and Kogw has not disembarked 

4/21/07 
version 4.1 released 
many new storyline images added 
many dialogue changes 
extra enemy added to Survival, to shorten it 
balancing changes to Pirate Schooner and Clipper 
all ships have reasonably fitting hit and die sounds 
Manor recruitment bug precluded 
cutscene code moved to separate file (a purely internal change) 
rain added to Open Ocean 
ships should have names 

6/14/07 
version 4.2 released 
dragon in Underground is now friendly 
River of Skulls rebalanced, map edited 
several bugfixes 
Blockade enhanced 
new Malakar and Kamalar graphics 
terrain error messages fixed 
FtF will sort properly in campaign menu 
ships now have names 
experience gained in Survival by Malakar will carry over to Rebellion 

NOTE: This will break saves of River of Skulls. Other saves will work, but they may use the old Malakar (which should work fine). 

7/6/07 
version 4.2.1 released, for Wesnoth 1.3.3+ 
bug fixes in Underground and River of Skulls 
Manor enhanced 
minor dialogue changes 
a few minor bug and potential bug fixes 

7/20/07 
version 4.2.2 released, for Wesnoth 1.3.4+ 
dialogue changes 
storyline graphics updated for new Malakar graphics 
new storyline graphics for Underground and Rockfall 
Caravan elves nerfed 
Drake Escape enhanced 
at least one bugfix 

8/3/07 
version 4.3 released, for Wesnoth 1.3.4+ 
changes (dialogue and other) to Rockfall, Betrayal, Hordes of the Foul Undead, Gate of Storms, Exodus, Blockade and Return to Morogor 
two scenarios added (Swamps of the Jamolar and Council of War), part of a possible branch (accessed from Survival) 
attainable objective added to Survival 
experimental wave animations in Rebellion 
minor bugfixes 
time over events added to some scenarios 
non-expendable player characters are spawned with hero icon 
balancing changes to Betrayal and Blockade 

8/23/07 
version 4.3.1 released, for Wesnoth 1.3.6+ 
new scenario, Forest of Nightmares (in second branch) 
enhancements to Manor, includes irrevenant's indoors time-of-day image 
several bugfixes 
thunder spirits in Landfall and Drake Escape will not spawn on first turn 
multi-hex fireball attack code implemented (not used yet) 
victory music added to victory events 
lava transitions fixed 

9/1/07 
version 4.3.2 released, for Wesnoth 1.3.7+ 
critical 1.3.7 compatibility bug fixed 
new scenario, Hafwyt (still not 100% finished) 
savegames of cave levels will not show snapshots 

10/22/07 
version 4.3.3 released, for Wesnoth 1.3.9+ 
unit WML updated to 1.3.8+ standard 
new scenario: Mountain Crypt (in second branch) 
bugfixes 
turn limit of Forest of Nightmares reduced to 25 
balancing changes 

1/20/08 
version 4.4 released, for Wesnoth 1.3.14+ 
headers and borders added to all maps 
two links added in secondary branch to main branch 
sword-and-shield narrator icon replaced 
new cutscenes 
Mountain Crypt darkness code revised 
bugfixes 

8/19/08 
version 4.5 released, for Wesnoth 1.4+ 
scenario 19, Liberation, completely rewritten 
dialogue changes 
user team names added, so that the status table will show the names of sides in a level 
bugfixes 
levels use new Wesnoth music when appropriate 

2/20/09 
version 4.6 released, for Wesnoth 1.5.6+ 
compatibility with Wesnoth 1.5 branch 
bugfixes 

7/25/21 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.3.3 5.3.3] released, for Wesnoth 1.14+ 
egallager's first release since taking over as maintainer 

5/18/22 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.0 5.4.0] released, for Wesnoth 1.16+ 
first release on the 1.16 add-on server 

11/27/22 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.1 5.4.1] released, for Wesnoth 1.16+ 
see release notes for full changelog 

1/27/24 
versions [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.2 5.4.2] and [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.5.0 5.5.0] released, for Wesnoth 1.16+ and Wesnoth 1.17+ respectively. 
see each of their release notes for full changelogs 

6/7/24 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.6.0 5.6.0] released, for Wesnoth 1.18+. 
see release notes for full changelog 

8/17/24 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.6.1 5.6.1] released, for Wesnoth 1.18+. 
see release notes for full changelog 

1/30/25 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.7.0 5.7.0] released, for Wesnoth 1.19.8+. 
see release notes for full changelog 

3/24/25 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.7.2 5.7.2] released, for Wesnoth 1.19.8+. 
see release notes for full changelog 

== See Also ==
* [[Guide_to_UMC_Content]]
* [[CampaignFlightFreedom]]

[[Category:Campaigns - Development]]

Guide to UMC Content

2025-03-25T02:44:28Z

Egallager: /* Flight to Freedom */ 5.7.2 now available for 1.19.8+

This is a guide to current-ish user-made content for players. It provides unfamiliar players with detailed information about campaigns (including story, completion, difficulty and playing style) as well as detailed information about eras. Feel free to edit this guide, as it is a wiki.

This list covers add-ons for the latest 3 stable releases (1.14, 1.16, and 1.18) of Wesnoth. There are archived versions of this page for [[Guide_to_UMC_Content/1.10|1.10]] and [[Guide_to_UMC_Content/1.12|1.12]].

For content creators who loved an add-on that hasn't been added to 1.14, 1.16, or 1.18 yet, and are wondering about taking it over, please ensure that its entry on the older (1.12 or 1.10) wiki page is up to date, add a link to the add-on's feedback thread in the forums, and generally do the tidy-up that doesn't need you to start changing the campaign, and then ask the old maintainer. (You should probably also wait a bit before assuming that a maintainer isn't already porting to 1.16 or 1.18).

If you are looking for even more campaigns, please see the links in at the bottom of this page.

== Instructions ==
When adding a campaign to the list, please place it in its alphabetically sorted location, ignoring any initial article ("A", "An", or "The").

=== Blueprint for Campaigns ===

* Description:

* Author:

* Maintainer: if not maintained by the author anymore.

* Status:
** Broken = Does not work at all
** Incomplete = Partially written, no progress
** WIP = Partially written, some progress
** Complete = Completely written, but buggy as well as potential balance issues.
** Finished = Completely written, minimal to no bugs, slight balance issues possible.

* Version campaign version on the add-ons server

* Length:

* Requirements: (only if needed)

* Difficulty:

Please note: Often campaigns introducing new mechanics are listed as expert level on the add-on server, here difficulty means the raw difficulty after the mechanics are understood.

** Unbalanced = If you can't beat the hard mode, it isn't necessarily unbalanced, but if the difficulty changes erratically from one scenario to the next and only people using the debug mode have seen the final, then it is.
** Easy
** Normal
** Hard

Please note: If you didn't play the campaign, write the difficulty written on the add-ons server.

* Style:

Please note: Many campaigns will feature more than one style. Please list the most significant ones. If you don't know which style is the campaign you are listing, don't write this.

** Skirmish = small to medium sized armies, your standard Wesnoth gameplay
** Dungeon = long and narrow tunnels (not every underground scenario is a dungeon, a dungeon isn't necessarily underground)
** RPG = role playing game elements such as talking with non-player-characters, item collection, dependency on a party of very few adventurers without or limited recruits
** Survival = being exposed to changing, spawning enemies while remaining on the same map
** Large Battle = large number of units on the battlefield, sizely maps
** Simulation = campaigns feat. terrain modification, alternative resources
** Boss battle = the challenge is to defeat a single powerful enemy unit
** Minigames = there are puzzles and minigames in the campaign that significantly differ from standard Wesnoth gameplay

* Faction/Era: Era for the whole campaign and more specifically the faction or unit composition you field.

* Custom units: Link to the unit tree for cases that don't feel sufficiently described by Faction / Era entry.

* Forum: Links to the feedback and development threads at forums.wesnoth.org

=== Blueprint for Eras ===

* Description:

* Author:

* Maintainer: if not maintained by the author anymore.

* Status 1.14/1.16/1.18:
** see the list of statuses in the campaign blueprint

* Faction Descriptions: Describe your individual factions here.

* Requirements: (only if needed)

* Forum: Links to the feedback and/or development threads at [https://forums.wesnoth.org/ forums.wesnoth.org].

== How to play for UMC factions ==

=== Southern Nations by Elvenisko ===
[[How_to_play_Death_Knights|Death Knights]] |
[[How_to_play_Southern_Drakes|Southern Drakes]] |
[[How_to_play_Southern_Dwarves|Southern Dwarves]] |
[[How_to_play_Southern_Elves|Southern Elves]] |
[[How_to_play_Southern_Mages|Southern Mages]] |
[[How_to_play_Southern_Mercenaries|Southern Mercenaries]] |
[[How_to_play_Southern_Orcs|Southern Orcs]] |
[[How_to_play_Southern_Swamplords|Southern Swamplords]] |
[[How_to_play_Southern_Nations|Comparison]] |
[https://units.wesnoth.org/1.17/Southern_Nations/en_US/era_southern.html All units (can be out of date)]

== Battle for Wesnoth 1.14 and newer ==

=== Campaigns ===

==== After the Storm ====

''Follow the journey of Galas and his band following the events of Invasion from the Unknown''

'''Author:''' shadowm/ShikadiQueen/Iris

'''Status:''' Finished, 0.10.11

'''Length:''' 3 episodes of 13 scenarios each, some of which are multi-part

'''Difficulty:''' Medium-hard

'''Style:''' Skirmish, Boss Battle, Dungeon

'''Faction/Era:''' Many custom units

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=32091]

'''GitHub:''' [//github.com/project-ethea/After_the_Storm]

'''Note:''' (vultraz) Long, very enjoyable campaign with great story. (Knyghtmare) The best UMC campaign ever!

'''[[Guide_to_UMC_Campaigns/Players_Reviews#After_the_Storm|Players’ Review(s)]]'''

====A Beastly Tale====

''When a small village is beset by troubles, its fate rests in the hands of a young woodsman and the animals he befriends.''

'''Author:''' GloccusV

'''Status:''' Complete

'''Version:''' 2.0.3

'''Length:''' 5 scenarios

'''Difficulty:''' Intermediate

'''Custom units:''' [//units.wesnoth.org/1.14/A_Beastly_Tale/en_US/A_Beastly_Tale.html Here]

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=41434&p=633612&hilit=A+Beastly+Tale#p579093 Here]

====A Song of the Winds====

''Every era has its heroes and heroines. Before the song of Myra, the odyssey of Akhen Wadjet and the aria of Tenma Yozora, there was the song of the winds that echoed in the mountains and halls at the heart of the Great Continent. Follow young Maat of Hiera'Shirsha and Prince Abhai of Garet-Desh in the war that set the stage for one of the greatest upheavals Irdya has ever witnessed.
(Prequel to the Dragon Trilogy)''

'''Author:''' revansurik

'''Status:''' Complete

'''Version:''' 1.0.0

'''Length:''' 43 scenarios (some of them dialogue-only)

'''Difficulty:''' Intermediate

'''Custom units:''' War of Legends + Custom factions

'''Forum:''' [//https://forums.wesnoth.org/viewtopic.php?f=8&t=53913 Here]

==== Bad Moon Rising ====

''An expedition to gather treasure from the cold north sets off compounding disaster.''

'''Author:''' Doofus-01

'''Status:''' Complete 1.10.0

'''Length:''' 20 scenarios

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Archaic Era

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=31348]

'''GitHub:''' [//github.com/doofus-01/wesnoth-Bad_Moon_Rising]

==== The Black Cross of Aleron ====

''A elvish school for druids comes under attack by goblins. It seems more than just a routine raid; is there something more sinister behind this attack? - In Beseiged Druids, you control Eärendil, the surviving teacher at the school, and the many and varied initiates. Not all of these are ordinary students; many have been experimenting with other forms of magic, while others are simply overachievers in some area of study. Unfortunately, they are not especially good at combat, at least initially. Together with a very small contingent of surviving guards, it is up to these students to save the island of Aleron from disaster.''

'''Author:''' Celtic Minstrel

'''Status:''' Complete 2.0.3

'''Length:''' 9 scenarios

'''Difficulty:''' Unbalanced

'''Style:''' Skirmish

'''Faction/Era:''' Default, Elves

'''[https://units.wesnoth.org/1.14/Black_Cross_of_Aleron/en_US/celmin-druid-siege.html Custom units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=37342

==== Danse Macabre ====

''Macabre is a rare zombie who has intelligence and will. What's he like? What's his purpose?''

'''Author:''' kamikaze

'''Maintainer:''' James_The_Invisible

'''Status:''' Completed, 1.3.2

'''Length:''' 12 scenarios

'''Difficulty:''' Unbalanced

'''Style:''' Large Battle

'''Faction/Era:''' Default, undead

'''[//units.wesnoth.org/1.14/Danse_Macabre/en_US/Danse_Macabre.html Custom units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=33745]

'''Note:''' While the campaign is playable on Wesnoth 1.14 without major issues, it is (still) in need of heavy re-balancing. Sadly, for various reasons I am not able to do it in near future but patches are always welcome, preferably in form of pull requests on [https://github.com/konecnyjakub/Danse_Macabre GitHub].

==== Dawn of Thunder ====

''A young elvish fighter is send to represent the Aethenwood at the Ka'lian. The adventure turns out to be bigger than expected.''

'''Author:''' Paulomat4

'''Maintainer:''' egallager

'''Status:''' [https://github.com/cooljeanius/dawn_of_thunder/issues/3 Incomplete], latest release on the BfW 1.16 add-on server is [https://github.com/cooljeanius/dawn_of_thunder/releases/tag/0.2.4 0.2.4].

'''Length:''' 18 scenarios

'''Difficulty:''' Challenging

'''Style:''' Skirmish, Large Battle, RPG-elements

'''Faction/Era:''' Default, Elves, Humans

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=39512 forums.wesnoth.org/viewtopic.php?f=8&t=39512]

==== A Fiery Birth ====

''A scholar of the Great Academy journeys to the land of the drakes to discover their secret origins.''

'''Author:''' Mathbrush

'''Status:''' Complete

'''Version:''' 1.2.0

'''Length:''' 9 scenarios

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=47861&p=623953 Here]

'''GitHub:''' [//github.com/brirush84/AFieryBirth]

==== The Final Exam ====

''Young mage Erika must find a magic book to become a true mage. But will it really be her final exam?''

'''Author:''' Elven

'''Status:''' Complete, 2.6.1

'''Length:''' 4 scenarios

'''Difficulty:''' Easy

'''Style:''' Skirmish, Minigames

'''Faction/Era:''' Default, Loyalists

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=23398]

'''Note:''' Short, easy campaign with varying objectives. Features female mage as leader.

==== [[FlightToFreedom|Flight to Freedom]] ====

''Flight to Freedom chronicles the story of the drake hero Malakar, and his desperate cross-country flight out of slavery.''

'''Authors:''' MadMax, Nova

'''Maintainer:''' egallager

'''Status:''' Complete

'''Length:''' 20 playable scenarios + 1 dialogue-only, for a total of 21 (may need an update now that the "B" branch has been reactivated)

'''Version:''' [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.2 5.4.2] (for BfW 1.16), or [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.5.0 5.5.0] (for BfW 1.17), or [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.6.1 5.6.1] (for BfW 1.18), or [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.7.2 5.7.2] (for BfW 1.19.8)

'''Difficulty:''' Expert

'''Style:''' Skirmish, Large Battle, Puzzle

'''Faction/Era:''' Drakes

'''Required Wesnoth version:''' 1.16+ or 1.17+ or 1.18+ or 1.19.8+

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=1887 Development], [//forums.wesnoth.org/viewtopic.php?t=40195 Feedback]

'''GitHub:''' [//github.com/cooljeanius/Flight_Freedom github.com/cooljeanius/Flight_Freedom]

==== Inky's Quest ====

''The Cuttlefish Campaign''

''Are the cuttlefish mere beasts or something more? What stories would they tell if they could speak? This story provides one possible answer. The easiest difficulty provides hints for novice players.''

'''Author:''' Telchin

'''Status:''' Complete

'''Length:''' 12 scenarios + story-only epilogue, for a total of 13

'''Version:''' 1.5.6

'''Difficulty:''' Easy

'''Style:''' Skirmish

'''Faction/Era:''' Custom units (cuttlefish, tentacles, giant clams...). Enemies use both default era units and custom ones.

'''[//units.wesnoth.org/1.14/Inky_Quest/en_US/Inky_Quest.html Custom Units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=32501]

==== Invasion from the Unknown ====

''Episode I - Seeking the Light: Long after the Fall, the last forest elves are forced to abandon their safe valley, and find themselves resorting to the dark means of necromancy in order to survive the perils and challenges of this new harsh world. May they finally free the Great Continent from its chaos, or perish in the foolish attempt of restoring peace and life to the lands.''

''Episode II - Armageddon: As the shadow of Chaos covers the entire continent, an assorted group of foolish heroes prepares a counter-attack to the Empire, with one unique goal in their minds: defeat the evil Emperor, whoever it is. Lead these courageous living and non-living warriors to victory, and rediscover lost secrets of the history.''

'''Author:''' shadowm/ShikadiQueen/Iris

'''Status:''' Finished, 2.1.9

'''Difficulty:''' Normal

'''Style:''' Skirmish, Dungeon, Boss battle

'''Faction/Era:''' Unique. You play Elves and Undead throughout the campaign.

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=43309]

'''GitHub:''' [//github.com/project-ethea/Invasion_from_the_Unknown]

'''Walkthrough:''' [[IftU Walkthrough]]

''[[Guide_to_UMC_Campaigns/Players_Reviews#Invasion_from_the_Unknown|Players’ Review(s)]]'''

==== Leader of the Drakes ====

''Leader of the drakes is killed. His son tries to defend homeland against the orcs. He choosed to ally with saurians, but other clans of drakes disagrees. Will fast and unexperienced Morin win against orcs and rebel drakes alike?''

'''Author:''' Elven

'''Status:''' Complete, 1.02b

'''Length:''' 3 scenarios

'''Difficulty:''' Easy/Medium

'''Style:''' Skirmish, Minigames

'''Faction/Era:''' Default, Drakes

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=53951&start=15]

'''Note:''' Short, easy campaign with simple objectives. Features Drake Glider as leader and modified Drake Burner with cold and slowing blade.

==== Legend of the Invincibles ====

'''''Part I: Shrouded in Darkness''' (5 chapters, 90 scenarios) - A pair of heroes, after stopping an orcish threat, are outcast into caves, where they have no other choice than to become liches in order to survive. They preserved their original appearance and moral principles, and fight in various skirmishes against evil (although using evil methods sometimes), until the Fall, when they are buried alive under the ashes of the third sun.''

'''''Part II: Into the Light''' (5 chapters, 110 scenarios) - Long after the Fall, the lich heroes awaken. Searching for more power, they manage to resurrect themselves as living beings, but this time more powerful and ridden of the evil within. But the evil from inside them did not cease to exist, and started a campaign to conquer the world. Stopping the campaign caused an even worse disaster...''

'''Author:''' Dugi

'''Status:''' Complete

'''Length:''' 200 (+8 talk-only) scenarios

'''Difficulty:''' Normal

'''Style:''' mostly Skirmish and Dungeon (all other styles are present as well, but less frequently)

'''Faction/Era:''' Elves, Loyalists, Undead, Dwarves; but they advance past their usual maximum level

'''Forum:''' [//r.wesnoth.org/t32384]

'''GitHub:''' [//github.com/Dugy/Legend_of_the_Invincibles]

'''[[Guide_to_UMC_Campaigns/Players_Reviews#Legends_of_the_Invincibles|Players’ Review(s)]]'''

'''Note:''' The most unique feature of this campaign is its RPG-like unit development system, enemies drop items units can use, leaders are stronger than most usual units and all units get AMLA (after maximum level advancement) after reaching their maximum level (that is also increased by a load of additional level 4 units).

==== A New Order ====

''The old kingdom of Wesnoth has fallen before barbarian hordes. The occupying barbarians are on the brink of civil war, the seeds of Wesnothian rebellion are kept alive by old legends, while bandits and Dunefolk mercenaries roam the land. Can Gawen Hagarthen unite these disparate factions against a common foe?''

''Note: This campaign contains mature themes, some of which may be unsuitable for children.''

'''Author:''' szopen

'''Maintainers:''' nemaara (Yumi), egallager

'''Status:''' Finished

'''Version:''' [https://github.com/nemaara/A_New_Order/releases/tag/1.7.0 1.7.0]

'''Length:''' Hard to say as it is non-linear; it is advertised as having 45 scenarios, but the numbering only goes up to 30 due to some of the scenarios being alternates to one another.

'''Requirements:''' Requires BfW 1.16+. Also uses the "Akladian Music" add-on.

'''Difficulty:''' Advertised as intermediate; could be considered hard, though.

'''Style:''' Mostly Skirmish, some Large Battle

'''Faction/Era:''' mostly various human factions (including the Dunefolk), with the addition of the Akladian faction of humans

'''[//units.wesnoth.org/1.16/A_New_Order/en_US/A_New_Order.html Custom Units]'''

'''Forum threads:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=6486&sid=2e644284f54e65736b4f1543b7098ef9 Development], [//forums.wesnoth.org/viewtopic.php?t=36183 Feedback], [//forums.wesnoth.org/viewtopic.php?t=6174 Original (older) art thread], [//forums.wesnoth.org/viewtopic.php?t=36074 Current art thread]

'''GitHub:''' [//github.com/nemaara/A_New_Order github.com/nemaara/A_New_Order]

'''Note:''' (Pyrophorus) Certainly one of the most mature and well designed campaign in add-ons. A must.

''' [[Guide_to_UMC_Campaigns/Players_Reviews#A_New_Order|Players’ Review(s)]]'''

==== The North Wind ====

''Wesnoth's army was occupied fighting Mal Ravanal in the East, but there were whisperings of an orcish attack in the north. Konrad II must send Deoran, now an experienced rider and commander, with a small band of knights to hold off the orcs....''

''This campaign features unique gameplay characteristics such as a lack of recruiting and a 24-turn time-of-day cycle.''

'''Author:''' aelius, Deusite; pyndragon

'''Status:''' WIP, 0.3.0

'''Length:''' 1 playable scenario, 6 intended

'''Difficulty:''' Normal

'''Style:''' RPG, Skirmish, Survival

'''Faction/Era:''' Loyalists

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=42854]

==== The Ravagers====

'''Description:''' ''The Ravagers'' is a tale of pure revenge. A tale of justice served cold, told in a flashback-style point-of-view narrative, by a ranger in the Inn at Weldyn.
The campaign includes many new exciting gameplay features, fun mechanics such as drinking, hundreds of custom units, and many more.

'''Author:''' WhiteWolf

'''Status:''' Finished*

'''Length:''' 25 playable scenarios + 2 scene scenarios

'''Requirements:''' Akladian Music Pack, Underness Music Pack

'''Difficulty:''' Intermediate

'''Style:''' Skirmish + RPG / Flashback narrative

'''Faction/Era:''' Humans, Elves, Ravagers(dark humans)

'''[//units.wesnoth.org/1.14/The_Ravagers/en_US/The_Ravagers.html Custom Units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=44930]

'''*Notes:''' The main storyline is complete, but there are unfinished side-missions that are still in development. The campaign is aimed to become finished with version 1.2.0.

==== Return from the Abyss ====

''After taking part to a disastrous expedition, Khafir and his men are lost and isolated from their people, thousands of miles away from home, bound by a pact sealed with a powerful dwarvish king. Help him escape from the depth of Irdya and finding his way back, in an adventure across two worlds during the rise of a sinister force in the Great Continent.''

'''Author:''' skeptical_troll

'''Status:''' finished

'''Length:''' 19 playable scenario + 10 story only

'''Difficulty:''' Hard

'''Style:''' Skirmish, Dungeon

'''Faction/Era:''' Dunefolk/Default

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=44545]

==== Rise of the Dunefolk ====

''Adventure of Siabbin and Helare from small village in desert, who step by step made the foundation of the Dunefolk nation. Play a stunning adventure against many enemies in different maps - from sandstorm to swampy areas and caves. Defeat powerful lich lord and train one of the best dark mages in the world of Wesnoth.''

'''Author:''' Elven

'''Status:''' Completed

'''Length:''' 11 scenarios

'''Difficulty:''' Medium

'''Style:''' Skirmish, Minigames, Survival

'''Faction/Era:''' Default, Dunefolk and dark mage

'''Note:''' enjoable gameplay with every map different. Enough experience to upgrade your units.

==== The Return of the Darks ====

''The Darks are a race which left Wesnoth in the ancient times and lives on Isles in the sky. But now the Magic wich helped them to move the Isles in Sky got lost and the isles are about to fall down. Rumion an adventurer goes to Wesnoth and searchs for something that could help them.''

'''Author:''' thvk

'''Status:''' WIP

'''Length:''' 4 playable scenario + 2 story only

'''Difficulty:''' Easy

'''Style:''' Skirmish

'''Faction/Era:''' Default + some self made units

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=52731]

==== Secrets of the Ancients ====

''From the Journal of Ardonna of Tarrynth:''

''It's unfair that we humans must die after so few years. Though this is the natural order, we need not embrace it! The lords on the Green Isle knew how to live forever. Pursuit of that knowledge was declared illegal by King Haldric I, but I believe it is worth the risk: If I can rediscover the secrets of the ancients, not only will I cheat death, I will become a hero to the whole continent!''

'''Author:''' beetlenaut

'''Status:''' Mainlined (this is now one of the campaigns that is downloaded with Wesnoth itself)

'''Length:''' 18 playable scenarios + 3 story only

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Undead/Default

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=40545]

'''Walkthrough:''' [[Secrets of the Ancients Walkthrough]]

==== Swamplings ====

''Banished by Yushnak the Ponderer, a tribe of lowly swamp goblins endure in the deadly mire of Pogo Bog. Four centuries before the founding of Wesnoth, this is the story of the goblins' struggle against the intrigues and betrayals of the greater races, and the rise of the first wolf rider.''

'''Author:''' John Rawlins (boru)

'''Status:''' Complete

'''Length:''' 17 scenarios

'''Version:''' 1.2.0i

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction:''' Goblins

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=41254]

'''[[Guide_to_UMC_Campaigns/Players_Reviews#Swamplings|Players’ Review(s)]]'''

==== The Dark Hordes ====

''Lead fugitive dark sorcerer Gwiti Ha’atel to mastery of the undead hordes.''

'''Author:''' Circon

'''Maintainer:''' Various

'''Status:''' Incomplete/WIP

'''Length:''' 15 scenarios done so far

'''Version:''' 0.1.2

'''Difficulty:''' Unbalanced

'''Style:''' Skirmish

'''Faction/Era:''' Default undead

'''[//units.wesnoth.org/1.10/The_Dark_Hordes/en_US/The_Dark_Hordes_1.html Custom Units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=16576&]

==== The Tale of Vaniyera ====

''The expansionist Lavinian Legion, led by the Imperator himself, has invaded the northern forests of the Sidhe, or Wild Elves. It is up to Leithan the Thunderblade and his advisor Vaniyera to push its armies back where they came from...''

'''Author:''' oreb, turin

'''Maintainer:''' UnwiseOwl

'''Status:''' Finished 0.11.0

'''Length:''' 5 scenarios

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Imperial Era, Sidhe.

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=37880]

'''Walkthrough''' There is a video-walkthrough by the campaign maintainer that begins [https://www.youtube.com/watch?v=dGM1bjImvkI&list=PLZorLYWvUD7VIhaXxKwzO8iQANlp_TaF0 here].

'''Note:''' As of August 2014, all previous issues raised about this campaign have been addressed. If you've not played this campaign since 1.4 or 1.10, in this humble maintainers opinion, it's worth another go.

==== To Lands Unknown ====

''This is the story of Mehir, the Summoner, and his journey to lands unknown.''

'''Author:''' inferno8

'''Status:''' Complete

'''Length:''' 20 scenarios, 4 dialogue only

'''Difficulty:''' Intermediate (Era of Magic)

'''Style''': Skirmish, Dungeon

'''Era:''' Era of Magic

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=31799]

'''GitHub:''' [//github.com/inferno8/wesnoth-To_Lands_Unknown]

'''[[Guide_to_UMC_Campaigns/Players_Reviews#To_Lands_Unknown|Players’ Review(s)]]'''

==== A Vision Blinded ====

''Defend the northern forest against what appeared like a routine orcish raid, and unravel the greater conspiracies that lie below its waves.''

'''Author:''' LemonTea

'''Maintainer:''' Adamant14

'''Status:''' Complete, 1.0.14

'''Length:''' 13 playable scenarios + 1 dialogue-only

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default, Elves (+ Trolls, Outlaws)

'''[//units.wesnoth.org/1.10/A_Vision_Blinded/en_US/A_Vision_Blinded.html Custom units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=23463]

=== Eras ===

[[Category:Campaigns|*]]
[[Category:Eras|*]]

==== '''Southern nations''' ====

[[How_to_play_Southern_Nations|Everything about southern nations, including how to play series]]

==== '''War of Legends''' ====

'''Description:''' A multiplayer era focused on the Dark Irdya Campaigns. Contains 15 factions.

'''Author:''' Tahsin Jahin Khalid (Lord-Knyghtmare)

'''Maintainer:''' Tahsin Jahin Khalid (Lord-Knyghtmare)

'''Status:''' Complete, new features being added for the 1.15.x version of the add-on

'''Factions:'''

# Aragwaithi
# Windsong
# Human Alliance
# Orcish Union
# Southerners (Desert Elves)
# Outlaws
# Elementals
# Undead
# Drakes
# Dark Legion
# Sylvans
# Minotaurs
# Vampires
# Dunefolk
# Knalgan Alliance

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=19&t=30087 Development and Feedback Thread]

'''GitHub:''' [//github.com/knyghtmare/War_of_Legends]

==== Era of Magic(EoMa) ====

'''Description:''' Aiming at using the whole potential of Battle of Wesnoth's graphic engine, the Era of Magic is considered to have a most amazing special effects and attack animations in the BfW game. There are 8 playable factions with fully animated units and tons of special effects contained in the era, and the stories of them are told in the campaign "To Lands Unknown".

'''Author:''' Inferno8

'''Maintainer:''' Inferno8

'''Status:''' Finished, 3.1

'''Faction Descriptions:'''

Sky Kingdom - powerful magi of all kinds. Their knowledge allows them to cast amazing spells and summon creatures like unstopable Golems or mysterious Mus. Masters of Elements and Gurus are one of the most powerful human beings in the Era.

Al-Kamija - these proud people are good warriors and spell casters of the desert. They use magical circles and scrolls to summon amazing creatures like Jinns or elementals from other dimension called Abyss. These creatures can't be poisoned, which is a great advantage.
(The campaign "To Lands Unknown" is mainly about the story of this faction)

Tharis - fearsome Tharis faction is very dangerous especially at night. Cruel people of Tharis with their black magic and dreadful monsters like Hydra can demolish everything standing on their way. Being so powerful in attack, Tharis have no healer, so they need to push forward at all costs.

Kharos - this strange name is the name of a beautiful country ruled by prophets of light. These peaceful people are masters of defense and support. Their formations of healers and Shielders assisted by Silver Warriors, who can teleport between friendly villages, are very hard to destroy.

Barbarians - the best in hand-to-hand combat. This multi-cultural society divided into Goblins, Orcs, Cyclops and Trolls with their own advantages and disadvantages can be hard opponent, but separately they are very weak.

Runemasters - these Dwarves use runic magic and equipment and are well known of their protection against magic. The Runemasters create steam machines like Gyrocopters, Robots and even mighty Mechanical Dragons. Units from this faction are very resistant but slow.

Dark Blood Alliance - this faction is composed of agile lizards, giant frogs, wyverns swallowing enemies and salamanders, which have developed to perfection the art of disguise. At the head of the community stand shamans known for their water magic, which is used in the fight as well as in healing.

Destroyers - a terrifying undead creations consisting of civilizations long gone...

'''Version:''' 1.1.1 (February 18th, 2015)

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=19&t=20039 Development and Feedback Thread]

'''GitHub:''' [//github.com/inferno8/wesnoth-Era_of_Magic]

==== Ageless Era ====

'''Description:''' Ageless Era is a compilation of the most popular eras and factions on the add-on server. It is more an era pack than an era.

'''Author:''' mnewton1, Ravana and various

'''Maintainer:''' Ravana

'''Status:''' Finished, 4.19

'''Unit Tree:''' [//units.wesnoth.org/1.12/Ageless_Era/en_US/Ageless%20Era.html Ageless Unit Tree (for 1.12)]

'''Factions List:''' Currently there are 91 factions in the era:

Default: Loyalist, Rebels, Northerners, Undead, Knalgan Alliance, Drakes, Khalifate

Extended Era: Loyalist, Sylvans, Dwarves, Outlaws, Northerners, Undead, Chaos, Dark Elves

Archaic Era: Khthon, Phantoms, Despair, Primeval, South-Seas, Ukians, Northern Orcs

Era of Four Moons: Highlanders, Imperialists, Sea States, Darklanders, Dalefolk, Freemen, Pygmies, Whites

Era of the Future: Welkin, Brungar

BEEM: Anakes, Calidonians, Wood Warriors

Custom Factions: Yokai, Dark Legion, Desert Elves, Steelhive, Frozen

Era of Myths: Celestials, Devlings, Elementals, Therians, Vampires, The Warg, Windsong

Feudal Era: Aragwaithi, Ceresians, Clockwork Dwarves, High Elves, Orcish Khaganates

Imperial Era: Arendians, Cavernei, Issaelfr, Lavinian Legion, Marauders, Orcei Gladiatores, Sidhe

Era of Strife: Eventide, Triththa, Free Saurians, Eltireans, Minotaurs

Era of Magic: Barbarians, Dark Blood Alliance, Sky Kingdom, Kharos, Runemasters, Al-Kamija, Tharis, Destroyers

Mercenaries Era: Highlanders, Enchanters, Avians, Slavers, Mercenaries, Equestrians, Emperor's Guard, Oracles, Holy Order, The Cult, Fanatics, Tribalists, Hive, Infernai, Refugees, Blight

'''Git:''' [https://github.com/ProditorMagnus/Ageless-for-1-11 Ageless-for-1-11] and also for 1.12 and [https://github.com/ProditorMagnus/Ageless-for-1-14 1.14]

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=19&t=25274 Development and Feedback Thread]

==== Imperial Era (IE) ====

'''Description:''' One of the oldest maintained user eras, the Imperial Era brings together seven different factions in a completely re-imagined setting, the world of Orbivm, a very lethal world indeed. The era contains both mainline and development versions of each faction and can be used to play five campaigns, each featuring a different race.

'''Author:''' Orbivm Project (but really Turin)

'''Maintainer:''' UnwiseOwl

'''Status:''' Complete, 0.23

'''Faction Descriptions:'''

# Lavinian Legion - Based on the Roman Legion, the Lavinians have strong, versatile melee units in the legionaries and a range of support classes sourced from amongst the Lavinian population and various subjugated races. The legion are strong in the plains but weak when fighting in forested areas. The Lavinians are featured in "Fall of Silvium".
# Sidhe - The Sidhe are a group of forest-dwelling elves whose focus is stealth and fleet movement. Their mages are able to channel the lightning itself, and their various other units move almost as fast. The Sidhe feature in "Tale of Vaniyera".
# Marauders - Based on the Germanic peoples that eventually conquered Rome (hint, hint), the Marauders are equally as at home in the hills, forests and swamps of their homeland. Their hard-hitting melee units are practicalyl unstoppable during the night-time. The Marauders are the stars of the "Alfhelm the Wise" campaign.
# Orcei Gentorum - The orcs have been captured gladiators slaving away in the Lavinian arenas for generations.The life of an orc in Orbivm is harsh and brutal, just like the orcs themselves. The tale of the uprising of one such group of Orcs is told in "Up from Slavery".
# Cavernei - The Cavernei are a dwarvish race with similarities to the mainline Knalgans, but with a greater emphasis on the military uses of runesmithing. They get a campaign too, in "Gali's Contract"
# Issaelfr - The frost elves live on the fringes of the habitable lands of Evrosia, the main continent of Orbivm, and have become inured to difficult conditions and tuned in to their Fae natures. They don't have a campaign yet, but you could always write one.
# Arendians - The Arendians are horse-lords living on the Western steppes of Evrosia. A life of constant battle has developed a military-focused society where warriors are trained from a young age. They used to have a campaign, but it fell into disrepair a very long time ago.

'''Wiki:''' [[Orbivm]]

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?t=37920 Development and Feedback Thread]

==== Lonely Era (LE) ====

'''Description:''' The Lonely Era is a new collection of six selected superior solitary sides with interesting and unusual abilities, traits and attributes.

It has been extensively revised and rebalanced over the last few years from the original era and the constituent factions.

'''Author:''' Atreides. Based on work by Shield, Desert_Shyde, Brilliand, Stern, Cloud, Grigistian, mikoc5, Stopsignal, The_Gnat, Minnakht.

'''Maintainer:''' Atreides

'''Status 1.16:''' Finished

'''Faction Descriptions:'''

1) Santa's Helpers are his Elves as well as animated pine trees. They are an updated faction based on the Merry Christmas Campaign. Beware of Elves bearing gifts though, the presents are very distracting. They are unique in not having standard levels, they each can gain up to 4 special abilities via AMLA but always remain at level 1. Of course there are also Flying Reindeer and Christmas Seals.

2) Gremlins are an all teleporting race of elusive ethereal creatures. Individually fragile they work together using their tremendous mobility to swarm and overwhelm their enemies. Their mages are perhaps the ultimate glass cannons but if you can somehow keep one alive long enough it might even get to level 5 and become immortal.

3) Vaeringjar are a Viking faction allied with Wolfkin. The vikings eschew ranged weapons as well as sissy ideas like dodging blows but are a very, very hardy lot. They also have a unique herbalist unit that can inspire berserker rage in adjacent vikings for a turn. The wolfkin are lithe and armed with bows and teeth on the other hand. They are also very agile in contrast to the vikings. As nocturnal hunters they are devastating at night and almost helpless in the day.

4) Avians are cold loving, water hating bipedal birds. Their hollow bones and feathers make them vulnerable to fire and blunt weapons. They are unique in having cheap level 0 healers. Unusually their leaders are not drawn from the ranks but form a separate class only selectable as leaders. Tamed Albatrosses to patrol the awful waters.

5) The Deep Ones - Slimy, slippery, blasphemous fish-frogs of the nameless design - living and horrible - have now been sighted on the edge of Wesnoth. Mutants who slowly evolve from human to monster these creatures are nothing to be trifled with! An all water faction they are quite capable of holding their own against the landlubbers.

6) Jephrifs live far up in the sky, miles above land. Away from even the most basic things most other races take for granted, such as solid ground, their society developed to be quite alien indeed. In recent times, jephrifs began descending from the skies to participate in combat against other races - apparently for their own amusement, seeing life as a game.

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?t=42630 Development and Feedback Thread]

== Additional info ==
See also:
* [[Player_UMC_Reviews|Player UMC Reviews]]
* [[:Category:User-made Campaigns - Walkthroughs|Walkthroughs for user-made campaigns]]
* [//r.wesnoth.org/t37476 forum thread] for this page
* [[Guide_to_UMC_Content/1.12|Guide to user-made content (UMC) for Battle for Wesnoth 1.12]]
* [[Guide_to_UMC_Content/1.10|Guide to user-made content (UMC) for Battle for Wesnoth 1.10]]
* [//r.wesnoth.org/t36733 thread discussing 1.8 UMC that wasn't ported to 1.10]
* [//r.wesnoth.org/t48086 thread discussing all UMC that hasn't been ported to 1.14]
* [//addons.wesnoth.org the addon server]

User:Egallager

2025-03-25T02:43:30Z

Egallager: /* This wiki */ link to FlightToFreedom

== Introduction ==
Hi, I am Eric Gallager. I am from New Hampshire.

== Forums ==
I also go by [https://forums.wesnoth.org/memberlist.php?mode=viewprofile&u=219741 egallager] on the forums.
Here are links to the topics I've either started, or that are for campaigns I've taken over:
* [https://forums.wesnoth.org/viewtopic.php?f=8&t=53597 Son of the Black Eye: Easy Edition]
* [https://forums.wesnoth.org/viewtopic.php?f=8&t=53601 A Tale of Two Brothers With a Third Difficulty]
* [https://forums.wesnoth.org/viewtopic.php?f=8&t=47885 A Little Adventure]
* [https://forums.wesnoth.org/viewtopic.php?f=8&t=26800 The Earth's Gut]
* [https://forums.wesnoth.org/viewtopic.php?f=8&t=1887 Flight to Freedom]
* [https://forums.wesnoth.org/viewtopic.php?f=31&t=24967 The War of Terrador]
* [https://forums.wesnoth.org/viewtopic.php?f=8&t=6486 A New Order]
* [https://forums.wesnoth.org/viewtopic.php?f=8&t=39512 Dawn of Thunder]
* [https://forums.wesnoth.org/viewtopic.php?f=7&t=54568 Call for translators (for my add-ons in general)]
* [https://forums.wesnoth.org/viewtopic.php?f=6&t=54369 Discussion of a Japanese "Let's Play" introduction to Wesnoth]
* [https://forums.wesnoth.org/viewtopic.php?t=57132 Word association]
* [https://forums.wesnoth.org/viewtopic.php?t=57215 Mainlining popular UMC tracks]
* [https://forums.wesnoth.org/viewtopic.php?t=57225 Categorizing UMC music by moods]
* [https://forums.wesnoth.org/viewtopic.php?t=58854 Floods of Irdya]

== Elsewhere on the web ==
I go by [https://github.com/cooljeanius "cooljeanius"] on GitHub (it's an old handle), and keep the sources for many of my Wesnoth things on there:
* [https://github.com/cooljeanius/wesnoth_mods generalized mods collection]
* [https://github.com/cooljeanius/Son_Of_The_Black_Eye_Easy_Edition Son of the Black Eye: Easy Edition]
* [https://github.com/cooljeanius/Saving_Elensefar Saving Elensefar]
* [https://github.com/cooljeanius/dawn_of_thunder Dawn of Thunder]
* [https://github.com/cooljeanius/Two_Brothers_With_A_Third_Difficulty A Tale of Two Brothers With a Third Difficulty]
* [https://github.com/cooljeanius/The_War_of_Terrador The War of Terrador]
* [https://github.com/cooljeanius/A_New_Order A New Order] (with a separate repo, [https://github.com/cooljeanius/ANO_art ANO_art], for the raw art assets used for it)
* [https://github.com/cooljeanius/A_Little_Adventure A Little Adventure] (with a separate repo, [https://github.com/cooljeanius/ALA_art ALA_art], for the raw art assets used for it)
* [https://github.com/cooljeanius/The_Earths_Gut The Earth's Gut] (with a separate repo, [https://github.com/cooljeanius/TEG_art TEG_art], for the raw art assets used for it)
* [https://github.com/cooljeanius/Flight_Freedom Flight to Freedom]
* <s>[https://github.com/cooljeanius/Roboke Roboke]</s> (Archived)
I also use that handle elsewhere, such as on Wikipedia: [https://en.wikipedia.org/wiki/User:Cooljeanius https://en.wikipedia.org/wiki/User:Cooljeanius]

== This wiki ==
I have been editing (and intend to edit further) the following pages: [[ReferenceWML]], [[CharactersStorys]], [[Guide to UMC Content]], [[Glossary]], [[Maintenance tools]], [[Available Music]], and [[FlightToFreedom]].

Guide to UMC Content

2025-01-30T20:56:51Z

Egallager: /* Flight to Freedom */ additional version update

This is a guide to current-ish user-made content for players. It provides unfamiliar players with detailed information about campaigns (including story, completion, difficulty and playing style) as well as detailed information about eras. Feel free to edit this guide, as it is a wiki.

This list covers add-ons for the latest 3 stable releases (1.14, 1.16, and 1.18) of Wesnoth. There are archived versions of this page for [[Guide_to_UMC_Content/1.10|1.10]] and [[Guide_to_UMC_Content/1.12|1.12]].

For content creators who loved an add-on that hasn't been added to 1.14, 1.16, or 1.18 yet, and are wondering about taking it over, please ensure that its entry on the older (1.12 or 1.10) wiki page is up to date, add a link to the add-on's feedback thread in the forums, and generally do the tidy-up that doesn't need you to start changing the campaign, and then ask the old maintainer. (You should probably also wait a bit before assuming that a maintainer isn't already porting to 1.16 or 1.18).

If you are looking for even more campaigns, please see the links in at the bottom of this page.

== Instructions ==
When adding a campaign to the list, please place it in its alphabetically sorted location, ignoring any initial article ("A", "An", or "The").

=== Blueprint for Campaigns ===

* Description:

* Author:

* Maintainer: if not maintained by the author anymore.

* Status:
** Broken = Does not work at all
** Incomplete = Partially written, no progress
** WIP = Partially written, some progress
** Complete = Completely written, but buggy as well as potential balance issues.
** Finished = Completely written, minimal to no bugs, slight balance issues possible.

* Version campaign version on the add-ons server

* Length:

* Requirements: (only if needed)

* Difficulty:

Please note: Often campaigns introducing new mechanics are listed as expert level on the add-on server, here difficulty means the raw difficulty after the mechanics are understood.

** Unbalanced = If you can't beat the hard mode, it isn't necessarily unbalanced, but if the difficulty changes erratically from one scenario to the next and only people using the debug mode have seen the final, then it is.
** Easy
** Normal
** Hard

Please note: If you didn't play the campaign, write the difficulty written on the add-ons server.

* Style:

Please note: Many campaigns will feature more than one style. Please list the most significant ones. If you don't know which style is the campaign you are listing, don't write this.

** Skirmish = small to medium sized armies, your standard Wesnoth gameplay
** Dungeon = long and narrow tunnels (not every underground scenario is a dungeon, a dungeon isn't necessarily underground)
** RPG = role playing game elements such as talking with non-player-characters, item collection, dependency on a party of very few adventurers without or limited recruits
** Survival = being exposed to changing, spawning enemies while remaining on the same map
** Large Battle = large number of units on the battlefield, sizely maps
** Simulation = campaigns feat. terrain modification, alternative resources
** Boss battle = the challenge is to defeat a single powerful enemy unit
** Minigames = there are puzzles and minigames in the campaign that significantly differ from standard Wesnoth gameplay

* Faction/Era: Era for the whole campaign and more specifically the faction or unit composition you field.

* Custom units: Link to the unit tree for cases that don't feel sufficiently described by Faction / Era entry.

* Forum: Links to the feedback and development threads at forums.wesnoth.org

=== Blueprint for Eras ===

* Description:

* Author:

* Maintainer: if not maintained by the author anymore.

* Status 1.14/1.16/1.18:
** see the list of statuses in the campaign blueprint

* Faction Descriptions: Describe your individual factions here.

* Requirements: (only if needed)

* Forum: Links to the feedback and/or development threads at [https://forums.wesnoth.org/ forums.wesnoth.org].

== How to play for UMC factions ==

=== Southern Nations by Elvenisko ===
[[How_to_play_Death_Knights|Death Knights]] |
[[How_to_play_Southern_Drakes|Southern Drakes]] |
[[How_to_play_Southern_Dwarves|Southern Dwarves]] |
[[How_to_play_Southern_Elves|Southern Elves]] |
[[How_to_play_Southern_Mages|Southern Mages]] |
[[How_to_play_Southern_Mercenaries|Southern Mercenaries]] |
[[How_to_play_Southern_Orcs|Southern Orcs]] |
[[How_to_play_Southern_Swamplords|Southern Swamplords]] |
[[How_to_play_Southern_Nations|Comparison]] |
[https://units.wesnoth.org/1.17/Southern_Nations/en_US/era_southern.html All units (can be out of date)]

== Battle for Wesnoth 1.14 and newer ==

=== Campaigns ===

==== After the Storm ====

''Follow the journey of Galas and his band following the events of Invasion from the Unknown''

'''Author:''' shadowm/ShikadiQueen/Iris

'''Status:''' Finished, 0.10.11

'''Length:''' 3 episodes of 13 scenarios each, some of which are multi-part

'''Difficulty:''' Medium-hard

'''Style:''' Skirmish, Boss Battle, Dungeon

'''Faction/Era:''' Many custom units

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=32091]

'''GitHub:''' [//github.com/project-ethea/After_the_Storm]

'''Note:''' (vultraz) Long, very enjoyable campaign with great story. (Knyghtmare) The best UMC campaign ever!

'''[[Guide_to_UMC_Campaigns/Players_Reviews#After_the_Storm|Players’ Review(s)]]'''

====A Beastly Tale====

''When a small village is beset by troubles, its fate rests in the hands of a young woodsman and the animals he befriends.''

'''Author:''' GloccusV

'''Status:''' Complete

'''Version:''' 2.0.3

'''Length:''' 5 scenarios

'''Difficulty:''' Intermediate

'''Custom units:''' [//units.wesnoth.org/1.14/A_Beastly_Tale/en_US/A_Beastly_Tale.html Here]

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=41434&p=633612&hilit=A+Beastly+Tale#p579093 Here]

====A Song of the Winds====

''Every era has its heroes and heroines. Before the song of Myra, the odyssey of Akhen Wadjet and the aria of Tenma Yozora, there was the song of the winds that echoed in the mountains and halls at the heart of the Great Continent. Follow young Maat of Hiera'Shirsha and Prince Abhai of Garet-Desh in the war that set the stage for one of the greatest upheavals Irdya has ever witnessed.
(Prequel to the Dragon Trilogy)''

'''Author:''' revansurik

'''Status:''' Complete

'''Version:''' 1.0.0

'''Length:''' 43 scenarios (some of them dialogue-only)

'''Difficulty:''' Intermediate

'''Custom units:''' War of Legends + Custom factions

'''Forum:''' [//https://forums.wesnoth.org/viewtopic.php?f=8&t=53913 Here]

==== Bad Moon Rising ====

''An expedition to gather treasure from the cold north sets off compounding disaster.''

'''Author:''' Doofus-01

'''Status:''' Complete 1.10.0

'''Length:''' 20 scenarios

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Archaic Era

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=31348]

'''GitHub:''' [//github.com/doofus-01/wesnoth-Bad_Moon_Rising]

==== The Black Cross of Aleron ====

''A elvish school for druids comes under attack by goblins. It seems more than just a routine raid; is there something more sinister behind this attack? - In Beseiged Druids, you control Eärendil, the surviving teacher at the school, and the many and varied initiates. Not all of these are ordinary students; many have been experimenting with other forms of magic, while others are simply overachievers in some area of study. Unfortunately, they are not especially good at combat, at least initially. Together with a very small contingent of surviving guards, it is up to these students to save the island of Aleron from disaster.''

'''Author:''' Celtic Minstrel

'''Status:''' Complete 2.0.3

'''Length:''' 9 scenarios

'''Difficulty:''' Unbalanced

'''Style:''' Skirmish

'''Faction/Era:''' Default, Elves

'''[https://units.wesnoth.org/1.14/Black_Cross_of_Aleron/en_US/celmin-druid-siege.html Custom units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=37342

==== Danse Macabre ====

''Macabre is a rare zombie who has intelligence and will. What's he like? What's his purpose?''

'''Author:''' kamikaze

'''Maintainer:''' James_The_Invisible

'''Status:''' Completed, 1.3.2

'''Length:''' 12 scenarios

'''Difficulty:''' Unbalanced

'''Style:''' Large Battle

'''Faction/Era:''' Default, undead

'''[//units.wesnoth.org/1.14/Danse_Macabre/en_US/Danse_Macabre.html Custom units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=33745]

'''Note:''' While the campaign is playable on Wesnoth 1.14 without major issues, it is (still) in need of heavy re-balancing. Sadly, for various reasons I am not able to do it in near future but patches are always welcome, preferably in form of pull requests on [https://github.com/konecnyjakub/Danse_Macabre GitHub].

==== Dawn of Thunder ====

''A young elvish fighter is send to represent the Aethenwood at the Ka'lian. The adventure turns out to be bigger than expected.''

'''Author:''' Paulomat4

'''Maintainer:''' egallager

'''Status:''' [https://github.com/cooljeanius/dawn_of_thunder/issues/3 Incomplete], latest release on the BfW 1.16 add-on server is [https://github.com/cooljeanius/dawn_of_thunder/releases/tag/0.2.4 0.2.4].

'''Length:''' 18 scenarios

'''Difficulty:''' Challenging

'''Style:''' Skirmish, Large Battle, RPG-elements

'''Faction/Era:''' Default, Elves, Humans

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=39512 forums.wesnoth.org/viewtopic.php?f=8&t=39512]

==== A Fiery Birth ====

''A scholar of the Great Academy journeys to the land of the drakes to discover their secret origins.''

'''Author:''' Mathbrush

'''Status:''' Complete

'''Version:''' 1.2.0

'''Length:''' 9 scenarios

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=47861&p=623953 Here]

'''GitHub:''' [//github.com/brirush84/AFieryBirth]

==== The Final Exam ====

''Young mage Erika must find a magic book to become a true mage. But will it really be her final exam?''

'''Author:''' Elven

'''Status:''' Complete, 2.6.1

'''Length:''' 4 scenarios

'''Difficulty:''' Easy

'''Style:''' Skirmish, Minigames

'''Faction/Era:''' Default, Loyalists

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=23398]

'''Note:''' Short, easy campaign with varying objectives. Features female mage as leader.

==== [[FlightToFreedom|Flight to Freedom]] ====

''Flight to Freedom chronicles the story of the drake hero Malakar, and his desperate cross-country flight out of slavery.''

'''Authors:''' MadMax, Nova

'''Maintainer:''' egallager

'''Status:''' Complete

'''Length:''' 20 playable scenarios + 1 dialogue-only, for a total of 21 (may need an update now that the "B" branch has been reactivated)

'''Version:''' [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.2 5.4.2] (for BfW 1.16), or [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.5.0 5.5.0] (for BfW 1.17), or [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.6.1 5.6.1] (for BfW 1.18), or [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.7.0 5.7.0] (for BfW 1.19.8)

'''Difficulty:''' Expert

'''Style:''' Skirmish, Large Battle, Puzzle

'''Faction/Era:''' Drakes

'''Required Wesnoth version:''' 1.16+ or 1.17+ or 1.18+ or 1.19.8+

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=1887 Development], [//forums.wesnoth.org/viewtopic.php?t=40195 Feedback]

'''GitHub:''' [//github.com/cooljeanius/Flight_Freedom github.com/cooljeanius/Flight_Freedom]

==== Inky's Quest ====

''The Cuttlefish Campaign''

''Are the cuttlefish mere beasts or something more? What stories would they tell if they could speak? This story provides one possible answer. The easiest difficulty provides hints for novice players.''

'''Author:''' Telchin

'''Status:''' Complete

'''Length:''' 12 scenarios + story-only epilogue, for a total of 13

'''Version:''' 1.5.6

'''Difficulty:''' Easy

'''Style:''' Skirmish

'''Faction/Era:''' Custom units (cuttlefish, tentacles, giant clams...). Enemies use both default era units and custom ones.

'''[//units.wesnoth.org/1.14/Inky_Quest/en_US/Inky_Quest.html Custom Units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=32501]

==== Invasion from the Unknown ====

''Episode I - Seeking the Light: Long after the Fall, the last forest elves are forced to abandon their safe valley, and find themselves resorting to the dark means of necromancy in order to survive the perils and challenges of this new harsh world. May they finally free the Great Continent from its chaos, or perish in the foolish attempt of restoring peace and life to the lands.''

''Episode II - Armageddon: As the shadow of Chaos covers the entire continent, an assorted group of foolish heroes prepares a counter-attack to the Empire, with one unique goal in their minds: defeat the evil Emperor, whoever it is. Lead these courageous living and non-living warriors to victory, and rediscover lost secrets of the history.''

'''Author:''' shadowm/ShikadiQueen/Iris

'''Status:''' Finished, 2.1.9

'''Difficulty:''' Normal

'''Style:''' Skirmish, Dungeon, Boss battle

'''Faction/Era:''' Unique. You play Elves and Undead throughout the campaign.

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=43309]

'''GitHub:''' [//github.com/project-ethea/Invasion_from_the_Unknown]

'''Walkthrough:''' [[IftU Walkthrough]]

''[[Guide_to_UMC_Campaigns/Players_Reviews#Invasion_from_the_Unknown|Players’ Review(s)]]'''

==== Leader of the Drakes ====

''Leader of the drakes is killed. His son tries to defend homeland against the orcs. He choosed to ally with saurians, but other clans of drakes disagrees. Will fast and unexperienced Morin win against orcs and rebel drakes alike?''

'''Author:''' Elven

'''Status:''' Complete, 1.02b

'''Length:''' 3 scenarios

'''Difficulty:''' Easy/Medium

'''Style:''' Skirmish, Minigames

'''Faction/Era:''' Default, Drakes

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=53951&start=15]

'''Note:''' Short, easy campaign with simple objectives. Features Drake Glider as leader and modified Drake Burner with cold and slowing blade.

==== Legend of the Invincibles ====

'''''Part I: Shrouded in Darkness''' (5 chapters, 90 scenarios) - A pair of heroes, after stopping an orcish threat, are outcast into caves, where they have no other choice than to become liches in order to survive. They preserved their original appearance and moral principles, and fight in various skirmishes against evil (although using evil methods sometimes), until the Fall, when they are buried alive under the ashes of the third sun.''

'''''Part II: Into the Light''' (5 chapters, 110 scenarios) - Long after the Fall, the lich heroes awaken. Searching for more power, they manage to resurrect themselves as living beings, but this time more powerful and ridden of the evil within. But the evil from inside them did not cease to exist, and started a campaign to conquer the world. Stopping the campaign caused an even worse disaster...''

'''Author:''' Dugi

'''Status:''' Complete

'''Length:''' 200 (+8 talk-only) scenarios

'''Difficulty:''' Normal

'''Style:''' mostly Skirmish and Dungeon (all other styles are present as well, but less frequently)

'''Faction/Era:''' Elves, Loyalists, Undead, Dwarves; but they advance past their usual maximum level

'''Forum:''' [//r.wesnoth.org/t32384]

'''GitHub:''' [//github.com/Dugy/Legend_of_the_Invincibles]

'''[[Guide_to_UMC_Campaigns/Players_Reviews#Legends_of_the_Invincibles|Players’ Review(s)]]'''

'''Note:''' The most unique feature of this campaign is its RPG-like unit development system, enemies drop items units can use, leaders are stronger than most usual units and all units get AMLA (after maximum level advancement) after reaching their maximum level (that is also increased by a load of additional level 4 units).

==== A New Order ====

''The old kingdom of Wesnoth has fallen before barbarian hordes. The occupying barbarians are on the brink of civil war, the seeds of Wesnothian rebellion are kept alive by old legends, while bandits and Dunefolk mercenaries roam the land. Can Gawen Hagarthen unite these disparate factions against a common foe?''

''Note: This campaign contains mature themes, some of which may be unsuitable for children.''

'''Author:''' szopen

'''Maintainers:''' nemaara (Yumi), egallager

'''Status:''' Finished

'''Version:''' [https://github.com/nemaara/A_New_Order/releases/tag/1.7.0 1.7.0]

'''Length:''' Hard to say as it is non-linear; it is advertised as having 45 scenarios, but the numbering only goes up to 30 due to some of the scenarios being alternates to one another.

'''Requirements:''' Requires BfW 1.16+. Also uses the "Akladian Music" add-on.

'''Difficulty:''' Advertised as intermediate; could be considered hard, though.

'''Style:''' Mostly Skirmish, some Large Battle

'''Faction/Era:''' mostly various human factions (including the Dunefolk), with the addition of the Akladian faction of humans

'''[//units.wesnoth.org/1.16/A_New_Order/en_US/A_New_Order.html Custom Units]'''

'''Forum threads:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=6486&sid=2e644284f54e65736b4f1543b7098ef9 Development], [//forums.wesnoth.org/viewtopic.php?t=36183 Feedback], [//forums.wesnoth.org/viewtopic.php?t=6174 Original (older) art thread], [//forums.wesnoth.org/viewtopic.php?t=36074 Current art thread]

'''GitHub:''' [//github.com/nemaara/A_New_Order github.com/nemaara/A_New_Order]

'''Note:''' (Pyrophorus) Certainly one of the most mature and well designed campaign in add-ons. A must.

''' [[Guide_to_UMC_Campaigns/Players_Reviews#A_New_Order|Players’ Review(s)]]'''

==== The North Wind ====

''Wesnoth's army was occupied fighting Mal Ravanal in the East, but there were whisperings of an orcish attack in the north. Konrad II must send Deoran, now an experienced rider and commander, with a small band of knights to hold off the orcs....''

''This campaign features unique gameplay characteristics such as a lack of recruiting and a 24-turn time-of-day cycle.''

'''Author:''' aelius, Deusite; pyndragon

'''Status:''' WIP, 0.3.0

'''Length:''' 1 playable scenario, 6 intended

'''Difficulty:''' Normal

'''Style:''' RPG, Skirmish, Survival

'''Faction/Era:''' Loyalists

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=42854]

==== The Ravagers====

'''Description:''' ''The Ravagers'' is a tale of pure revenge. A tale of justice served cold, told in a flashback-style point-of-view narrative, by a ranger in the Inn at Weldyn.
The campaign includes many new exciting gameplay features, fun mechanics such as drinking, hundreds of custom units, and many more.

'''Author:''' WhiteWolf

'''Status:''' Finished*

'''Length:''' 25 playable scenarios + 2 scene scenarios

'''Requirements:''' Akladian Music Pack, Underness Music Pack

'''Difficulty:''' Intermediate

'''Style:''' Skirmish + RPG / Flashback narrative

'''Faction/Era:''' Humans, Elves, Ravagers(dark humans)

'''[//units.wesnoth.org/1.14/The_Ravagers/en_US/The_Ravagers.html Custom Units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=44930]

'''*Notes:''' The main storyline is complete, but there are unfinished side-missions that are still in development. The campaign is aimed to become finished with version 1.2.0.

==== Return from the Abyss ====

''After taking part to a disastrous expedition, Khafir and his men are lost and isolated from their people, thousands of miles away from home, bound by a pact sealed with a powerful dwarvish king. Help him escape from the depth of Irdya and finding his way back, in an adventure across two worlds during the rise of a sinister force in the Great Continent.''

'''Author:''' skeptical_troll

'''Status:''' finished

'''Length:''' 19 playable scenario + 10 story only

'''Difficulty:''' Hard

'''Style:''' Skirmish, Dungeon

'''Faction/Era:''' Dunefolk/Default

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=44545]

==== Rise of the Dunefolk ====

''Adventure of Siabbin and Helare from small village in desert, who step by step made the foundation of the Dunefolk nation. Play a stunning adventure against many enemies in different maps - from sandstorm to swampy areas and caves. Defeat powerful lich lord and train one of the best dark mages in the world of Wesnoth.''

'''Author:''' Elven

'''Status:''' Completed

'''Length:''' 11 scenarios

'''Difficulty:''' Medium

'''Style:''' Skirmish, Minigames, Survival

'''Faction/Era:''' Default, Dunefolk and dark mage

'''Note:''' enjoable gameplay with every map different. Enough experience to upgrade your units.

==== The Return of the Darks ====

''The Darks are a race which left Wesnoth in the ancient times and lives on Isles in the sky. But now the Magic wich helped them to move the Isles in Sky got lost and the isles are about to fall down. Rumion an adventurer goes to Wesnoth and searchs for something that could help them.''

'''Author:''' thvk

'''Status:''' WIP

'''Length:''' 4 playable scenario + 2 story only

'''Difficulty:''' Easy

'''Style:''' Skirmish

'''Faction/Era:''' Default + some self made units

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=52731]

==== Secrets of the Ancients ====

''From the Journal of Ardonna of Tarrynth:''

''It's unfair that we humans must die after so few years. Though this is the natural order, we need not embrace it! The lords on the Green Isle knew how to live forever. Pursuit of that knowledge was declared illegal by King Haldric I, but I believe it is worth the risk: If I can rediscover the secrets of the ancients, not only will I cheat death, I will become a hero to the whole continent!''

'''Author:''' beetlenaut

'''Status:''' Mainlined (this is now one of the campaigns that is downloaded with Wesnoth itself)

'''Length:''' 18 playable scenarios + 3 story only

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Undead/Default

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=40545]

'''Walkthrough:''' [[Secrets of the Ancients Walkthrough]]

==== Swamplings ====

''Banished by Yushnak the Ponderer, a tribe of lowly swamp goblins endure in the deadly mire of Pogo Bog. Four centuries before the founding of Wesnoth, this is the story of the goblins' struggle against the intrigues and betrayals of the greater races, and the rise of the first wolf rider.''

'''Author:''' John Rawlins (boru)

'''Status:''' Complete

'''Length:''' 17 scenarios

'''Version:''' 1.2.0i

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction:''' Goblins

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=41254]

'''[[Guide_to_UMC_Campaigns/Players_Reviews#Swamplings|Players’ Review(s)]]'''

==== The Dark Hordes ====

''Lead fugitive dark sorcerer Gwiti Ha’atel to mastery of the undead hordes.''

'''Author:''' Circon

'''Maintainer:''' Various

'''Status:''' Incomplete/WIP

'''Length:''' 15 scenarios done so far

'''Version:''' 0.1.2

'''Difficulty:''' Unbalanced

'''Style:''' Skirmish

'''Faction/Era:''' Default undead

'''[//units.wesnoth.org/1.10/The_Dark_Hordes/en_US/The_Dark_Hordes_1.html Custom Units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=16576&]

==== The Tale of Vaniyera ====

''The expansionist Lavinian Legion, led by the Imperator himself, has invaded the northern forests of the Sidhe, or Wild Elves. It is up to Leithan the Thunderblade and his advisor Vaniyera to push its armies back where they came from...''

'''Author:''' oreb, turin

'''Maintainer:''' UnwiseOwl

'''Status:''' Finished 0.11.0

'''Length:''' 5 scenarios

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Imperial Era, Sidhe.

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=37880]

'''Walkthrough''' There is a video-walkthrough by the campaign maintainer that begins [https://www.youtube.com/watch?v=dGM1bjImvkI&list=PLZorLYWvUD7VIhaXxKwzO8iQANlp_TaF0 here].

'''Note:''' As of August 2014, all previous issues raised about this campaign have been addressed. If you've not played this campaign since 1.4 or 1.10, in this humble maintainers opinion, it's worth another go.

==== To Lands Unknown ====

''This is the story of Mehir, the Summoner, and his journey to lands unknown.''

'''Author:''' inferno8

'''Status:''' Complete

'''Length:''' 20 scenarios, 4 dialogue only

'''Difficulty:''' Intermediate (Era of Magic)

'''Style''': Skirmish, Dungeon

'''Era:''' Era of Magic

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=31799]

'''GitHub:''' [//github.com/inferno8/wesnoth-To_Lands_Unknown]

'''[[Guide_to_UMC_Campaigns/Players_Reviews#To_Lands_Unknown|Players’ Review(s)]]'''

==== A Vision Blinded ====

''Defend the northern forest against what appeared like a routine orcish raid, and unravel the greater conspiracies that lie below its waves.''

'''Author:''' LemonTea

'''Maintainer:''' Adamant14

'''Status:''' Complete, 1.0.14

'''Length:''' 13 playable scenarios + 1 dialogue-only

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default, Elves (+ Trolls, Outlaws)

'''[//units.wesnoth.org/1.10/A_Vision_Blinded/en_US/A_Vision_Blinded.html Custom units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=23463]

=== Eras ===

[[Category:Campaigns|*]]
[[Category:Eras|*]]

==== '''Southern nations''' ====

[[How_to_play_Southern_Nations|Everything about southern nations, including how to play series]]

==== '''War of Legends''' ====

'''Description:''' A multiplayer era focused on the Dark Irdya Campaigns. Contains 15 factions.

'''Author:''' Tahsin Jahin Khalid (Lord-Knyghtmare)

'''Maintainer:''' Tahsin Jahin Khalid (Lord-Knyghtmare)

'''Status:''' Complete, new features being added for the 1.15.x version of the add-on

'''Factions:'''

# Aragwaithi
# Windsong
# Human Alliance
# Orcish Union
# Southerners (Desert Elves)
# Outlaws
# Elementals
# Undead
# Drakes
# Dark Legion
# Sylvans
# Minotaurs
# Vampires
# Dunefolk
# Knalgan Alliance

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=19&t=30087 Development and Feedback Thread]

'''GitHub:''' [//github.com/knyghtmare/War_of_Legends]

==== Era of Magic(EoMa) ====

'''Description:''' Aiming at using the whole potential of Battle of Wesnoth's graphic engine, the Era of Magic is considered to have a most amazing special effects and attack animations in the BfW game. There are 8 playable factions with fully animated units and tons of special effects contained in the era, and the stories of them are told in the campaign "To Lands Unknown".

'''Author:''' Inferno8

'''Maintainer:''' Inferno8

'''Status:''' Finished, 3.1

'''Faction Descriptions:'''

Sky Kingdom - powerful magi of all kinds. Their knowledge allows them to cast amazing spells and summon creatures like unstopable Golems or mysterious Mus. Masters of Elements and Gurus are one of the most powerful human beings in the Era.

Al-Kamija - these proud people are good warriors and spell casters of the desert. They use magical circles and scrolls to summon amazing creatures like Jinns or elementals from other dimension called Abyss. These creatures can't be poisoned, which is a great advantage.
(The campaign "To Lands Unknown" is mainly about the story of this faction)

Tharis - fearsome Tharis faction is very dangerous especially at night. Cruel people of Tharis with their black magic and dreadful monsters like Hydra can demolish everything standing on their way. Being so powerful in attack, Tharis have no healer, so they need to push forward at all costs.

Kharos - this strange name is the name of a beautiful country ruled by prophets of light. These peaceful people are masters of defense and support. Their formations of healers and Shielders assisted by Silver Warriors, who can teleport between friendly villages, are very hard to destroy.

Barbarians - the best in hand-to-hand combat. This multi-cultural society divided into Goblins, Orcs, Cyclops and Trolls with their own advantages and disadvantages can be hard opponent, but separately they are very weak.

Runemasters - these Dwarves use runic magic and equipment and are well known of their protection against magic. The Runemasters create steam machines like Gyrocopters, Robots and even mighty Mechanical Dragons. Units from this faction are very resistant but slow.

Dark Blood Alliance - this faction is composed of agile lizards, giant frogs, wyverns swallowing enemies and salamanders, which have developed to perfection the art of disguise. At the head of the community stand shamans known for their water magic, which is used in the fight as well as in healing.

Destroyers - a terrifying undead creations consisting of civilizations long gone...

'''Version:''' 1.1.1 (February 18th, 2015)

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=19&t=20039 Development and Feedback Thread]

'''GitHub:''' [//github.com/inferno8/wesnoth-Era_of_Magic]

==== Ageless Era ====

'''Description:''' Ageless Era is a compilation of the most popular eras and factions on the add-on server. It is more an era pack than an era.

'''Author:''' mnewton1, Ravana and various

'''Maintainer:''' Ravana

'''Status:''' Finished, 4.19

'''Unit Tree:''' [//units.wesnoth.org/1.12/Ageless_Era/en_US/Ageless%20Era.html Ageless Unit Tree (for 1.12)]

'''Factions List:''' Currently there are 91 factions in the era:

Default: Loyalist, Rebels, Northerners, Undead, Knalgan Alliance, Drakes, Khalifate

Extended Era: Loyalist, Sylvans, Dwarves, Outlaws, Northerners, Undead, Chaos, Dark Elves

Archaic Era: Khthon, Phantoms, Despair, Primeval, South-Seas, Ukians, Northern Orcs

Era of Four Moons: Highlanders, Imperialists, Sea States, Darklanders, Dalefolk, Freemen, Pygmies, Whites

Era of the Future: Welkin, Brungar

BEEM: Anakes, Calidonians, Wood Warriors

Custom Factions: Yokai, Dark Legion, Desert Elves, Steelhive, Frozen

Era of Myths: Celestials, Devlings, Elementals, Therians, Vampires, The Warg, Windsong

Feudal Era: Aragwaithi, Ceresians, Clockwork Dwarves, High Elves, Orcish Khaganates

Imperial Era: Arendians, Cavernei, Issaelfr, Lavinian Legion, Marauders, Orcei Gladiatores, Sidhe

Era of Strife: Eventide, Triththa, Free Saurians, Eltireans, Minotaurs

Era of Magic: Barbarians, Dark Blood Alliance, Sky Kingdom, Kharos, Runemasters, Al-Kamija, Tharis, Destroyers

Mercenaries Era: Highlanders, Enchanters, Avians, Slavers, Mercenaries, Equestrians, Emperor's Guard, Oracles, Holy Order, The Cult, Fanatics, Tribalists, Hive, Infernai, Refugees, Blight

'''Git:''' [https://github.com/ProditorMagnus/Ageless-for-1-11 Ageless-for-1-11] and also for 1.12 and [https://github.com/ProditorMagnus/Ageless-for-1-14 1.14]

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=19&t=25274 Development and Feedback Thread]

==== Imperial Era (IE) ====

'''Description:''' One of the oldest maintained user eras, the Imperial Era brings together seven different factions in a completely re-imagined setting, the world of Orbivm, a very lethal world indeed. The era contains both mainline and development versions of each faction and can be used to play five campaigns, each featuring a different race.

'''Author:''' Orbivm Project (but really Turin)

'''Maintainer:''' UnwiseOwl

'''Status:''' Complete, 0.23

'''Faction Descriptions:'''

# Lavinian Legion - Based on the Roman Legion, the Lavinians have strong, versatile melee units in the legionaries and a range of support classes sourced from amongst the Lavinian population and various subjugated races. The legion are strong in the plains but weak when fighting in forested areas. The Lavinians are featured in "Fall of Silvium".
# Sidhe - The Sidhe are a group of forest-dwelling elves whose focus is stealth and fleet movement. Their mages are able to channel the lightning itself, and their various other units move almost as fast. The Sidhe feature in "Tale of Vaniyera".
# Marauders - Based on the Germanic peoples that eventually conquered Rome (hint, hint), the Marauders are equally as at home in the hills, forests and swamps of their homeland. Their hard-hitting melee units are practicalyl unstoppable during the night-time. The Marauders are the stars of the "Alfhelm the Wise" campaign.
# Orcei Gentorum - The orcs have been captured gladiators slaving away in the Lavinian arenas for generations.The life of an orc in Orbivm is harsh and brutal, just like the orcs themselves. The tale of the uprising of one such group of Orcs is told in "Up from Slavery".
# Cavernei - The Cavernei are a dwarvish race with similarities to the mainline Knalgans, but with a greater emphasis on the military uses of runesmithing. They get a campaign too, in "Gali's Contract"
# Issaelfr - The frost elves live on the fringes of the habitable lands of Evrosia, the main continent of Orbivm, and have become inured to difficult conditions and tuned in to their Fae natures. They don't have a campaign yet, but you could always write one.
# Arendians - The Arendians are horse-lords living on the Western steppes of Evrosia. A life of constant battle has developed a military-focused society where warriors are trained from a young age. They used to have a campaign, but it fell into disrepair a very long time ago.

'''Wiki:''' [[Orbivm]]

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?t=37920 Development and Feedback Thread]

==== Lonely Era (LE) ====

'''Description:''' The Lonely Era is a new collection of six selected superior solitary sides with interesting and unusual abilities, traits and attributes.

It has been extensively revised and rebalanced over the last few years from the original era and the constituent factions.

'''Author:''' Atreides. Based on work by Shield, Desert_Shyde, Brilliand, Stern, Cloud, Grigistian, mikoc5, Stopsignal, The_Gnat, Minnakht.

'''Maintainer:''' Atreides

'''Status 1.16:''' Finished

'''Faction Descriptions:'''

1) Santa's Helpers are his Elves as well as animated pine trees. They are an updated faction based on the Merry Christmas Campaign. Beware of Elves bearing gifts though, the presents are very distracting. They are unique in not having standard levels, they each can gain up to 4 special abilities via AMLA but always remain at level 1. Of course there are also Flying Reindeer and Christmas Seals.

2) Gremlins are an all teleporting race of elusive ethereal creatures. Individually fragile they work together using their tremendous mobility to swarm and overwhelm their enemies. Their mages are perhaps the ultimate glass cannons but if you can somehow keep one alive long enough it might even get to level 5 and become immortal.

3) Vaeringjar are a Viking faction allied with Wolfkin. The vikings eschew ranged weapons as well as sissy ideas like dodging blows but are a very, very hardy lot. They also have a unique herbalist unit that can inspire berserker rage in adjacent vikings for a turn. The wolfkin are lithe and armed with bows and teeth on the other hand. They are also very agile in contrast to the vikings. As nocturnal hunters they are devastating at night and almost helpless in the day.

4) Avians are cold loving, water hating bipedal birds. Their hollow bones and feathers make them vulnerable to fire and blunt weapons. They are unique in having cheap level 0 healers. Unusually their leaders are not drawn from the ranks but form a separate class only selectable as leaders. Tamed Albatrosses to patrol the awful waters.

5) The Deep Ones - Slimy, slippery, blasphemous fish-frogs of the nameless design - living and horrible - have now been sighted on the edge of Wesnoth. Mutants who slowly evolve from human to monster these creatures are nothing to be trifled with! An all water faction they are quite capable of holding their own against the landlubbers.

6) Jephrifs live far up in the sky, miles above land. Away from even the most basic things most other races take for granted, such as solid ground, their society developed to be quite alien indeed. In recent times, jephrifs began descending from the skies to participate in combat against other races - apparently for their own amusement, seeing life as a game.

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?t=42630 Development and Feedback Thread]

== Additional info ==
See also:
* [[Player_UMC_Reviews|Player UMC Reviews]]
* [[:Category:User-made Campaigns - Walkthroughs|Walkthroughs for user-made campaigns]]
* [//r.wesnoth.org/t37476 forum thread] for this page
* [[Guide_to_UMC_Content/1.12|Guide to user-made content (UMC) for Battle for Wesnoth 1.12]]
* [[Guide_to_UMC_Content/1.10|Guide to user-made content (UMC) for Battle for Wesnoth 1.10]]
* [//r.wesnoth.org/t36733 thread discussing 1.8 UMC that wasn't ported to 1.10]
* [//r.wesnoth.org/t48086 thread discussing all UMC that hasn't been ported to 1.14]
* [//addons.wesnoth.org the addon server]

FlightToFreedom

2025-01-30T20:54:35Z

Egallager: further version number updates

<big>Flight to Freedom</big>


Last updated 1/30/25 (although before that, there have been multiple long stretches where it hadn't been updated, so much of the info on this page may still be out-of-date)

Flight to Freedom is a campaign featuring the Drakes. The hero, Malakar, and his tribe have been enslaved by humans,
and Malakar must free the tribe and take revenge on his oppressors.

Latest versions, depending on your Wesnoth version, are:

* [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.2 5.4.2] (for Wesnoth 1.16.x+)
* [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.5.0 5.5.0] (for Wesnoth 1.17.x+)
* [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.6.1 5.6.1] (for Wesnoth 1.18.x+)
* [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.7.0 5.7.0] (for Wesnoth 1.19.8+)

The forum thread is [http://www.wesnoth.org/forum/viewtopic.php?f=8&t=1887 here]. 
Made by MadMax, Nova 
Currently maintained by [[User:egallager|egallager]], although MadMax still contributes, too. 

== News ==

9/6/04: 
News started, not that I expect much to come up.

Artists wanted [http://www.wesnoth.org/forum/viewtopic.php?t=2996 here] for a new Kogw graphic. 
Announce your loyalty to the Drake cause [http://www.wesnoth.org/forum/viewtopic.php?t=2976 here]!

9/7/04 
I need feedback to keep improving. Keep it coming.

9/13/04: 
Revision 27 released, with many changes. A major update.

9/17/04: 
Poll updated. Redeclare your loyalties [http://www.wesnoth.org/forum/viewtopic.php?t=3132 here]!

9/19/04: 
Poll updated again. Prove yourself [http://www.wesnoth.org/forum/viewtopic.php?t=3143 here]! 
Campaign is on campaign server (requires CVS). Unless any major bugs arise before 0.8.5 is released, all future updates
will take place on the campaign server.

9/23/04 
revision 28 released on campaign server. Contains new drakes, Kogw graphic, and several balance changes. Requires CVS
or better 
Need attack/defense animations for Kogw graphic, need indoor time graphic (the picture under the map)

9/24/04 
revision 28.3 on campaign server. This is necessary for compatibility with CVS as of 9/24/04 (when the Drake Slave was
removed). Also has many bug fixes, including the bug that caused scenario 2 to hang.

9/26/04 
revision 28.4 on server. Bug fixes, balancing, additions to River of Skulls (credit Wesvoid), and an easter egg (not
telling you what, but I will say it's randomly activated in Endgame).

10/5/04 
revision 29 released. 1.4MB. Major changes: 
many bug fixes 
thunder spirit spawn animation 
debugger unit for testing and cheating 
improvements to Rebellion, Manor, Exodus 
new sound in the victory sequence 
new Drakes 
Note that there are some nasty engine bugs (Savannah #10569, #10570) that cause the recall list to disappear in Open
Ocean, and the campaign to quit altogether in Drake Escape. If anyone can help, I would very much appreciate it.

10/8/04 
New version. This changes the pier tiles to bridge, and it adds the Drake Hatchling back and the Drake Guard required
in scenario 21, fixing a major bug involving recruitment.

10/15/04 
New version. Bug in Drake Escape (#10570) worked around, but recall bug (#10569) is still at large. I also have made
Kogw level two, and gave him a level 3.

11/21/04 
New version released on campaign server. (2.2) 
Improvements:

switched to the x.x.x version system 
neutral birds actually fly 
in Drake Escape, Goblin Pillagers can pillage 
balancing changes to many scenarios 
bug fixes in Rebellion

1/3/05 
Update: 
version 2.4:

bug fix 
storyline images for Survival and Rebellion 
balancing improvements in Endgame

1/19/05 
Update: 
version 2.5:

changes to Manor 
a major bugfix

1/20/05 
Update: 
version 2.5.1

minor bugfix in Manor

2/3/05 
Update: 
version 2.6

maps use new terrains where appropriate 
scenarios set on Morogor now have their location denoted on a [http://gs295.sp.cs.cmu.edu/brennan/wercator/index.html Wercator]-
created map ([http://gs295.sp.cs.cmu.edu/brennan/wercator/maps/Peoples_in_Decline.jpg here]) 
balance changes to Manor, River of Skulls, Return to Morogor, Liberation, Endgame 
minor bugfixes

2/19/05 
Update: 
version 2.6.1

directory structure updated 
balance changes to Endgame 
0.8.11 compatibility

2/27/05 
Update: 
version 2.6.2

major bugfix to Blockade, should be possible to win now

4/13/05 
Update: 
version 2.7

scenarios updated for compatibility with 0.9 
varied dialogue improvements 
balancing to River of Skulls (removed village in chokepoint) 
scenarios take advantage of new [objectives] tag, changing objectives added 
maps now use river ford and ruin terrains

5/14/05 
Update: 
version 2.8

translated into German and Swedish 
WML syntax updated for 0.9.1 (involving translations) 
portrait for Kogw

6/10/05 
Update: 
version 2.9

WML updated for 0.9.2 
WML optimizations, separate copies of drake unit.cfgs no longer needed 
portrait for Malakar added 
balancing changes to Survival 
pngcrush run on all images 
rock golem image updated

6/22/05 
NOTE: This update breaks all in-game saves (NOT beginning-of-scenario saves) for the following scenarios: 
Southern Shore 
Open Ocean 
Landfall 
Blockade

Update: 
version 2.9.1

SHOULD be compatible with 0.9.2CVS 
missing newline at end of Flight_Freedom.cfg fixed 
FtF's Pirate Galleon does not override the in-game Pirate Galleon 
new graphics for the Driver 
balancing changes to Rebellion and Manor, Malakar has leadership in those scenarios

7/03/05 
Update: 
version 2.9.2

balancing change to River of Skulls, second chokepoint added parallel to the first 
mid-scenario objectives changes work properly now 
enemies in Survival do not recruit infinite numbers of units 
in Caravan, the caravan's movement points reflects its actual movement

11/02/05 
I know it's been overdue for over a month, but here it is. I've finally got the underground scenarios balanced, but there are so many changes (and so little time to debug) that I have had to release a beta. Hopefully, unless any major bugs are found, I'll finalize FtF 3.0 in a week.

In the meantime, PLEASE reply if you find any bugs.

12/2/05 
UPDATE: 
version 3.0

FtF 3.0 finally released!

Many changes across the board, far too many to list, but here are the major changes (including those of the 3.0 beta): 
storyline changes 
Rebellion enhanced 
underground scenarios balanced 
bug fixes, dialogue changes in Landfall

12/3/05 
UPDATE: 
version 3.0.1

game-killing bug in Landfall fixed (map was not sent)

3/23/06 
UPDATE: 
version 3.1

updated for 1.12+, not backward compatible (beginning-of-scenario saves will still work) 
new terrain added: dark tiles, from UtBS (replaces some dirt, sand in caves) 
maps updated for new terrain 
image references updated to reflect 1.12 directory structure 
terrain code for lava bridge changed to ` instead of ' to avoid conflict 
Skeletal Dragon, Watch Tower moved into FtF from EI, SoTBE (credit Hanno for alerting me to this) 
old wesnoth-8.ogg moved into FtF 
soundtracks updated for music changes/removals 
balancing changes to Underground, River of Skulls, Endgame 
unit .cfgs updated for 1.12 compatibility 
easter egg temporarily commented out, pending consideration 

NOTE: due to technical differences between the old code and the 1.12+ compatible code, I was forced to split the campaign into two distributions, which are on their respective campaign servers. Because of this, however, the translations will not be current until the branch is created on wescamp (so that translators can update it).

8/20/06 
3.2 is on the campaign server. It [i]should[/i] be (almost) fully compatible with 1.18, but I can't guarantee that every animation will work right. I have also made balancing changes up until Exodus (level 16), but the cave levels are still buggy. 
Any feedback is appreciated!

12/22/06 
Hosted on http://warhangel.ru/wesnoth/campaigns/Flight_Freedom_1_x.zip . Special thanks to warhangel for hosting this campaign. 

1/5/07 
FtF 3.3 uploaded.

NPC AI should be fixed 
naga, saurian animations are working, graphics from Marsh Era 
two attack icons added, one by Xan, the other from the Extended Era 
balancing changes to Manor, Underground, River of Skulls and Blockade 
Rockfall fixed with RedLTeut's patch 
other fixes and tweaks which I have forgotten about 

3/20/07 
FtF 4.0 released, for Wesnoth 1.3 and up only. 
compatible with new terrain system, will make cave roads passable 
Manor enhanced 
Survival edited, but cutscene not implemented yet 
several dialogue changes 
Landfall bridge collapse softened 
new graphic for the enslaved Malakar 
several bugfixes 
Drake Guerillas/Revolutionaries have visible spear overlay 
losing text added if Unforgiver is sunk and Kogw has not disembarked 

4/21/07 
version 4.1 released 
many new storyline images added 
many dialogue changes 
extra enemy added to Survival, to shorten it 
balancing changes to Pirate Schooner and Clipper 
all ships have reasonably fitting hit and die sounds 
Manor recruitment bug precluded 
cutscene code moved to separate file (a purely internal change) 
rain added to Open Ocean 
ships should have names 

6/14/07 
version 4.2 released 
dragon in Underground is now friendly 
River of Skulls rebalanced, map edited 
several bugfixes 
Blockade enhanced 
new Malakar and Kamalar graphics 
terrain error messages fixed 
FtF will sort properly in campaign menu 
ships now have names 
experience gained in Survival by Malakar will carry over to Rebellion 

NOTE: This will break saves of River of Skulls. Other saves will work, but they may use the old Malakar (which should work fine). 

7/6/07 
version 4.2.1 released, for Wesnoth 1.3.3+ 
bug fixes in Underground and River of Skulls 
Manor enhanced 
minor dialogue changes 
a few minor bug and potential bug fixes 

7/20/07 
version 4.2.2 released, for Wesnoth 1.3.4+ 
dialogue changes 
storyline graphics updated for new Malakar graphics 
new storyline graphics for Underground and Rockfall 
Caravan elves nerfed 
Drake Escape enhanced 
at least one bugfix 

8/3/07 
version 4.3 released, for Wesnoth 1.3.4+ 
changes (dialogue and other) to Rockfall, Betrayal, Hordes of the Foul Undead, Gate of Storms, Exodus, Blockade and Return to Morogor 
two scenarios added (Swamps of the Jamolar and Council of War), part of a possible branch (accessed from Survival) 
attainable objective added to Survival 
experimental wave animations in Rebellion 
minor bugfixes 
time over events added to some scenarios 
non-expendable player characters are spawned with hero icon 
balancing changes to Betrayal and Blockade 

8/23/07 
version 4.3.1 released, for Wesnoth 1.3.6+ 
new scenario, Forest of Nightmares (in second branch) 
enhancements to Manor, includes irrevenant's indoors time-of-day image 
several bugfixes 
thunder spirits in Landfall and Drake Escape will not spawn on first turn 
multi-hex fireball attack code implemented (not used yet) 
victory music added to victory events 
lava transitions fixed 

9/1/07 
version 4.3.2 released, for Wesnoth 1.3.7+ 
critical 1.3.7 compatibility bug fixed 
new scenario, Hafwyt (still not 100% finished) 
savegames of cave levels will not show snapshots 

10/22/07 
version 4.3.3 released, for Wesnoth 1.3.9+ 
unit WML updated to 1.3.8+ standard 
new scenario: Mountain Crypt (in second branch) 
bugfixes 
turn limit of Forest of Nightmares reduced to 25 
balancing changes 

1/20/08 
version 4.4 released, for Wesnoth 1.3.14+ 
headers and borders added to all maps 
two links added in secondary branch to main branch 
sword-and-shield narrator icon replaced 
new cutscenes 
Mountain Crypt darkness code revised 
bugfixes 

8/19/08 
version 4.5 released, for Wesnoth 1.4+ 
scenario 19, Liberation, completely rewritten 
dialogue changes 
user team names added, so that the status table will show the names of sides in a level 
bugfixes 
levels use new Wesnoth music when appropriate 

2/20/09 
version 4.6 released, for Wesnoth 1.5.6+ 
compatibility with Wesnoth 1.5 branch 
bugfixes 

7/25/21 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.3.3 5.3.3] released, for Wesnoth 1.14+ 
egallager's first release since taking over as maintainer 

5/18/22 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.0 5.4.0] released, for Wesnoth 1.16+ 
first release on the 1.16 add-on server 

11/27/22 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.1 5.4.1] released, for Wesnoth 1.16+ 
see release notes for full changelog 

1/27/24 
versions [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.2 5.4.2] and [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.5.0 5.5.0] released, for Wesnoth 1.16+ and Wesnoth 1.17+ respectively. 
see each of their release notes for full changelogs 

6/7/24 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.6.0 5.6.0] released, for Wesnoth 1.18+. 
see release notes for full changelog 

8/17/24 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.6.1 5.6.1] released, for Wesnoth 1.18+. 
see release notes for full changelog 

1/30/25 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.7.0 5.7.0] released, for Wesnoth 1.19.8+. 
see release notes for full changelog 

== See Also ==
* [[Guide_to_UMC_Content]]
* [[CampaignFlightFreedom]]

[[Category:Campaigns - Development]]

Create Writing

2025-01-25T13:29:05Z

Egallager: /* Useful Resources */ fix link, and add one to ProseStyle

{| style="float:right"
|
__TOC__
|}

Writers usually meet in the [http://www.wesnoth.org/forum/viewforum.php?f=32 Writers' Forum]. This is where you can go to discuss possible contributions to mainline Wesnoth writing (campaign dialog, unit descriptions, etc.), work on the Wesnoth Manual, collect reference information about the world of Wesnoth, world-build, and do other writerly things. Keep in mind that this involves bringing together information from all over the Wesnothian universe. In other words, this forum does contain spoilers.

If you have an IRC client, you can also join the [irc://irc.freenode.net/wesnoth #wesnoth] channel on irc.freenode.net and talk about lore in realtime.

Note: Any text included in The Battle for Wesnoth must be released and available under the [http://www.gnu.org/copyleft/gpl.html Gnu General Public License]. Read [http://www.wesnoth.org/forum/viewtopic.php?t=2015 this forum post by Jetrel] and [[Wesnoth:Copyrights]] for more information on this.

== Reference Material ==

Warning: These materials may contain spoilers. This is necessary for writers, who may not want or need to play through a campaign to work over the dialog. If you don't want spoilers, you're in the wrong place.

All dialog for mainline campaigns and unit descriptions can be accessed in the [[EditingWesnoth#The_game_data_directory|game data directory]]. There is also a current project to [[CampaignDialogue|copy all campaign dialogue onto the wiki]].

=== The World of Wesnoth ===

* [[Mainline_Campaigns|The mainline campaigns of Wesnoth]]
* [[History of Wesnoth|The history of Wesnoth]]
* [[Geography of Wesnoth|The geography of Wesnoth]]

=== The People of Wesnoth ===

* [[Faction|The factions of Wesnoth]]
* [[Races|The races of creatures in Wesnoth]]
* [[RaceDescriptions-backstory|Eleazar on Orcs and Trolls]]
* [[CharactersStorys|A list of hero descriptions]]
* [[Garardine_Dynasty|A detailed family tree of the Garardine Dynasty]]
* [[SecretLore|Secret Lore]]

== Useful Resources ==

The [[Typography Style Guide]] details the general standards used by text within Wesnoth. There are two areas where this has a bearing: in mainline campaigns, and in the user interface itself. For user-made content, writers have much more freedom, but any content or writing accepted into the game must follow our established style guides.

ESR has already produced some [http://www.catb.org/~esr/wesnoth/campaign-design-howto.html excellent guidelines] on writing Wesnoth campaign material. This guide covers storyboarding, plotting and adding flavor, as well as advice on map design, balance, and some of the pitfalls to avoid.

You can't really have a tutorial on how to write. Everyone has a different process. However, here are some pages from the internet that you could glance at before taking up your pen.
* [http://www.sfwa.org/2009/06/turkey-city-lexicon-a-primer-for-sf-workshops/ A Primer for SF Workshops]
* [[ProseStyle]]

[[Category:Create|*]]

ProseStyle

2025-01-25T13:16:15Z

Egallager: link back to Create Writing; a few other copyedits

{{Translations}}

One important step when setting out to [[Create Writing]] is to consider
your '''Prose Style'''.

=== Elements of the style ===

Wesnoth is a game of heroic and high fantasy. In writing for it, you
should use formal and poetic language with enough archaic words in it
to convey a feeling of grandeur and times past.

In English, there is no need to go all the way back to the Elizabethan
English of Shakespeare, but you do in general want to sound like a
fantasy novelist of Victorian or Edwardian times. J.R.R. Tolkien was,
of course, the best known of these; other good models are Lord
Dunsany, E.R. Eddison, or James Branch Cabell.

Beware of sounding like a bad parody, however. When writing in this
style it is easy to become florid and overwrought. Restraint is
important, otherwise readers will just laugh.

If you are a good writer and very sure of yourself, you can mix in
some elements of modern 'street' language, especially for comic and
intimate scenes and when you are doing irony. But try not to mix
mall-rat slang and archaisms in the same dialogue, the effect is too
jarring. See "The Rise of Wesnoth" for a campaign in which occasional
modern intrusions in the fantasy-poetic language are done well and
transitions from one to the other are particularly smooth.

=== Usage notes ===

Use the forms "elves", "elven", "elvish", "dwarves", "dwarven", and
"dwarvish", rather than the older spellings using 'f'. Mainstream English
is tending this way anyway under Tolkien's influence and they are now
definitely preferred for fantasy use.

In English it is legitimate to either treat all names of speaking
peoples as proper nouns to be capitalized (Humans, Elves, Dwarves,
Orcs) or as common collective nouns not capitalized (humans, elves,
dwarves, orcs); however these two conventions should not be mixed in
the same work. In BfW we use the second convention.

Be careful about plurals and possessives and don't misplace
apostrophes. Note that "lich", like other English words ending in
"ch", pluralizes as "liches", not "lichs".

When referring to a specific unit type (e.g. "Spearman", "Ulfserker",
capitalize it when talking about the unit in the narrator's voice,
but do not do so when characters are speaking. Thus, the narrator
might say "You may now recruit Spearmen", but a character would
say "We should send some spearmen to protect the eastern gate."

=== Dialogue and accents ===

In general, formality and elaboration of speech should increase with
social rank. (This is true in every society, but strongly true in the
European medieval societies that are the models for Wesnoth.)

Magic-users and liches (especially high-ranking ones) should sound like
nobles. (They have to be educated and literate.)

Dwarves have been given the accent of old-time highland Scots. When
translating into other languages, pick an accent associated with
tough, stubborn mountain folk.

Ogres and trolls have crude and rather mangled grammar. This is
deliberate, as they are rather stupid by human standards.

Orcs and goblins, which are a bit brighter, should speak mostly correct
but rather crude and vulgar language. Notice the epithets they have
for other speaking peoples ("tree-shagger", etc.) and use them freely;
they are a window into how orcs think.

Elves should have the most refined, correct, and elaborate speech. Common
elves should sound like human nobles, and noble elves like human orators
and poets.

[[Category:Create]]

Timeline of Ancient Irdya (Unofficial)

2025-01-23T12:46:32Z

Egallager: /* 632 YW */ "it's" and "its" are commonly confused

==War of Legends Campaigns Timeline==

This is meant to be a reference for the '''War of Legends canon''', which is the setting for the campaigns designed by Lord-Knightmare. '''It is imperative to acknowledge that this timeline does NOT follow the official Timeline of Wesnoth nor the Irdya canon timeline and exists in an alternate continuity'''. Even though it is not required, the timeline stated here is done in relation to the Official Wesnoth timeline for comparison.

* BW: Before Wesnoth
* YW: Years Wesnoth

Note on '''Quenoth Elves''': 
The '''Quenoth Elves (Desert Elves)''' stated are here are NOT the ones from the '''Under the Burning Suns'''. '''The Fall never happens in this timeline.''' They are mostly located in the South-Western parts of Argea.

===Geographical Locations===

====Great Continent====
This is Irdya's largest known continent. However, only a small portion of it has been explored.

=====The Sandy Wastes=====
This is a great desert that exists between Wesnoth and the Silver Lands. It is rumoured that the Dunefolk may reside in settlements here. However, there is no evidence of their existence.

=====The Silver Lands=====
The community lying to the east of Wesnoth is known as the Silver Lands. At its north, lies the southeastern part of the Lins-Elen (Lintair Forest) and the Eventide cities of Noct and Diurna, a volcano known as the Fire Cloud Peak that is home to the Silver Drakes and Ssyuriss Fenn, a swamp home to the hyena-like Gnolls and saurian tribes. The Bitter Swamp and the Sandy Wastes desert separate this region from Wesnoth. The Triththa Mountains lie at its heart and is the home of the Dwarves of Triththa. Lake Aoir lies to the South and the Minotaur country is situated around this lake.

Explorers say that this may be the eastern edge of the Great Continent, but no evidence has supported their stories... yet.

=====Kingdom of Wesnoth=====

This is the most prominent kingdom in Irdya, almost associated with the entire western part of the Continent. Its capital is Weldyn located at the kingdom's eastern regions. Its most significant city is Dan'Tonk.

[[Timeline of Wesnoth]]

[[Geography of Wesnoth]]

=====Elensefar=====

A lorddom near Wesnoth's western border. This city state is sometimes a part of Wesnoth or sometimes considered to be an independent nation. Either way, it has been an ally of Wesnoth almost throughout its history.

=====The Northlands=====
The region lying between the northern shore of the Great River and the south of the Heart Mountains is known as the Northlands. Notable locations include Wesmere Forest, home of the Kalian council, and Dwarven Doors.

=====The Far North=====
The region beyond the Heart Mountains is known as the Far North. This is home mostly to the orcish tribes, although a xenophobic faction of elves reside within the Silent Forest in the aftermath of the First Elven Civil War.

=====The Far South=====
The region that lies beyond the southern border of Wesnoth and the Aethenwood is known as the Far South. There is no factual account of what actually exists here, but many adventurers who had opportunity to explore the region state there is only a vast desert known as the Ashland Desert, which is actually an extension of the Sandy Wastes.
----

====Arkenova====
A vast island, directly west from the Far North region of the Great Continent, and separated from the mainland by the Great Ocean. It is considered by most explorers as a small continent.
----

====Argea====

The actual name of the continent that is referred in Wesfolk lore as the Old Continent. It is smaller than the Great Continent but, no data has ever confirmed this. This land was where Haldric's people, the Valefolk, first originated from. The human Empire of Anaktoran was once a glorious empire, stretching from the eastern edge of the continent to the very heart of it. The western parts are the orcish homelands and some Minotaurs have also been seen in these regions. The Orcs reside in the hills, while the Minotaurs reside in the forests. It is not confirmed what lies at its northern shores but the southern portions house a vast forest. Not many things about this forest are known, save for the fact that it is rumoured to be the abode of many strange creatures — abominations and undead-like begins. King Dowrein I, the first king ever to lead an expedition to the forest and survive its ordeal, named the forest the '''Forest of Nightmares'''. The far southern part of this mainland is said to be a vast desert with multiple oases inhabited by tribes of the Dunefolk.
----

====The Green Isle====
A large island lying somewhere on the Great Ocean, between the landmasses of Argea and the Great Continent (Argh! Somebody please make a better name this!). It is thought to be the place where the Wose first came into existence (the evidence backing this up is very fragile and thus, could be ignored).

The central and southern area are home to the Isle-folk (Halric's people) — descendants of the refugees from Anaktoran who initially settled there - and over time these Isle-folk settlements had developed into small cities such Southbay, Stormvale and Clearwater. Decades later, the Wesfolk, led by Jevyan, arrive in the northern shores of the Green Isle and a lengthy war is fought between the two sides. The Isle-folk prevail, pushing the Wesfolk to settle in small communities, although two of these settlements developed into cities, namely Jevyan's Haven and Blackmore.
----

====Lands of the Icy North====
The northern most landmass of Irdya, or in simple terms, the 'North Pole.' This region has long been the home of the Windsong Foundation however, neither the foundation's exact location nor its existence has been confirmed.
----

====Unknown Landmass====
Located somewhere between the landmasses of Argea and the Great Continent and perpetually surrounded by the endless ocean, the land was divided evenly between two nations - the Celestials and the Ceresians - in a forgotten era. At the heart of the continent, there is a vast mountain which has a legend centred around it. The mythos stated that the remains of Mor-Inal were kept deep inside the core of the mountain however, the legend has been largely dismissed by both Ceresians and Celestials.
----

===Timeline:===
----

==== Circa ~5000 BW : The First Irdyan War ====
* Seven prominent kingdoms/empires rule throughout Irdya, the names of these kingdoms/empires were never found. Mor-Inal, the first head of the Chaplain of Darkness and ruler of one of the kingdoms, commissions Moradin of the Dwarves to create a sceptre of unsurpassed power.
* The Sceptre of Power is crafted after 70 years of hard-work and research.
* Mor-Inal with the Sceptre of Power achieves supreme power becoming one of the most powerful beings in existence.
* Mor-Inal declares war on the other kingdoms, unleashing his undead, nightmares, monstrosities and elemental warriors.
* The Empire situated at Arkenova falls. Emperor Kaliban is slain in battle by Mor-Inal. Mor-Inal execrates Kaliban and his army to fight for him in undeath.
* The remaining kingdoms/empires unite against Mor-Inal, forming the first ever '''Alliance of Irdya'''.
* Various battles at different locations of Irdya destroy the lands, terraforming it in many cases.
* The remaining three kingdoms/empires are vanquished by Mor-Inal. Mor-Inal's apprentice, Vaddyn, realising what a monster his master had become, ambushes Mor-Inal at his lair. Mor-Inal is supposedly destroyed; his sceptre is disassembled. The details of this battle has never been recovered or disclosed.
* The remainder of Mor-Inal's forces scatter to remote locations of the planet.
* Vaddyn decides that the gemstones of Power (Dragon Eye, White Sapphire, Dark Emerald and the Opal of Air) must be dispersed throughout Irdya to prevent the occurrence of a second catastrophic war. He transforms the '''Dragon Eye''' into a feral dragon and allows it to leave and roam Irdya; the '''Opal of Air''' is granted to the survivors of the three kingdoms, the Aragwaithi; the '''Dark Emerald''' is hidden underneath the Southern Mountains of the Old Continent/Argea; and finally, Vaddyn takes the '''White Sapphire''' and places it within the Realm of Fire, confident of the protectorship of the Fire Elementals.
* Survivors of the Seven Kingdoms split into numerous groups and go there separate ways.
* '''The Windsong Foundation''' is established at the Farthest North, formed by a large group of female explorers, mages and scholars of the fallen empires.

==== Circa ~4200 BW : Creation of the Vampires ====

'''Location: North-Eastern Argea'''
* The human nation of Dhagonth, situated at North-Eastern Argea begin experimentation with blood magic, which eventually leads to the creation of the vampires. The vampiric 'disease' engulfs the city like a plague and a point is reached where the vampires have seized authority and the remaining humans are degraded to serfs.

==== 4100 BW : Rise of the Wargs ====

'''Location: North-Eastern Argea'''
* A human community, located deep inside the vast forests south of Dhagonth, encounter a lich and her undead army. They eradicate the monstrosity but as she swept into the death realm, she placed a powerful curse on the community. This curse transformed the humans into wolflike creatures, giving birth to the Wargs. Due to their wolflike instincts, the unity of the community dissolve and some Warg packs end up leaving the forest. However, the majority of their populace are there, refusing to leave due to the abundant game.

==== 4000 BW - 3200 BW : Battle of the Supernaturals ====

'''Location: North-Eastern Argea'''
* Frequent battles between the Wargs and the Vampires lead to an all-out war between the two races. The battle rages on for centuries and eventually reaches a stalemate with neither side gaining the upper hand.
* Greater hostilities gradually cease however, there are frequent skirmishes between them.

==== 3800 BW ====
'''Location: South-Eastern Arkenova'''
* Vampiric settlers arrive at the southeastern shores of Arkenova, naming it the Peninsula of Ichor.

==== 3500 BW : Origins of the Minotaurs ====
'''Location: Central Argea'''
* Human settlement of Karkas, somewhere in the middle of Argea, is struck by droughts and famine, resulting in a multitude of deaths. The humans find cattle and consider the bulls to be deities: an action which causes their original deity to become infuriated and she curses the humans, transforming them into the Minotaurs, half-human and half-bull.
* As a means of communicating with their god, their deity created 3 crystals: allowing only a Minotaur king or an apostle to use them.

==== Circa ~2800 BW ====
'''Location: The Great Continent'''
* Elves inhabit Lin-Elens (Lintanir Forest).
* Dwarves live in the mountains and underworld realms of Irdya.
* Saurians live in the Ssyuriss Fenn.

==== 2700 BW ====
'''Location: Arkenova'''
* Minotaurs settle at the northeastern area of Arkenova.

==== 2750 BW ====
'''Location: The Silver Lands'''
* Minotaurs settle at the plains around Lake Aoir.

==== 2600 BW ====
'''Location: Argea'''
* Empire of Anaktoran is founded.

==== 2500 BW - 2400 BW ====
'''Location: Argea'''
* The Elves in Argea, migrate to the deserts of South-Western Argea due to territorial disputes and eventually become the Quenoth Elves. They have better feuds with both Dunefolk and Aragwaithi.

==== 2400 BW ====
'''Location: Argea'''
* Civil war erupts in Anaktoran, leaving hundreds of thousands dead. First Dark Age begins for Anaktoran. Anaktoran eventually re-united at some point.

==== Circa ~2000 BW ====
'''Location: Argea'''
* Galderien dynasty begins in Anaktoran; Anaktoran absorbs lesser the kingdom of Helletia. Capital moved to Gyaldon, later renamed as "The Imperial City".

==== 1550 BW ====
'''Location: Arkenova'''
* Vaddyn arrives at Arkenova from a distant land and builds the Academy for his small group of followers.

==== 1380 BW ====
'''Location: Arkenova'''
* The mighty Kor Vas, a dragon suspected to be immortal, arrives in the northern shores of Arkenova with his Drake flight and eventually establish the Drake Empire, the second mightiest empire ever to be situated in Arkenova.

==== 1185 BW - 1184 BW : '''Library of Kratemaqht''' ====
'''Location: Argea'''
* Cahal, a nobleman residing in the Imperial City of Anaktoran, leads an expedition against the dragon Arkinas. His party finds and slays the dragon. Cahal and his disciples secretly examine the corpse and Cahal extracts the Dragon Eye from the dead dragon's forehead. He dubs it the ''Dragon Stone''.
* Lord Lenvan suspects Cahal of deception and kills him. Cahal uses the stone to resurrect himself as a Lich Lord, the first one ever recorded in Irdya's history to be not affiliated with the Dark Elementalist.
* War breaks out between the Empire of Anaktoran and Lich Lord Cahal. At first, the forces of the empire are victorious and Jevyan is crowned emperor. On his first day as emperor, he succumbs to old age and accepts Lich Lord Cahal's offer of becoming a Lich Lord. Antheia, granddaughter of Ariphon - advisor to the emperor — takes most of the remaining population and sets sail away from Anaktoran, leaving it to be devastated by the Lich Lords.

==== 1182 BW ====
'''Location: Arkenova'''
* Human refugees from the destroyed empire of Anaktoran arrive at the western shores of Arkenova. Finding the land fit for colonisation, they start to build a new empire.

==== 1180 BW - 986 BW ====
'''Location: The Silver Lands'''
* Another group of human refugees from the destroyed empire of Anaktoran arrive at the northern shores of the eastern Great Continent.
* Refugees make contact with the Elves of Lin-Elens and are granted the plains east of the forest in exchanged for their allegiance and gold.
* Refugees build a few colonies at various locations near the rivers, Cythring, Xalal and Silverrill.
* Wandering magic-casters, former disciples of Vaddyn from Arkenova, arrive at the settlements and teach magic.
* The refugee-turned-colonists rapidly expand their territory.
* Ideological conflict about types of magic starts fracturing the new nation.
* The opposing sides eventually consolidate around the cities of Noct and Diurna, on opposite sides of the river.

==== 984 BW ====
'''Location: Arkenova'''
* The Empire of New Anaktoran, situated at the western portion of Arkenova, is found.

==== 865 BW ====
'''Location: Arkenova'''
* Mage scholars of New Anaktoran, sensing the strong elemental magic, leave the empire and enrol as residents and students of the Academy.

==== 820 BW ====
'''Location: Arkenova'''
* Orcish Warlords of Northern Arkenova invade the elven lands with their relentless hordes. Forests are torched and the elven population is killed en masse. The remnants of the elven society flee southwards and arrive at the Lands of the Burning Sky (a term used by the elves instead of desert) and build settlements, eventually becoming the Desert Elves or the Quenoth.

==== 590 BW - 585 BW ====
'''Location: Arkenova'''
* The Orcish Warlords of Northern Arkenova wage a war against the mighty dragon Kor Vas. Saurians, trolls and goblins are drawn into the conflict.
* Five years later, the orcs sign a peace treaty, but end up breaking it a year later.

==== 460 BW: Founding of Verdanyn ====
'''Location: Arkenova'''
* A human lord gathering his loyal followers, leaves the New Anaktoran Empire and journeys into the former home of the elves. They build a settlement at the heart of Arkenova, which eventually becomes the city of Verdanyn.

==== 300 BW: Fall of Verdanyn ====
'''Location: Arkenova'''
* Vampires attack and conquer Verdanyn, enslaving the populace.

==== 280 BW - 278 BW ====
'''Location: Argea'''
* Kratemaqht, guardian of the Library at the ancient capital of Anaktoran, is visited by a mage, who had heard about the Library from a story, and the great dragon allows the mage and his students to live and study there.

==== 210 BW ====
'''Location: Argea'''
* Lich Lord Cahal visits the library of ancient Anaktoran in search of a book, but the great dragon denies him any access. Enraged, the lich summons his minions, which Kratemaqht easily overcomes. Defeated, the lich lord vows to return and kill him.

==== 209 BW - 198 BW: ====
'''Location: Argea'''
* Kratemaqht forges an alliance of the various races including Orcs, Goblins, Vale-folk, Minotaurs, Gnolls, Saurians, Drakes the Dunefolk tribes in Argea and declares war on the Lich Lords.
* After a long war, Lich Lord Cahal is destroyed, and Jevyan takes the remainder of his followers and sets sail to the Green Isle.
* The Lich-Lords arrive on the Green Isle after losing a war in the distant West.
* After a long war Haldric's people (The Islefolk) come to dominate the Green Isle.
* The 'Wesfolk' and their Lich-Lords are pushed onto marginal lands.

==== 180 BW ====
'''Location: The Silver Lands'''
* Dwarves from Firecloud Peak cross the Great River and colonize the hills of Triththa.

==== 146 BW ====
'''Location: Argea'''
* The Ruby of Fire (the Dragon Eye) finds its way into the hands of Lich Lord Lenvan.

==== 120 BW - 119 BW ====
'''Location: The Silver Lands'''
* The Silver Drakes attack Firecloud peak and the surrounding area, drafting most of the saurians from Ssyuriss Fenn into their ranks.
* The dwarven defences crumble under the combined offensive. When it becomes clear that the war is lost, the survivors evacuate to Triththa.
* The saurians suffer the brunt of the casualties in the war and the remainder are enslaved by the Silver Drakes.
* The saurians remaining in Ssyuriss Fenn are soundly defeated by a Triththan offensive in the following year. The remnants of their civilisation are a number of disorganised tribes.

==== 62 BW ====
'''Location: The Green Isle'''
* Lich Lord Lenvan is trapped beneath Greenwood Forest in the Green Isle; with him goes the Ruby of Fire.

==== 61 BW - 55 BW ====
'''Location: Argea'''
* The '''Aragwaithi-Dunefolk''' war takes place between the Aragwaithian Kingdoms and the Dunefolk Alliance.
* The war drags on for 5 years until a stalemate is reached, and an uneasy treaty is signed.

==== 60 BW - 58 BW ====
* An unknown chain of events lead to the return of Mor-Inal. Seeing the planet brimming with life and still vexed of not being able to conquer the world, he vows to extinguish all life on Irdya.

==== 55 BW ====
'''Location: Unknown Landmass'''
* The Celestial Empire is one of the first to be subjected to the Dark Elementalist's vengeance, resulting in an all-out war. The stalemate continues for years as the Celestial armies prove moderately sufficient at keeping his dark forces at bay.

==== 50 BW - 48 BW ====
'''Location: Argea'''
* Events of the campaign '''Electrifyre''' take place.

==== 12 BW ====
* The Crown Prince of Southbay, one of the many kingdoms of the Isle-folk, discovers the Great Continent.

==== 11 BW - 07 BW ====
* The Crown Prince makes several voyages between the Green Isle and the Great Continent.

==== 08 BW ====
'''Location: Arkenova'''
* The desert elves of Arkenova begin researching into greater magic spells deep inside their mountain temple and end up creating a portal to the world of Urvatha (known later as the Inferno). Demons arrive and are considered deities by the elves. Under the leadership of the demonic generals, the elves prepare to conquer the known lands, that is, Arkenova. The agenda of the demonic generals wanting dominion is never explicitly stated.

==== 06 BW ====
'''Location: The Green Isle'''
* The Isle-folk wage a war with the Wesfolk and their Lich-Lords.
* The Lich-Lords sense they will be destroyed and open gates to the homeland of the Orcs in the West (Argea).

==== 06 BW - 04 BW : '''Epic of Jalin''' ====
'''Location: The Silver Lands'''
* Settlements of Gaelia and Marhelm northeast of the lands soon to be called Wesnoth fall. Lich-General Vaxmos (one of Mor-Inal's Chosen) is ousted by Jalin, restoring relative peace. Jalin then sails west, stumbles upon Arkenova and consequently, gets captured and imprisoned by the desert elves.

==== 05 BW - 02 BW ====
'''Location: The Green Isle'''
* The Green Isle is overrun with Orcs.
* The Wesfolk desert their Lich-Lords as they fear becoming prey for the Orcs.
* Haldric leads the evacuation of the survivors to the Great Continent. '''The Rise of Wesnoth''' begins.

==== 03 BW - 05 YW: Book I of the Lithian Codex ====
'''Location: The Silver Lands'''
* Minotaur warlords split up land and contend against each other for dominance over their territory near Lake Aoir. Civil war between the minotaurs breaks out and eventually, three families achieve prominence: the Ranorm family in the south west (guardians of Lithia and the crystals), the Turan family in the north, and the Kimmor family in the east.
* The civil war persists, Talok Ranorm, head of the Ranorm family is slain. His eldest son, Rilend, ascends as the new leader of the Ranorms.
* Rilend leads a massive expedition and defeats the Turans and Kimmors.
* In uniting the land, he is granted the title of Rilend Iron-fist and made the first king of Lithia (where the Lithian codex and the three crystals are kept).
* The Minotaur Elder Zeal becomes the first apostle sacrificing his sight to be able to see his creator through the crystals.

==== 01 BW ====
'''Location: The Great Continent'''
* Human settlers, led by Prince Haldric, arrive at the western coast of the Great Continent (the landfall occurs in the future Bay of Pearls) in large numbers.

==== 01 YW ====
'''Location: The Great Continent'''
* Haldric is granted the plains north and south of the Great River.
* Haldric agrees to a Pact of Mutual Defence with the Elves, but the Ka'lian decides it will betray him and allow humans and orcs to exhaust each other in war if the opportunity presents. Haldric, learning of this, considers the Pact a dead letter.
* The Ruby of Fire is temporarily hidden, and the lich-lord Jevyan is deceived into believing it is held by the Elves.
* Haldric founds the country of Wesnoth in the central plain south of the great River.
* Reign of Haldric I (formerly prince Haldric) begins. '''The Rise of Wesnoth''' ends.

==== 02 YW ====
'''Location: The Great Continent'''
* Orcs, following the ships fleeing from the Green Isle, begin to arrive on the Great Continent.
* These Orcs are defeated by Haldric's forces.
* Some of the Orcish survivors flee back to the Green Isle, others move to attack the Elves.
* King Haldric helps the Elves fight the surviving Orcs.

==== 08 YW ====
'''Location: The Great Continent'''
* A second wave of Orcs arrive from the Green Isle; these Orcs begin claiming large portions of the northern Great Continent for themselves.
* Haldric I publicly repudiates the Pact he spoke with the Elves, refusing to give aid.

==== 09 - 11 YW ====
'''Location: The Great Continent'''
* Many Elves are killed in battle by the Orcs.
* Elvish emissaries are turned away from Wesnoth.

==== 10 YW ====
'''Location: Arkenova'''
* Meherab and Mahir, friends of Jahin are born.

==== 11 YW ====
'''Location: Arkenova'''
* Jahin, later known as the Hero of Irdya, is born.

==== 12 YW ====
'''Location: The Great Continent'''
* Orcs fail to take the Wesmere Forest and instead march down the coast, devastating human settlements there.
* Elves refuse to aid the Humans in confronting the Orcs.
* Human refugees from the coastal settlements relocate in what will become known as the Great Central Plain. Dan'Tonk, which will become Wesnoth's largest city, is founded.

==== 25 YW : '''The Second and Final Irdyan War Begins''' ====
* Mor-Inal sends his minions throughout Irdya in order to subjugate it, igniting the chain of events known as the '''Battle for Irdya'''.

==== 29 YW : '''Sepulchre of Elran''' ====
'''Location: The Great Continent (Northern Part)'''
The ancient tomb of King Elran, a legendary king of the Lins-Elens, is raided by forces of the Dark Elementalist. Lady Gioviel of Lins-Elen is dispatched with an army to investigate the mausoleum.

==== 30 YW - 32 YW : '''Hero of Irdya: Book I''' ====
'''Location: The Arkenova'''
* Jahin and his friends escape the vampire-occupied Verdanyn and flee to the Academy, where they stay and learn for six months.
* Relentless attacks orchestrated independently by the Drakes, Elves, Trolls, Orcs, and the Vampires ignite the '''Great Arkenovan War'''.
* Kor Vas recruits Jahin to find allies to aid him win the war. Drakes, Trolls, Minotaurs, and the Dwarves unite and form the Alliance of Arkenova.
* During his journey, Jahin retrieves the White Sapphire from its guarded location but later surrenders to the Desert Elves when they attack the Dwarven gates.
* Verdanyn is liberated from vampire occupation by the Alliance. Jahin is promoted to Lord by the Alliance leaders and his Loyalists.
* Several locations of Arkenova are attacked by the forces of the Dark Elementalist. The Academy of Magic is destroyed by the hordes of undead. Vaddyn, having been deterioted for having existed over 5000 years, is vanquished. The secret to stopping Mor-Inal is lost forever.
* The Desert elves and their demon allies are subjected to attacks from the Dark Elementalist.
* The Alliance of Arkenova force the vampires to surrender, defeats the elves, rescues Jalin, forces the orcs, naga and saurians to surrender, and establishes a peace treaty with the Empire of New Anaktoran.
* The White Sapphire is lost to the forces of Mor-Inal during the battle at Red Mountain.

==== 31 YW - 32 YW : Frigid Nightmares ====
'''Location: The Farthest North'''
* The Windsong Foundation at the Farthest North or Lands of the Icy North is attacked by the minions of the Dark Elementalist.
* The Farthest North is engulfed in Eternal Night.
* Sauda of the Windsong rallies the Windsong and other races against the invaders.
* The coalition of the Northern allies manage to repel the attack but are left severely weakened.

==== 32 YW - 42 YW : '''Great Strife''' ====
'''Location: The Silver Lands'''
* Saurians residing at Firecloud Peak, revolt against the remaining drake overseers and liberate themselves from slavery.
* Mor-Inal's wizards destroy the cities of Noct and Diurna. The survivors of the cities set their differences aside and band together as the Eventide. The Eventide army set out to extract their vengeance on Irdya.
* Eltireans prepare for the defence against the Silver Drakes and the Minotaurs.
* The Silver Drakes send a significant portion of their armies towards the Flying Isles.
* Under the banner of Rilend Iron-fist, the minotaurs start expanding their territory. Lacking the expertise and materials to cross the Bitter Swamps, the Minotaurs send their armies north and southeastwards.
* The dwarves of Triththa suddenly see themselves threatened by multiple militaristic belligerents.
* The aforementioned events within the Silver Lands incite the '''Great Strife'''.

==== 625 YW ====
'''Location: The Great Continent'''
* Mysterious disappearances of livestock and peasants cause partial evacuation of the the Estmark Hills. Lords of the Horse Clans report increased banditry from there.
* Konrad II sends Dacyn with Owaec and Gweddry to occupy the old River Guard strongpoints. '''Eastern Invasion''' begins.

==== 626 YW ====
'''Location: The Great Continent'''
* Mal-Ravanal attacks the middle outpost where Gweddry and Dacyn are stationed.
* Dacyn and Gweddry travel to the northern outpost, and, with Owaec, retreat into the northlands.

==== 627 YW ====
'''Location: The Great Continent'''
* Wesnoth's last defenses are broken and the undead march onto Weldyn.
* In the northlands, the orcs drive Gweddry's army back across the river.
* Weldyn is besieged.
* Gweddry breaks through undead lines to reach Weldyn and a council is held.
* Gweddry's army is fortunate and kills Mal-Ravanal. '''Eastern Invasion''' ends.
* Wesnoth is saved, but large portions have been laid waste by the undead.

==== 632 YW ====
'''Location: The Great Continent'''
* In response to Mal-Ravanal's attack, a hidden council of magic-casters from every race is started, named the '''Secret Council''', with its headquarters situated in the magically hidden Elven Citadel of ''Eil-En-Seiril'', located in Grey Woods.

==== 878 YW ====
'''Location: The Great Continent'''
* The Frost Mage, '''Erinna''' is born.

==== 897 YW: '''Journey of a Frost Mage''' ====
'''Location: The Great Continent'''
* Events of '''Journey of a Frost Mage''' start.

===Sources===
----
Information has been derived from the following UMC add-ons:

* Era of Strife
* Library of Kratemaqht
* Epic of Jalin
* Nightmares of Meloen
* Electrifyre
* Blackfyre
* Blades of Steel
* Defending Halostrand
* The Rise of Wesnoth
* War of Legends
* Hero of Irdya: Book I
* Sepulchre of Elran
* Frigid Nightmares
* Journey of a Frost Mage

Template:WML Tags

2025-01-17T06:44:48Z

Egallager: have "WML Tags" link to ReferenceWML

{| class="reference-sidebar"
|-
|
[[{{SERVER}}{{localurl:Template:WML Tags|action=edit}} edit]]'''[[ReferenceWML|WML Tags]]'''
|-
|''A:''
[[AbilitiesWML#The .5Babilities.5D tag|abilities]],
[[CreditsWML#.5Babout.5D|about]],
[[AchievementsWML#.5Bachievement.5D|achievement]],
[[AchievementsWML#.5Bachievement_group.5D|achievement_group]],
[[Lua_AI_Legacy_Methods_Howto#Behavior_.28Sticky.29_Candidate_Actions|add_ai_behavior]],
[[AdvancedPreferenceWML|advanced_preference]],
[[UnitTypeWML#advancefrom|advancefrom]],
[[UnitTypeWML#After_max_level_advancement_.28AMLA.29|advancement]],
[[StatisticalScenarioWML#The_.5Bteam.5D_tag|advances]],
[[AbilitiesWML#affect_adjacent|affect_adjacent]],
[[Wesnoth_AI_Framework#The_.5Bai.5D_Tag_.E2.80.94_Top-level_Elements|ai]],
[[StandardSideFilter#allied_with|allied_with]],
[[DirectActionsWML#.5Ballow_end_turn.5D|allow_end_turn]],
[[DirectActionsWML#.5Ballow_extra_recruit.5D|allow_extra_recruit]],
[[DirectActionsWML#.5Ballow_recruit.5D|allow_recruit]],
[[DirectActionsWML#.5Ballow_undo.5D|allow_undo]],
[[ConditionalActionsWML#Meta-Condition_Tags|and]],
[[InterfaceActionsWML#.5Banimate_unit.5D|animate]],
[[InterfaceActionsWML#.5Banimate_unit.5D|animate_unit]],
[[AnimationWML#The .5Banimation.5D tag|animation]],
[[Wesnoth_AI_Framework#The_.5Bai.5D_Tag_.E2.80.94_Aspects|aspect]],
attack ([[ReplayWML#attack|replay]], [[UnitTypeWML#Attacks|weapon]]),
[[AnimationWML#short-attack|attack_anim]],
attacks ([[AbilitiesWML#The_.5Bspecials.5D_tag|special]], [[StatisticalScenarioWML#The_.5Bteam.5D_tag|stats]]),
[[AiWML#avoid|avoid]];
|-
|''B:''
[[UnitTypeWML#base_unit|base_unit]],
[[IntroWML#.5Bbackground_layer.5D|background_layer]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|berserk]],
[[BinaryPathWML|binary_path]],
[[InternalActionsWML#Flow_control_actions|break]],
[[EditorWML#The_.5Bbrush.5D_tag|brush]];
|-
|''C:''
[[CampaignWML#The_.5Bcampaign.5D_tag|campaign]],
[[DirectActionsWML#.5Bcancel_action.5D|cancel_action]],
[[Wesnoth_AI_Framework#The_.5Bcandidate_action.5D_Tag|candidate_action]],
[[DirectActionsWML#.5Bcapture_village.5D|capture_village]],
[[ConditionalActionsWML#.5Bswitch.5D|case]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|chance_to_hit]],
[[InterfaceActionsWML#.5Bchange_theme.5D|change_theme]],
[[InterfaceActionsWML#.5Bchat.5D|chat]],
[[OptionWML#checkbox|checkbox]],
[[OptionWML#choice|choice]],
[[ReplayWML#choose|choose]],
[[PersistenceWML#WML Syntax|clear_global_variable]],
[[InterfaceActionsWML#.5Bclear_menu_item.5D|clear_menu_item]],
[[InternalActionsWML#.5Bclear_variable.5D|clear_variable]],
[[InterfaceActionsWML#.5Bcolor_adjust.5D|color_adjust]],
[[GameConfigWML#Color_Palettes|color_palette]],
[[GameConfigWML#Color_Palettes|color_range]],
command ([[ConditionalActionsWML#.5Bcommand.5D|action]], [[ReplayWML|replay]]),
[[InternalActionsWML#Flow_control_actions|continue]],
[[CoreWML|core]],
[[CreditsWML#.5Bcredits_group.5D|credits_group]],
[[AiWML#The_.5Bgoal.5D_Tag|criteria]];
|-
|''D:''
[[AbilitiesWML#The_.5Bspecials.5D_tag|damage]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|damage_type]],
[[AnimationWML#short-death|death]],
[[StatisticalScenarioWML#The_.5Bteam.5D_tag|deaths]],
[[Wesnoth_AI_Framework#The_.5Bai.5D_Tag_.E2.80.94_Aspects|default]],
[[AnimationWML#short-defend|defend]],
[[StatisticalScenarioWML#The_.5Bteam.5D_tag|defends]],
[[UnitsWML#defense|defense]],
[[InterfaceActionsWML#.5Bdelay.5D|delay]],
[[InterfaceActionsWML#.5Bdeprecated_message.5D|deprecated_message]],
[[ReplayWML#attack|destination]],
[[CampaignWML#difficulty|difficulty]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|disable]],
[[DirectActionsWML#.5Bdisallow_end_turn.5D|disallow_end_turn]],
[[DirectActionsWML#.5Bdisallow_extra_recruit.5D|disallow_extra_recruit]],
[[DirectActionsWML#.5Bdisallow_recruit.5D|disallow_recruit]],
[[ConditionalActionsWML#.5Bwhile.5D|do]],
[[DirectActionsWML#.5Bdo_command.5D|do_command]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|drains]],
[[AnimationWML#short-draw_weapon|draw_weapon_anim]];
|-
|''E:''
[[EditorWML#The_.5Beditor_group.5D_tag|editor_group]],
[[EditorWML#The_.5Beditor_music.5D_tag|editor_music]],
[[EditorWML#The_.5Beditor_times.5D_tag|editor_times]],
[[EffectWML|effect]],
else ([[ConditionalActionsWML#.5Bif.5D|action]], [[AnimationWML#Conditional Branches|animation]]), [[ConditionalActionsWML#.5Bif.5D|elseif]],
[[DirectActionsWML#.5Bendlevel.5D|endlevel]],
end_turn ([[DirectActionsWML#.5Bend_turn.5D|action]], [[ReplayWML#end_turn|replay]]),
[[StandardSideFilter#enemy_of|enemy_of]],
[[Wesnoth_AI_Framework#The_.5Bai.5D_Tag_.E2.80.94_Engines|engine]],
entry ([[CreditsWML#.5Bentry.5D|credits]], [[OptionWML#entry|options]]),
[[EraWML|era]],
[[EventWML|event]],
[[StandardUnitFilter#filter_ability|experimental_filter_ability]],
[[StandardUnitFilter#filter_ability_active|experimental_filter_ability_active]],
[[AbilitiesWML#filter_specials|experimental_filter_specials]],
[[AnimationWML#short-extra|extra_anim]];
|-
|''F:''
[[Wesnoth_AI_Framework#The_.5Bai.5D_Tag_.E2.80.94_Aspects|facet]],
[[InterfaceActionsWML#.5Banimate_unit.5D|facing]],
[[InterfaceActionsWML#.5Bmove_units_fake.5D|fake_unit]],
[[ConditionalActionsWML#.5Bfalse.5D|false]],
[[PblWML#.5Bfeedback.5D|feedback]],
[[UnitTypeWML#variation|female]],
filter ([[FilterWML|concept]], [[EventWML#.5Bfilter.5D|event]]),
[[StandardUnitFilter#filter_adjacent|filter_adjacent]],
[[StandardLocationFilter#filter_adjacent_location|filter_adjacent_location]],
[[FilterWML#Filtering_Weapons|filter_attack]],
[[AbilitiesWML#filter_attacker|filter_attacker]],
[[AbilitiesWML#filter_base_value|filter_base_value]],
[[EventWML#.5Bfilter_condition.5D|filter_condition]],
[[AbilitiesWML#filter_defender|filter_defender]],
[[AiWML#Filtering_Combat_with_the_attacks_Aspect|filter_enemy]],
[[StandardLocationFilter|filter_location]],
[[AbilitiesWML#filter_opponent|filter_opponent]],
[[AiWML#Filtering_Combat_with_the_attacks_Aspect|filter_own]],
[[StandardLocationFilter#filter_owner|filter_owner]],
[[StandardLocationFilter#filter_radius|filter_radius]],
[[SingleUnitWML#filter_recall|filter_recall]],
[[StandardUnitFilter|filter_second]],
[[FilterWML#Filtering_Weapons|filter_second_attack]],
[[AbilitiesWML#filter_self|filter_self]],
[[StandardSideFilter|filter_side]],
[[AbilitiesWML#filter_student|filter_student]],
[[FilterWML#Filtering_Vision|filter_vision]],
[[FilterWML#Filtering_Weapons|filter_weapon]],
[[FilterWML#Filtering_on_WML_data|filter_wml]],
[[InternalActionsWML#.5Bfind_path.5D|find_path]],
[[InternalActionsWML#.5Bfire_event.5D|fire_event]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|firststrike]],
[[InterfaceActionsWML#.5Bfloating_text.5D|floating_text]],
[[FontsWML|fonts]],
[[ConditionalActionsWML#.5Bfor.5D|for]],
[[ConditionalActionsWML#.5Bforeach.5D|foreach]],
[[ConditionalActionsWML#.5Bfound_item.5D|found_item]],
[[AnimationWML#The .5Bframe.5D tag|frame]];
|-
|''G:''
[[GameConfigWML|game_config]],
[[PersistenceWML#WML Syntax|get_global_variable]],
[[AiWML#The_.5Bgoal.5D_Tag|goal]],
[[DirectActionsWML#.5Bgold.5D|gold]],
[[InterfaceActionsWML#objectives-gold_carryover|gold_carryover]];
|-
|''H:''
[[DirectActionsWML#.5Bharm_unit.5D|harm_unit]],
[[StandardSideFilter#has_ally|has_ally]],
[[StandardUnitFilter#has_attack|has_attack]],
[[StandardSideFilter#has_unit|has_unit]],
[[ConditionalActionsWML#.5Bhas_achievement.5D|has_achievement]],
[[ConditionalActionsWML#.5Bhave_location.5D|have_location]],
[[ConditionalActionsWML#.5Bhave_unit.5D|have_unit]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|heal_on_hit]],
[[DirectActionsWML#.5Bheal_unit.5D|heal_unit]],
[[AnimationWML#short-healed|healed_anim]],
[[AnimationWML#short-healing|healing_anim]],
[[AbilitiesWML#The_.5Babilities.5D_tag|heals]],
[[UnitsWML#.5Bhide_help.5D|hide_help]],
[[InterfaceActionsWML#.5Bhide_unit.5D|hide_unit]],
[[AbilitiesWML#The_.5Babilities.5D_tag|hides]];
|-
|''I:''
[[AnimationWML#short-idle|idle_anim]],
if ([[ConditionalActionsWML#.5Bif.5D|action]], [[AnimationWML#Conditional Branches|animation]], [[IntroWML|intro]]),
[[AbilitiesWML#The_.5Babilities.5D_tag|illuminates]],
image ([[IntroWML#.5Bimage.5D|intro]], [[TerrainGraphicsWML#The_.5Bimage.5D_subtag|terrain]]),
[[ReplayWML#init_side|init_side]],
[[VariablesWML#.5Binsert_tag.5D|insert_tag]],
[[InterfaceActionsWML#.5Binspect.5D|inspect]],
[[InterfaceActionsWML#.5Bitem.5D|item]],
[[EditorWML#The_.5Bitem_group.5D_tag|item_group]];
|-
|''J:''
[[UnitsWML#jamming_costs|jamming_costs]],
[[InternalActionsWML#join|join]];
|-
|''K:''
[[DirectActionsWML#.5Bkill.5D|kill]],
[[StatisticalScenarioWML#The_.5Bteam.5D_tag|killed]];
|-
|''L:''
[[InterfaceActionsWML#.5Blabel.5D|label]],
[[LanguageWML|language]],
[[SideWML#leader|leader]],
[[AiWML#leader_goal|leader_goal]],
[[AbilitiesWML#The_.5Babilities.5D_tag|leadership]],
[[AnimationWML#short-leading|leading_anim]],
[[AnimationWML#short-levelin|levelin_anim]],
[[AnimationWML#short-levelout|levelout_anim]],
[[DirectActionsWML#.5Blift_fog.5D|lift_fog]],
[[AI_Recruitment#instructions-limit|limit]],
[[InternalActionsWML#set_variables-literal|literal]],
[[AddonsWML#load_resource|load_resource]],
[[LocaleWML|locale]],
[[InterfaceActionsWML#.5Block_view.5D|lock_view]],
[[LuaWML|lua]];
|-
|''M:''
[[UnitTypeWML#variation|male]],
[[SavefileWML|menu_item]],
[[InterfaceActionsWML#.5Bmessage.5D|message]],
[[Micro AIs|micro_ai]],
[[AnimationWML#The .5Bframe.5D tag|missile_frame]],
[[ModificationWML|modification]],
[[SingleUnitWML#modifications|modifications]],
[[DirectActionsWML#.5Bmodify_ai.5D|modify_ai]],
[[DirectActionsWML#.5Bmodify_side.5D|modify_side]],
[[DirectActionsWML#.5Bmodify_turns.5D|modify_turns]],
[[DirectActionsWML#.5Bmodify_unit.5D|modify_unit]],
[[AddonsWML#modify_unit_type|modify_unit_type]],
[[ReplayWML#move|move]],
[[DirectActionsWML#.5Bmove_unit.5D|move_unit]],
[[InterfaceActionsWML#.5Bmove_unit_fake.5D|move_unit_fake]],
[[InterfaceActionsWML#.5Bmove_units_fake.5D|move_units_fake]],
[[AnimationWML#short-movement|movement_anim]],
[[UnitsWML#movement_costs|movement costs]],
[[UnitsWML#.5Bmovetype.5D|movetype]],
[[ScenarioWML#The_.5Bmultiplayer.5D_tag|multiplayer]],
[[EraWML#Defining_Factions|multiplayer_side]],
[[MusicListWML#.5Bmusic.5D|music]];
|-
|''N:''
[[ConditionalActionsWML#Meta-Condition_Tags|not]],
[[InterfaceActionsWML#objectives-note|note]];
|-
|''O:''
[[DirectActionsWML#.5Bobject.5D|object]],
[[InterfaceActionsWML#objectives-objective|objective]],
[[InterfaceActionsWML#.5Bobjectives.5D|objectives]],
[[DirectActionsWML#.5Bon_undo.5D|on_undo]],
[[InterfaceActionsWML#.5Bopen_help.5D|open_help]],
[[InterfaceActionsWML#.5Bmessage.5D|option]],
[[OptionWML|options]],
[[ConditionalActionsWML#Meta-Condition_Tags|or]];
|-
|''P:''
[[IntroWML#.5Bpart.5D|part]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|petrifies]],
[[DirectActionsWML#.5Bpetrify.5D|petrify]],
[[DirectActionsWML#.5Bplace_shroud.5D|place_shroud]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|plague]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|poison]],
[[AnimationWML#short-post_movement|post_movement_anim]],
[[AnimationWML#short-pre_movement|pre_movement_anim]],
[[InternalActionsWML#.5Bfire_event.5D|primary_attack]],
[[InternalActionsWML#.5Bfire_event.5D|primary_unit]],
[[InterfaceActionsWML#.5Bprint.5D|print]],
[[DirectActionsWML#.5Bprogress_achievement.5D|progress_achievement]],
[[DirectActionsWML#.5Bput_to_recall_list.5D|put_to_recall_list]];
|-
|''R:''
[[UnitsWML#.5Brace.5D|race]],
[[InternalActionsWML#.5Brandom_placement.5D|random_placement]],
recall ([[DirectActionsWML#.5Brecall.5D|action]], [[ReplayWML#recall|replay]]),
[[StatisticalScenarioWML#The_.5Bteam.5D_tag|recalls]],
[[ReplayWML#recruit|recruit]],
[[AnimationWML#short-recruit|recruit_anim]],
[[AnimationWML#short-recruiting|recruiting_anim]],
[[StatisticalScenarioWML#The_.5Bteam.5D_tag|recruits]],
[[InterfaceActionsWML#.5Bredraw.5D|redraw]],
[[AbilitiesWML#The_.5Babilities.5D_tag|regenerate]],
[[InternalActionsWML#.5Bremove_event.5D|remove_event]],
[[InterfaceActionsWML#.5Bremove_item.5D|remove_item]],
[[DirectActionsWML#.5Bremove_object.5D|remove_object]],
[[DirectActionsWML#.5Bremove_shroud.5D|remove_shroud]],
[[InterfaceActionsWML#.5Bremove_sound_source.5D|remove_sound_source]],
[[DirectActionsWML#.5Bremove_time_area.5D|remove_time_area]],
[[DirectActionsWML#.5Bremove_trait.5D|remove_trait]],
[[InterfaceActionsWML#.5Bremove_unit_overlay.5D|remove_unit_overlay]],
[[ConditionalActionsWML#.5Brepeat.5D|repeat]],
[[DirectActionsWML#.5Breplace_map.5D|replace_map]],
[[DirectActionsWML#.5Breplace_schedule.5D|replace_schedule]],
[[ReplayWML|replay]],
[[SavefileWML|replay_start]],
[[DirectActionsWML#.5Breset_fog.5D|reset_fog]],
resistance ([[AbilitiesWML#The_.5Babilities.5D_tag|ability]], [[UnitsWML#resistance|unit]]),
[[UnitsWML#.5Bresistance_defaults.5D|resistance_defaults]],
[[ThemeWML#The_toplevel_.5Btheme.5D_tag|resolution]],
[[ModificationWML#The_.5Bresource.5D_toplevel_tag|resource]],
[[InternalActionsWML#Flow_control_actions|return]],
[[InternalActionsWML#.5Brole.5D|role]],
[[TerrainMaskWML#rule|rule]];
|-
|''S:''
[[SavefileWML|save]],
[[ScenarioWML#The_.5Bscenario.5D_tag|scenario]],
[[InterfaceActionsWML#.5Bscreen_fade.5D|screen_fade]],
[[InterfaceActionsWML#.5Bscroll.5D|scroll]],
[[InterfaceActionsWML#.5Bscroll_to.5D|scroll_to]],
[[InterfaceActionsWML#.5Bscroll_to_unit.5D|scroll_to_unit]],
[[InternalActionsWML#.5Bfire_event.5D|secondary_attack]],
[[InternalActionsWML#.5Bfire_event.5D|secondary_unit]],
[[HelpWML#section|section]],
[[InterfaceActionsWML#.5Bselect_unit.5D|select_unit]],
[[ReplayWML#sequence|sequence]],
[[DirectActionsWML#.5Bset_achievement.5D|set_achievement]],
[[DirectActionsWML#.5Bset_extra_recruit.5D|set_extra_recruit]],
[[PersistenceWML#WML_Syntax|set_global_variable]],
[[InterfaceActionsWML#.5Bset_menu_item.5D|set_menu_item]],
[[DirectActionsWML#.5Bset_recruit.5D|set_recruit]],
[[EffectWML#set_specials|set_specials]],
[[InternalActionsWML#.5Bset_variable.5D|set_variable]],
[[InternalActionsWML#.5Bset_variables.5D|set_variables]],
[[AnimationWML#short-sheath_weapon|sheath_weapon_anim]],
show_if ([[InterfaceActionsWML#.5Bmessage.5D|message]],
[[InterfaceActionsWML#.5Bobjectives.5D|objective]],
[[InterfaceActionsWML#.5Bset_menu_item.5D|set_menu_item]]),
[[InterfaceActionsWML#.5Bshow_objectives.5D|show_objectives]],
[[SideWML|side]],
[[AbilitiesWML#The_.5Babilities.5D_tag|skirmisher]],
[[OptionWML#slider|slider]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|slow]],
[[SavefileWML|snapshot]],
[[InterfaceActionsWML#.5Bsound.5D|sound]],
[[InterfaceActionsWML#.5Bsound_source.5D|sound_source]],
source ([[ReplayWML#attack|replay]], [[DirectActionsWML#.5Btunnel.5D|teleport]]),
[[UnitTypeWML#Special Notes|special_note]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|specials]],
[[InternalActionsWML#set_variables-split|split]],
[[Wesnoth_AI_Framework#The_.5Bai.5D_Tag_.E2.80.94_Stages|stage]],
[[AnimationWML#short-standing|standing_anim]],
[[StatisticalScenarioWML#The_.5Bstatistics.5D_tag|statistics]],
[[SingleUnitWML#status|status]],
[[InternalActionsWML#.5Bstore_gold.5D|store_gold]],
[[InternalActionsWML#.5Bstore_items.5D|store_items]],
[[InternalActionsWML#.5Bstore_locations.5D|store_locations]],
[[InternalActionsWML#.5Bstore_map_dimensions.5D|store_map_dimensions]],
[[InternalActionsWML#.5Bstore_reachable_locations.5D|store_reachable_locations]],
[[InternalActionsWML#.5Bstore_relative_direction.5D|store_relative_direction]],
[[InternalActionsWML#.5Bstore_side.5D|store_side]],
[[InternalActionsWML#.5Bstore_starting_location.5D|store_starting_location]],
[[InternalActionsWML#.5Bstore_time_of_day.5D|store_time_of_day]],
[[InternalActionsWML#.5Bstore_turns.5D|store_turns]],
[[InternalActionsWML#.5Bstore_unit.5D|store_unit]],
[[InternalActionsWML#.5Bstore_unit_defense.5D|store_unit_defense]],
[[InternalActionsWML#.5Bstore_unit_defense_on.5D|store_unit_defense_on]],
[[InternalActionsWML#.5Bstore_unit_type.5D|store_unit_type]],
[[InternalActionsWML#.5Bstore_unit_type_ids.5D|store_unit_type_ids]],
[[InternalActionsWML#.5Bstore_villages.5D|store_villages]],
[[IntroWML|story]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|swarm]],
[[AchievementsWML#.5Bsub_achievement.5D|sub_achievement]],
[[ConditionalActionsWML#.5Bswitch.5D|switch]],
[[InternalActionsWML#.5Bsync_variable.5D|sync_variable]];
|-
|''T:''
[[DirectActionsWML#.5Btunnel.5D|target]],
[[StatisticalScenarioWML#The_.5Bteam.5D_tag|team]],
teleport ([[AbilitiesWML#Extra_tags_used_by_the_.5Bteleport.5D_ability|ability]], [[DirectActionsWML#.5Bteleport.5D|action]]),
[[AnimationWML#short-teleport|teleport_anim]],
[[DirectActionsWML#.5Bterrain.5D|terrain]],
[[UnitsWML#.5Bterrain_defaults.5D|terrain_defaults]],
[[TerrainGraphicsWML|terrain_graphics]],
[[TerrainMaskWML|terrain_mask]],
[[TerrainWML|terrain_type]],
[[ScenarioWML#The_.5Btest.5D_tag|test]],
[[InterfaceActionsWML#.5Btest_condition.5D|test_condition]],
[[TestWML#The_.5Btest_do_attack_by_id.5D_tag|test_do_attack_by_id]],
[[InterfaceActionsWML#message-text_input|text_input]],
[[GettextForWesnothDevelopers#The_textdomain_tag|textdomain]],
[[ThemeWML|theme]],
[[ConditionalActionsWML#.5Bif.5D|then]],
[[TerrainGraphicsWML#The_.5Btile.5D_subtag|tile]],
[[TimeWML|time]],
[[DirectActionsWML#.5Btime_area.5D|time_area]],
[[HelpWML#topic|topic]],
[[HelpWML#toplevel|toplevel]],
[[UnitsWML#.5Btrait.5D|trait]],
[[DirectActionsWML#.5Btransform_unit.5D|transform_unit]],
[[InternalActionsWML#.5Bfind_path.5D|traveler]],
[[ConditionalActionsWML#.5Btrue.5D|true]],
[[DirectActionsWML#.5Btunnel.5D|tunnel]];
|-
|''U:''
[[InterfaceActionsWML#.5Bunhide_unit.5D|unhide_unit]],
unit ([[DirectActionsWML#.5Bunit.5D|action]], [[SingleUnitWML|scenario]]),
[[InterfaceActionsWML#.5Bunit_overlay.5D|unit_overlay]],
[[UnitTypeWML|unit_type]],
[[InternalActionsWML#.5Bunit_worth.5D|unit_worth]],
[[UnitsWML|units]],
[[InterfaceActionsWML#.5Bunlock_view.5D|unlock_view]],
[[DirectActionsWML#.5Bunpetrify.5D|unpetrify]],
[[DirectActionsWML#.5Bunstore_unit.5D|unstore_unit]],
[[InternalActionsWML#.5Bunsynced.5D|unsynced]];
|-
| ''V:''
[[InternalActionsWML#set_variables-value|value]],
[[ConditionalActionsWML#.5Bvariable.5D|variable]],
[[VariablesWML#The_.5Bvariables.5D_tag|variables]],
[[TerrainGraphicsWML#variant|variant]],
[[UnitTypeWML#variation|variation]],
[[AnimationWML#short-victory|victory_anim]],
[[SideWML#village|village]],
[[UnitsWML#vision_costs|vision_costs]],
[[InterfaceActionsWML#.5Bvolume.5D|volume]];
|-
| ''W:''
[[ConditionalActionsWML#.5Bwhile.5D|while]],
[[InterfaceActionsWML#.5Bwml_message.5D|wml_message]],
[[SchemaWML|wml_schema]];
|-
| ''Z:''
[[InterfaceActionsWML#.5Bzoom.5D|zoom]];
|}<includeonly>[[Category:WML Reference]]</includeonly><noinclude>A box with all the WML tags, each one linking to the page and section they are described in. This box should be included in each of the [[ReferenceWML|WML reference]] pages.</noinclude>

Maintenance tools

2024-12-31T23:47:25Z

Egallager: /* wmllint */ wiki version of https://github.com/wesnoth/wesnoth/commit/2583d9ae80e26b433e04a74a78d83e72098a11b0

<div class="floatright"> __TOC__ </div>

The Wesnoth source code distribution includes a couple of tools intended to help authors maintain campaigns, faction & unit packs, and other WML resources. These
are:

; wmlscope: a cross-reference lister, useful for finding unresolved macro and resource-file references.

; wmllint: a utility for sanity-checking WML syntax and porting your old WML to the current version of WML.

; wmlindent: a utility for reindenting WML to a uniform style.

; GUI.pyw: a graphical interface

== General Information ==

You will need a Python 3 interpreter on your system to use these tools. Linux, *BSD, and Mac OS/X should already have Python 3 installed; for Windows it's a free download
from http://www.python.org. You will also need to know how to run command-line tools on your system.

If you're working with Debian or Ubuntu you might have to install the package wesnoth-1.16-tools (or the convenient version).
sudo apt install wesnoth-1.16-tools

All three tools will require you to supply a directory list. This is a set of directories containing the WML files you want to work on.

This page is intended as documentation for users.

Note to Windows Users: This means you have to run it from the '''Command Line'''. The command line may be reached by hitting Start, then Run, then "cmd" or "command" depending on your version of Windows.

Example uses:
python wmllint path\to\files
python wmlindent path\to\files

Another example:
"C:\Program Files\Python3.7\python.exe" data\tools\wmllint --dryrun data\core data\{multiplayer,themes} data\campaigns
(You have to specify the full directory path to the executable if you don't have your environment variables set up correctly).
The first thing you type is the path to your python executable, followed by a space. The second thing you type is the path to the desired script to run, followed by a space. The third thing you type is the path to the folder (or file) to be processed.

'''A convenient way of running wmllint''' on Linux (Debian or Ubuntu) and Windows in comparison, '''Linux''':

Assuming we're working with wesnoth 1.16 or more advanced versions.
python3 /usr/share/games/wesnoth/1.16/data/tools/wmllint --dryrun /usr/share/games/wesnoth/1.16/data/core ~/.local/share/wesnoth/1.16/data/add-ons/A_Simple_Campaign 1>wmllint-run.log 2>wmllint-err.log
I have these commands inside of a file named
wmllint_dryrun_ASC.sh
and execute it by opening a shell (=terminal, console, command window, bash,...), navigating into the directory with that file and typing
bash wmllint_dryrun_ASC.sh
The python3 command should be automatically known on Debian. The path to the script tells the python interpreter what to execute. --dryrun: A wmllint option, see below. The path to the core files is needed to let wmllint know about e.g. defined core units, followed by the path to the add-on that shall be checked; the last two commands cause the result of the wmllint usage to be written into those files in the same directory as the script.
'''Windows''', this is logically exactly the same as the Linux shell script above, so if you are on a Mac you can probably conclude how you need to adapt the paths:
E:\Python37\python.exe E:\Programme\Wesnoth_1.16_git\data\tools\wmllint --dryrun E:\Programme\Wesnoth_1.16_git\data\core E:\Programme\Wesnoth_1.16_git\userdata\data\add-ons\A_Simple_Campaign 1>wmllint-run.log 2>wmllint-err.log
This is the content of a .txt file, whose extension I rename to .bat and double-click onto it. Opening a command window is not needed this way.
Since Python isn't natively installed on windows and I don't have environment variables set, the full path to python.exe is given. If your directories contain spaces it may help to include the path in quotes:
"C:\Programs\Battle for Wesnoth 1.16\data\tools\wmllint"
Remember that you do not need to enter all of the commands/paths at once. If it doesn't work, start with only "python" or "C:\Python37\python.exe" or the like and interpret the error messages that you get. If you get an "unknown command", python isn't installed or environment variables aren't set correctly. After that, you can add the later commands one by one.

== wmlscope ==

The main use for <tt>wmlscope</tt> is to find WML macro references without definitions and references to resource files (sounds and images) that don't exist. These are difficult to spot from in-game because they usually result in silence or a missing image rather than actual broken game logic (see [https://github.com/wesnoth/wesnoth/issues/5332 issue 5332] for more info). They may happen because of typos in your WML, or because the name of a macro or the location of a resource file changed between versions of the game.

<tt>wmlscope</tt> also checks macro invocations for consistency. It will complain
if a macro is called with the wrong number of arguments. In most cases it can deduce information about the type of the literal expected to be passed to a given macro argument by looking at the name of the formal.

<table class="wikitable"><tr>
<th>Type</th>
<th>Meaning</th>
<th>Formals requiring this type</th>
<th>Literals of this type</th>
</tr>
<tr>
<td>side</td>
<td>a single side number</td>
<td>SIDE, *_SIDE, SIDE[0-9]</td>
<td>a numeric or "global"</td>
</tr>
<tr>
<td>numeric</td>
<td>a numeric integer literal</td>
<td>SIDE, X, Y, RED, GREEN, BLUE, TURN, PROB, LAYER, TIME, *_SIDE, *NUMBER, *AMOUNT, *COST, *RADIUS, *_X, *_Y, *_INCREMENT, *_FACTOR, *_TIME, *_SIZE, DURATION</td>
<td>\-?[0-9]+</td>
</tr>
<tr>
<td>percentage</td>
<td>a percentage</td>
<td>*PERCENTAGE</td>
<td>a numeric or 0\.[0-9]+</td>
</tr>
<tr>
<td>position</td>
<td>a single x,y coordinate</td>
<td>POSITION, *_POSITION, BASE</td>
<td>-?[0-9]+,-?[0-9]+</td>
</tr>
<tr>
<td>span</td>
<td>a set of coordinates or coordinate ranges</td>
<td>*_SPAN</td>
<td>a numeric, position or ([0-9]+\-[0-9]+,?|[0-9]+,?)+</td>
</tr>
<tr>
<td>alliance</td>
<td>a set of side numbers</td>
<td>SIDES, *_SIDES</td>
<td>a span, or the empty string</td>
</tr>
<tr>
<td>range</td>
<td>an attack range</td>
<td>RANGE</td>
<td>"melee" or "ranged"</td>
</tr>
<tr>
<td>alignment</td>
<td>an alignment keyword</td>
<td>ALIGN</td>
<td>"lawful" or "neutral" or "chaotic"</td>
</tr>
<tr>
<td>types</td>
<td>a set of unit types</td>
<td>TYPES</td>
<td>a shortname, name, or anything that contains spaces and matches no other type</td>
</tr>
<tr>
<td>terrain_pattern</td>
<td>a set of terrain codes to filter</td>
<td>ADJACENT*, TERRAINLIST*, *TERRAIN_PATTERN, RESTRICTING</td>
<td>a terrain_code or name</td>
</tr>
<tr>
<td>terrain_code</td>
<td>a single terrain code, perhaps with overlay</td>
<td>TERRAIN*, *TERRAIN</td>
<td>a shortname or (\*|[A-Z][a-z]+)\^([A-Z][a-z\\|/]+\Z)?</td>
</tr>
<tr>
<td>shortname</td>
<td>a terrain code or a short, capitalized variable name</td>
<td></td>
<td>[A-Z][a-z][a-z]?</td>
<tr>
<td>name</td>
<td>a name or identifier</td>
<td>NAME, VAR, IMAGESTEM, ID, FLAG, *_NAME, *_ID, NAMESPACE, BUILDER, *_VAR</td>
<td>anything without spaces that matches no other type</td>
</tr>
<tr>
<td>optional_string</td>
<td>a string value (may be empty)</td>
<td>ID_STRING, NAME_STRING, DESCRIPTION, IPF</td>
<td>a string, or the empty string</td>
</tr>
<tr>
<td>string</td>
<td>a nonempty string not matching any of the preceding types</td>
<td>STRING, TYPE, TEXT, *_STRING, *_TYPE, *_TEXT</td>
<td>a shortname, a name, a stringliteral, or anything that contains spaces and matches no other type</td>
</tr>
<tr>
<td>stringliteral</td>
<td>a string in doublequotes or a translated string</td>
<td></td>
<td>".*" or _.* but not _[a-z].*</td>
</tr>
<tr>
<td>image</td>
<td>an image path, perhaps with [[ImagePathFunctionWML|image path functions]]</td>
<td>*IMAGE, PROFILE</td>
<td>[A-Za-z0-9{}.][A-Za-z0-9_/+{}.-]*\.(png|jpg)(?=(~.*)?)</td>
</tr>
<tr>
<td>sound</td>
<td>a music or sound filename</td>
<td>MUSIC, SOUND</td>
<td>string ending with ".wav" or ".ogg"</td>
</tr>
<tr>
<td>filter</td>
<td>[[FilterWML|WML filter]]</td>
<td>FILTER</td>
<td>any non-quoted string containing "="</td>
</tr>
<tr>
<td>WML</td>
<td>arbitrary WML fragment</td>
<td>WML, *_WML</td>
<td>any non-quoted string containing "=", or the empty string</td>
</tr>
<tr>
<td>affix</td>
<td>a prefix, suffix, or infix for a variable name</td>
<td>AFFIX, *AFFIX, POSTFIX, ROTATION</td>
<td>a shortname or name, or the empty string</td>
</tr>
<tr>
<td>any</td>
<td>anything</td>
<td>*VALUE, [ARS][0-9]</td>
<td>anything</td>
</tr>
</table>

If the actual argument is a macro call {.*}, then it matches any formal. Otherwise, if the formal has an identifiable type, <tt>wmlscope</tt> will complain if the actual literal does not match it.

The argument type check only works in macro calls that fit on a single line.

<tt>wmlscope</tt> has many options for changing the reports it generates; the more advanced ones are intended for Wesnoth developers. Invocations for the most commonly useful reports it generates are included in data/tools/Makefile of the source distribution. Here are some of those reports:

; make unresolved: Report on unresolved macro calls and resource references; also report macro argument-type mismatches. (This is what you are most likely to want to do).

; make all: Report all macro and resource file references, not just unresolved ones.

; make collisions: Report on duplicate resource files.

For more advanced users, or those who want to understand what the canned Makefile invocations are doing, here is a summary of <tt>wmlscope</tt>'s options. Some of the more advanced options will require you to understand
[http://docs.python.org/lib/re-syntax.html Python regular expressions].

; -h, --help: Emit a help message and quit
; -c, --crossreference: Report resolved macro references (implies <tt>-w 1</tt>)
; -C, --collisions: Report duplicate resource files
; -d, --deflist: Make definition list. (This one is for campaign server maintainers.)
; -e regexp, --exclude regexp: Ignore files matching the specified regular expression.
; -f dir, --from dir: Report only on macros defined under dir
; -l, --listfiles: List files that will be processed
; -r ddd, --refcount=ddd: Report only on macros with references in exactly ddd files.
; -t TYPELIST, --typelist TYPELIST: List actual & formal argtypes for calls in fname
; -u, --unresolved: Report unresolved macro references
; -w, --warnlevel: Set to 1 to warn of duplicate macro definitions
; -p, --progress: Show progress
; --force-used reg: Ignore reference count 0 on names matching regexp
; --extracthelp: Extract help from macro definition comments.
; --unchecked: Report all macros with untyped formals.
; --version: show program's version number and exit

These options are used with a list of directories as arguments; if none is given,
<tt>wmlscope</tt> behaves as though the current directory had been specified as a
single argument. Each directory is treated as a separate domain for
macro and resource visibility purposes.

<tt>wmlscope</tt> recognizes two kinds of namespace, exporting and non-exporting.
Exporting namespaces make all their resources and macro names
globally visible. You can make a namespace exporting by embedding
a comment like this in it:

# wmlscope: export=yes

Wesnoth core data is an exporting namespace. Campaigns are non-exporting;
they should contain the declaration

# wmlscope: export=no

somewhere. <tt>wmlscope</tt> will complain when it sees a namespace with no export
property, then treat it as non-exporting.

You can tell <tt>wmlscope</tt> to ignore stretches of config files
with the following magic comments:

# wmlscope: start ignoring
# wmlscope: stop ignoring

Similarly, you can tell <tt>wmlscope</tt> to ignore multiple or duplicate macro
definitions in a range of lines with the following magic comments:

# wmlscope: start conditionals
# wmlscope: stop conditionals

The following magic comment:

# wmlscope: prune FOOBAR

will cause <tt>wmlscope</tt> to forget about all but one of the definitions of
<tt>FOOBAR</tt> it has seen. This will be useful mainly for symbols that have
different definitions enabled by an <tt>#ifdef</tt>.

Due to a preprocessor limitation, inline macros cannot contain a documentation
string. If you need to document these macros in the HTML macro reference, you
can use the following directive:

# wmlscope: docstring FOOBAR

The docstring for the FOOBAR macro will be collected until a non-comment line,
a <tt>#define</tt> or another <tt># wmlscope: docstring</tt> are found. External
docstrings '''''must''''' be defined before the macro to which they refer; defining
two or more external docstrings keeps only the most recent one, but having both an
external and an internal docstring is allowed (in this case, the internal one
will be appended to the external one in the macro reference).

This tool does catch one kind of implicit reference: if an attack name
is specified but no icon is given, the attack icon will default to
a name generated from the attack name. This behavior can be suppressed
by adding a magic comment containing the string "no-icon" to the <tt>name=</tt>
line.

The checking done by this tool has a couple of flaws:

(1) It doesn't actually evaluate file inclusions. Instead, any
macro definition satisfies any macro call made under the same
directory. Exception: when an <tt>#undef</tt> is detected, the macro is
tagged local and not visible outside the span of lines where it was
defined.

(2) It doesn't read <tt>[binary_path]</tt> tags, as this would require
implementing a WML parser. Instead, it assumes that a resource-file
reference can be satisfied by any matching image file from anywhere
in the same directory it came from. The resources under the '''''first'''''
directory argument (only) are visible everywhere.

(3) A reference with embedded {}s in a macro will have the macro's
formal args substituted in at WML evaluation time. Instead, this
tool treats each {} as a .* wildcard and considers the reference to
match '''''every''''' resource filename that matches that pattern.
Under appropriate circumstances this might report a resource filename
statically matching the pattern as having been referenced even
though none of the actual macro calls would actually generate it.

Problems (1) and (2) imply that this tool might conceivably report
that a reference has been satisfied when under actual
WML-interpreter rules it has not.

The reporting format is compatible with GNU Emacs compile mode.

For debugging purposes, an in-line comment of the form

# wmlscope: warnlevel NNN

sets the warning level.

== wmllint ==

<tt>wmllint</tt> is a tool for migrating your WML to the current version. It handles two problems:

* Resource files and macro names may change between versions of the game. <tt>wmllint</tt> knows about these changes and will tweak your WML to fit where it can.

* Between 1.2.x and 1.3.1 the terrain-coding system used in map files underwent a major change. It changed again in a minor way between 1.3.1 and 1.3.2. If you port such old code, use <tt>wmllint-1.4</tt>, which is located in the same directory as <tt>wmllint</tt>. It will translate your maps for you, unless you use custom terrains in which case you will have to do it by hand.

<tt>wmllint</tt> also performs various sanity-checking operations, reporting:

* unbalanced tags
* strings that need a translation mark and do not have them
* strings that have a translation mark and should not
* translatable strings containing macro references
* filter references by description= (id= in 1.5) not matched by an actual unit
* abilities or traits without matching special notes, or vice-versa
* consistency between recruit= and recruitment_pattern= instances
* double space after punctuation in translatable strings.
* unknown races or movement types in units

<tt>wmllint</tt> takes a directory-path argument specifying the WML directories to work on. It will modify any cfg and map files under those directories that need to be changed. Here is a summary of its options:

; -h, --help: Emit a help message and quit.
; -c, --clean: Clean up -bak files.
; -D, --diffs: Display diffs between converted and unconverted files.
; -d, --dryrun: List changes (-v) but don't perform them.
; -r, --revert: Revert the conversion from the -bak files.
; -m, --missing: Warn about tags without side= keys now applying to all sides.
; -s, --stripcr: Convert DOS-style CR/LF to Unix-style LF.
; -v, --verbose: Set verbosity; more details below.
; -K, --known: Suppress check for unknown unit types, recruits, races, scenarios, etc.
; -S, --nospellcheck: Suppress spellchecking
; --version: show program's version number and exit

The verbosity option works like this:

; -v: lists changes.
; -v -v: warns of maps already converted.
; -v -v -v: names each file before it's processed.
; -v -v -v -v: shows verbose parse details (developers only).

The recommended procedure is this:

# Run it with --dryrun first to see what it will do.
# If the messages look good, run without --dryrun; the old content will be left in backup files with a -bak extension.
# Eyeball the changes with the --diff option.
# Use wmlscope, with a directory path including the Wesnoth mainline WML, to check that you have no unresolved references.
# Test the conversion.
# Use either --clean to remove the -bak files or --revert to undo the conversion.

Additionally, wmllint tries to locate a spell checker on your system and spell-checks storyline and message strings. It will work automatically with any of [https://github.com/AbiWord/enchant enchant]'s spellchecking backends (including aspell, myspell, ispell, applespell, hunspell, nuspell, and so on, depending on the version of enchant), provided you have the <tt>enchant.py</tt> Python library installed. Note that the spellchecking results can vary depending on which backend enchant decides to use.

wmllint supports a number of magic comments to customize its behaviour and avoid false positives. All magic wmllint comments begin with the string <tt>wmllint:</tt>, followed by some additional keyword and potentially some arguments. In the below explanations, a string of the form <code>[a|b]</code> means you may use either <code>a</code> or <code>b</code> at that location, while a string of the form <code><arg></code> indicates free text substitution.

* <code>ignore</code>: Disables checking of terrains and translation marks on the current line only.
* <code>noconvert</code>: Disables conversion of terrains and image/sound filenames on the current line only.
* <code>markcheck [on|off]</code>: Enables or disables translation mark checking from the current (next?) line onward.
* <code>no-icon</code>: Prevents description insertions (what does that mean?)
* <code>recognize <name></code>: Indicates that the character with the given name exists even though a declaration (ie a <code>[unit]</code> or <code>[side]</code> tag) is not visible.
* <code>whofield <macro> <number></code>: Indicates that the specified macro declares a character whose name is given by the specified argument to the macro.
* <code>whofield clear <macro></code>: Removes the <code>whofield</code> definition for the specified macro.
* <code>who <macro> is <name> <name> ...</code>: Indicates that the specified macro declares one or more characters whose names are given as a space-separated list. This can also be used for macros that auto-recall a list of characters, some of which join later or may die at some point. If a definition for the macro already exists, then the specified names are appended to it. If a name is preceded by a double minus (<code>-- <name></code>) then it is removed from the definition.
* <code>unwho all|<name></code>: Removes the <code>who</code> definition for the specified macro, or all <code>who</code> definitions.
* <code>usage of "<unit>" is <class></code>: Declares the usage of the specified unit (the <code>usage=</code> key in the <code>[unit_type]</code> tag). Useful if you are using macros to generate several similar unit types.
* <code>usagetype <class></code>: Declares a valid usage type for units. <code>usagetypes</code> is also recognized, and a comma-separated list of usage types can be specified.
* <code>validate-[on|off]</code>: Enables or disables stack-based validation checks. Use when you have unbalanced tags in macros.
* <code>unbalanced-[on|off]</code>: Similar to above, the precise difference is unclear.
* <code>no translatables</code>: Suppresses warnings about a missing textdomain declaration in the current file. Make sure the file really does have no translatable strings!
* <code>display [on|off]</code>: Enable or disable warnings about newlines in messages.
* <code>notecheck [on|off]</code>: Enable or disable note consistency checks for unit descriptions.
* <code>deathcheck [on|off]</code>: Enable or disable the check for units speaking in their death events.
* <code>[general|directory|local] spellings <word> <word> ...</code>: Declares the specified space-separated list of words to be valid spellings in the specified context. The context <code>local</code> indicates the current file only, while <code>directory</code> means the current file and any siblings in the same directory or subdirectories. The <code>global</code> context indicates the spellings are valid anywhere.
* <code>no spellcheck</code>: Disables spell checking on the current line.
* <code>skip-side</code>: Indicates that there is a missing side declaration at this location that will be provided by a macro expansion.
* <code>match <string> with <notes_macro></code>: Indicates that uses of the specified string in a unit definition (usually a macro, including the curly braces) should be matched up with the specified special notes macro (which is also specified as the full macro with curly braces).
* <code>no ellipsecheck</code>: Disables checking of unit ellipses on the current line.

=== Explanations of <tt>wmllint</tt> diagnostics ===
Some <tt>wmllint</tt> diagnostics may require further explanation for UMC authors to understand; this section will be for providing such explanations, and descriptions of how to solve and/or silence them.

In these, <code>%s</code> will be replaced by a string. When the recommended solution also includes a <code>%s</code>, it's a suggestion to copy the string from the error message into your code.

* <code>nonstandard word-wrap style within message</code>: This message meant there was an unexpected newline character within a <code>[message]</code> tag. However, this check was removed in the 1.15.10 release. Pre-1.15.10, add-on developers could silence by putting a <code># wmllint: display on</code> comment before the string and a <code># wmllint: display off</code> comment after the string, however, post-1.15.10, this is no longer necessary.
* <code>%s is not a known unit type</code> (in cases where you'd think the unit type ''would'' be known): This means the unit has a type that was never defined in mainline or in the add-on. This is why you're supposed to always add Wesnoth's core directory as the first item to be checked when using <tt>wmllint</tt> (which is something that the GUI version of it will do automatically for you), so that it can load the mainline unit types. (You can also silence this warning by passing the <tt>-K</tt> flag to <tt>wmllint</tt>.)
* <code>unknown speaker '%s' of [message]</code>: use a <code># wmllint: recognize %s</code> magic comment, or, alternatively, if the speaker is created by a macro, use a magic comment of the form of either <code># wmllint: who MACRO is SPEAKER</code> or <code># wmllint: whofield MACRO NUMBER</code>, depending on whether the macro takes an argument for the unit's name or not.
* <code>unknown '%s' referred to by id</code>: use a <code># wmllint: recognize %s</code> magic comment, or, alternatively, if the unit is created by a macro, use a magic comment of the form of either <code># wmllint: who MACRO is UNIT</code> or <code># wmllint: whofield MACRO NUMBER</code>, depending on whether the macro takes an argument for the unit's name or not.
* <code>%s has unknown advancements</code> (in cases where you'd think the advancement ''would'' be known): This means the unit has an advancement that was never defined in mainline or in the add-on. This is why you're supposed to always add Wesnoth's core directory as the first item to be checked when using <tt>wmllint</tt> (which is something that the GUI version of it will do automatically for you), so that it can load mainline units for checking advancements. Note that it's also possible that you just made typo, too, so be sure to check your spelling. (You can also silence this warning by passing the <tt>-K</tt> flag to <tt>wmllint</tt>.)
* <code>.description may need hand fixup</code>: This one comes from mucking around with the <code>.description</code> field of unit data manually in a hackish fashion. There isn't really much of a way to work around it, besides just the "don't do that" solution.
* <code>tag stack nonempty (%s) at end of file.</code>: This means that you have unbalanced tags somewhere in the file, e.g. an opener without a closer, or vice versa. This can often be seen when defining macros for unit abilities. A way to fix this warning is to wrap the section with unbalanced tags with a <code># wmllint: unbalanced-on</code> magic comment beforehand and a <code># wmllint: unbalanced-off</code> magic comment afterwards. As having unbalanced tags will also cause issues for other WML maintenance tools, such as <tt>wmlindent</tt> and <tt>wmlxgettext</tt>, you may also want to add separate magic comments for each of them (see their documentation for the form they take).
* <code>unit declaration without side attribute</code>: the default side for a unit declaration when left implicit is side 1. Specify your unit sides explicitly to solve this.
* <code>no %s units recruitable at difficulty %s</code> (even when there are such units recruitable): This diagnostic has to do with matching the <code>usage</code> key of units recruitable by an AI side with their <code>recruitment_pattern</code>. It means the unit has a usage that was never defined in mainline or in the add-on. This is why you're supposed to always add Wesnoth's core directory as the first item to be checked when using <tt>wmllint</tt> (which is something that the GUI version of it will do automatically for you), so that it can know which mainline units are recruitable. (You can also silence this warning by passing the <tt>-K</tt> flag to <tt>wmllint</tt>.)
* <code>%s has unknown movement type</code> (even when you'd think that that movement type ''would'' actually be known): This means the unit has a movetype that was never defined in mainline or in the add-on. This is why you're supposed to always add Wesnoth's core directory as the first item to be checked when using <tt>wmllint</tt> (which is something that the GUI version of it will do automatically for you), so that it can load the mainline movement types. (You can also silence this warning by passing the <tt>-K</tt> flag to <tt>wmllint</tt>.)
* <code>%s has unknown race</code> (even when you'd think that that race ''would'' actually be known): This means the unit has a race that was never defined in mainline or in the add-on. This is why you're supposed to always add Wesnoth's core directory as the first item to be checked when using <tt>wmllint</tt> (which is something that the GUI version of it will do automatically for you), so that it can load the mainline races. (You can also silence this warning by passing the <tt>-K</tt> flag to <tt>wmllint</tt>.)
* <code>derivation of %s from %s does not resolve</code> (even when you'd think it would): This means that a unit using the [[UnitTypeWML#Other_tags|[base_unit]]] tag specifies a unit ID in that tag that was never defined in mainline or in the add-on. This is why you're supposed to always add Wesnoth's core directory as the first item to be checked when using <tt>wmllint</tt> (which is something that the GUI version of it will do automatically for you), so that it can load the core units for its derivation checks. (You can also silence this warning by passing the <tt>-K</tt> flag to <tt>wmllint</tt>.)
* <code>[advancefrom] needs to be manually updated to [modify_unit_type] and moved into the _main.cfg file</code>: This one is pretty self-explanatory: [[UnitTypeWML#Unit_Type|[advancefrom]]] was deprecated in [https://github.com/wesnoth/wesnoth/commit/3950f40f3f0483032bc70b3e57166bd355acd9fc commit 3950f40] due to [https://github.com/wesnoth/wesnoth/issues/3955 issue #3955], and in fact doesn't even work anymore (in 1.16) as per [https://github.com/wesnoth/wesnoth/issues/6204 issue #6204]. The main reason <tt>wmllint</tt> can't fix this automatically is because it could end up being too complicated for it to figure out which files to edit if there are multiple uses of <code>[advancefrom]</code>, and it also doesn't want to assume where to put the [[ModificationWML|[modify_unit_type]]] tag in <tt>_main.cfg</tt>.

== wmlindent ==

Call with no arguments to filter WML on standard input to reindented WML on
standard output. If arguments are specified, they are taken to be files to be
re-indented in place; a directory name causes reindenting on all WML
beneath it.

The indent unit is four spaces. Absence of an option to change this is
deliberate; the purpose of this tool is to ''prevent'' style wars, not encourage
them.

On non-empty lines, this code never modifies anything but leading and
trailing whitespace. Leading whitespace will be regularized to the
current indent; trailing whitespace will be stripped. After processing
all lines will end with a Unix-style <code>\n</code> end-of-line marker.

Runs of entirely blank lines will be reduced to one blank line, except
in two cases where they will be discarded: (a) before WML closing
tags, and (b) after WML opening tags.

It is possible to wrap a section of lines in special comments so that
<tt>wmlindent</tt> will ignore them. You may need to do this for unbalanced
macros (it's better, though, to get rid of those where possible).
Use '<code>wmlindent: {start,stop} ignoring</code>' anywhere in a comment.

It is also possible to declare custom openers an closers, e.g for macros
that are actually control constructs. To do this, use declarations

# wmlindent: opener "{EXCEPTIONAL_OPENER "
# wmlindent: closer "{EXCEPTIONAL_CLOSER "

The lines after an opener will be indented an extra level; a closer
and lines following will be indented one level less. Note that these
declare prefixes; any prefix match to the non-whitespace text of a line
will be recognized.

The public utility macros "<code>{FOREACH</code>" and "<code>{NEXT</code>" come as wired-in exceptions,
because it is not guaranteed that their indent declarations will be processed
before the macro library is reached.

Interrupting <tt>wmlindent</tt> ought to be safe, as each reindenting will be done to a copy
that is atomically renamed when it's done. If the output file is identical
to the input, the output file will simply be deleted, so the timestamp
on the input file won't be touched.

The <tt>--dryrun</tt> option detects and reports files that would be changed
without changing them. The <tt>--verbose</tt> or <tt>-v</tt> option enables reporting
of files that are (or would be, under <tt>--dryrun</tt>) changed. With <tt>-v -v</tt>,
unchanged files are also reported. The <tt>--exclude</tt> option takes a regexp
and excludes files matching it.

If you don't apply this tool to your own WML that you wish to submit, the
mainline-campaign maintainers will do it when and if your code is accepted into the tree.

Note: This tool does not include a parser. It will produce bad results on WML
that is syntactically unbalanced. Unbalanced double quotes that aren't part
of a multiline literal will also confuse it. You will receive warnings
if there's an indent open at end of file or if a closer occurs with
indent already zero; these two conditions strongly suggest unbalanced WML.

== GUI.pyw ==

Starting from version 1.11.15 and 1.13.0, a GUI (written in Tkinter, plus the themed widgets ttk) is available in the same directory as the other tools. To use it, you need to have a version of Python equal to or greater than 3.1.0 (the 3.0.x series doesn't include the ttk widgets, and as such is unsuitable for this script).

If you're on Linux, be sure to have installed the ''python3-tk'' module, '''or the application won't run at all'''. To install it in a Debian-based distro (like Ubuntu), type this line in a Terminal:
sudo apt install python3-tk

To start it, just double click on the GUI.pyw file. The interface is pretty much self-explanatory, and allows you to run wmllint, wmlscope, wmlindent and wmlxgettext, modify their options, select an add-on and save the tools' output as a text file.

== See Also ==
* [[Translation Maintenance Commands]] (for <tt>wmlxgettext</tt>)

[[Category:Create]]
[[Category:Tools]]

GettextForWesnothDevelopers

2024-11-21T17:05:18Z

Egallager: /* Generating the .mo files for UMC */ update

This page is used to help Wesnoth developers and UMC authors to work with the internationalization (i18n) system, based on GNU gettext.

== General design of gettext use ==

Programs using Gettext include the strings in one language (usually English) within the source code. For each target language, a separate file provides a look-up table from English to that language. If the file is missing or doesn't have a translation for that string, the system falls back to using the English text.

The translation mechanism usually involves a function or macro called ''_'' (a single underscore sign). Examples are in the programming-language specific sections below.

=== Textdomains ===

Gettext splits translations into domains. For Wesnoth, the general idea is to use distinct textdomains for each campaign or add-on, so that UMC authors can easily ship translations together with their campaigns. These domains are covered in more depth in [[GettextForTranslators]].

The convention is to name each domain using the name of the add-on, or just its initials. For example, ''wesnoth-utbs'' or ''wesnoth-Son_of_Haldric''. For UMC, it probably makes sense to use the full name to ensure that it doesn't clash with another add-on.

=== Caret hints ===

Some strings look the same in English but should not necessarily look identical in translations. To handle this, those strings can be prefixed with any descriptive string and a '''^''' character. For users viewing in '''en_US''', these hints will be automatically removed from the string before showing it to the user.

{{DevFeature1.15|2}} if the string contains more than one '''^''', the descriptive string ends at the first '''^''', everything following the first '''^''' will be shown to the user.

{{DevFeature1.15|18}} When using gettext's Plural Forms, these prefixes can and should be used in both the singular and the plural.

=== UTF-8 ===

For translation, all C++, WML and Lua files should be in UTF-8. As noted in the [[Typography_Style_Guide]], some punctuation should be used that's outside of the ASCII subset.

== Marking up strings in C++ ==

In C++, you can mark up strings for translations using the <syntaxhighlight lang=c++ inline>_("A translation")</syntaxhighlight> and <syntaxhighlight lang=c++ inline>_n("Translation", "Translations", int)</syntaxhighlight> macros. The <code>_n</code> macro is to be used if the string has a singular and plural form.

You can also add comments for translators. Single-line comments must start with <code>TRANSLATORS:</code> and be on the line ''immediately'' above the translatable string. For multi-line comments, the <code>TRANSLATORS:</code> only needs to be on the first line to include the whole comment, and the last line must be immediately above the translatable string.

If the string contains any placeholders, '''don't''' use <code>snprintf</code>. Instead use WML style variables, put their values in a <syntaxhighlight lang=c++ inline>utils::string_map</syntaxhighlight> and use the <code>VGETTEXT</code> or <code>VNGETTEXT</code> macros instead.

<syntaxhighlight lang=c++>
utils::string_map symbols;
symbols["enemies"] = std::to_string(enemy_count_);
symbols["friends"] = std::to_string(friend_count_);
std::string message;
if ( friend_count_ != 0 && enemy_count_ != 0 ) {
// Omitted from the example - see the code in src/action/move.cpp for how to handle strings with two independent ints.
} else if ( enemy_count_ != 0 ) {
// TRANSLATORS: Only enemies sighted -- bad message.
// This is shown when a move is interrupted because units were revealed from the fog of war.
message = VNGETTEXT("Enemy unit sighted!", "$enemies enemy units sighted!", enemy_count_, symbols);
} else if ( friend_count_ != 0 ) {
// TRANSLATORS: Only friends sighted -- good message.
// This is shown when a move is interrupted because units were revealed from the fog of war.
message = VNGETTEXT("Friendly unit sighted", "$friends friendly units sighted", friend_count_, symbols);
}
</syntaxhighlight>

The <code>string_map</code> can contain additional values that aren't used in the translated string. In the example above, it has both ''friends'' and ''enemies''.

By default, all strings in C++ belong to the "wesnoth" textdomain. If a different textdomain is required, you can add a textdomain binding at the top of the source file, before any include statements. A textdomain binding looks like this: <syntaxhighlight lang=c++>#define GETTEXT_DOMAIN "wesnoth-lib"</syntaxhighlight>

You should avoid placing translatable strings in C++ headers if at all possible. Though there are a few places where it may be unavoidable, such as if templates are in use, it creates the risk of the strings sometimes being looked up in the wrong textdomain if the header is included in multiple files with different textdomains. If possible, always factor the translatable strings out into a source file.

Don't wrap the existing macros in more macros, as the .pot files are generated by gettext. Gettext isn't a full C++ parser, it's just searching for arguments to functions and macros in this list: <code>_ N_ _n N_n VGETTEXT VNGETTEXT sgettext vgettext sngettext vngettext</code>. That list is defined in cmake/FindTranslationTools.cmake and po/SConscript.

The <code>N_</code> and <code>N_n</code> macros are used equivalently to <code>_</code> and <code>_n</code>, but return the source string instead of the translated string – this can be used to manually look up the translation later. This is something of a niche use-case however, and most of the time you should prefer to use <code>_</code> and <code>_n</code>.

== Marking up strings in WML ==

=== The textdomain bindings ===

All files with translatable strings must declare which textdomain they use, which is normally done by putting ''#textdomain'' on the first line of each .wml file. See the example below:

<syntaxhighlight lang=wml>
#textdomain wesnoth-Son_of_Haldric

[unit_type]
id=Mu
name= _ "Mu"
# ...
[/unit_type]
</syntaxhighlight>

Note that it is highly recommended that the first textdomain binding be on the first line of the file. Otherwise, odd stuff may happen.

=== The translatable strings ===

To mark a string as translatable, just put an underscore ( _ ) in front of the string you wish to be marked as translatable, like the example below. When parsing this, the engine will record both the visible text and the active textdomain, which can later be used to get the translation when displaying the text to the player.

<syntaxhighlight lang=wml>
name= _ "Mu"
</syntaxhighlight>

==== Notes to the translators ====

If you think a translatable string needs additional guidance to be translated properly, you can provide a special comment that will be seen by the translators. Some hints are generated automatically, but in general if you have to wonder whether a hint is needed then it probably is. The context of the scenario isn't obvious in the translation tools, and you can't assume that the strings are shown to the translator in the same order that they appear in the WML file.

Just begin the comment with '#po:' or '# po:' above the string in question. This must be on the line (or lines) immediately before the string that the hint applies to:

<syntaxhighlight lang=wml>
#po: "northern marches" is *not* a typo for "northern marshes" here.
#po: In archaic English, "march" means "border country".
story=_ "The orcs were first sighted from the north marches of the great forest of Wesmere."
</syntaxhighlight>

The wmlxgettext tool will automatically generate hints for some tags, in addition to hints from '# po:' comments:

* For ''[message]'': the ''id'', ''speaker'', ''role'' or ''type'' used to choose the speaker
* For ''[object]'': the ''id''
* For ''[unit]'': the ''id'' and ''unit_type''
* For ''[unit_type]'': the ''id'' and ''race''
* For ''[objective]'': whether it's ''condition=win'' or ''condition=lose''

==== Things to avoid ====

Note that there are certain things you should never do. For example, '''never''' mark an empty string as translatable, for wmlxgettext (the tool that extracts strings from WML) will abort upon detecting one. Therefore, what is seen below should never be done:

<syntaxhighlight lang=wml>
name= _ ""
</syntaxhighlight>

Also, never put macro arguments in a translatable string, for it will not work. The reason for this is that the preprocessor does its job before gettext, thus gettext will try to replace a string that does not exist. Therefore, what is shown below should not be done:

<syntaxhighlight lang=wml>
name= _ "{TYPE} Mu"
</syntaxhighlight>

To show why it will not work:

<syntaxhighlight lang=wml>
#define UNIT_NAME TYPE
name= _ "{TYPE} Mu"
#enddef

{UNIT_NAME ( _ "Sword")}
{UNIT_NAME ( _ "Bow")}
</syntaxhighlight>

Translation catalogues would have this: "{TYPE} Mu", therefore gettext will look for it even though it will not exist because we, in fact, have these after the preprocessor is done:

<syntaxhighlight lang=wml>
name= _ "Sword Mu"
name= _ "Bow Mu"
</syntaxhighlight>

Since those are not in the catalogues, they will not get translated.

=== Gender-specific strings ===

Several tags, including ''[message]'', ''[abilities]'' and ''[trait]'', can choose different strings based on the gender of the unit. In English the two versions are likely to be the same, but other languages may have gender-specific words for 'I' or 'me'.

<syntaxhighlight lang=wml>
[message]
speaker=student
message= _ "Have you found an orc for me to fight, huh? A troll?"
female_message= _ "female^Have you found an orc for me to fight, huh? A troll?"
[/message]
</syntaxhighlight>

The convention in WML is, as above, to use ''message='' and ''female_message='', with the latter string including the prefix ''female^''. The mechanism also supports ''male_message='', but all units will fall back to using the plain ''message='' value if there isn't gender-specific version that matches their gender.

The message is chosen based on the gender of the speaking unit. To change the message based on the gender of another unit requires separate ''[message]'' tags:

<syntaxhighlight lang=wml>
[if]
[have_unit]
id=student
gender=male
[/have_unit]
[then]
[message]
speaker=Delfador
message= _ "Young man, you have $student_hp hitpoints and a sword. I’m fairly sure you’ll win."
[/message]
[/then]
[else]
[message]
speaker=Delfador
message= _ "female^Young lady, you have $student_hp hitpoints and a sword. I’m fairly sure you’ll win."
[/message]
[/else]
[/if]
</syntaxhighlight>

Using a macro to encapsulate most of that can be useful. The example above is from the tutorial, after expanding the ''GENDER'' macro which is defined in data/campaigns/tutorial/utils/utils.cfg.

=== Proper nouns in strings ===

Some languages require declensions of proper nouns - a person's name may change slightly depending on their role in a sentence. See for example [https://github.com/hrubymar10/wesnoth-cs/pull/209#issuecomment-1066163433 the Czech translators' PR 209].

Where there are a small number of units that might be addressed, for example the two in the tutorial or the four possible allies in UtBS, it's better to have a separate translatable string for each possible character instead of interpolating '''$unit.name''' into a string.

=== Reusing mainline translations ===

You can reuse translations for strings in mainline domains by using multiple textdomain bindings:

<syntaxhighlight lang=wml>
# textdomain wesnoth-Son_of_Haldric

[unit_type]
id=Mu
name= _ "Mu"
# ...

[attack]
id=sword
#textdomain wesnoth-units
description= _ "sword"
# ...
[/attack]

#textdomain wesnoth-Son_of_Haldric
# ...
[/unit_type]
</syntaxhighlight>

Of course, if you use bindings for multiple textdomains, make sure the right parts of the file are bound to the right domains. Also, never try to use the mainline campaigns’ domains, for there is no guarantee that the mainline campaigns will be available on all setups. So, only use the core domains: wesnoth, wesnoth-editor, wesnoth-lib, wesnoth-help, and wesnoth-units.

==== The gettext helper file ====

A gettext helper file is a lovely file that makes reusing mainline translations nice and easy, by having all strings that should use a specific textdomain in a single file. It is also more wmllint-friendly.

Here is an example of a gettext helper file. The macro names start with 'SOH_' to ensure that they don't clash with another add-on's macros (assuming that this add-on is Son_of_Haldric).

<syntaxhighlight lang=wml>
#textdomain wesnoth-lib

#define SOH_STR_ICE
_"Ice" #enddef

#textdomain wesnoth-units

#define SOH_STR_SWORD
_"sword" #enddef
</syntaxhighlight>

A typical name for gettext helper files is ''mainline-strings.cfg''.

To use it, just wire it into your add-on and use the macros:

<syntaxhighlight lang=wml>
[attack]
id=sword
name={SOH_STR_SWORD}
# ...
[/attack]

[terrain_type]
id=ice2
name={SOH_STR_ICE}
# ...
[/terrain_type]
</syntaxhighlight>

=== Unbalanced WML macros ===

WML macros can be ''unbalanced'', meaning that they either include a [tag] without the corresponding [/tag] or a [/tag] before the corresponding [+tag]. These macros are expected to be used in a place where the [tag] is already open. Writing new macros using this isn't recommended; instead please ask in the WML Workshop forum about better ways to do it.

When generating the .pot files for translation, wmlxgettext may stop with one of the errors
* error: Son_Of_Haldric/utils/abilities.cfg:29: unexpected closing tag '[/abilities]' outside any scope.
* error: Son_Of_Haldric/utils/abilities.cfg:300: End of WML file reached, but some tags were not properly closed. (nearest unclosed tag is: [abilities])

Suppose abilities.cfg line 29 is in the definition of SOH_ABILITY_BLITZ. To get the .pot file generated, the simplest change is to use ''# wmlxgettext'' comments to add the missing opening or closing tags:

# wmllint: unbalanced-on
# wmlxgettext: [abilities]
#define SOH_ABILITY_BLITZ
[dummy]
id=soh_blitz
# ... ability definition stuff ...
[/dummy]
[/abilities]
# ... several lines of code, none of which are an ''#enddef'' ...
[+abilities] # wmlxgettext: [/abilities]
#enddef
# wmllint: unbalanced-off

== Marking up strings in Lua ==

In Lua code, textdomains are a callable object that looks up a string. This has support for both singular and plural strings. By convention, the name <code>_</code> is usually used for the textdomain object.

The following sample code demonstrates how to fetch translatable strings in Lua:

<syntaxhighlight lang=lua>
local _ = wesnoth.textdomain "wesnoth"

-- Look up a normal string:
local win_condition = _ "Defeat enemy leader(s)"

-- Hints for the translators start with "po:", as in WML:
-- po: Floating text shown when a unit with the "feeding" ability gets a kill
local text = stringx.vformat(_"+$value max HP", { value = feeding.value})
</syntaxhighlight>

Plural strings are supported since Wesnoth 1.14:
<syntaxhighlight lang=lua>
local turn_count = 5
turn_counter = _("this turn left", "%d turns left", turn_count)
turn_counter = tostring(turn_counter):format(turn_count)

-- For readability, the example's strings are slightly different to the real code.
-- The real strings have brackets in the text shown to the player.
</syntaxhighlight>

In Wesnoth 1.15, variables can be interpolated using names:
<syntaxhighlight lang=lua>
-- Look up a plural string, using the preferred style (as of Wesnoth 1.15.3):
local turn_count = 5
turn_counter = _("this turn left", "$remaining_turns turns left", turn_count)
turn_counter = turn_counter:vformat{remaining_turns = turn_count}
</syntaxhighlight>

== The textdomain tag ==

To tell the engine where to search for the .po and .mo files, each textdomain needs a ''[textdomain]'' tag. For add-ons and mainline campaigns, the tag is usually placed inside of the _main.cfg. This is a top-level tag, so should be outside the ''[campaign]'' or ''[modification]'' tag.

Translatable strings from C++ and Lua use the same textdomains as WML; this WML tag tells the engine where to search for these strings irrespective of which programming language the string appeared in.

<syntaxhighlight lang=wml>
[textdomain]
name="wesnoth-Son_of_Haldric"
path="data/add-ons/Son_of_Haldric/translations"
[/textdomain]
</syntaxhighlight>

The .po (or .mo) files will be loaded from a subdirectory of the ''translations'' directory.

== Generating the .pot and .po files for UMC ==

For each language, Wesnoth will search for a .po file containing the translations. How to create that file will be explained below, but first the overview of where it should go. Continuing with the Son of Haldric example, the Swedish translation would be in the file:

* ''data/add-ons/Son_of_Haldric/translations/wesnoth-Son_of_Haldric/sv.po'' .

That comes from:

* ''data/add-ons/Son_of_Haldric/translations'' comes from the ''[textdomain]'' tag's ''path''
* ''wesnoth-Son_of_Haldric'' is the textdomain's name
* ''sv'' is the language code for Swedish. The codes for each language are given in the big table on [https://www.wesnoth.org/gettext/ https://www.wesnoth.org/gettext/] .

Wesnoth 1.14 (but not 1.12) supports reading .po files directly, so when you add the .po file and the new translation should appear as soon as you refresh the cache.

=== Generating the .pot file ===

The template (.pot) file contains all of the strings that need to be translated in the .po files, but without the translations.

The .pot is generated from WML and Lua files using a tool called wmlxgettext. With Wesnoth 1.14.5 and later, this is shipped with Wesnoth itself as part of the [[Maintenance_tools]] and can be used from the Maintenance Tools' GUI. At the moment it's not documented on that page, but if you follow the instructions to get GUI.pyw running then you'll see there's a wmlxgettext tab.

Pre-1.13 instructions on how to get and use it are in Nobun's [https://r.wesnoth.org/p617733 forum posting].

==== Error messages from wmlxgettext ====

If you get the error from ''wmlxgettext'' of "UTF-8 Format error. Can't decode byte 0x91 (invalid start byte).", and the line in question has a curly quotation mark, that likely means that your text editor is using the Windows-1252 character set, and you need to replace the Windows quotes with their Unicode equivalents, see [[Typography_Style_Guide]] and your editor's documentation for more info. The same applies if the error message says 0x92, 0x93 or 0x94.

If you get either "unexpected closing tag '[/''something'']' outside any scope" or "End of WML file reached, but some tags were not properly closed. (nearest unclosed tag is: [''something''])" then see [[#Unbalanced_WML_macros]] above.

=== Generating the .po files for each language ===

Each .po file can start as a simple copy of the .pot file. Either the author or the translator copies the template to the language-specific filename, and then the work of [[GettextForTranslators]] happens on those copies.

Some .po editors, for example poedit, will recognise that the .pot is a template, and automatically suggest saving to a different filename. The poedit editor can also update a .po file based on changes to the .pot file.

=== Generating the .mo files for UMC ===

For Wesnoth 1.14 and later, it's generally not necessary to compile the .po files to .mo files. The mainline translations still use .mo files for better performance, but UMC authors can skip the .mo compilation stage.

== See Also ==

* [[WesnothTranslations]]
* http://www.gnu.org/software/gettext/
* [https://www.gnu.org/software/gettext/manual/html_node/Preparing-Strings.html#Preparing-Strings GNU gettext manual on preparing translatable strings]
* [[GetText]]
* [https://wmlxgettext-unoff.readthedocs.io/en/latest/ wmlxgettext documentation]

[[Category:Development]]

User:Egallager

2024-11-09T18:54:45Z

Egallager: /* Elsewhere on the web */

User:Egallager

2024-11-09T18:52:58Z

Egallager: /* Forums */ +1 link

== Introduction ==
Hi, I am Eric Gallager. I am from New Hampshire.

== Forums ==
I also go by [https://forums.wesnoth.org/memberlist.php?mode=viewprofile&u=219741 egallager] on the forums.
Here are links to the topics I've either started, or that are for campaigns I've taken over:
* [https://forums.wesnoth.org/viewtopic.php?f=8&t=53597 Son of the Black Eye: Easy Edition]
* [https://forums.wesnoth.org/viewtopic.php?f=8&t=53601 A Tale of Two Brothers With a Third Difficulty]
* [https://forums.wesnoth.org/viewtopic.php?f=8&t=47885 A Little Adventure]
* [https://forums.wesnoth.org/viewtopic.php?f=8&t=26800 The Earth's Gut]
* [https://forums.wesnoth.org/viewtopic.php?f=8&t=1887 Flight to Freedom]
* [https://forums.wesnoth.org/viewtopic.php?f=31&t=24967 The War of Terrador]
* [https://forums.wesnoth.org/viewtopic.php?f=8&t=6486 A New Order]
* [https://forums.wesnoth.org/viewtopic.php?f=8&t=39512 Dawn of Thunder]
* [https://forums.wesnoth.org/viewtopic.php?f=7&t=54568 Call for translators (for my add-ons in general)]
* [https://forums.wesnoth.org/viewtopic.php?f=6&t=54369 Discussion of a Japanese "Let's Play" introduction to Wesnoth]
* [https://forums.wesnoth.org/viewtopic.php?t=57132 Word association]
* [https://forums.wesnoth.org/viewtopic.php?t=57215 Mainlining popular UMC tracks]
* [https://forums.wesnoth.org/viewtopic.php?t=57225 Categorizing UMC music by moods]
* [https://forums.wesnoth.org/viewtopic.php?t=58854 Floods of Irdya]

== Elsewhere on the web ==
I go by [https://github.com/cooljeanius "cooljeanius"] on GitHub (it's an old handle), and keep the sources for many of my Wesnoth things on there:
* [https://github.com/cooljeanius/wesnoth_mods generalized mods collection]
* [https://github.com/cooljeanius/Son_Of_The_Black_Eye_Easy_Edition Son of the Black Eye: Easy Edition]
* [https://github.com/cooljeanius/Saving_Elensefar Saving Elensefar]
* [https://github.com/cooljeanius/dawn_of_thunder Dawn of Thunder]
* [https://github.com/cooljeanius/Two_Brothers_With_A_Third_Difficulty A Tale of Two Brothers With a Third Difficulty]
* [https://github.com/cooljeanius/The_War_of_Terrador The War of Terrador]
* [https://github.com/cooljeanius/A_New_Order A New Order] (with a separate repo, [https://github.com/cooljeanius/ANO_art ANO_art], for the raw art assets used for it)
* [https://github.com/cooljeanius/A_Little_Adventure A Little Adventure] (with a separate repo, [https://github.com/cooljeanius/ALA_art ALA_art], for the raw art assets used for it)
* [https://github.com/cooljeanius/The_Earths_Gut The Earth's Gut] (with a separate repo, [https://github.com/cooljeanius/TEG_art TEG_art], for the raw art assets used for it)
* [https://github.com/cooljeanius/Flight_Freedom Flight to Freedom]
* [https://github.com/cooljeanius/Roboke Roboke]
I also use that handle elsewhere, such as on Wikipedia: [https://en.wikipedia.org/wiki/User:Cooljeanius https://en.wikipedia.org/wiki/User:Cooljeanius]

== This wiki ==
I have been editing (and intend to edit further) the following pages: [[ReferenceWML]], [[CharactersStorys]], [[Guide to UMC Content]], [[Glossary]], [[Maintenance tools]], and [[Available Music]].

Glossary

2024-11-09T17:48:28Z

Egallager: /* Wesnothian Acronyms */ put back TTK, since there was no explanation for its removal

Use the following list to demystify the various (mostly wesnoth specific) terms and acronyms you may run into.



== Gaming Terms ==

; ability : A special game rule or capability applied to all units of the given unit type - for example every Elvish Shaman has the ability "heal". (See [[AbilitiesWML]] for creating abilities.)

; campaign: A sequence of scenarios with a connecting storyline. ([[MainlineCampaigns]], [[Guide_to_UMC_Content]], [[CampaignWML]])

; creeping biggerism: the tendency for sprite artists to make new sprites bigger and more detailed than the existing ones, leading to issues of scale.

; era: A set of factions available in multiplayer. You can download additional eras from the [[Guide_to_UMC_Content|add-on server]]. ([[EraWML]])

; faction: A set of units available to be plated as a side in multiplayer games. ([[EraWML|multiplayer_side WML tag]])

; fog of war: A scenario option; enemy units are displayed only when close to player's units

; mainline: A [[MainlineCampaigns|campaign]], multiplayer map, era, faction, image, or other resource that ships with the Wesnoth distribution. The opposite of "[[#U|UMC]]".

; scenario: A sequence of turns played on one map. ([[ScenarioWML]])

; shroud: A scenario option; the whole map is black at the beginning, only parts already "discovered" by the player are visible.

; team color (TColor, TC): A unit graphic done so that color of some unit part (e.g. clothes) reflects the team where unit belongs ([[Team Color Shifting]])

; trait: A random minor modification of a unit; it makes a unit different from other units of the same type. ([[UnitsWML|the trait tag]])

; UMC: "User-Made content" or "User-Maintained Content", campaigns and other material that does not ship with the game but is available for download from the [[Guide_to_UMC_Content|Wesnoth add-on server]].

; [[WesCamp|Wescamp]]: The (former) project for translating unofficial user-made campaigns

; zone of control (ZoC): game rule; when a unit moves to a hex adjacent to enemy unit, it usually cannot move further.

; zone-locked: said of a unit that has entered an enemy ZoC and therefore cannot move further (often just "zoced" for short).

== Wesnothian Acronyms ==

*AI - Artificial Intelligence (An 'AI side' is a side controlled by the computer)
*AMLA - After Maximum Level Advancement
*AoH - Age of Heroes
*BfM - Battle for Meridia
*BfW - Battle for Wesnoth (the name of the game)
*BWH - '''B'''een suggested before. '''W'''e think it's a good idea. '''H'''ope to add it eventually.
*CABD - Can Already Be Done, e.g., you can already create custom unit abilities via WML.
*CtH - Chance to Hit (also C2H)
*CtBH - Chance to Be Hit (also C2BH)
*CtK - Chance to Kill (also C2K)
*CtBK - Chance to Be Killed (also C2BK)
*FoW - Fog of War (i.e. fog)
*FFA - Free For All (playing a map with >2 players without teams)
*FPI - Frequently Posted Idea (read the [http://www.wesnoth.org/forum/viewtopic.php?t=1158|FPI Post] from the Ideas Forum)
*HANE—EtH - Hexes Are Not Evil - Embrace the Hex
*HAPMA - Hexes Are Possibly Miles Across
*HP - Hit points
*IIRWIIR - It Is Ready When It Is Ready
*IPF - [[ImagePathFunctions|Image Path Function]]
*KISS - Keep It Simple, Stupid: Applies to coding, not game rules (although indirectly it does): see [[WesnothPhilosophy]]
*MAI - Micro AI: see: [[Micro_AIs]]
*MP - Multiplayer or Movement Points
*MUB - Massive Unit Blobs
*N3T - No 3-Teams; A belief stating that contests between three equal and opposing forces are inherently unbalanced
*OAB - Options Are Bad; In reference to gameplay, not user interface options. Mostly used by Turin.
*OFWRA - Old Flame War Revival Alert; In other words, we have discussed this before and have no interest in discussing it again, especially if it got ugly
*OOS - Out Of Sync - an error generated by Wesnoth. OOS errors occur when game data for one player is different/incompatible from the others
*PoD - Paths of Daggers, the name of a 2v2 multiplayer map.
*RiPLIB - Reduction in Power when Leveling Is Bad: means that when a unit upgrades, at least one of its options should be strictly superior to the original unit. [http://www.wesnoth.org/forum/viewtopic.php?t=1423 Reference 1] / [http://www.wesnoth.org/forum/viewtopic.php?t=7205 Reference 2]
*RNG - Random Number Generator
*RPG - Role Playing Game - [http://www.wesnoth.org/forum/viewtopic.php?t=4385 1)] Wesnoth's experience system. <nowiki>2)</nowiki> An "RPG-style" game on the MP server means the primary focus will be walking your leader-units through a scripted storyline involving map exploration and lots of WML.
*RTS - Real Time Strategy Game - as opposed to a turn-based game like Wesnoth
*SLF - [[StandardLocationFilter]]
*SP - Single Player (Campaigns)
*SSF - [[StandardSideFilter]]
*SUF - [[StandardUnitFilter]]
*TBS - Turn Based Strategy Game, like Wesnoth
*ToD - Time of Day
*TTK - Time To Kill
*TWP - The Wesnoth Philosophy: [[WesnothPhilosophy]]
*UAPEB - Units Are Possibly Entire Battalions
*UMC - User Made Campaign or User Made Content (any add-on not packaged with Wesnoth)
*WICOT - WML is capable of this (the requested feature is already possible to script, so no need to hard-code it in C++)
*WINR - Wesnoth Is Not Realistic
*WIN_ - Wesnoth Is Not... (Warcraft, Lord of the Rings, medieval Europe, an RPG, a wargame, a war simulation, Fire Emblem, etc.)
*WML - Wesnoth Markup Language: [[ReferenceWML]]
*XP - Experience
*ZoC - Zone of Control

== Names of Mainline Campaigns and Scenarios ==

*AoI - ''An Orcish Incursion''
*DiD - ''Descent into Darkness''
*DM - ''Delfador's Memoirs''
*DW - ''Dead Water''
*EI - ''The Eastern Invasion''
*HttT - ''Heir to the Throne''
** BoP - ''Bay of Pearls''
** DD - ''Dwarven Doors''
** HotNE - ''Home of the North Elves''
** IotD - ''Isle of the Damned''
** RtW - ''Return to Wesnoth''
** SoE - ''Siege of Elensefar''
** SoF - ''Sceptre of Fire''
** TotC - ''Test of the Clans''
*IoM - ''Isle of Mists'' (MP, mainlined in 1.15)
*LoW - ''Legend of Wesmere''
*NR - ''Northern Rebirth''
*SoF - ''Sceptre of Fire''
*SotA - ''Secrets of the Ancient''
*SotBE - ''Son of the Black Eye''
*TB (or AToTB) - ''A Tale of Two Brothers''
*THoT - ''The Hammer of Thursagan''
*TRoW - ''The Rise of Wesnoth''
*TSG - ''The South Guard''
*UtBS - ''Under the Burning Suns''
*WC - ''World Conquest'' (MP, mainlined in 1.15)
*WoF - ''Winds of Fate'' (formerly WoV for ''Wings of Victory'' or ''Wings of Valor'')

== Unofficial Campaigns ==

*ANO - ''A New Order''
*AotDS - ''Aria of the Dragon Slayer''
*ARL - ''A Rough Life''
*ASoF - ''A Song of Fire''
*AtS - ''After the Storm''
*BCoA - ''Black Cross of Aleron''
*BMR - ''Bad Moon Rising''
*BW - ''Brave Wings''
*CCamp - ''Custom Campaign''
*FoaP - ''Fate of a Princess''
*FTC - ''Forward They Cried''
*FtF - ''Flight to Freedom''
*Gns - ''Genesis''
*HoI1 - ''Hero of Irdya - Book I''
*IftU - ''Invasion from the Unknown''
*IQ - ''Inky's Quest''
*LotI - ''Legend of the Invincibles''
*SE - ''Saving Elensefar''
*SfF - ''Struggle for Freedom''
*TBC - ''The Beautiful Child''
*TDH - ''The Dark Hordes''
*TEG - ''The Earth's Gut''
*TFE - ''The Final Exam''
*TLU - ''To Lands Unknown''
*TSL - ''The Silver Lands''
*TSoG - ''The Sojournings of Grog''
*WotJ - ''War of the Jewel''

<div id="Unit_Names"></div>

== Unofficial MP Eras ==

*AE - ''Ageless Era/Archaic Era''
*ANLE - ''A New Land Era''
*EEaW - ''17th Century Eastern Europe at War''
*EoM - ''Era of Myths''
*EoMa - ''Era of Magic''
*GSE - ''Great Steppe Era''
*IE - ''Imperial Era''
*RE - ''Rashy Era''
*RotL/Rotl - ''Reign of The Lords''
*WoL - ''War of Legends''

== Unit Jargon ==

*bird - usually Gryphon Rider/Master (knalgans), or occasionally a Falcon or Eagle Rider from the [//units.wesnoth.org/1.14/Extended_Era/en_US/era_extended_37.0.0.0.html Extended Era] Aragwaith and Kalifa factions.
*DA - Dark Adept (undead)
*DF - Dunefolk
*fish - Merman (loyalists or rebels) or Naga Fighter (northerners)
*frog - a Saurian, especially "magic frog" for an Augur
*gobo - An affectionate, if somewhat derogatory term for the Goblin Spearman
*gunner - Dwarvish Thunderer/Thunderguard/Dragonguard (knalgans)
*HI - Heavy Infantryman (loyalists)
*MoL - Mage of Light (loyalists or rebels)
*pyro - Unit in the Drake Burner line
*Ulf - Dwarvish Ulfserker (knalgans)
*WC - Walking Corpse (undead)
*zombie - Walking Corpse

== General Acronyms ==

*AFaICT - As Far as I Can Tell (A statement with a disclaimer on truthfulness)
*AFaIK - As Far as I Know (A statement with a disclaimer on truthfulness)
*AFaIU - As Far as I Understand (likewise)
*AfK - Away from the Keyboard
*ASaP - As Soon as Possible
*BRB - Be Right Back
*BtW - By the Way (A statement with a disclaimer on relevance)
*DTRT - Do The Right Thing (expectation for how something should work)
*EV - Expected Value
*FTR - For The Record
*FUBAR - F***ed up beyond all repair / reason
*FWIW - For what it's worth
*FYI - For Your Information
*GG - Good Game (a common courtesy to say after a multiplayer game; alternatively "GGWP" for "Good Game, Well Played")
*GtG - Got to Go
*IANAL - I Am Not A Lawyer (A disclaimer that a statement may not constitute legal advice.)
*IDK - I Don't Know
*IIRC - If I Recall/Remember Correctly (A statement with a disclaimer on truthfulness)
*IIUC - If I Understand Correctly (Similar to IIRC, but not implying that the speaker once knew with certainty.)
*IMHO - In My Humble Opinion (A statement with a disclaimer on objectiveness) (can also be read as "In My Honest Opinion")
*IMO - In My Opinion
*IYSWIM - If You See What I Mean (A statement seeking agreement)
*LGTM - Looks Good To Me (used by maintainers when approving Pull Requests on GitHub)
*LMAO - Laughing My A** Off
*LTNS - Long Time No See
*OMG - oh my god(s)
*OP - either "OverPowered", "Original Post", or "Original Poster", depending on context.
*OT - Off Topic: can refer either to the forum category ([http://www.wesnoth.org/forum/viewforum.php?f=11]) or to spam
*OtOH - On the Other Hand (A contrast)
*PR - Pull Request (in the context of contributing to a project like Wesnoth on GitHub; other projects that use other issue trackers use it to mean Problem Report instead)
*QFT - Quote For Truth
*RotFL - Rolling on the Floor Laughing; also RoFL
*RtFM - Read the F***ing Manual
*TTYL - Talk To You Later
*YMMV - Your Mileage May Vary (a disclaimer allowing for subjectivity)

[[Category:World of Wesnoth]]

Guide to UMC Content

2024-10-27T02:30:11Z

Egallager: 1.18 is stable now

This is a guide to current-ish user-made content for players. It provides unfamiliar players with detailed information about campaigns (including story, completion, difficulty and playing style) as well as detailed information about eras. Feel free to edit this guide, as it is a wiki.

This list covers add-ons for the latest 3 stable releases (1.14, 1.16, and 1.18) of Wesnoth. There are archived versions of this page for [[Guide_to_UMC_Content/1.10|1.10]] and [[Guide_to_UMC_Content/1.12|1.12]].

For content creators who loved an add-on that hasn't been added to 1.14, 1.16, or 1.18 yet, and are wondering about taking it over, please ensure that its entry on the older (1.12 or 1.10) wiki page is up to date, add a link to the add-on's feedback thread in the forums, and generally do the tidy-up that doesn't need you to start changing the campaign, and then ask the old maintainer. (You should probably also wait a bit before assuming that a maintainer isn't already porting to 1.16 or 1.18).

If you are looking for even more campaigns, please see the links in at the bottom of this page.

== Instructions ==
When adding a campaign to the list, please place it in its alphabetically sorted location, ignoring any initial article ("A", "An", or "The").

=== Blueprint for Campaigns ===

* Description:

* Author:

* Maintainer: if not maintained by the author anymore.

* Status:
** Broken = Does not work at all
** Incomplete = Partially written, no progress
** WIP = Partially written, some progress
** Complete = Completely written, but buggy as well as potential balance issues.
** Finished = Completely written, minimal to no bugs, slight balance issues possible.

* Version campaign version on the add-ons server

* Length:

* Requirements: (only if needed)

* Difficulty:

Please note: Often campaigns introducing new mechanics are listed as expert level on the add-on server, here difficulty means the raw difficulty after the mechanics are understood.

** Unbalanced = If you can't beat the hard mode, it isn't necessarily unbalanced, but if the difficulty changes erratically from one scenario to the next and only people using the debug mode have seen the final, then it is.
** Easy
** Normal
** Hard

Please note: If you didn't play the campaign, write the difficulty written on the add-ons server.

* Style:

Please note: Many campaigns will feature more than one style. Please list the most significant ones. If you don't know which style is the campaign you are listing, don't write this.

** Skirmish = small to medium sized armies, your standard Wesnoth gameplay
** Dungeon = long and narrow tunnels (not every underground scenario is a dungeon, a dungeon isn't necessarily underground)
** RPG = role playing game elements such as talking with non-player-characters, item collection, dependency on a party of very few adventurers without or limited recruits
** Survival = being exposed to changing, spawning enemies while remaining on the same map
** Large Battle = large number of units on the battlefield, sizely maps
** Simulation = campaigns feat. terrain modification, alternative resources
** Boss battle = the challenge is to defeat a single powerful enemy unit
** Minigames = there are puzzles and minigames in the campaign that significantly differ from standard Wesnoth gameplay

* Faction/Era: Era for the whole campaign and more specifically the faction or unit composition you field.

* Custom units: Link to the unit tree for cases that don't feel sufficiently described by Faction / Era entry.

* Forum: Links to the feedback and development threads at forums.wesnoth.org

=== Blueprint for Eras ===

* Description:

* Author:

* Maintainer: if not maintained by the author anymore.

* Status 1.14/1.16/1.18:
** see the list of statuses in the campaign blueprint

* Faction Descriptions: Describe your individual factions here.

* Requirements: (only if needed)

* Forum: Links to the feedback and/or development threads at [https://forums.wesnoth.org/ forums.wesnoth.org].

== How to play for UMC factions ==

=== Southern Nations by Elvenisko ===
[[How_to_play_Death_Knights|Death Knights]] |
[[How_to_play_Southern_Drakes|Southern Drakes]] |
[[How_to_play_Southern_Dwarves|Southern Dwarves]] |
[[How_to_play_Southern_Elves|Southern Elves]] |
[[How_to_play_Southern_Mages|Southern Mages]] |
[[How_to_play_Southern_Mercenaries|Southern Mercenaries]] |
[[How_to_play_Southern_Orcs|Southern Orcs]] |
[[How_to_play_Southern_Swamplords|Southern Swamplords]] |
[[How_to_play_Southern_Nations|Comparison]] |
[https://units.wesnoth.org/1.17/Southern_Nations/en_US/era_southern.html All units (can be out of date)]

== Battle for Wesnoth 1.14 and newer ==

=== Campaigns ===

==== After the Storm ====

''Follow the journey of Galas and his band following the events of Invasion from the Unknown''

'''Author:''' shadowm/ShikadiQueen/Iris

'''Status:''' Finished, 0.10.11

'''Length:''' 3 episodes of 13 scenarios each, some of which are multi-part

'''Difficulty:''' Medium-hard

'''Style:''' Skirmish, Boss Battle, Dungeon

'''Faction/Era:''' Many custom units

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=32091]

'''GitHub:''' [//github.com/project-ethea/After_the_Storm]

'''Note:''' (vultraz) Long, very enjoyable campaign with great story. (Knyghtmare) The best UMC campaign ever!

'''[[Guide_to_UMC_Campaigns/Players_Reviews#After_the_Storm|Players’ Review(s)]]'''

====A Beastly Tale====

''When a small village is beset by troubles, its fate rests in the hands of a young woodsman and the animals he befriends.''

'''Author:''' GloccusV

'''Status:''' Complete

'''Version:''' 2.0.3

'''Length:''' 5 scenarios

'''Difficulty:''' Intermediate

'''Custom units:''' [//units.wesnoth.org/1.14/A_Beastly_Tale/en_US/A_Beastly_Tale.html Here]

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=41434&p=633612&hilit=A+Beastly+Tale#p579093 Here]

====A Song of the Winds====

''Every era has its heroes and heroines. Before the song of Myra, the odyssey of Akhen Wadjet and the aria of Tenma Yozora, there was the song of the winds that echoed in the mountains and halls at the heart of the Great Continent. Follow young Maat of Hiera'Shirsha and Prince Abhai of Garet-Desh in the war that set the stage for one of the greatest upheavals Irdya has ever witnessed.
(Prequel to the Dragon Trilogy)''

'''Author:''' revansurik

'''Status:''' Complete

'''Version:''' 1.0.0

'''Length:''' 43 scenarios (some of them dialogue-only)

'''Difficulty:''' Intermediate

'''Custom units:''' War of Legends + Custom factions

'''Forum:''' [//https://forums.wesnoth.org/viewtopic.php?f=8&t=53913 Here]

==== Bad Moon Rising ====

''An expedition to gather treasure from the cold north sets off compounding disaster.''

'''Author:''' Doofus-01

'''Status:''' Complete 1.10.0

'''Length:''' 20 scenarios

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Archaic Era

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=31348]

'''GitHub:''' [//github.com/doofus-01/wesnoth-Bad_Moon_Rising]

==== The Black Cross of Aleron ====

''A elvish school for druids comes under attack by goblins. It seems more than just a routine raid; is there something more sinister behind this attack? - In Beseiged Druids, you control Eärendil, the surviving teacher at the school, and the many and varied initiates. Not all of these are ordinary students; many have been experimenting with other forms of magic, while others are simply overachievers in some area of study. Unfortunately, they are not especially good at combat, at least initially. Together with a very small contingent of surviving guards, it is up to these students to save the island of Aleron from disaster.''

'''Author:''' Celtic Minstrel

'''Status:''' Complete 2.0.3

'''Length:''' 9 scenarios

'''Difficulty:''' Unbalanced

'''Style:''' Skirmish

'''Faction/Era:''' Default, Elves

'''[https://units.wesnoth.org/1.14/Black_Cross_of_Aleron/en_US/celmin-druid-siege.html Custom units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=37342

==== Danse Macabre ====

''Macabre is a rare zombie who has intelligence and will. What's he like? What's his purpose?''

'''Author:''' kamikaze

'''Maintainer:''' James_The_Invisible

'''Status:''' Completed, 1.3.2

'''Length:''' 12 scenarios

'''Difficulty:''' Unbalanced

'''Style:''' Large Battle

'''Faction/Era:''' Default, undead

'''[//units.wesnoth.org/1.14/Danse_Macabre/en_US/Danse_Macabre.html Custom units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=33745]

'''Note:''' While the campaign is playable on Wesnoth 1.14 without major issues, it is (still) in need of heavy re-balancing. Sadly, for various reasons I am not able to do it in near future but patches are always welcome, preferably in form of pull requests on [https://github.com/konecnyjakub/Danse_Macabre GitHub].

==== Dawn of Thunder ====

''A young elvish fighter is send to represent the Aethenwood at the Ka'lian. The adventure turns out to be bigger than expected.''

'''Author:''' Paulomat4

'''Maintainer:''' egallager

'''Status:''' [https://github.com/cooljeanius/dawn_of_thunder/issues/3 Incomplete], latest release on the BfW 1.16 add-on server is [https://github.com/cooljeanius/dawn_of_thunder/releases/tag/0.2.4 0.2.4].

'''Length:''' 18 scenarios

'''Difficulty:''' Challenging

'''Style:''' Skirmish, Large Battle, RPG-elements

'''Faction/Era:''' Default, Elves, Humans

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=39512 forums.wesnoth.org/viewtopic.php?f=8&t=39512]

==== A Fiery Birth ====

''A scholar of the Great Academy journeys to the land of the drakes to discover their secret origins.''

'''Author:''' Mathbrush

'''Status:''' Complete

'''Version:''' 1.2.0

'''Length:''' 9 scenarios

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=47861&p=623953 Here]

'''GitHub:''' [//github.com/brirush84/AFieryBirth]

==== The Final Exam ====

''Young mage Erika must find a magic book to become a true mage. But will it really be her final exam?''

'''Author:''' Elven

'''Status:''' Complete, 2.6.1

'''Length:''' 4 scenarios

'''Difficulty:''' Easy

'''Style:''' Skirmish, Minigames

'''Faction/Era:''' Default, Loyalists

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=23398]

'''Note:''' Short, easy campaign with varying objectives. Features female mage as leader.

==== [[FlightToFreedom|Flight to Freedom]] ====

''Flight to Freedom chronicles the story of the drake hero Malakar, and his desperate cross-country flight out of slavery.''

'''Authors:''' MadMax, Nova

'''Maintainer:''' egallager

'''Status:''' Complete

'''Length:''' 20 playable scenarios + 1 dialogue-only, for a total of 21 (may need an update now that the "B" branch has been reactivated)

'''Version:''' [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.2 5.4.2] (for BfW 1.16), or [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.5.0 5.5.0] (for BfW 1.17), or [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.6.0 5.6.0] (for BfW 1.18)

'''Difficulty:''' Expert

'''Style:''' Skirmish, Large Battle, Puzzle

'''Faction/Era:''' Drakes

'''Required Wesnoth version:''' 1.16+ or 1.17+ or 1.18+

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=1887 Development], [//forums.wesnoth.org/viewtopic.php?t=40195 Feedback]

'''GitHub:''' [//github.com/cooljeanius/Flight_Freedom github.com/cooljeanius/Flight_Freedom]

==== Inky's Quest ====

''The Cuttlefish Campaign''

''Are the cuttlefish mere beasts or something more? What stories would they tell if they could speak? This story provides one possible answer. The easiest difficulty provides hints for novice players.''

'''Author:''' Telchin

'''Status:''' Complete

'''Length:''' 12 scenarios + story-only epilogue, for a total of 13

'''Version:''' 1.5.6

'''Difficulty:''' Easy

'''Style:''' Skirmish

'''Faction/Era:''' Custom units (cuttlefish, tentacles, giant clams...). Enemies use both default era units and custom ones.

'''[//units.wesnoth.org/1.14/Inky_Quest/en_US/Inky_Quest.html Custom Units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=32501]

==== Invasion from the Unknown ====

''Episode I - Seeking the Light: Long after the Fall, the last forest elves are forced to abandon their safe valley, and find themselves resorting to the dark means of necromancy in order to survive the perils and challenges of this new harsh world. May they finally free the Great Continent from its chaos, or perish in the foolish attempt of restoring peace and life to the lands.''

''Episode II - Armageddon: As the shadow of Chaos covers the entire continent, an assorted group of foolish heroes prepares a counter-attack to the Empire, with one unique goal in their minds: defeat the evil Emperor, whoever it is. Lead these courageous living and non-living warriors to victory, and rediscover lost secrets of the history.''

'''Author:''' shadowm/ShikadiQueen/Iris

'''Status:''' Finished, 2.1.9

'''Difficulty:''' Normal

'''Style:''' Skirmish, Dungeon, Boss battle

'''Faction/Era:''' Unique. You play Elves and Undead throughout the campaign.

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=43309]

'''GitHub:''' [//github.com/project-ethea/Invasion_from_the_Unknown]

'''Walkthrough:''' [[IftU Walkthrough]]

''[[Guide_to_UMC_Campaigns/Players_Reviews#Invasion_from_the_Unknown|Players’ Review(s)]]'''

==== Leader of the Drakes ====

''Leader of the drakes is killed. His son tries to defend homeland against the orcs. He choosed to ally with saurians, but other clans of drakes disagrees. Will fast and unexperienced Morin win against orcs and rebel drakes alike?''

'''Author:''' Elven

'''Status:''' Complete, 1.02b

'''Length:''' 3 scenarios

'''Difficulty:''' Easy/Medium

'''Style:''' Skirmish, Minigames

'''Faction/Era:''' Default, Drakes

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=53951&start=15]

'''Note:''' Short, easy campaign with simple objectives. Features Drake Glider as leader and modified Drake Burner with cold and slowing blade.

==== Legend of the Invincibles ====

'''''Part I: Shrouded in Darkness''' (5 chapters, 90 scenarios) - A pair of heroes, after stopping an orcish threat, are outcast into caves, where they have no other choice than to become liches in order to survive. They preserved their original appearance and moral principles, and fight in various skirmishes against evil (although using evil methods sometimes), until the Fall, when they are buried alive under the ashes of the third sun.''

'''''Part II: Into the Light''' (5 chapters, 110 scenarios) - Long after the Fall, the lich heroes awaken. Searching for more power, they manage to resurrect themselves as living beings, but this time more powerful and ridden of the evil within. But the evil from inside them did not cease to exist, and started a campaign to conquer the world. Stopping the campaign caused an even worse disaster...''

'''Author:''' Dugi

'''Status:''' Complete

'''Length:''' 200 (+8 talk-only) scenarios

'''Difficulty:''' Normal

'''Style:''' mostly Skirmish and Dungeon (all other styles are present as well, but less frequently)

'''Faction/Era:''' Elves, Loyalists, Undead, Dwarves; but they advance past their usual maximum level

'''Forum:''' [//r.wesnoth.org/t32384]

'''GitHub:''' [//github.com/Dugy/Legend_of_the_Invincibles]

'''[[Guide_to_UMC_Campaigns/Players_Reviews#Legends_of_the_Invincibles|Players’ Review(s)]]'''

'''Note:''' The most unique feature of this campaign is its RPG-like unit development system, enemies drop items units can use, leaders are stronger than most usual units and all units get AMLA (after maximum level advancement) after reaching their maximum level (that is also increased by a load of additional level 4 units).

==== A New Order ====

''The old kingdom of Wesnoth has fallen before barbarian hordes. The occupying barbarians are on the brink of civil war, the seeds of Wesnothian rebellion are kept alive by old legends, while bandits and Dunefolk mercenaries roam the land. Can Gawen Hagarthen unite these disparate factions against a common foe?''

''Note: This campaign contains mature themes, some of which may be unsuitable for children.''

'''Author:''' szopen

'''Maintainers:''' nemaara (Yumi), egallager

'''Status:''' Finished

'''Version:''' [https://github.com/nemaara/A_New_Order/releases/tag/1.7.0 1.7.0]

'''Length:''' Hard to say as it is non-linear; it is advertised as having 45 scenarios, but the numbering only goes up to 30 due to some of the scenarios being alternates to one another.

'''Requirements:''' Requires BfW 1.16+. Also uses the "Akladian Music" add-on.

'''Difficulty:''' Advertised as intermediate; could be considered hard, though.

'''Style:''' Mostly Skirmish, some Large Battle

'''Faction/Era:''' mostly various human factions (including the Dunefolk), with the addition of the Akladian faction of humans

'''[//units.wesnoth.org/1.16/A_New_Order/en_US/A_New_Order.html Custom Units]'''

'''Forum threads:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=6486&sid=2e644284f54e65736b4f1543b7098ef9 Development], [//forums.wesnoth.org/viewtopic.php?t=36183 Feedback], [//forums.wesnoth.org/viewtopic.php?t=6174 Original (older) art thread], [//forums.wesnoth.org/viewtopic.php?t=36074 Current art thread]

'''GitHub:''' [//github.com/nemaara/A_New_Order github.com/nemaara/A_New_Order]

'''Note:''' (Pyrophorus) Certainly one of the most mature and well designed campaign in add-ons. A must.

''' [[Guide_to_UMC_Campaigns/Players_Reviews#A_New_Order|Players’ Review(s)]]'''

==== The North Wind ====

''Wesnoth's army was occupied fighting Mal Ravanal in the East, but there were whisperings of an orcish attack in the north. Konrad II must send Deoran, now an experienced rider and commander, with a small band of knights to hold off the orcs....''

''This campaign features unique gameplay characteristics such as a lack of recruiting and a 24-turn time-of-day cycle.''

'''Author:''' aelius, Deusite; pyndragon

'''Status:''' WIP, 0.3.0

'''Length:''' 1 playable scenario, 6 intended

'''Difficulty:''' Normal

'''Style:''' RPG, Skirmish, Survival

'''Faction/Era:''' Loyalists

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=42854]

==== The Ravagers====

'''Description:''' ''The Ravagers'' is a tale of pure revenge. A tale of justice served cold, told in a flashback-style point-of-view narrative, by a ranger in the Inn at Weldyn.
The campaign includes many new exciting gameplay features, fun mechanics such as drinking, hundreds of custom units, and many more.

'''Author:''' WhiteWolf

'''Status:''' Finished*

'''Length:''' 25 playable scenarios + 2 scene scenarios

'''Requirements:''' Akladian Music Pack, Underness Music Pack

'''Difficulty:''' Intermediate

'''Style:''' Skirmish + RPG / Flashback narrative

'''Faction/Era:''' Humans, Elves, Ravagers(dark humans)

'''[//units.wesnoth.org/1.14/The_Ravagers/en_US/The_Ravagers.html Custom Units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=44930]

'''*Notes:''' The main storyline is complete, but there are unfinished side-missions that are still in development. The campaign is aimed to become finished with version 1.2.0.

==== Return from the Abyss ====

''After taking part to a disastrous expedition, Khafir and his men are lost and isolated from their people, thousands of miles away from home, bound by a pact sealed with a powerful dwarvish king. Help him escape from the depth of Irdya and finding his way back, in an adventure across two worlds during the rise of a sinister force in the Great Continent.''

'''Author:''' skeptical_troll

'''Status:''' finished

'''Length:''' 19 playable scenario + 10 story only

'''Difficulty:''' Hard

'''Style:''' Skirmish, Dungeon

'''Faction/Era:''' Dunefolk/Default

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=44545]

==== Rise of the Dunefolk ====

''Adventure of Siabbin and Helare from small village in desert, who step by step made the foundation of the Dunefolk nation. Play a stunning adventure against many enemies in different maps - from sandstorm to swampy areas and caves. Defeat powerful lich lord and train one of the best dark mages in the world of Wesnoth.''

'''Author:''' Elven

'''Status:''' Completed

'''Length:''' 11 scenarios

'''Difficulty:''' Medium

'''Style:''' Skirmish, Minigames, Survival

'''Faction/Era:''' Default, Dunefolk and dark mage

'''Note:''' enjoable gameplay with every map different. Enough experience to upgrade your units.

==== The Return of the Darks ====

''The Darks are a race which left Wesnoth in the ancient times and lives on Isles in the sky. But now the Magic wich helped them to move the Isles in Sky got lost and the isles are about to fall down. Rumion an adventurer goes to Wesnoth and searchs for something that could help them.''

'''Author:''' thvk

'''Status:''' WIP

'''Length:''' 4 playable scenario + 2 story only

'''Difficulty:''' Easy

'''Style:''' Skirmish

'''Faction/Era:''' Default + some self made units

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=52731]

==== Secrets of the Ancients ====

''From the Journal of Ardonna of Tarrynth:''

''It's unfair that we humans must die after so few years. Though this is the natural order, we need not embrace it! The lords on the Green Isle knew how to live forever. Pursuit of that knowledge was declared illegal by King Haldric I, but I believe it is worth the risk: If I can rediscover the secrets of the ancients, not only will I cheat death, I will become a hero to the whole continent!''

'''Author:''' beetlenaut

'''Status:''' Mainlined (this is now one of the campaigns that is downloaded with Wesnoth itself)

'''Length:''' 18 playable scenarios + 3 story only

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Undead/Default

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=40545]

'''Walkthrough:''' [[Secrets of the Ancients Walkthrough]]

==== Swamplings ====

''Banished by Yushnak the Ponderer, a tribe of lowly swamp goblins endure in the deadly mire of Pogo Bog. Four centuries before the founding of Wesnoth, this is the story of the goblins' struggle against the intrigues and betrayals of the greater races, and the rise of the first wolf rider.''

'''Author:''' John Rawlins (boru)

'''Status:''' Complete

'''Length:''' 17 scenarios

'''Version:''' 1.2.0i

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction:''' Goblins

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=41254]

'''[[Guide_to_UMC_Campaigns/Players_Reviews#Swamplings|Players’ Review(s)]]'''

==== The Dark Hordes ====

''Lead fugitive dark sorcerer Gwiti Ha’atel to mastery of the undead hordes.''

'''Author:''' Circon

'''Maintainer:''' Various

'''Status:''' Incomplete/WIP

'''Length:''' 15 scenarios done so far

'''Version:''' 0.1.2

'''Difficulty:''' Unbalanced

'''Style:''' Skirmish

'''Faction/Era:''' Default undead

'''[//units.wesnoth.org/1.10/The_Dark_Hordes/en_US/The_Dark_Hordes_1.html Custom Units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=16576&]

==== The Tale of Vaniyera ====

''The expansionist Lavinian Legion, led by the Imperator himself, has invaded the northern forests of the Sidhe, or Wild Elves. It is up to Leithan the Thunderblade and his advisor Vaniyera to push its armies back where they came from...''

'''Author:''' oreb, turin

'''Maintainer:''' UnwiseOwl

'''Status:''' Finished 0.11.0

'''Length:''' 5 scenarios

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Imperial Era, Sidhe.

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=37880]

'''Walkthrough''' There is a video-walkthrough by the campaign maintainer that begins [https://www.youtube.com/watch?v=dGM1bjImvkI&list=PLZorLYWvUD7VIhaXxKwzO8iQANlp_TaF0 here].

'''Note:''' As of August 2014, all previous issues raised about this campaign have been addressed. If you've not played this campaign since 1.4 or 1.10, in this humble maintainers opinion, it's worth another go.

==== To Lands Unknown ====

''This is the story of Mehir, the Summoner, and his journey to lands unknown.''

'''Author:''' inferno8

'''Status:''' Complete

'''Length:''' 20 scenarios, 4 dialogue only

'''Difficulty:''' Intermediate (Era of Magic)

'''Style''': Skirmish, Dungeon

'''Era:''' Era of Magic

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=31799]

'''GitHub:''' [//github.com/inferno8/wesnoth-To_Lands_Unknown]

'''[[Guide_to_UMC_Campaigns/Players_Reviews#To_Lands_Unknown|Players’ Review(s)]]'''

==== A Vision Blinded ====

''Defend the northern forest against what appeared like a routine orcish raid, and unravel the greater conspiracies that lie below its waves.''

'''Author:''' LemonTea

'''Maintainer:''' Adamant14

'''Status:''' Complete, 1.0.14

'''Length:''' 13 playable scenarios + 1 dialogue-only

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default, Elves (+ Trolls, Outlaws)

'''[//units.wesnoth.org/1.10/A_Vision_Blinded/en_US/A_Vision_Blinded.html Custom units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=23463]

=== Eras ===

[[Category:Campaigns|*]]
[[Category:Eras|*]]

==== '''Southern nations''' ====

[[How_to_play_Southern_Nations|Everything about southern nations, including how to play series]]

==== '''War of Legends''' ====

'''Description:''' A multiplayer era focused on the Dark Irdya Campaigns. Contains 15 factions.

'''Author:''' Tahsin Jahin Khalid (Lord-Knyghtmare)

'''Maintainer:''' Tahsin Jahin Khalid (Lord-Knyghtmare)

'''Status:''' Complete, new features being added for the 1.15.x version of the add-on

'''Factions:'''

# Aragwaithi
# Windsong
# Human Alliance
# Orcish Union
# Southerners (Desert Elves)
# Outlaws
# Elementals
# Undead
# Drakes
# Dark Legion
# Sylvans
# Minotaurs
# Vampires
# Dunefolk
# Knalgan Alliance

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=19&t=30087 Development and Feedback Thread]

'''GitHub:''' [//github.com/knyghtmare/War_of_Legends]

==== Era of Magic(EoMa) ====

'''Description:''' Aiming at using the whole potential of Battle of Wesnoth's graphic engine, the Era of Magic is considered to have a most amazing special effects and attack animations in the BfW game. There are 8 playable factions with fully animated units and tons of special effects contained in the era, and the stories of them are told in the campaign "To Lands Unknown".

'''Author:''' Inferno8

'''Maintainer:''' Inferno8

'''Status:''' Finished, 3.1

'''Faction Descriptions:'''

Sky Kingdom - powerful magi of all kinds. Their knowledge allows them to cast amazing spells and summon creatures like unstopable Golems or mysterious Mus. Masters of Elements and Gurus are one of the most powerful human beings in the Era.

Al-Kamija - these proud people are good warriors and spell casters of the desert. They use magical circles and scrolls to summon amazing creatures like Jinns or elementals from other dimension called Abyss. These creatures can't be poisoned, which is a great advantage.
(The campaign "To Lands Unknown" is mainly about the story of this faction)

Tharis - fearsome Tharis faction is very dangerous especially at night. Cruel people of Tharis with their black magic and dreadful monsters like Hydra can demolish everything standing on their way. Being so powerful in attack, Tharis have no healer, so they need to push forward at all costs.

Kharos - this strange name is the name of a beautiful country ruled by prophets of light. These peaceful people are masters of defense and support. Their formations of healers and Shielders assisted by Silver Warriors, who can teleport between friendly villages, are very hard to destroy.

Barbarians - the best in hand-to-hand combat. This multi-cultural society divided into Goblins, Orcs, Cyclops and Trolls with their own advantages and disadvantages can be hard opponent, but separately they are very weak.

Runemasters - these Dwarves use runic magic and equipment and are well known of their protection against magic. The Runemasters create steam machines like Gyrocopters, Robots and even mighty Mechanical Dragons. Units from this faction are very resistant but slow.

Dark Blood Alliance - this faction is composed of agile lizards, giant frogs, wyverns swallowing enemies and salamanders, which have developed to perfection the art of disguise. At the head of the community stand shamans known for their water magic, which is used in the fight as well as in healing.

Destroyers - a terrifying undead creations consisting of civilizations long gone...

'''Version:''' 1.1.1 (February 18th, 2015)

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=19&t=20039 Development and Feedback Thread]

'''GitHub:''' [//github.com/inferno8/wesnoth-Era_of_Magic]

==== Ageless Era ====

'''Description:''' Ageless Era is a compilation of the most popular eras and factions on the add-on server. It is more an era pack than an era.

'''Author:''' mnewton1, Ravana and various

'''Maintainer:''' Ravana

'''Status:''' Finished, 4.19

'''Unit Tree:''' [//units.wesnoth.org/1.12/Ageless_Era/en_US/Ageless%20Era.html Ageless Unit Tree (for 1.12)]

'''Factions List:''' Currently there are 91 factions in the era:

Default: Loyalist, Rebels, Northerners, Undead, Knalgan Alliance, Drakes, Khalifate

Extended Era: Loyalist, Sylvans, Dwarves, Outlaws, Northerners, Undead, Chaos, Dark Elves

Archaic Era: Khthon, Phantoms, Despair, Primeval, South-Seas, Ukians, Northern Orcs

Era of Four Moons: Highlanders, Imperialists, Sea States, Darklanders, Dalefolk, Freemen, Pygmies, Whites

Era of the Future: Welkin, Brungar

BEEM: Anakes, Calidonians, Wood Warriors

Custom Factions: Yokai, Dark Legion, Desert Elves, Steelhive, Frozen

Era of Myths: Celestials, Devlings, Elementals, Therians, Vampires, The Warg, Windsong

Feudal Era: Aragwaithi, Ceresians, Clockwork Dwarves, High Elves, Orcish Khaganates

Imperial Era: Arendians, Cavernei, Issaelfr, Lavinian Legion, Marauders, Orcei Gladiatores, Sidhe

Era of Strife: Eventide, Triththa, Free Saurians, Eltireans, Minotaurs

Era of Magic: Barbarians, Dark Blood Alliance, Sky Kingdom, Kharos, Runemasters, Al-Kamija, Tharis, Destroyers

Mercenaries Era: Highlanders, Enchanters, Avians, Slavers, Mercenaries, Equestrians, Emperor's Guard, Oracles, Holy Order, The Cult, Fanatics, Tribalists, Hive, Infernai, Refugees, Blight

'''Git:''' [https://github.com/ProditorMagnus/Ageless-for-1-11 Ageless-for-1-11] and also for 1.12 and [https://github.com/ProditorMagnus/Ageless-for-1-14 1.14]

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=19&t=25274 Development and Feedback Thread]

==== Imperial Era (IE) ====

'''Description:''' One of the oldest maintained user eras, the Imperial Era brings together seven different factions in a completely re-imagined setting, the world of Orbivm, a very lethal world indeed. The era contains both mainline and development versions of each faction and can be used to play five campaigns, each featuring a different race.

'''Author:''' Orbivm Project (but really Turin)

'''Maintainer:''' UnwiseOwl

'''Status:''' Complete, 0.23

'''Faction Descriptions:'''

# Lavinian Legion - Based on the Roman Legion, the Lavinians have strong, versatile melee units in the legionaries and a range of support classes sourced from amongst the Lavinian population and various subjugated races. The legion are strong in the plains but weak when fighting in forested areas. The Lavinians are featured in "Fall of Silvium".
# Sidhe - The Sidhe are a group of forest-dwelling elves whose focus is stealth and fleet movement. Their mages are able to channel the lightning itself, and their various other units move almost as fast. The Sidhe feature in "Tale of Vaniyera".
# Marauders - Based on the Germanic peoples that eventually conquered Rome (hint, hint), the Marauders are equally as at home in the hills, forests and swamps of their homeland. Their hard-hitting melee units are practicalyl unstoppable during the night-time. The Marauders are the stars of the "Alfhelm the Wise" campaign.
# Orcei Gentorum - The orcs have been captured gladiators slaving away in the Lavinian arenas for generations.The life of an orc in Orbivm is harsh and brutal, just like the orcs themselves. The tale of the uprising of one such group of Orcs is told in "Up from Slavery".
# Cavernei - The Cavernei are a dwarvish race with similarities to the mainline Knalgans, but with a greater emphasis on the military uses of runesmithing. They get a campaign too, in "Gali's Contract"
# Issaelfr - The frost elves live on the fringes of the habitable lands of Evrosia, the main continent of Orbivm, and have become inured to difficult conditions and tuned in to their Fae natures. They don't have a campaign yet, but you could always write one.
# Arendians - The Arendians are horse-lords living on the Western steppes of Evrosia. A life of constant battle has developed a military-focused society where warriors are trained from a young age. They used to have a campaign, but it fell into disrepair a very long time ago.

'''Wiki:''' [[Orbivm]]

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?t=37920 Development and Feedback Thread]

==== Lonely Era (LE) ====

'''Description:''' The Lonely Era is a new collection of six selected superior solitary sides with interesting and unusual abilities, traits and attributes.

It has been extensively revised and rebalanced over the last few years from the original era and the constituent factions.

'''Author:''' Atreides. Based on work by Shield, Desert_Shyde, Brilliand, Stern, Cloud, Grigistian, mikoc5, Stopsignal, The_Gnat, Minnakht.

'''Maintainer:''' Atreides

'''Status 1.16:''' Finished

'''Faction Descriptions:'''

1) Santa's Helpers are his Elves as well as animated pine trees. They are an updated faction based on the Merry Christmas Campaign. Beware of Elves bearing gifts though, the presents are very distracting. They are unique in not having standard levels, they each can gain up to 4 special abilities via AMLA but always remain at level 1. Of course there are also Flying Reindeer and Christmas Seals.

2) Gremlins are an all teleporting race of elusive ethereal creatures. Individually fragile they work together using their tremendous mobility to swarm and overwhelm their enemies. Their mages are perhaps the ultimate glass cannons but if you can somehow keep one alive long enough it might even get to level 5 and become immortal.

3) Vaeringjar are a Viking faction allied with Wolfkin. The vikings eschew ranged weapons as well as sissy ideas like dodging blows but are a very, very hardy lot. They also have a unique herbalist unit that can inspire berserker rage in adjacent vikings for a turn. The wolfkin are lithe and armed with bows and teeth on the other hand. They are also very agile in contrast to the vikings. As nocturnal hunters they are devastating at night and almost helpless in the day.

4) Avians are cold loving, water hating bipedal birds. Their hollow bones and feathers make them vulnerable to fire and blunt weapons. They are unique in having cheap level 0 healers. Unusually their leaders are not drawn from the ranks but form a separate class only selectable as leaders. Tamed Albatrosses to patrol the awful waters.

5) The Deep Ones - Slimy, slippery, blasphemous fish-frogs of the nameless design - living and horrible - have now been sighted on the edge of Wesnoth. Mutants who slowly evolve from human to monster these creatures are nothing to be trifled with! An all water faction they are quite capable of holding their own against the landlubbers.

6) Jephrifs live far up in the sky, miles above land. Away from even the most basic things most other races take for granted, such as solid ground, their society developed to be quite alien indeed. In recent times, jephrifs began descending from the skies to participate in combat against other races - apparently for their own amusement, seeing life as a game.

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?t=42630 Development and Feedback Thread]

== Additional info ==
See also:
* [[Player_UMC_Reviews|Player UMC Reviews]]
* [[:Category:User-made Campaigns - Walkthroughs|Walkthroughs for user-made campaigns]]
* [//r.wesnoth.org/t37476 forum thread] for this page
* [[Guide_to_UMC_Content/1.12|Guide to user-made content (UMC) for Battle for Wesnoth 1.12]]
* [[Guide_to_UMC_Content/1.10|Guide to user-made content (UMC) for Battle for Wesnoth 1.10]]
* [//r.wesnoth.org/t36733 thread discussing 1.8 UMC that wasn't ported to 1.10]
* [//r.wesnoth.org/t48086 thread discussing all UMC that hasn't been ported to 1.14]
* [//addons.wesnoth.org the addon server]

Glossary

2024-10-21T20:09:48Z

Egallager: /* Wesnothian Acronyms */ add TTK (still not sure what the "gc" is for in "gcTTK", though...)

Use the following list to demystify the various (mostly wesnoth specific) terms and acronyms you may run into.



== Gaming Terms ==

; ability : A special game rule or capability applied to all units of the given unit type - for example every Elvish Shaman has the ability "heal". (See [[AbilitiesWML]] for creating abilities.)

; campaign: A sequence of scenarios with a connecting storyline. ([[MainlineCampaigns]], [[Guide_to_UMC_Content]], [[CampaignWML]])

; creeping biggerism: the tendency for sprite artists to make new sprites bigger and more detailed than the existing ones, leading to issues of scale.

; era: A set of factions available in multiplayer. You can download additional eras from the [[Guide_to_UMC_Content|add-on server]]. ([[EraWML]])

; faction: A set of units available to be plated as a side in multiplayer games. ([[EraWML|multiplayer_side WML tag]])

; fog of war: A scenario option; enemy units are displayed only when close to player's units

; mainline: A [[MainlineCampaigns|campaign]], multiplayer map, era, faction, image, or other resource that ships with the Wesnoth distribution. The opposite of "[[#U|UMC]]".

; scenario: A sequence of turns played on one map. ([[ScenarioWML]])

; shroud: A scenario option; the whole map is black at the beginning, only parts already "discovered" by the player are visible.

; team color (TColor, TC): A unit graphic done so that color of some unit part (e.g. clothes) reflects the team where unit belongs ([[Team Color Shifting]])

; trait: A random minor modification of a unit; it makes a unit different from other units of the same type. ([[UnitsWML|the trait tag]])

; UMC: "User-Made content" or "User-Maintained Content", campaigns and other material that does not ship with the game but is available for download from the [[Guide_to_UMC_Content|Wesnoth add-on server]].

; [[WesCamp|Wescamp]]: The (former) project for translating unofficial user-made campaigns

; zone of control (ZoC): game rule; when a unit moves to a hex adjacent to enemy unit, it usually cannot move further.

; zone-locked: said of a unit that has entered an enemy ZoC and therefore cannot move further (often just "zoced" for short).

== Wesnothian Acronyms ==

*AI - Artificial Intelligence (An 'AI side' is a side controlled by the computer)
*AMLA - After Maximum Level Advancement
*AoH - Age of Heroes
*BfM - Battle for Meridia
*BfW - Battle for Wesnoth (the name of the game)
*BWH - '''B'''een suggested before. '''W'''e think it's a good idea. '''H'''ope to add it eventually.
*CABD - Can Already Be Done, e.g., you can already create custom unit abilities via WML.
*CtH - Chance to Hit (also C2H)
*CtBH - Chance to Be Hit (also C2BH)
*CtK - Chance to Kill (also C2K)
*CtBK - Chance to Be Killed (also C2BK)
*FoW - Fog of War (i.e. fog)
*FFA - Free For All (playing a map with >2 players without teams)
*FPI - Frequently Posted Idea (read the [http://www.wesnoth.org/forum/viewtopic.php?t=1158|FPI Post] from the Ideas Forum)
*HANE—EtH - Hexes Are Not Evil - Embrace the Hex
*HAPMA - Hexes Are Possibly Miles Across
*HP - Hit points
*IIRWIIR - It Is Ready When It Is Ready
*IPF - [[ImagePathFunctions|Image Path Function]]
*KISS - Keep It Simple, Stupid: Applies to coding, not game rules (although indirectly it does): see [[WesnothPhilosophy]]
*MAI - Micro AI: see: [[Micro_AIs]]
*MP - Multiplayer or Movement Points
*MUB - Massive Unit Blobs
*N3T - No 3-Teams; A belief stating that contests between three equal and opposing forces are inherently unbalanced
*OAB - Options Are Bad; In reference to gameplay, not user interface options. Mostly used by Turin.
*OFWRA - Old Flame War Revival Alert; In other words, we have discussed this before and have no interest in discussing it again, especially if it got ugly
*OOS - Out Of Sync - an error generated by Wesnoth. OOS errors occur when game data for one player is different/incompatible from the others
*PoD - Paths of Daggers, the name of a 2v2 multiplayer map.
*RiPLIB - Reduction in Power when Leveling Is Bad: means that when a unit upgrades, at least one of its options should be strictly superior to the original unit. [http://www.wesnoth.org/forum/viewtopic.php?t=1423 Reference 1] / [http://www.wesnoth.org/forum/viewtopic.php?t=7205 Reference 2]
*RNG - Random Number Generator
*RPG - Role Playing Game - [http://www.wesnoth.org/forum/viewtopic.php?t=4385 1)] Wesnoth's experience system. <nowiki>2)</nowiki> An "RPG-style" game on the MP server means the primary focus will be walking your leader-units through a scripted storyline involving map exploration and lots of WML.
*RTS - Real Time Strategy Game - as opposed to a turn-based game like Wesnoth
*SLF - [[StandardLocationFilter]]
*SP - Single Player (Campaigns)
*SSF - [[StandardSideFilter]]
*SUF - [[StandardUnitFilter]]
*TBS - Turn Based Strategy Game, like Wesnoth
*ToD - Time of Day
*TTK - Time To Kill
*TWP - The Wesnoth Philosophy: [[WesnothPhilosophy]]
*UAPEB - Units Are Possibly Entire Battalions
*UMC - User Made Campaign or User Made Content (any add-on not packaged with Wesnoth)
*WICOT - WML is capable of this (the requested feature is already possible to script, so no need to hard-code it in C++)
*WINR - Wesnoth Is Not Realistic
*WIN_ - Wesnoth Is Not... (Warcraft, Lord of the Rings, medieval Europe, an RPG, a wargame, a war simulation, Fire Emblem, etc.)
*WML - Wesnoth Markup Language: [[ReferenceWML]]
*XP - Experience
*ZoC - Zone of Control

== Names of Mainline Campaigns and Scenarios ==

*AoI - ''An Orcish Incursion''
*DiD - ''Descent into Darkness''
*DM - ''Delfador's Memoirs''
*DW - ''Dead Water''
*EI - ''The Eastern Invasion''
*HttT - ''Heir to the Throne''
** BoP - ''Bay of Pearls''
** DD - ''Dwarven Doors''
** HotNE - ''Home of the North Elves''
** IotD - ''Isle of the Damned''
** RtW - ''Return to Wesnoth''
** SoE - ''Siege of Elensefar''
** SoF - ''Sceptre of Fire''
** TotC - ''Test of the Clans''
*IoM - ''Isle of Mists'' (MP, mainlined in 1.15)
*LoW - ''Legend of Wesmere''
*NR - ''Northern Rebirth''
*SoF - ''Sceptre of Fire''
*SotA - ''Secrets of the Ancient''
*SotBE - ''Son of the Black Eye''
*TB (or AToTB) - ''A Tale of Two Brothers''
*THoT - ''The Hammer of Thursagan''
*TRoW - ''The Rise of Wesnoth''
*TSG - ''The South Guard''
*UtBS - ''Under the Burning Suns''
*WC - ''World Conquest'' (MP, mainlined in 1.15)
*WoF - ''Winds of Fate'' (formerly WoV for ''Wings of Victory'' or ''Wings of Valor'')

== Unofficial Campaigns ==

*ANO - ''A New Order''
*AotDS - ''Aria of the Dragon Slayer''
*ARL - ''A Rough Life''
*ASoF - ''A Song of Fire''
*AtS - ''After the Storm''
*BCoA - ''Black Cross of Aleron''
*BMR - ''Bad Moon Rising''
*BW - ''Brave Wings''
*CCamp - ''Custom Campaign''
*FoaP - ''Fate of a Princess''
*FTC - ''Forward They Cried''
*FtF - ''Flight to Freedom''
*Gns - ''Genesis''
*HoI1 - ''Hero of Irdya - Book I''
*IftU - ''Invasion from the Unknown''
*IQ - ''Inky's Quest''
*LotI - ''Legend of the Invincibles''
*SE - ''Saving Elensefar''
*SfF - ''Struggle for Freedom''
*TBC - ''The Beautiful Child''
*TDH - ''The Dark Hordes''
*TEG - ''The Earth's Gut''
*TFE - ''The Final Exam''
*TLU - ''To Lands Unknown''
*TSL - ''The Silver Lands''
*TSoG - ''The Sojournings of Grog''
*WotJ - ''War of the Jewel''

<div id="Unit_Names"></div>

== Unofficial MP Eras ==

*AE - ''Ageless Era/Archaic Era''
*ANLE - ''A New Land Era''
*EEaW - ''17th Century Eastern Europe at War''
*EoM - ''Era of Myths''
*EoMa - ''Era of Magic''
*GSE - ''Great Steppe Era''
*IE - ''Imperial Era''
*RE - ''Rashy Era''
*RotL/Rotl - ''Reign of The Lords''
*WoL - ''War of Legends''

== Unit Jargon ==

*bird - usually Gryphon Rider/Master (knalgans), or occasionally a Falcon or Eagle Rider from the [//units.wesnoth.org/1.14/Extended_Era/en_US/era_extended_37.0.0.0.html Extended Era] Aragwaith and Kalifa factions.
*DA - Dark Adept (undead)
*fish - Merman (loyalists or rebels) or Naga Fighter (northerners)
*frog - a Saurian, especially "magic frog" for an Augur
*gobo - An affectionate, if somewhat derogatory term for the Goblin Spearman
*gunner - Dwarvish Thunderer/Thunderguard/Dragonguard (knalgans)
*HI - Heavy Infantryman (loyalists)
*MoL - Mage of Light (loyalists or rebels)
*pyro - Unit in the Drake Burner line
*Ulf - Dwarvish Ulfserker (knalgans)
*WC - Walking Corpse (undead)
*zombie - Walking Corpse

== General Acronyms ==

*AFaICT - As Far as I Can Tell (A statement with a disclaimer on truthfulness)
*AFaIK - As Far as I Know (A statement with a disclaimer on truthfulness)
*AFaIU - As Far as I Understand (likewise)
*AfK - Away from the Keyboard
*ASaP - As Soon as Possible
*BRB - Be Right Back
*BtW - By the Way (A statement with a disclaimer on relevance)
*DTRT - Do The Right Thing (expectation for how something should work)
*EV - Expected Value
*FTR - For The Record
*FUBAR - F***ed up beyond all repair / reason
*FWIW - For what it's worth
*FYI - For Your Information
*GG - Good Game (a common courtesy to say after a multiplayer game; alternatively "GGWP" for "Good Game, Well Played")
*GtG - Got to Go
*IANAL - I Am Not A Lawyer (A disclaimer that a statement may not constitute legal advice.)
*IDK - I Don't Know
*IIRC - If I Recall/Remember Correctly (A statement with a disclaimer on truthfulness)
*IIUC - If I Understand Correctly (Similar to IIRC, but not implying that the speaker once knew with certainty.)
*IMHO - In My Humble Opinion (A statement with a disclaimer on objectiveness) (can also be read as "In My Honest Opinion")
*IMO - In My Opinion
*IYSWIM - If You See What I Mean (A statement seeking agreement)
*LGTM - Looks Good To Me (used by maintainers when approving Pull Requests on GitHub)
*LMAO - Laughing My A** Off
*LTNS - Long Time No See
*OMG - oh my god(s)
*OP - either "OverPowered", "Original Post", or "Original Poster", depending on context.
*OT - Off Topic: can refer either to the forum category ([http://www.wesnoth.org/forum/viewforum.php?f=11]) or to spam
*OtOH - On the Other Hand (A contrast)
*PR - Pull Request (in the context of contributing to a project like Wesnoth on GitHub; other projects that use other issue trackers use it to mean Problem Report instead)
*QFT - Quote For Truth
*RotFL - Rolling on the Floor Laughing; also RoFL
*RtFM - Read the F***ing Manual
*TTYL - Talk To You Later
*YMMV - Your Mileage May Vary (a disclaimer allowing for subjectivity)

[[Category:World of Wesnoth]]

AiWML

2024-10-21T06:38:03Z

Egallager: /* Filtering Combat with the attacks Aspect */ make "See Also" its own section

{{WML Tags}}

== Customizing the Default AI Using WML ==

This page describes how the behavior of the default (RCA) AI can be customized using simple WML commands. The descriptions below assume a basic understanding of how the RCA AI evaluates moves, what '''candidate actions''', '''aspects''' and '''goals''' are, and how they interact. If you do not know these things yet, check out the [[RCA AI]] page.

This page contains:
* Descriptions of the aspects and goals of the default AI
* Instructions for setting them up at the beginning of the scenario in a [side] tag

This page does '''not''' contain:
* Instructions for [[LuaAI#Dynamic_Lua_Aspects|setting up aspects dynamically using Lua]].
* Instructions for [[Modifying_AI_Components#Modifying_Standard_Aspects|changing aspects and goals mid scenario]], although for many of them (for example, for all [[Wesnoth_AI_Framework#The_.5Bai.5D_Tag_.E2.80.94_Aspects|standard aspects]]) the methods are almost identical
* Instructions for some of the [[Modifying_AI_Components|more complex AI customization tasks]].
* Anything about [[Micro_AIs|MicroAIs]]
* [[AI_Recruitment|Advanced recruitment details]]

== Defining Aspects and Goals of the RCA AI ==

[[RCA_AI#Use_of_Aspects_in_the_RCA_AI|Aspects]] and [[RCA_AI#Use_of_Goals_and_Targets_in_the_RCA_AI|goals]] of the [[RCA_AI|default (RCA) AI]] can be defined at the beginning of a scenario with [ai] tags inside the [side] tags. They are used to customize certain aspects of the AI. The [ai] tag, when used for this purpose, takes the [[#List_of_AI_Aspects|aspects themselves]] as arguments, as well as the following general keys:
* '''time_of_day''': (string) The time(s) of day when the AI should use the parameters given in this [ai] tag. Possible values are listed in [https://github.com/wesnoth/wesnoth/blob/master/data/core/macros/schedules.cfg data/core/macros/schedules.cfg] (see also [[TimeWML]]). Note that it is the ''id'' (not the ''name'') of the time of day that needs to be used here. Also note that this aspect did not work for a long time due to a bug (versions 1.7.4 - 1.11.6). It has been fixed for BfW 1.11.7.

* '''turns''': (string) During which turns the AI should use the parameters given in this [ai] tag. This takes the same syntax of dashes (-) and commas (,) as is described under Filtering Locations in [[FilterWML]], except of course they apply to turns not locations.

* '''ai_algorithm''': (string) Allows an alternate AI algorithm (cannot be created with WML) to be used. Besides the default, the game only comes with ''idle_ai'', which makes the AI do nothing and can be used to create a passive, unmoving side. Cannot be applied only to a set of turns or a given time of day using the keys ''turns'' and ''time_of_day'', but must be given either in an [ai] tag without the aforementioned keys or in the [side] tag outside all [ai] tags. {{DevFeature1.13|5}} In 1.13, the meaning of '''ai_algorithm''' has changed and no longer selects a native AI that's built into the engine, as the RCA AI has now become the core system and no alternatives exist anymore. Instead, it selects a predefined ''[ai]'' definition, such as those defined in ''data/ai/ais''. Since these are defined in WML, you can easily build your own.

An example of a simple use of the [ai] tag to set AI parameters (aspects) is

<syntaxhighlight lang=wml>
[ai]
time_of_day=dusk
aggression=0.99
caution=0.01
[avoid]
[filter]
side=2,3
[/filter]
radius=2
[/avoid]
[/ai]
</syntaxhighlight>

'''Important Note:''' If you use a different AI engine ([[FormulaAI]] or [[LuaAI]]) for a side, setting aspects in the [side] tag might not work due to a bug in the AI setup mechanism (or it might; there's no general rule that catches all cases). In that case, you might have to use [modify_side][ai] in a ''prestart'' or ''start'' event instead. If unsure, you can use <code>:inspect</code> in debug mode to verify whether an aspect was changed successfully.

==List of AI Aspects==

'''Note:''' Only one instance of each aspect will be active for a side at any time. Where multiple instances of the same aspect are included in an [ai] tag, the last whose conditions (time of day, turns, etc.) match will be the only one that applies.

* {{anchor|advancements|'''advancements'''}}: (string) Defines a list of unit types to which AI units can advance. If a unit type is listed here, units that can advance to this type will only advance to this type, even if they have, in principle, several advancement options. As an example, if this aspect is set to 'Javelineer,Elvish Hero', then all Spearmen advance to Javelineers, and all Elvish Fighters advance to Elvish Heroes. All other units follow their usual advancement choices as determined by the AI. '''Important notes:'''
** This is a simplified version of the more complex (and arguably more useful) application of a dynamic Lua ''advancements'' aspect, as described [[LuaAI#The_advancements_Aspect|here]].
** The ''advancements'' aspect only takes effect during the AI turn, that is, on offense only, not on defense.
** Listing more than one advancement unit type for a given unit still results in only one of the types being used (generally the one listed last).

* {{anchor|aggression|'''aggression'''}}=0.4: (double: ranging from -infinity to 1.0) This key affects how the AI selects its attack targets. The higher the value, the more likely the AI is to attack even if odds are not in its favor. The description below applies as written to the ''combat'' CA only, but aggression is taken into account by the ''high_xp_attack'' and ''spread_poison'' CAs as well (as of '''Wesnoth 1.13.5''' and '''1.15.3''' respectively).
** '''Important: do not set aggression to values greater than 1''' as this makes the AI ''prefer'' attacks in which it receives more damage (see below) unless that is specifically the effect you want to achieve.
** In the attack evaluation, each attack (this includes attack combinations of several AI units against the same enemy unit) is assigned a score. The attack with the highest score is done first. Then the next attack is evaluated, until no attack with a score greater than 0 is found any more. (Note that this ''attack score'' is different from the ''combat CA score'', which is always 100,000 as long as an individual attack score >0 is found. The combat CA score is zero if the highest attack score is <=0).
** The attack score is a complex combination of many different aspects of the attacks. Positive (additive) contributions to the score are things like the value (cost and XP) of the target, the chance to kill the target, whether it is already wounded, how much damage the attack is likely to inflict, etc. Negative (additive) factors include how much damage the AI's units are likely to take, how valuable they are, how exposed they will be after the attack, etc. There are also multiplicative factors that are used if the attack target is a threat to the AI's leader etc.
** All the negative contributions to the score are multiplied by '(1-aggression)'. This means that:
*** If 'aggression=1', no negative contributions are added to the score. Thus, the AI disregards damage done to its own units and selects attacks based solely on the damage it can do to enemy units. If the AI can inflict 1 damage and take 0, or inflict 2 damage and take 20, it will take the latter option.
*** The smaller the value of ''aggression'', the more weight is put on value of and potential damage to the AI's units as compared to the attack target.
*** Roughly speaking, 'aggression=0' results in the AI valuing its units approximately as much as the enemy units. This is not a one-to-one relation, but can be used as an approximate guideline.
*** Very large negative values of ''aggression'' mean that the value of the AI's units is much more important than that of the enemy units. As a result, the AI never attacks unless it will receive no damage in exchange.
*** The rating for damage received in an attack actually becomes a positive contribution to the score for values of aggression larger than 1. This usually does not result in sensible behavior and values greater than 1 should therefore not be used.
** Note: ''aggression'' is always set to 1.0 for attacks on units that pose a direct threat to the AI's leader. Currently this only means units adjacent to the leader.

*{{anchor|allow_ally_villages|'''allow_ally_villages'''}}=no (bool) {{DevFeature1.17|6}} Affects ''retreat-injured'' CA only. Normally, the AI is not allowed to take villages from an ally. If this is set to 'yes', the AI may retreat injured units to allied villages (and thereby capture them).

*{{anchor|attacks|'''[attacks]'''}}: Filters the units considered for combat, both on the AI and the enemy sides. Applies to the ''combat'', ''high_xp_attacks'' and ''spread_poison'' CAs only. It cannot be set in the same way as the other aspects and is therefore described in a [[#Filtering_Combat_with_the_attacks_Aspect|separate section]] below.

* {{anchor|avoid|'''[avoid]'''}}: Makes the AI avoid specific locations. The AI never moves a unit to these locations except for trying to move its leader to a keep or toward [leader_goal]s, and thus applies to all CAs except ''move-leader-to-goals'' and ''move-leader-to-keep''.
** '''[[StandardLocationFilter]]''': The locations for the AI to avoid. Do not use a [filter_location] tag.
**'''Note:''' Only one instance of an [avoid] aspect will be active for a side at any time. Where multiple instances are included in an [ai] tag, the last whose conditions (time of day, turns, etc.) match will be the only one that applies.

* {{anchor|caution|'''caution'''}}=0.25: (double) Defines how cautious the AI is in several ways. It determines whether the leader should move toward [leader_goal], if attacks are worth moving onto less favorable terrain, whether units should retreat, and whether the AI should move units toward targets individually, as groups or not at all. Affects several CAs (listed in the order of their [[RCA_AI#The_Candidate_Actions_.28CAs.29_of_the_main_loop_Stage_in_the_RCA_AI|evaluation scores]]):
** ''Move-leader-to-goals CA'': If ''max_risk'' is not set in [leader_goal], its default value is '1-caution'. This determines whether the leader takes the next step toward his goal. See description of [leader_goal].
** ''Combat'' CA:
*** During the evaluation of attacks, the AI considers whether the attacking units could get onto more favorable terrain if they didn't attack but moved somewhere else instead. The difference between the two terrain ratings, together with a number of other factors, determines the "exposure" rating of the units. This exposure is then subtracted from the 'attack score' as described for ''aggression'' above.
*** The exposure rating also contains a multiplication by ''caution'', meaning that 'caution=0' results in exposure not being taken into account, and that it becomes more and more important for larger values. In other words, the higher the values of ''caution'', the more reluctant is the AI to attack from unfavorable terrain. (Note that exposure is one of the negative contributions to the attack score as described for ''aggression'', and therefore is also ignored if 'aggression=1' is set.)
*** If the AI leader is used in an attack, the AI ''always'' uses 'caution=2' for the evaluation of that attack.
** ''Retreat'' CA: {{DevFeature1.15|3}} This CA has been removed.
*** If caution is greater than 0, there is an evaluation of forces for the map location a unit stands on. This is basically the sum of damage that can be done to that location by either side, reduced by terrain defense and relative hitpoints if attackers don't have full health. A retreat takes place, if <tt>caution × their_power > our_power</tt>. There is also a terrain factor involved if the attacker is not on optimal terrain, similar to the exposure described above for the combat CA.
*** So let's say the AI has its default caution of 0.25. Then the enemy forces have to be at least 4 times as strong before the unit retreats. For a caution of 1, as soon as the enemy is stronger, the unit retreats.
*** The AI never retreats if caution is set to 0 or lower.
** ''Move-to-targets'' CA:
*** If grouping for the AI is enabled and the path along which to move toward a target is considered to be dangerous, caution has an influence, too. "Dangerous" mainly means that there is a good chance for a unit to be killed if it's by itself. In that case, the AI compares its units to the enemy units and based on the result moves forward or not. All units that can reach the next location of the move are considered. The formula for deciding whether to move toward the target as a group is <tt>our_strength / their_strength > 0.5 + caution</tt>. If this condition holds true, units are moved toward the goal as a group, otherwise they try to group together in a location favorable for a attack on the enemy during the next turn.
***So if caution is 0.5, the AI side needs to be at least as strong as the enemy. If it is 0, the AI moves toward the target, even if the enemy is up to twice as strong as the AI. Setting caution to 1.5 means the AI needs to be at least twice as strong as the enemy.
*** The AI also considers retreating units during the move-to-target phase based on criteria similar to those for the retreat CA.

* {{anchor|grouping|'''grouping'''}}="offensive": (string) How the AI should try to group units. Applies to ''move-to-targets'' CA only. Possible values:
** ''offensive'': Makes the AI try to group units together before attacking.
** ''defensive'': Makes the AI group units together very conservatively, only advancing them much beyond its castle if it has overwhelming force.
** ''no'': Makes the AI use no grouping behavior.

* {{anchor|leader_aggression|'''leader_aggression'''}}="-4.0": Exactly as aggression, but for units which can recruit. Applies to ''combat'' CA only. Note that the move-leader-to-keep CA has a higher score than the combat CA. A leader therefore usually only attacks if he is on his keep at the beginning of the turn, otherwise he moves toward the closest keep instead, even with ''leader_aggression=1''.

* {{anchor|leader_goal|'''[leader_goal]'''}}="": Makes the AI try to move its leader to a specific location. Applies to ''move-leader-to-goals'' CA only.
** '''x''', '''y''': The location toward which the AI should move its leader.
** '''auto_remove'''=no: (bool) If 'no' (default), the AI moves the leader to the goal, after which he stays there until [leader_goal] is [[Modifying_AI_Components#Modifying_Standard_Aspects|removed manually]]. If 'yes', the leader_goal is removed upon the leader getting there. Important: this ''only'' works if ''id'' is set correctly (see the next bullet).
** '''id'''="": (string) An internal id key of the [leader_goal] tag. An id is required for ''auto_remove'' to work. However, setting this id does not automatically set the id of the [leader_goal] [[Wesnoth_AI_Framework#The_.5Bai.5D_Tag_.E2.80.94_Aspects|facet]]. Thus, in principle for this to work, you need to set the id of the facet as described [[Modifying_AI_Components#Modifying_Standard_Aspects|here]] ''and'' set the ''id'' key in [leader_value] to the same value. Since you are probably only going to use one [leader_goal] tag at a time, there is a much simpler way: setting 'id=0' (which refers to the first facet) or 'id=*' (which means all facets) in [leader_goal] allows ''auto_remove'' to work without the extra step of setting the facet id. {{DevFeature1.13|5}} Setting this now also sets the id of the [leader_goal] facet, allowing auto_remove to work with multiple leader goals without using the fully-expanded aspect syntax.
**'''max_risk'''=1-caution: (double: meaningful values are >=0) How much risk the leader may be exposed to by moving toward the goal. For evaluating this risk, the AI multiplies the leader's hitpoints by this number. The leader is only moved toward the goal if the resulting value is larger than the expected damage the leader is going to take during the next enemy turn. Thus, 'max_risk=0' means he will only move if no attack on him is possible at the target hex of the move. 'max_risk=1' (or larger) results in him moving even if he's almost certainly going to die.

* {{anchor|leader_ignores_keep|'''leader_ignores_keep'''}}=no: (bool) Set to 'yes' for this aspect to apply to all leaders of a side. {{DevFeature1.15|3}} In addition to 'yes/no', the aspect can now also be set to a comma-separated list of unit ids. The aspect then only applies to leaders with ids matching an id on that list. Setting leader_ignores_keep for some or all leaders means that:
** The affected AI leaders do not move to the closest keep at the beginning of the turn. Instead, they participate in the ''move_to_targets'' candidate action (and all other CAs in which they already participated anyway, of course). Thus, these leaders behave in the same way as any other unit of the AI side.
** This also means that these AI leaders do not recruit except on the first turn if they start on a keep, or if they accidentally end up on a keep. Thus, if a leader is supposed to recruit first and then participate in the action, leader_ignores_keep should be set to 'no' at the beginning of the scenario, and be changed to 'yes' in an event later.

* {{anchor|leader_value|'''leader_value'''}}=3: (double) A number 0 or higher which determines the value of enemy leaders as [[#AI_Targets_and_Goals|targets]]. Affects ''move-to-targets CA'' only (and therefore specifically does not apply to attacks).

* {{anchor|passive_leader|'''passive_leader'''}}=no: (bool) If 'yes', the AI leader never moves or attacks, not even to move back to the keep (unless 'passive_leader_shares_keep=yes' is set) or to attack adjacent units, except to obey [leader_goal]s. Affects all CAs except ''recruitment'' and ''move-leader-to-goals''. {{DevFeature1.15|3}} In addition to 'yes/no', the aspect can now also be set to a comma-separated list of unit ids. The aspect then only applies to leaders with ids matching an id on that list.

* {{anchor|passive_leader_shares_keep|'''passive_leader_shares_keep'''}}=no: (bool) If 'yes', lets the AI leader moves off the keep to share it with allied leaders (if they can reach it next turn) if 'passive_leader=yes' is set. He also returns to keep to recruit when possible and attacks adjacent enemy units. {{DevFeature1.15|3}} In addition to 'yes/no', the aspect can now also be set to a comma-separated list of unit ids. The aspect then only applies to leaders with ids matching an id on that list.

*'''recruitment_diversity''', '''recruitment_instructions''', '''recruitment_more''', '''recruitment_pattern''', '''recruitment_randomness''', '''recruitment_save_gold''': These aspects can be used to customize recruiting with the new recruitment CA introduced in Wesnoth 1.11. They are described on a [[AI_Recruitment|separate page]].

*{{anchor|retreat_factor|'''retreat_factor'''}}=0.25 (double) {{DevFeature1.15|11}} Affects ''retreat-injured'' CA only. Determines how injured AI units have to be before they attempt retreating. This is approximately the fraction of the units' hitpoints, but other factors play a role also, such as the terrain the units are on, and leaders and poisoned units retreat somewhat earlier. Setting this to 0 (or negative values) disables retreating. Note that even setting this to very large values still requires units to be somewhat injured before they start retreating.

*{{anchor|retreat_enemy_weight|'''retreat_enemy_weight'''}}=1.0 (double) {{DevFeature1.15|11}} Affects ''retreat-injured'' CA only. When deciding where to retreat to, the AI considers how much healing a location provides and weighs it against the threat of all the enemies that can get there (balanced by the own units that can get there). In this evaluation, it multiplies the enemy threat rating by ''retreat_enemy_weight'', meaning that the larger its value is, the more a unit tries to move away from enemies. There are three regimes for this aspect:
** Positive values: Only locations that provide healing (both from terrain and from adjacent healers which have no MP left) are considered. For regenerating units, all hexes are treated as if they provide healing.
** Zero: Enemy threats are ignored
** Negative values: All hexes are considered for retreating. The enemy threat rating is multiplied by the absolute value of the aspect value. Thus, if very negative values are used (e.g. -100), this can be used to make units run away from enemies with little consideration for anything else.

* {{anchor|scout_village_targeting|'''scout_village_targeting'''}}=3: (double) The AI multiplies the value of village [[#AI_Targets_and_Goals|targets]] for scouts by this value. Affects ''move-to-targets'' CA only.

* {{anchor|simple_targeting|'''simple_targeting'''}}=no: (bool) If 'yes', the AI moves its units toward [[#AI_Targets_and_Goals|targets]] one by one (sequentially), without considering whether another unit might be better suited for the current move or target. If 'no' (the default), all units are considered for all targets. This is slower, but might result in better moves. Affects ''move-to-targets'' CA only.

* {{anchor|support_villages|'''support_villages'''}}=no: (bool) Trigger a code path that tries to protect those villages that are threatened by the enemy. This seems to cause the AI to 'sit around' a lot, so it's only used if it's explicitly enabled. Affects ''move-to-targets'' CA only.

* {{anchor|village_value|'''village_value'''}}=1: (double) A number 0 or higher which determines how much the AI tries to go for villages as [[#AI_Targets_and_Goals|targets]]. Affects ''move-to-targets'' CA only.

* {{anchor|villages_per_scout|'''villages_per_scout'''}}=4: (int) A number 0 or higher which determines how many scouts the AI recruits. If 0, the AI doesn't recruit scouts to capture villages. Affects ''recruitment'' CA only.

=== Removed AI Aspects ===

The following AI parameters (aspects) can still be set, their values can be retrieved, and they can be viewed in the gamestate inspector dialog, but they do not have an effect in the RCA AI code any more. Some other parameters will also likely be removed in the future. We will update this list accordingly. {{DevFeature1.13|5}} Except for attack_depth, these have now all been removed. {{DevFeature1.15|0}} attack_depth is now removed as well.

* '''attack_depth'''=5: (int)
* '''number_of_possible_recruits_to_force_recruit'''=3.1: (double)
* '''recruitment''': This aspect was used to customize the recruitment of the old default AI (the one used before the RCA AI). This recruitment code is not used in the RCA AI any more. Setting recruitment instructions with this aspect is therefore meaningless. Use the '''recruitment_instructions''' aspect instead.
** It is, in principle, still possible to use this aspect together with the [[Wesnoth_AI_Framework#Recruitment_Stage|recruitment stage]], but this is discouraged for the reasons given at this link.
* '''recruitment_ignore_bad_combat'''=no: (bool)
* '''recruitment_ignore_bad_movement'''=no: (bool)

==AI Targets and Goals==

AI targets are used in the ''move-to-targets'' candidate action (CA) to move the AI's units toward selected units or locations. The AI engine automatically selects all enemy leaders, enemy units that pose a threat to the AI leader and unowned or enemy-owned villages as targets and assigns them certain [[RCA_AI#RCA_AI_Aspect_and_Goal_Configuration|base values]]. Additional targets can be defined using the [goal] tag.

It is '''very important''' to realize that these targets apply to the ''move-to-targets'' CA only and have no influence on other CAs. In particular, they have no effect whatsoever on which enemies the AI attacks. This is often a source of confusion for scenario creators. More background information on RCA AI targets and goals can be found [[RCA_AI#Use_of_Goals_and_Targets_in_the_RCA_AI|here]]. The sections below only describe how to set up goals in order to add targets for the ''move-to-targets'' CA.

===The [goal] Tag===

The [goal] tag defines units or locations as [[#AI_Targets_and_Goals|move targets]] (not attack targets!) for the AI. '''Applies to ''move-to-targets'' CA only'''. <-- That is '''extremely important''' to understand, in particular the fact that the [goal] tag has '''no influence whatsoever on attacks'''.

The following keys/tags can be used:
* '''name'''="target": (string) The following values are possible and result in different types of targets, as shown in the examples below:
** ''target'': The (default) target goal specifies target units (not necessarily enemy units) toward which the AI should move its units. {{DevFeature1.13|5}} target_unit is now a synonym for this.
** ''target_location'': Specifies target locations toward which the AI should move its units.
** ''protect_location'': Specifies locations that the AI should protect. Enemy units within the specified distance (''protect_radius'') of one of these locations are marked as targets with the provided value. Note that the AI will ''not'' station any units around the protected locations. It will only send units toward enemy units that come within ''protect_radius'' of them.
** ''protect_unit'': Specifies units (of all sides) that the AI should protect. Enemy units within ''protect_radius'' of one of these units are marked as targets with the provided value. Note once again that the AI will not place units around the protected units if there are no enemies nearby.
** ''protect_my_unit'': ('''deprecated''') <s>Specifies units from the AI's own side that the AI should protect. (This is basically the ''protect_unit'' goal with an implied ''side='' in the filter, restricting matching units to the AI's side.) Enemy units within ''protect_radius'' of one of these units are marked as targets with the provided value. Note once again that the AI will not place units around the protected units if there are no enemies nearby.</s>
** ''lua_goal'': A dynamically calculated goal written in Lua. See [[LuaAI#Lua_Goals_and_Targets|here]] for details on how this works.

* '''[criteria]'''="": Contains a [[StandardUnitFilter]] (for ''target'', ''protect_unit'' or ''protect_my_unit'') or [[StandardLocationFilter]] (for ''target_location'' or ''protect_location'') describing the targets.

* '''value'''=0: (double) The value of the goal.

* '''protect_radius'''=20: (int) The protection radius. Applies to ''protect_location'', ''protect_unit'' and ''protect_my_unit''.

* '''id'''="": (string) Optional ID used for [[Modifying_AI_Components#Modifying_Goals|modifying the goal]].

===Examples of [goal] Tag Usage===

'''target:'''
<syntaxhighlight lang='wml'>
[ai]
[goal]
[criteria] #NOTE: this is a SUF, because we're targeting a unit
side=3
[/criteria]
value=5
[/goal]
[/ai]
</syntaxhighlight>

'''target_location:'''
<syntaxhighlight lang='wml'>
[ai]
[goal]
name=target_location
[criteria] #NOTE: this is a SLF, because we're targeting a location
x,y=42,20
[/criteria]
value=5
[/goal]
[/ai]
</syntaxhighlight>

'''protect_location:'''
<syntaxhighlight lang='wml'>
[ai]
[goal]
name=protect_location
[criteria] #NOTE: this is a SLF, because we're protecting a location
x,y=42,20
[/criteria]
protect_radius=16
value=5
[/goal]
[/ai]
</syntaxhighlight>

'''protect_unit:'''
<syntaxhighlight lang='wml'>
[ai]
[goal]
name=protect_unit
[criteria] #NOTE: this is a SUF, because we're protecting a unit
side=3
[/criteria]
protect_radius=16
value=5
[/goal]
[/ai]
</syntaxhighlight>

'''How to use protect_unit to protect the own leader''' (We are side 2)
<syntaxhighlight lang='wml'>
[ai]
[goal]
name=protect_unit
[criteria]
side=2
canrecruit=yes
[/criteria]
protect_radius=8
value=5
[/goal]
[/ai]
</syntaxhighlight>

=== Deprecated AI Targeting Aspects ===

The following AI targeting parameters currently still work, but have been superseded by the [[#The_.5Bgoal.5D_Tag|[goal] tag]]. They should not be used any more as they will likely be removed at some point. These tags only apply to the move-to-targets CA.

* '''[target]'''="": '''Deprecated'''. Any number of [target] tags can be used to set targets for the AI. For anything related to 'values', set them relative to other targets. An AI is willing to dedicate twice as many resources and travel twice as far to get to a target worth '2.0' as for a target worth '1.0'. Applies to move-to-targets CA only.
** '''[[StandardUnitFilter]]''': Do not use a [filter] tag.
** '''value'''=1: (double) A number greater than 0 (default=1) which determines how much the AI tries to move toward units which pass the filter.

* '''[protect_location]'''="": '''Deprecated'''. Gives the AI a location to protect. Note that the AI does ''not'' station any units around the location, it only sends units to attack any enemy units that come within the guarding radius of the target. Applies to move-to-targets CA only.
** '''x''', '''y''': Standard coordinates. These indicate the location the AI is protecting.
** '''radius''': The radius around it to protect (0 indicates a single hex). {{DevFeature1.13|5}} This key has been changed to protect_radius, though it's preferred to change old code to use the [goal] tag instead.
** '''value''': The importance of protecting this location.

* '''[protect_unit]'''="": '''Deprecated'''. Gives the AI a set of units to protect. Note once again that the AI does not place units around the protected units if there are no enemies nearby. Applies to move-to-targets CA only.
** '''[[StandardUnitFilter]]''': The unit(s) to protect. Do not use a [filter] tag.
** '''radius''': The radius around it to protect (0 indicates a single hex). {{DevFeature1.13|5}} This key has been changed to protect_radius, though it's preferred to change old code to use the [goal] tag instead.
** '''value''': The importance of protecting this unit.

* '''protect_leader'''=2.0 and '''protect_leader_radius'''=10: '''Deprecated'''. Target any enemy units that come within 'protect_leader_radius' of the AI leader with a value of 'protect_leader'. Applies to move-to-targets CA only.

== Filtering which Units Participate in which Actions==

{{DevFeature1.15|3}}

Each [[RCA_AI#The_Candidate_Actions_.28CAs.29_of_the_main_loop_Stage_in_the_RCA_AI|candidate action of the default AI]] can be restricted to apply to only a subset of the AI units. This is done by adding a '''[filter_own]''' tag to the '''[[Wesnoth_AI_Framework#The_.5Bai.5D_Tag_.E2.80.94_Candidate_Actions|[candidate_action]]]''' tag definition.

Typical use cases:
* Restricting an action to certain units so that other units are not used to this. For example, village grabbing could be restricted to scout units only, so that slower units do not take detours on their way toward the enemies. See the example below.
* Excluding units from a certain action in order to have them available for other actions afterward. For example, one might want to add a custom candidate action which moves healers behind injured units (or use the existing [[Micro_AIs|Micro AI]] for this). Ideally, this should happen after ''all'' other units have moved, specifically also after the move-to-targets candidate action (MtT CA) is done. In the default setting, however, the MtT CA would also move the healers. Thus, we would want to exclude them using a '''[filter_own]''' tag.
* Adding two instances of the same candidate action with different scores to force the order in which units participate in this action. For example, one could add another instance of the move-leader-to-keep CA with a '''[filter_own]''' tag restricting it to one leader, in order to make this leader move to a keep (and therefore recruit) first.

Note that for the combat AI, using the attacks aspect to filter units as described in the next section '''is slightly more efficient'''. Thus, that should be the preferred method if there are many units on the map.

Example:
<syntaxhighlight lang='wml'>
[candidate_action]
id=villages
engine=cpp
name=ai_default_rca::get_villages_phase
max_score=60000
score=60000
[filter_own]
type=Wolf Rider
[/filter_own]
[/candidate_action]
</syntaxhighlight>

== Filtering Combat with the ''attacks'' Aspect==

The ''attacks'' aspect lets us filter the units considered by the ''combat'', ''high_xp_attacks'' and ''spread_poison'' candidate actions. Units on the AI side can be selected with the '''[filter_own]''' tag and enemy units are filtered via '''[filter_enemy]''', both of which take a [[StandardUnitFilter]]. Only units defined in these tags are considered as attacker/target pairs. To define, for example, an ''attacks'' aspect in which units from the elvish sorceress line are the only attackers, and undead units are the only targets, use
<syntaxhighlight lang='wml'>
[ai]
[aspect]
id=attacks
[facet]
invalidate_on_gamestate_change=yes
[filter_own]
type=Elvish Sorceress,Elvish Enchantress,Elvish Sylph
[/filter_own]
[filter_enemy]
race=undead
[/filter_enemy]
[/facet]
[/aspect]
[/ai]
</syntaxhighlight>
Several important notes:
* The ''attacks'' aspect is a ''composite'' aspect and cannot be defined using the simple syntax of the other ''standard'' aspects. See [[Wesnoth_AI_Framework#The_.5Bai.5D_Tag_.E2.80.94_Aspects|here]] for a description of the syntax of the example.
* This only works if <code>invalidate_on_gamestate_change=yes</code> is set. The reason is that the ''attacks'' aspect internally contains information about all available attacker/target pairs. These need to be recalculated after each move. This is explained [[Wesnoth_AI_Framework#Some_more_on_the_invalidation_keys|here]].
* If [filter_own] or [filter_enemy] are omitted, the selection defaults to all units of the respective sides.
* '''Most importantly''': The above example results in sorceress-line vs undead attacks being the only attacks done by the AI. No other attacks are executed, no matter how advantageous their outcomes may be. There is no simple way around that, but it can be accomplished by one of the following means:
** Setting up the [filter_own] or [filter_enemy] [[StandardUnitFilter]]s to adapt dynamically to the situation on the map.
** Adding a Lua candidate action which dynamically adjusts the aspect depending on the current situation on the map. An example of dealing with this is given in the [[Micro_AIs#Micro_AI_Test_and_Demo_Scenarios|Micro AI test scenario]] [https://github.com/wesnoth/wesnoth/blob/master/data/ai/micro_ais/scenarios/protect_unit.cfg ''Protect Unit''].
** Using [[LuaAI#Dynamic_Lua_Aspects|dynamic Lua aspects]] is in principle also possible, but far from easy due to the complex tables this aspect returns.

{{DevFeature1.13|5}}

Though the above code still works in 1.13.5 and later (and will continue to work indefinitely), it can also be simplified a little:
<syntaxhighlight lang='wml'>
[ai]
[attacks]
invalidate_on_gamestate_change=yes
[filter_own]
type=Elvish Sorceress,Elvish Enchantress,Elvish Sylph
[/filter_own]
[filter_enemy]
race=undead
[/filter_enemy]
[/attacks]
[/ai]
</syntaxhighlight>

== See Also ==
* [[Wesnoth AI]]
* [[ReferenceWML]]

[[Category: WML Reference]]
[[Category:AI]]

Choosing your palette

2024-10-10T03:35:35Z

Egallager: some spellchecking

== Introduction ==
When choosing colours for your sprite art it is usually best to use already existing (mainline or UMC) palettes. But what can you do when you want to create your own, individual units?

I'll try to give you a short lesson -and hopefully some insights- into colour theory.

== Analysing existing art ==
Some of the newer mainline sprites use a lot of shades you (at first) wouldn't expect. Before creating your own images it is good to look at and analyse them.
Good examples are the Firedragon(green and purple shadows) and Elvish Outrider(yellow highlights on metal)

http://units.wesnoth.org/1.12/pics/core$images$units$monsters$fire-dragon.png

http://units.wesnoth.org/1.12/pics/core$images$units$elves-wood$outrider$outrider.png

Those colours, sparingly used, can create contrast in the picture without breaking the whole image.

== Choosing number of colours ==
Any material (which doesn't lie completely in shadows) should have at least 4 shades. Bigger surfaces should have up to 6, while the most dominant can have around 8 shades, but try to keep the number low.
The shades you need are:

1. White: for shiny or bright surfaces

2. Highlighting colour (optional)

3. Base-colour of the material in normal light

4. Blackish outline (Don't use black; The outline can be the same colour for the whole unit)

5.-8. About 2-4 Darker shades of the base-colour (can be replaced with other colours; more of that later)

== Shading depending on material ==
Metal is usually shiny and therefore should be white where light hits best. It reflects its surroundings, so many different colours could be used. Metal surfaces usually use more shades than other materials

Skin and leather aren't (very) reflective. Oily skin is very shiny (-> high contrast), while dry or dirty skin has a lower difference between shades.

Textile isn't shiny or reflective at all. As result white can only be used for bright fabric. It also creates folds on its own, so light shades and shadows often alternate.

https://forums.wesnoth.org/download/file.php?id=75043.png

== Reusing shades ==
I'd generally advise '''against''' using the same shades in the same image on different surfaces as it can make later edits more difficult and look confusing, but sharing the palette between different units can be useful to indicate unity (e.g. units from the same faction).

Nevertheless here are three units, who use only 12 shades of brown, to show you how to reduce colour count

https://forums.wesnoth.org/download/file.php?id=75046.png

These units create different materials and colours by using variating shading method (see above) and quantity of a colour.

The fist one has a lot of orange in his trousers to distinguish it from his skintone. His weapon uses browntones with a hint of purple and green to create the illusion of a natural wooden branch and beige for dry leaves. The golden ornaments are mostly yellow with white as highlights and orange/brown in the shadows.

Nr.2 has a darker but shiny skin, so the contrast is higher (white highlights to brown skin)

The last one has a lighter skin with mostly beige shades. On his shoulders are bronze plates with a lot more orange than the gold ornaments of Nr.1. His skirt and breastplate have nearly the same shades as the skin, but a lot more white (skirt) and brown (armor) to distinguish.

Most of the time the shape of an object can be decisive for the appearance of the material.

== Shadows ==
Darker shades can be replaced with different colours to create a higher contrast or to give the material an undertone.

The default shadow for Wesnoth is purple. It works best on orange or brown shades, but can be used for almost every colour with good results.

Non-reflective surfaces (e.g. normal clothes) should have just darker shades of the base colour, grey, or the default purple in the shadows. Metal and other reflective materials can use a larger variety.

Complementary colours (e.g dark green shadow for orange materials) let the surface shine a little brighter.

To create the illusion of reflection green (grass,forest) and blue (sky) shades on metal work best.

Other colours can be used to characterize a faction/unit (e.g. blue shadows for units with a water theme, red for a fire theme...)

Additionally the number of shades you replace can have a large effect:

Replace only one shade for a hardly noticeable undertone. It's an easy effect with little effort.

Replace multiple shades with different colours to create properties for the material (e.g rusty surface, magical aura, unique (magical) metals like mythril). It has to be carefully crafted, otherwise it will look very strange.

Replacing multiple shades with the same colour will change the colour of the material. It is only good when desired.

As general rules:

1.Replacing brighter shades will most of the time be more noticeable than replacing dark ones.

2.Replacement-shades should have (roughly) the same brightness as the original shade.

3.Replacement-shades will be less noticeable if they have a low saturation or a similar saturation as the original shade. Can be desired or not.

== Highlights ==

Highlights are bright shades with a different colour than the material. They will mostly be used for metals, but can also give textile a shining ability (-> silk).

If you don't want to change the whole colour of the material, they should only be used very sparely (single pixels). Only use them as replacement for the brightest shades, otherwise use shadows (see above).

Theoretically you could use any colour (with high brightness) to highlight, but bright green and yellow works best most of the time.
Similar to shadows, a hue with higher saturation will be more invading than a grey colour.

== Results ==
https://forums.wesnoth.org/download/file.php?id=75000.png

From far away the colours haven't changed too much.
The material is still clearly recognizable as metal or fabric, but thanks to the colors in the highlight/shadows, it has given it a special kind of glow.

Instead of a dull grey/black the units have a unique color scheme that gives more character to the faction.

Preprocessor

2024-08-25T10:04:42Z

Egallager: Redirected page to PreprocessorRef

#REDIRECT [[PreprocessorRef]]

Guide to UMC Content

2024-08-25T06:42:52Z

Egallager: /* A New Order */ bump release

This is a guide to current-ish user-made content for players. It provides unfamiliar players with detailed information about campaigns (including story, completion, difficulty and playing style) as well as detailed information about eras. Feel free to edit this guide, as it is a wiki.

This list covers add-ons for the latest 2 stable releases (1.14 and 1.16) of Wesnoth. There are archived versions of this page for [[Guide_to_UMC_Content/1.10|1.10]] and [[Guide_to_UMC_Content/1.12|1.12]].

For content creators who loved an add-on that hasn't been added to 1.14 or 1.16 yet, and are wondering about taking it over, please ensure that its entry on the older (1.12 or 1.10) wiki page is up to date, add a link to the add-on's feedback thread in the forums, and generally do the tidy-up that doesn't need you to start changing the campaign, and then ask the old maintainer. (You should probably also wait a bit before assuming that a maintainer isn't already porting to 1.16).

If you are looking for even more campaigns, please see the links in at the bottom of this page.

== Instructions ==
When adding a campaign to the list, please place it in its alphabetically sorted location, ignoring any initial article ("A", "An", or "The").

=== Blueprint for Campaigns ===

* Description:

* Author:

* Maintainer: if not maintained by the author anymore.

* Status:
** Broken = Does not work at all
** Incomplete = Partially written, no progress
** WIP = Partially written, some progress
** Complete = Completely written, but buggy as well as potential balance issues.
** Finished = Completely written, minimal to no bugs, slight balance issues possible.

* Version campaign version on the add-ons server

* Length:

* Requirements: (only if needed)

* Difficulty:

Please note: Often campaigns introducing new mechanics are listed as expert level on the add-on server, here difficulty means the raw difficulty after the mechanics are understood.

** Unbalanced = If you can't beat the hard mode, it isn't necessarily unbalanced, but if the difficulty changes erratically from one scenario to the next and only people using the debug mode have seen the final, then it is.
** Easy
** Normal
** Hard

Please note: If you didn't play the campaign, write the difficulty written on the add-ons server.

* Style:

Please note: Many campaigns will feature more than one style. Please list the most significant ones. If you don't know which style is the campaign you are listing, don't write this.

** Skirmish = small to medium sized armies, your standard Wesnoth gameplay
** Dungeon = long and narrow tunnels (not every underground scenario is a dungeon, a dungeon isn't necessarily underground)
** RPG = role playing game elements such as talking with non-player-characters, item collection, dependency on a party of very few adventurers without or limited recruits
** Survival = being exposed to changing, spawning enemies while remaining on the same map
** Large Battle = large number of units on the battlefield, sizely maps
** Simulation = campaigns feat. terrain modification, alternative resources
** Boss battle = the challenge is to defeat a single powerful enemy unit
** Minigames = there are puzzles and minigames in the campaign that significantly differ from standard Wesnoth gameplay

* Faction/Era: Era for the whole campaign and more specifically the faction or unit composition you field.

* Custom units: Link to the unit tree for cases that don't feel sufficiently described by Faction / Era entry.

* Forum: Links to the feedback and development threads at forums.wesnoth.org

=== Blueprint for Eras ===

* Description:

* Author:

* Maintainer: if not maintained by the author anymore.

* Status 1.14/1.16:
** see the list of statuses in the campaign blueprint

* Faction Descriptions: Describe your individual factions here.

* Requirements: (only if needed)

* Forum: Links to the feedback and/or development threads at [https://forums.wesnoth.org/ forums.wesnoth.org].

== How to play for UMC factions ==

=== Southern Nations by Elvenisko ===
[[How_to_play_Death_Knights|Death Knights]] |
[[How_to_play_Southern_Drakes|Southern Drakes]] |
[[How_to_play_Southern_Dwarves|Southern Dwarves]] |
[[How_to_play_Southern_Elves|Southern Elves]] |
[[How_to_play_Southern_Mages|Southern Mages]] |
[[How_to_play_Southern_Mercenaries|Southern Mercenaries]] |
[[How_to_play_Southern_Orcs|Southern Orcs]] |
[[How_to_play_Southern_Swamplords|Southern Swamplords]] |
[[How_to_play_Southern_Nations|Comparison]] |
[https://units.wesnoth.org/1.17/Southern_Nations/en_US/era_southern.html All units (can be out of date)]

== Battle for Wesnoth 1.14 and newer ==

=== Campaigns ===

==== After the Storm ====

''Follow the journey of Galas and his band following the events of Invasion from the Unknown''

'''Author:''' shadowm/ShikadiQueen/Iris

'''Status:''' Finished, 0.10.11

'''Length:''' 3 episodes of 13 scenarios each, some of which are multi-part

'''Difficulty:''' Medium-hard

'''Style:''' Skirmish, Boss Battle, Dungeon

'''Faction/Era:''' Many custom units

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=32091]

'''GitHub:''' [//github.com/project-ethea/After_the_Storm]

'''Note:''' (vultraz) Long, very enjoyable campaign with great story. (Knyghtmare) The best UMC campaign ever!

'''[[Guide_to_UMC_Campaigns/Players_Reviews#After_the_Storm|Players’ Review(s)]]'''

====A Beastly Tale====

''When a small village is beset by troubles, its fate rests in the hands of a young woodsman and the animals he befriends.''

'''Author:''' GloccusV

'''Status:''' Complete

'''Version:''' 2.0.3

'''Length:''' 5 scenarios

'''Difficulty:''' Intermediate

'''Custom units:''' [//units.wesnoth.org/1.14/A_Beastly_Tale/en_US/A_Beastly_Tale.html Here]

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=41434&p=633612&hilit=A+Beastly+Tale#p579093 Here]

====A Song of the Winds====

''Every era has its heroes and heroines. Before the song of Myra, the odyssey of Akhen Wadjet and the aria of Tenma Yozora, there was the song of the winds that echoed in the mountains and halls at the heart of the Great Continent. Follow young Maat of Hiera'Shirsha and Prince Abhai of Garet-Desh in the war that set the stage for one of the greatest upheavals Irdya has ever witnessed.
(Prequel to the Dragon Trilogy)''

'''Author:''' revansurik

'''Status:''' Complete

'''Version:''' 1.0.0

'''Length:''' 43 scenarios (some of them dialogue-only)

'''Difficulty:''' Intermediate

'''Custom units:''' War of Legends + Custom factions

'''Forum:''' [//https://forums.wesnoth.org/viewtopic.php?f=8&t=53913 Here]

==== Bad Moon Rising ====

''An expedition to gather treasure from the cold north sets off compounding disaster.''

'''Author:''' Doofus-01

'''Status:''' Complete 1.10.0

'''Length:''' 20 scenarios

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Archaic Era

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=31348]

'''GitHub:''' [//github.com/doofus-01/wesnoth-Bad_Moon_Rising]

==== The Black Cross of Aleron ====

''A elvish school for druids comes under attack by goblins. It seems more than just a routine raid; is there something more sinister behind this attack? - In Beseiged Druids, you control Eärendil, the surviving teacher at the school, and the many and varied initiates. Not all of these are ordinary students; many have been experimenting with other forms of magic, while others are simply overachievers in some area of study. Unfortunately, they are not especially good at combat, at least initially. Together with a very small contingent of surviving guards, it is up to these students to save the island of Aleron from disaster.''

'''Author:''' Celtic Minstrel

'''Status:''' Complete 2.0.3

'''Length:''' 9 scenarios

'''Difficulty:''' Unbalanced

'''Style:''' Skirmish

'''Faction/Era:''' Default, Elves

'''[https://units.wesnoth.org/1.14/Black_Cross_of_Aleron/en_US/celmin-druid-siege.html Custom units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=37342

==== Danse Macabre ====

''Macabre is a rare zombie who has intelligence and will. What's he like? What's his purpose?''

'''Author:''' kamikaze

'''Maintainer:''' James_The_Invisible

'''Status:''' Completed, 1.3.2

'''Length:''' 12 scenarios

'''Difficulty:''' Unbalanced

'''Style:''' Large Battle

'''Faction/Era:''' Default, undead

'''[//units.wesnoth.org/1.14/Danse_Macabre/en_US/Danse_Macabre.html Custom units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=33745]

'''Note:''' While the campaign is playable on Wesnoth 1.14 without major issues, it is (still) in need of heavy re-balancing. Sadly, for various reasons I am not able to do it in near future but patches are always welcome, preferably in form of pull requests on [https://github.com/konecnyjakub/Danse_Macabre GitHub].

==== Dawn of Thunder ====

''A young elvish fighter is send to represent the Aethenwood at the Ka'lian. The adventure turns out to be bigger than expected.''

'''Author:''' Paulomat4

'''Maintainer:''' egallager

'''Status:''' [https://github.com/cooljeanius/dawn_of_thunder/issues/3 Incomplete], latest release on the BfW 1.16 add-on server is [https://github.com/cooljeanius/dawn_of_thunder/releases/tag/0.2.4 0.2.4].

'''Length:''' 18 scenarios

'''Difficulty:''' Challenging

'''Style:''' Skirmish, Large Battle, RPG-elements

'''Faction/Era:''' Default, Elves, Humans

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=39512 forums.wesnoth.org/viewtopic.php?f=8&t=39512]

==== A Fiery Birth ====

''A scholar of the Great Academy journeys to the land of the drakes to discover their secret origins.''

'''Author:''' Mathbrush

'''Status:''' Complete

'''Version:''' 1.2.0

'''Length:''' 9 scenarios

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=47861&p=623953 Here]

'''GitHub:''' [//github.com/brirush84/AFieryBirth]

==== The Final Exam ====

''Young mage Erika must find a magic book to become a true mage. But will it really be her final exam?''

'''Author:''' Elven

'''Status:''' Complete, 2.6.1

'''Length:''' 4 scenarios

'''Difficulty:''' Easy

'''Style:''' Skirmish, Minigames

'''Faction/Era:''' Default, Loyalists

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=23398]

'''Note:''' Short, easy campaign with varying objectives. Features female mage as leader.

==== [[FlightToFreedom|Flight to Freedom]] ====

''Flight to Freedom chronicles the story of the drake hero Malakar, and his desperate cross-country flight out of slavery.''

'''Authors:''' MadMax, Nova

'''Maintainer:''' egallager

'''Status:''' Complete

'''Length:''' 20 playable scenarios + 1 dialogue-only, for a total of 21 (may need an update now that the "B" branch has been reactivated)

'''Version:''' [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.2 5.4.2] (for BfW 1.16), or [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.5.0 5.5.0] (for BfW 1.17), or [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.6.0 5.6.0] (for BfW 1.18)

'''Difficulty:''' Expert

'''Style:''' Skirmish, Large Battle, Puzzle

'''Faction/Era:''' Drakes

'''Required Wesnoth version:''' 1.16+ or 1.17+ or 1.18+

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=1887 Development], [//forums.wesnoth.org/viewtopic.php?t=40195 Feedback]

'''GitHub:''' [//github.com/cooljeanius/Flight_Freedom github.com/cooljeanius/Flight_Freedom]

==== Inky's Quest ====

''The Cuttlefish Campaign''

''Are the cuttlefish mere beasts or something more? What stories would they tell if they could speak? This story provides one possible answer. The easiest difficulty provides hints for novice players.''

'''Author:''' Telchin

'''Status:''' Complete

'''Length:''' 12 scenarios + story-only epilogue, for a total of 13

'''Version:''' 1.5.6

'''Difficulty:''' Easy

'''Style:''' Skirmish

'''Faction/Era:''' Custom units (cuttlefish, tentacles, giant clams...). Enemies use both default era units and custom ones.

'''[//units.wesnoth.org/1.14/Inky_Quest/en_US/Inky_Quest.html Custom Units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=32501]

==== Invasion from the Unknown ====

''Episode I - Seeking the Light: Long after the Fall, the last forest elves are forced to abandon their safe valley, and find themselves resorting to the dark means of necromancy in order to survive the perils and challenges of this new harsh world. May they finally free the Great Continent from its chaos, or perish in the foolish attempt of restoring peace and life to the lands.''

''Episode II - Armageddon: As the shadow of Chaos covers the entire continent, an assorted group of foolish heroes prepares a counter-attack to the Empire, with one unique goal in their minds: defeat the evil Emperor, whoever it is. Lead these courageous living and non-living warriors to victory, and rediscover lost secrets of the history.''

'''Author:''' shadowm/ShikadiQueen/Iris

'''Status:''' Finished, 2.1.9

'''Difficulty:''' Normal

'''Style:''' Skirmish, Dungeon, Boss battle

'''Faction/Era:''' Unique. You play Elves and Undead throughout the campaign.

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=43309]

'''GitHub:''' [//github.com/project-ethea/Invasion_from_the_Unknown]

'''Walkthrough:''' [[IftU Walkthrough]]

''[[Guide_to_UMC_Campaigns/Players_Reviews#Invasion_from_the_Unknown|Players’ Review(s)]]'''

==== Leader of the Drakes ====

''Leader of the drakes is killed. His son tries to defend homeland against the orcs. He choosed to ally with saurians, but other clans of drakes disagrees. Will fast and unexperienced Morin win against orcs and rebel drakes alike?''

'''Author:''' Elven

'''Status:''' Complete, 1.02b

'''Length:''' 3 scenarios

'''Difficulty:''' Easy/Medium

'''Style:''' Skirmish, Minigames

'''Faction/Era:''' Default, Drakes

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=53951&start=15]

'''Note:''' Short, easy campaign with simple objectives. Features Drake Glider as leader and modified Drake Burner with cold and slowing blade.

==== Legend of the Invincibles ====

'''''Part I: Shrouded in Darkness''' (5 chapters, 90 scenarios) - A pair of heroes, after stopping an orcish threat, are outcast into caves, where they have no other choice than to become liches in order to survive. They preserved their original appearance and moral principles, and fight in various skirmishes against evil (although using evil methods sometimes), until the Fall, when they are buried alive under the ashes of the third sun.''

'''''Part II: Into the Light''' (5 chapters, 110 scenarios) - Long after the Fall, the lich heroes awaken. Searching for more power, they manage to resurrect themselves as living beings, but this time more powerful and ridden of the evil within. But the evil from inside them did not cease to exist, and started a campaign to conquer the world. Stopping the campaign caused an even worse disaster...''

'''Author:''' Dugi

'''Status:''' Complete

'''Length:''' 200 (+8 talk-only) scenarios

'''Difficulty:''' Normal

'''Style:''' mostly Skirmish and Dungeon (all other styles are present as well, but less frequently)

'''Faction/Era:''' Elves, Loyalists, Undead, Dwarves; but they advance past their usual maximum level

'''Forum:''' [//r.wesnoth.org/t32384]

'''GitHub:''' [//github.com/Dugy/Legend_of_the_Invincibles]

'''[[Guide_to_UMC_Campaigns/Players_Reviews#Legends_of_the_Invincibles|Players’ Review(s)]]'''

'''Note:''' The most unique feature of this campaign is its RPG-like unit development system, enemies drop items units can use, leaders are stronger than most usual units and all units get AMLA (after maximum level advancement) after reaching their maximum level (that is also increased by a load of additional level 4 units).

==== A New Order ====

''The old kingdom of Wesnoth has fallen before barbarian hordes. The occupying barbarians are on the brink of civil war, the seeds of Wesnothian rebellion are kept alive by old legends, while bandits and Dunefolk mercenaries roam the land. Can Gawen Hagarthen unite these disparate factions against a common foe?''

''Note: This campaign contains mature themes, some of which may be unsuitable for children.''

'''Author:''' szopen

'''Maintainers:''' nemaara (Yumi), egallager

'''Status:''' Finished

'''Version:''' [https://github.com/nemaara/A_New_Order/releases/tag/1.7.0 1.7.0]

'''Length:''' Hard to say as it is non-linear; it is advertised as having 45 scenarios, but the numbering only goes up to 30 due to some of the scenarios being alternates to one another.

'''Requirements:''' Requires BfW 1.16+. Also uses the "Akladian Music" add-on.

'''Difficulty:''' Advertised as intermediate; could be considered hard, though.

'''Style:''' Mostly Skirmish, some Large Battle

'''Faction/Era:''' mostly various human factions (including the Dunefolk), with the addition of the Akladian faction of humans

'''[//units.wesnoth.org/1.16/A_New_Order/en_US/A_New_Order.html Custom Units]'''

'''Forum threads:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=6486&sid=2e644284f54e65736b4f1543b7098ef9 Development], [//forums.wesnoth.org/viewtopic.php?t=36183 Feedback], [//forums.wesnoth.org/viewtopic.php?t=6174 Original (older) art thread], [//forums.wesnoth.org/viewtopic.php?t=36074 Current art thread]

'''GitHub:''' [//github.com/nemaara/A_New_Order github.com/nemaara/A_New_Order]

'''Note:''' (Pyrophorus) Certainly one of the most mature and well designed campaign in add-ons. A must.

''' [[Guide_to_UMC_Campaigns/Players_Reviews#A_New_Order|Players’ Review(s)]]'''

==== The North Wind ====

''Wesnoth's army was occupied fighting Mal Ravanal in the East, but there were whisperings of an orcish attack in the north. Konrad II must send Deoran, now an experienced rider and commander, with a small band of knights to hold off the orcs....''

''This campaign features unique gameplay characteristics such as a lack of recruiting and a 24-turn time-of-day cycle.''

'''Author:''' aelius, Deusite; pyndragon

'''Status:''' WIP, 0.3.0

'''Length:''' 1 playable scenario, 6 intended

'''Difficulty:''' Normal

'''Style:''' RPG, Skirmish, Survival

'''Faction/Era:''' Loyalists

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=42854]

==== The Ravagers====

'''Description:''' ''The Ravagers'' is a tale of pure revenge. A tale of justice served cold, told in a flashback-style point-of-view narrative, by a ranger in the Inn at Weldyn.
The campaign includes many new exciting gameplay features, fun mechanics such as drinking, hundreds of custom units, and many more.

'''Author:''' WhiteWolf

'''Status:''' Finished*

'''Length:''' 25 playable scenarios + 2 scene scenarios

'''Requirements:''' Akladian Music Pack, Underness Music Pack

'''Difficulty:''' Intermediate

'''Style:''' Skirmish + RPG / Flashback narrative

'''Faction/Era:''' Humans, Elves, Ravagers(dark humans)

'''[//units.wesnoth.org/1.14/The_Ravagers/en_US/The_Ravagers.html Custom Units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=44930]

'''*Notes:''' The main storyline is complete, but there are unfinished side-missions that are still in development. The campaign is aimed to become finished with version 1.2.0.

==== Return from the Abyss ====

''After taking part to a disastrous expedition, Khafir and his men are lost and isolated from their people, thousands of miles away from home, bound by a pact sealed with a powerful dwarvish king. Help him escape from the depth of Irdya and finding his way back, in an adventure across two worlds during the rise of a sinister force in the Great Continent.''

'''Author:''' skeptical_troll

'''Status:''' finished

'''Length:''' 19 playable scenario + 10 story only

'''Difficulty:''' Hard

'''Style:''' Skirmish, Dungeon

'''Faction/Era:''' Dunefolk/Default

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=44545]

==== Rise of the Dunefolk ====

''Adventure of Siabbin and Helare from small village in desert, who step by step made the foundation of the Dunefolk nation. Play a stunning adventure against many enemies in different maps - from sandstorm to swampy areas and caves. Defeat powerful lich lord and train one of the best dark mages in the world of Wesnoth.''

'''Author:''' Elven

'''Status:''' Completed

'''Length:''' 11 scenarios

'''Difficulty:''' Medium

'''Style:''' Skirmish, Minigames, Survival

'''Faction/Era:''' Default, Dunefolk and dark mage

'''Note:''' enjoable gameplay with every map different. Enough experience to upgrade your units.

==== The Return of the Darks ====

''The Darks are a race which left Wesnoth in the ancient times and lives on Isles in the sky. But now the Magic wich helped them to move the Isles in Sky got lost and the isles are about to fall down. Rumion an adventurer goes to Wesnoth and searchs for something that could help them.''

'''Author:''' thvk

'''Status:''' WIP

'''Length:''' 4 playable scenario + 2 story only

'''Difficulty:''' Easy

'''Style:''' Skirmish

'''Faction/Era:''' Default + some self made units

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=52731]

==== Secrets of the Ancients ====

''From the Journal of Ardonna of Tarrynth:''

''It's unfair that we humans must die after so few years. Though this is the natural order, we need not embrace it! The lords on the Green Isle knew how to live forever. Pursuit of that knowledge was declared illegal by King Haldric I, but I believe it is worth the risk: If I can rediscover the secrets of the ancients, not only will I cheat death, I will become a hero to the whole continent!''

'''Author:''' beetlenaut

'''Status:''' Mainlined (this is now one of the campaigns that is downloaded with Wesnoth itself)

'''Length:''' 18 playable scenarios + 3 story only

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Undead/Default

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=40545]

'''Walkthrough:''' [[Secrets of the Ancients Walkthrough]]

==== Swamplings ====

''Banished by Yushnak the Ponderer, a tribe of lowly swamp goblins endure in the deadly mire of Pogo Bog. Four centuries before the founding of Wesnoth, this is the story of the goblins' struggle against the intrigues and betrayals of the greater races, and the rise of the first wolf rider.''

'''Author:''' John Rawlins (boru)

'''Status:''' Complete

'''Length:''' 17 scenarios

'''Version:''' 1.2.0i

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction:''' Goblins

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=41254]

'''[[Guide_to_UMC_Campaigns/Players_Reviews#Swamplings|Players’ Review(s)]]'''

==== The Dark Hordes ====

''Lead fugitive dark sorcerer Gwiti Ha’atel to mastery of the undead hordes.''

'''Author:''' Circon

'''Maintainer:''' Various

'''Status:''' Incomplete/WIP

'''Length:''' 15 scenarios done so far

'''Version:''' 0.1.2

'''Difficulty:''' Unbalanced

'''Style:''' Skirmish

'''Faction/Era:''' Default undead

'''[//units.wesnoth.org/1.10/The_Dark_Hordes/en_US/The_Dark_Hordes_1.html Custom Units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=16576&]

==== The Tale of Vaniyera ====

''The expansionist Lavinian Legion, led by the Imperator himself, has invaded the northern forests of the Sidhe, or Wild Elves. It is up to Leithan the Thunderblade and his advisor Vaniyera to push its armies back where they came from...''

'''Author:''' oreb, turin

'''Maintainer:''' UnwiseOwl

'''Status:''' Finished 0.11.0

'''Length:''' 5 scenarios

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Imperial Era, Sidhe.

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=37880]

'''Walkthrough''' There is a video-walkthrough by the campaign maintainer that begins [https://www.youtube.com/watch?v=dGM1bjImvkI&list=PLZorLYWvUD7VIhaXxKwzO8iQANlp_TaF0 here].

'''Note:''' As of August 2014, all previous issues raised about this campaign have been addressed. If you've not played this campaign since 1.4 or 1.10, in this humble maintainers opinion, it's worth another go.

==== To Lands Unknown ====

''This is the story of Mehir, the Summoner, and his journey to lands unknown.''

'''Author:''' inferno8

'''Status:''' Complete

'''Length:''' 20 scenarios, 4 dialogue only

'''Difficulty:''' Intermediate (Era of Magic)

'''Style''': Skirmish, Dungeon

'''Era:''' Era of Magic

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=31799]

'''GitHub:''' [//github.com/inferno8/wesnoth-To_Lands_Unknown]

'''[[Guide_to_UMC_Campaigns/Players_Reviews#To_Lands_Unknown|Players’ Review(s)]]'''

==== A Vision Blinded ====

''Defend the northern forest against what appeared like a routine orcish raid, and unravel the greater conspiracies that lie below its waves.''

'''Author:''' LemonTea

'''Maintainer:''' Adamant14

'''Status:''' Complete, 1.0.14

'''Length:''' 13 playable scenarios + 1 dialogue-only

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default, Elves (+ Trolls, Outlaws)

'''[//units.wesnoth.org/1.10/A_Vision_Blinded/en_US/A_Vision_Blinded.html Custom units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=23463]

=== Eras ===

[[Category:Campaigns|*]]
[[Category:Eras|*]]

==== '''Southern nations''' ====

[[How_to_play_Southern_Nations|Everything about southern nations, including how to play series]]

==== '''War of Legends''' ====

'''Description:''' A multiplayer era focused on the Dark Irdya Campaigns. Contains 15 factions.

'''Author:''' Tahsin Jahin Khalid (Lord-Knyghtmare)

'''Maintainer:''' Tahsin Jahin Khalid (Lord-Knyghtmare)

'''Status:''' Complete, new features being added for the 1.15.x version of the add-on

'''Factions:'''

# Aragwaithi
# Windsong
# Human Alliance
# Orcish Union
# Southerners (Desert Elves)
# Outlaws
# Elementals
# Undead
# Drakes
# Dark Legion
# Sylvans
# Minotaurs
# Vampires
# Dunefolk
# Knalgan Alliance

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=19&t=30087 Development and Feedback Thread]

'''GitHub:''' [//github.com/knyghtmare/War_of_Legends]

==== Era of Magic(EoMa) ====

'''Description:''' Aiming at using the whole potential of Battle of Wesnoth's graphic engine, the Era of Magic is considered to have a most amazing special effects and attack animations in the BfW game. There are 8 playable factions with fully animated units and tons of special effects contained in the era, and the stories of them are told in the campaign "To Lands Unknown".

'''Author:''' Inferno8

'''Maintainer:''' Inferno8

'''Status:''' Finished, 3.1

'''Faction Descriptions:'''

Sky Kingdom - powerful magi of all kinds. Their knowledge allows them to cast amazing spells and summon creatures like unstopable Golems or mysterious Mus. Masters of Elements and Gurus are one of the most powerful human beings in the Era.

Al-Kamija - these proud people are good warriors and spell casters of the desert. They use magical circles and scrolls to summon amazing creatures like Jinns or elementals from other dimension called Abyss. These creatures can't be poisoned, which is a great advantage.
(The campaign "To Lands Unknown" is mainly about the story of this faction)

Tharis - fearsome Tharis faction is very dangerous especially at night. Cruel people of Tharis with their black magic and dreadful monsters like Hydra can demolish everything standing on their way. Being so powerful in attack, Tharis have no healer, so they need to push forward at all costs.

Kharos - this strange name is the name of a beautiful country ruled by prophets of light. These peaceful people are masters of defense and support. Their formations of healers and Shielders assisted by Silver Warriors, who can teleport between friendly villages, are very hard to destroy.

Barbarians - the best in hand-to-hand combat. This multi-cultural society divided into Goblins, Orcs, Cyclops and Trolls with their own advantages and disadvantages can be hard opponent, but separately they are very weak.

Runemasters - these Dwarves use runic magic and equipment and are well known of their protection against magic. The Runemasters create steam machines like Gyrocopters, Robots and even mighty Mechanical Dragons. Units from this faction are very resistant but slow.

Dark Blood Alliance - this faction is composed of agile lizards, giant frogs, wyverns swallowing enemies and salamanders, which have developed to perfection the art of disguise. At the head of the community stand shamans known for their water magic, which is used in the fight as well as in healing.

Destroyers - a terrifying undead creations consisting of civilizations long gone...

'''Version:''' 1.1.1 (February 18th, 2015)

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=19&t=20039 Development and Feedback Thread]

'''GitHub:''' [//github.com/inferno8/wesnoth-Era_of_Magic]

==== Ageless Era ====

'''Description:''' Ageless Era is a compilation of the most popular eras and factions on the add-on server. It is more an era pack than an era.

'''Author:''' mnewton1, Ravana and various

'''Maintainer:''' Ravana

'''Status:''' Finished, 4.19

'''Unit Tree:''' [//units.wesnoth.org/1.12/Ageless_Era/en_US/Ageless%20Era.html Ageless Unit Tree (for 1.12)]

'''Factions List:''' Currently there are 91 factions in the era:

Default: Loyalist, Rebels, Northerners, Undead, Knalgan Alliance, Drakes, Khalifate

Extended Era: Loyalist, Sylvans, Dwarves, Outlaws, Northerners, Undead, Chaos, Dark Elves

Archaic Era: Khthon, Phantoms, Despair, Primeval, South-Seas, Ukians, Northern Orcs

Era of Four Moons: Highlanders, Imperialists, Sea States, Darklanders, Dalefolk, Freemen, Pygmies, Whites

Era of the Future: Welkin, Brungar

BEEM: Anakes, Calidonians, Wood Warriors

Custom Factions: Yokai, Dark Legion, Desert Elves, Steelhive, Frozen

Era of Myths: Celestials, Devlings, Elementals, Therians, Vampires, The Warg, Windsong

Feudal Era: Aragwaithi, Ceresians, Clockwork Dwarves, High Elves, Orcish Khaganates

Imperial Era: Arendians, Cavernei, Issaelfr, Lavinian Legion, Marauders, Orcei Gladiatores, Sidhe

Era of Strife: Eventide, Triththa, Free Saurians, Eltireans, Minotaurs

Era of Magic: Barbarians, Dark Blood Alliance, Sky Kingdom, Kharos, Runemasters, Al-Kamija, Tharis, Destroyers

Mercenaries Era: Highlanders, Enchanters, Avians, Slavers, Mercenaries, Equestrians, Emperor's Guard, Oracles, Holy Order, The Cult, Fanatics, Tribalists, Hive, Infernai, Refugees, Blight

'''Git:''' [https://github.com/ProditorMagnus/Ageless-for-1-11 Ageless-for-1-11] and also for 1.12 and [https://github.com/ProditorMagnus/Ageless-for-1-14 1.14]

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=19&t=25274 Development and Feedback Thread]

==== Imperial Era (IE) ====

'''Description:''' One of the oldest maintained user eras, the Imperial Era brings together seven different factions in a completely re-imagined setting, the world of Orbivm, a very lethal world indeed. The era contains both mainline and development versions of each faction and can be used to play five campaigns, each featuring a different race.

'''Author:''' Orbivm Project (but really Turin)

'''Maintainer:''' UnwiseOwl

'''Status:''' Complete, 0.23

'''Faction Descriptions:'''

# Lavinian Legion - Based on the Roman Legion, the Lavinians have strong, versatile melee units in the legionaries and a range of support classes sourced from amongst the Lavinian population and various subjugated races. The legion are strong in the plains but weak when fighting in forested areas. The Lavinians are featured in "Fall of Silvium".
# Sidhe - The Sidhe are a group of forest-dwelling elves whose focus is stealth and fleet movement. Their mages are able to channel the lightning itself, and their various other units move almost as fast. The Sidhe feature in "Tale of Vaniyera".
# Marauders - Based on the Germanic peoples that eventually conquered Rome (hint, hint), the Marauders are equally as at home in the hills, forests and swamps of their homeland. Their hard-hitting melee units are practicalyl unstoppable during the night-time. The Marauders are the stars of the "Alfhelm the Wise" campaign.
# Orcei Gentorum - The orcs have been captured gladiators slaving away in the Lavinian arenas for generations.The life of an orc in Orbivm is harsh and brutal, just like the orcs themselves. The tale of the uprising of one such group of Orcs is told in "Up from Slavery".
# Cavernei - The Cavernei are a dwarvish race with similarities to the mainline Knalgans, but with a greater emphasis on the military uses of runesmithing. They get a campaign too, in "Gali's Contract"
# Issaelfr - The frost elves live on the fringes of the habitable lands of Evrosia, the main continent of Orbivm, and have become inured to difficult conditions and tuned in to their Fae natures. They don't have a campaign yet, but you could always write one.
# Arendians - The Arendians are horse-lords living on the Western steppes of Evrosia. A life of constant battle has developed a military-focused society where warriors are trained from a young age. They used to have a campaign, but it fell into disrepair a very long time ago.

'''Wiki:''' [[Orbivm]]

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?t=37920 Development and Feedback Thread]

==== Lonely Era (LE) ====

'''Description:''' The Lonely Era is a new collection of six selected superior solitary sides with interesting and unusual abilities, traits and attributes.

It has been extensively revised and rebalanced over the last few years from the original era and the constituent factions.

'''Author:''' Atreides. Based on work by Shield, Desert_Shyde, Brilliand, Stern, Cloud, Grigistian, mikoc5, Stopsignal, The_Gnat, Minnakht.

'''Maintainer:''' Atreides

'''Status 1.16:''' Finished

'''Faction Descriptions:'''

1) Santa's Helpers are his Elves as well as animated pine trees. They are an updated faction based on the Merry Christmas Campaign. Beware of Elves bearing gifts though, the presents are very distracting. They are unique in not having standard levels, they each can gain up to 4 special abilities via AMLA but always remain at level 1. Of course there are also Flying Reindeer and Christmas Seals.

2) Gremlins are an all teleporting race of elusive ethereal creatures. Individually fragile they work together using their tremendous mobility to swarm and overwhelm their enemies. Their mages are perhaps the ultimate glass cannons but if you can somehow keep one alive long enough it might even get to level 5 and become immortal.

3) Vaeringjar are a Viking faction allied with Wolfkin. The vikings eschew ranged weapons as well as sissy ideas like dodging blows but are a very, very hardy lot. They also have a unique herbalist unit that can inspire berserker rage in adjacent vikings for a turn. The wolfkin are lithe and armed with bows and teeth on the other hand. They are also very agile in contrast to the vikings. As nocturnal hunters they are devastating at night and almost helpless in the day.

4) Avians are cold loving, water hating bipedal birds. Their hollow bones and feathers make them vulnerable to fire and blunt weapons. They are unique in having cheap level 0 healers. Unusually their leaders are not drawn from the ranks but form a separate class only selectable as leaders. Tamed Albatrosses to patrol the awful waters.

5) The Deep Ones - Slimy, slippery, blasphemous fish-frogs of the nameless design - living and horrible - have now been sighted on the edge of Wesnoth. Mutants who slowly evolve from human to monster these creatures are nothing to be trifled with! An all water faction they are quite capable of holding their own against the landlubbers.

6) Jephrifs live far up in the sky, miles above land. Away from even the most basic things most other races take for granted, such as solid ground, their society developed to be quite alien indeed. In recent times, jephrifs began descending from the skies to participate in combat against other races - apparently for their own amusement, seeing life as a game.

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?t=42630 Development and Feedback Thread]

== Additional info ==
See also:
* [[Player_UMC_Reviews|Player UMC Reviews]]
* [[:Category:User-made Campaigns - Walkthroughs|Walkthroughs for user-made campaigns]]
* [//r.wesnoth.org/t37476 forum thread] for this page
* [[Guide_to_UMC_Content/1.12|Guide to user-made content (UMC) for Battle for Wesnoth 1.12]]
* [[Guide_to_UMC_Content/1.10|Guide to user-made content (UMC) for Battle for Wesnoth 1.10]]
* [//r.wesnoth.org/t36733 thread discussing 1.8 UMC that wasn't ported to 1.10]
* [//r.wesnoth.org/t48086 thread discussing all UMC that hasn't been ported to 1.14]
* [//addons.wesnoth.org the addon server]

Maintenance tools

2024-08-17T23:19:50Z

Egallager: /* wmlscope */ Update with info from the big block comment at the top of the script

<div class="floatright"> __TOC__ </div>

The Wesnoth source code distribution includes a couple of tools intended to help authors maintain campaigns, faction & unit packs, and other WML resources. These
are:

; wmlscope: a cross-reference lister, useful for finding unresolved macro and resource-file references.

; wmllint: a utility for sanity-checking WML syntax and porting your old WML to the current version of WML.

; wmlindent: a utility for reindenting WML to a uniform style.

; GUI.pyw: a graphical interface

== General Information ==

You will need a Python 3 interpreter on your system to use these tools. Linux, *BSD, and Mac OS/X should already have Python 3 installed; for Windows it's a free download
from http://www.python.org. You will also need to know how to run command-line tools on your system.

If you're working with Debian or Ubuntu you might have to install the package wesnoth-1.16-tools (or the convenient version).
sudo apt install wesnoth-1.16-tools

All three tools will require you to supply a directory list. This is a set of directories containing the WML files you want to work on.

This page is intended as documentation for users.

Note to Windows Users: This means you have to run it from the '''Command Line'''. The command line may be reached by hitting Start, then Run, then "cmd" or "command" depending on your version of Windows.

Example uses:
python wmllint path\to\files
python wmlindent path\to\files

Another example:
"C:\Program Files\Python3.7\python.exe" data\tools\wmllint --dryrun data\core data\{multiplayer,themes} data\campaigns
(You have to specify the full directory path to the executable if you don't have your environment variables set up correctly).
The first thing you type is the path to your python executable, followed by a space. The second thing you type is the path to the desired script to run, followed by a space. The third thing you type is the path to the folder (or file) to be processed.

'''A convenient way of running wmllint''' on Linux (Debian or Ubuntu) and Windows in comparison, '''Linux''':

Assuming we're working with wesnoth 1.16 or more advanced versions.
python3 /usr/share/games/wesnoth/1.16/data/tools/wmllint --dryrun /usr/share/games/wesnoth/1.16/data/core ~/.local/share/wesnoth/1.16/data/add-ons/A_Simple_Campaign 1>wmllint-run.log 2>wmllint-err.log
I have these commands inside of a file named
wmllint_dryrun_ASC.sh
and execute it by opening a shell (=terminal, console, command window, bash,...), navigating into the directory with that file and typing
bash wmllint_dryrun_ASC.sh
The python3 command should be automatically known on Debian. The path to the script tells the python interpreter what to execute. --dryrun: A wmllint option, see below. The path to the core files is needed to let wmllint know about e.g. defined core units, followed by the path to the add-on that shall be checked; the last two commands cause the result of the wmllint usage to be written into those files in the same directory as the script.
'''Windows''', this is logically exactly the same as the Linux shell script above, so if you are on a Mac you can probably conclude how you need to adapt the paths:
E:\Python37\python.exe E:\Programme\Wesnoth_1.16_git\data\tools\wmllint --dryrun E:\Programme\Wesnoth_1.16_git\data\core E:\Programme\Wesnoth_1.16_git\userdata\data\add-ons\A_Simple_Campaign 1>wmllint-run.log 2>wmllint-err.log
This is the content of a .txt file, whose extension I rename to .bat and double-click onto it. Opening a command window is not needed this way.
Since Python isn't natively installed on windows and I don't have environment variables set, the full path to python.exe is given. If your directories contain spaces it may help to include the path in quotes:
"C:\Programs\Battle for Wesnoth 1.16\data\tools\wmllint"
Remember that you do not need to enter all of the commands/paths at once. If it doesn't work, start with only "python" or "C:\Python37\python.exe" or the like and interpret the error messages that you get. If you get an "unknown command", python isn't installed or environment variables aren't set correctly. After that, you can add the later commands one by one.

== wmlscope ==

The main use for <tt>wmlscope</tt> is to find WML macro references without definitions and references to resource files (sounds and images) that don't exist. These are difficult to spot from in-game because they usually result in silence or a missing image rather than actual broken game logic (see [https://github.com/wesnoth/wesnoth/issues/5332 issue 5332] for more info). They may happen because of typos in your WML, or because the name of a macro or the location of a resource file changed between versions of the game.

<tt>wmlscope</tt> also checks macro invocations for consistency. It will complain
if a macro is called with the wrong number of arguments. In most cases it can deduce information about the type of the literal expected to be passed to a given macro argument by looking at the name of the formal.

<table class="wikitable"><tr>
<th>Type</th>
<th>Meaning</th>
<th>Formals requiring this type</th>
<th>Literals of this type</th>
</tr>
<tr>
<td>side</td>
<td>a single side number</td>
<td>SIDE, *_SIDE, SIDE[0-9]</td>
<td>a numeric or "global"</td>
</tr>
<tr>
<td>numeric</td>
<td>a numeric integer literal</td>
<td>SIDE, X, Y, RED, GREEN, BLUE, TURN, PROB, LAYER, TIME, *_SIDE, *NUMBER, *AMOUNT, *COST, *RADIUS, *_X, *_Y, *_INCREMENT, *_FACTOR, *_TIME, *_SIZE, DURATION</td>
<td>\-?[0-9]+</td>
</tr>
<tr>
<td>percentage</td>
<td>a percentage</td>
<td>*PERCENTAGE</td>
<td>a numeric or 0\.[0-9]+</td>
</tr>
<tr>
<td>position</td>
<td>a single x,y coordinate</td>
<td>POSITION, *_POSITION, BASE</td>
<td>-?[0-9]+,-?[0-9]+</td>
</tr>
<tr>
<td>span</td>
<td>a set of coordinates or coordinate ranges</td>
<td>*_SPAN</td>
<td>a numeric, position or ([0-9]+\-[0-9]+,?|[0-9]+,?)+</td>
</tr>
<tr>
<td>alliance</td>
<td>a set of side numbers</td>
<td>SIDES, *_SIDES</td>
<td>a span, or the empty string</td>
</tr>
<tr>
<td>range</td>
<td>an attack range</td>
<td>RANGE</td>
<td>"melee" or "ranged"</td>
</tr>
<tr>
<td>alignment</td>
<td>an alignment keyword</td>
<td>ALIGN</td>
<td>"lawful" or "neutral" or "chaotic"</td>
</tr>
<tr>
<td>types</td>
<td>a set of unit types</td>
<td>TYPES</td>
<td>a shortname, name, or anything that contains spaces and matches no other type</td>
</tr>
<tr>
<td>terrain_pattern</td>
<td>a set of terrain codes to filter</td>
<td>ADJACENT*, TERRAINLIST*, *TERRAIN_PATTERN, RESTRICTING</td>
<td>a terrain_code or name</td>
</tr>
<tr>
<td>terrain_code</td>
<td>a single terrain code, perhaps with overlay</td>
<td>TERRAIN*, *TERRAIN</td>
<td>a shortname or (\*|[A-Z][a-z]+)\^([A-Z][a-z\\|/]+\Z)?</td>
</tr>
<tr>
<td>shortname</td>
<td>a terrain code or a short, capitalized variable name</td>
<td></td>
<td>[A-Z][a-z][a-z]?</td>
<tr>
<td>name</td>
<td>a name or identifier</td>
<td>NAME, VAR, IMAGESTEM, ID, FLAG, *_NAME, *_ID, NAMESPACE, BUILDER, *_VAR</td>
<td>anything without spaces that matches no other type</td>
</tr>
<tr>
<td>optional_string</td>
<td>a string value (may be empty)</td>
<td>ID_STRING, NAME_STRING, DESCRIPTION, IPF</td>
<td>a string, or the empty string</td>
</tr>
<tr>
<td>string</td>
<td>a nonempty string not matching any of the preceding types</td>
<td>STRING, TYPE, TEXT, *_STRING, *_TYPE, *_TEXT</td>
<td>a shortname, a name, a stringliteral, or anything that contains spaces and matches no other type</td>
</tr>
<tr>
<td>stringliteral</td>
<td>a string in doublequotes or a translated string</td>
<td></td>
<td>".*" or _.* but not _[a-z].*</td>
</tr>
<tr>
<td>image</td>
<td>an image path, perhaps with [[ImagePathFunctionWML|image path functions]]</td>
<td>*IMAGE, PROFILE</td>
<td>[A-Za-z0-9{}.][A-Za-z0-9_/+{}.-]*\.(png|jpg)(?=(~.*)?)</td>
</tr>
<tr>
<td>sound</td>
<td>a music or sound filename</td>
<td>MUSIC, SOUND</td>
<td>string ending with ".wav" or ".ogg"</td>
</tr>
<tr>
<td>filter</td>
<td>[[FilterWML|WML filter]]</td>
<td>FILTER</td>
<td>any non-quoted string containing "="</td>
</tr>
<tr>
<td>WML</td>
<td>arbitrary WML fragment</td>
<td>WML, *_WML</td>
<td>any non-quoted string containing "=", or the empty string</td>
</tr>
<tr>
<td>affix</td>
<td>a prefix, suffix, or infix for a variable name</td>
<td>AFFIX, *AFFIX, POSTFIX, ROTATION</td>
<td>a shortname or name, or the empty string</td>
</tr>
<tr>
<td>any</td>
<td>anything</td>
<td>*VALUE, [ARS][0-9]</td>
<td>anything</td>
</tr>
</table>

If the actual argument is a macro call {.*}, then it matches any formal. Otherwise, if the formal has an identifiable type, <tt>wmlscope</tt> will complain if the actual literal does not match it.

The argument type check only works in macro calls that fit on a single line.

<tt>wmlscope</tt> has many options for changing the reports it generates; the more advanced ones are intended for Wesnoth developers. Invocations for the most commonly useful reports it generates are included in data/tools/Makefile of the source distribution. Here are some of those reports:

; make unresolved: Report on unresolved macro calls and resource references; also report macro argument-type mismatches. (This is what you are most likely to want to do).

; make all: Report all macro and resource file references, not just unresolved ones.

; make collisions: Report on duplicate resource files.

For more advanced users, or those who want to understand what the canned Makefile invocations are doing, here is a summary of <tt>wmlscope</tt>'s options. Some of the more advanced options will require you to understand
[http://docs.python.org/lib/re-syntax.html Python regular expressions].

; -h, --help: Emit a help message and quit
; -c, --crossreference: Report resolved macro references (implies <tt>-w 1</tt>)
; -C, --collisions: Report duplicate resource files
; -d, --deflist: Make definition list. (This one is for campaign server maintainers.)
; -e regexp, --exclude regexp: Ignore files matching the specified regular expression.
; -f dir, --from dir: Report only on macros defined under dir
; -l, --listfiles: List files that will be processed
; -r ddd, --refcount=ddd: Report only on macros with references in exactly ddd files.
; -t TYPELIST, --typelist TYPELIST: List actual & formal argtypes for calls in fname
; -u, --unresolved: Report unresolved macro references
; -w, --warnlevel: Set to 1 to warn of duplicate macro definitions
; -p, --progress: Show progress
; --force-used reg: Ignore reference count 0 on names matching regexp
; --extracthelp: Extract help from macro definition comments.
; --unchecked: Report all macros with untyped formals.
; --version: show program's version number and exit

These options are used with a list of directories as arguments; if none is given,
<tt>wmlscope</tt> behaves as though the current directory had been specified as a
single argument. Each directory is treated as a separate domain for
macro and resource visibility purposes.

<tt>wmlscope</tt> recognizes two kinds of namespace, exporting and non-exporting.
Exporting namespaces make all their resources and macro names
globally visible. You can make a namespace exporting by embedding
a comment like this in it:

# wmlscope: export=yes

Wesnoth core data is an exporting namespace. Campaigns are non-exporting;
they should contain the declaration

# wmlscope: export=no

somewhere. <tt>wmlscope</tt> will complain when it sees a namespace with no export
property, then treat it as non-exporting.

You can tell <tt>wmlscope</tt> to ignore stretches of config files
with the following magic comments:

# wmlscope: start ignoring
# wmlscope: stop ignoring

Similarly, you can tell <tt>wmlscope</tt> to ignore multiple or duplicate macro
definitions in a range of lines with the following magic comments:

# wmlscope: start conditionals
# wmlscope: stop conditionals

The following magic comment:

# wmlscope: prune FOOBAR

will cause <tt>wmlscope</tt> to forget about all but one of the definitions of
<tt>FOOBAR</tt> it has seen. This will be useful mainly for symbols that have
different definitions enabled by an <tt>#ifdef</tt>.

Due to a preprocessor limitation, inline macros cannot contain a documentation
string. If you need to document these macros in the HTML macro reference, you
can use the following directive:

# wmlscope: docstring FOOBAR

The docstring for the FOOBAR macro will be collected until a non-comment line,
a <tt>#define</tt> or another <tt># wmlscope: docstring</tt> are found. External
docstrings '''''must''''' be defined before the macro to which they refer; defining
two or more external docstrings keeps only the most recent one, but having both an
external and an internal docstring is allowed (in this case, the internal one
will be appended to the external one in the macro reference).

This tool does catch one kind of implicit reference: if an attack name
is specified but no icon is given, the attack icon will default to
a name generated from the attack name. This behavior can be suppressed
by adding a magic comment containing the string "no-icon" to the <tt>name=</tt>
line.

The checking done by this tool has a couple of flaws:

(1) It doesn't actually evaluate file inclusions. Instead, any
macro definition satisfies any macro call made under the same
directory. Exception: when an <tt>#undef</tt> is detected, the macro is
tagged local and not visible outside the span of lines where it was
defined.

(2) It doesn't read <tt>[binary_path]</tt> tags, as this would require
implementing a WML parser. Instead, it assumes that a resource-file
reference can be satisfied by any matching image file from anywhere
in the same directory it came from. The resources under the '''''first'''''
directory argument (only) are visible everywhere.

(3) A reference with embedded {}s in a macro will have the macro's
formal args substituted in at WML evaluation time. Instead, this
tool treats each {} as a .* wildcard and considers the reference to
match '''''every''''' resource filename that matches that pattern.
Under appropriate circumstances this might report a resource filename
statically matching the pattern as having been referenced even
though none of the actual macro calls would actually generate it.

Problems (1) and (2) imply that this tool might conceivably report
that a reference has been satisfied when under actual
WML-interpreter rules it has not.

The reporting format is compatible with GNU Emacs compile mode.

For debugging purposes, an in-line comment of the form

# wmlscope: warnlevel NNN

sets the warning level.

== wmllint ==

<tt>wmllint</tt> is a tool for migrating your WML to the current version. It handles two problems:

* Resource files and macro names may change between versions of the game. <tt>wmllint</tt> knows about these changes and will tweak your WML to fit where it can.

* Between 1.2.x and 1.3.1 the terrain-coding system used in map files underwent a major change. It changed again in a minor way between 1.3.1 and 1.3.2. If you port such old code, use <tt>wmllint-1.4</tt>, which is located in the same directory as <tt>wmllint</tt>. It will translate your maps for you, unless you use custom terrains in which case you will have to do it by hand.

<tt>wmllint</tt> also performs various sanity-checking operations, reporting:

* unbalanced tags
* strings that need a translation mark and do not have them
* strings that have a translation mark and should not
* translatable strings containing macro references
* filter references by description= (id= in 1.5) not matched by an actual unit
* abilities or traits without matching special notes, or vice-versa
* consistency between recruit= and recruitment_pattern= instances
* double space after punctuation in translatable strings.
* unknown races or movement types in units

<tt>wmllint</tt> takes a directory-path argument specifying the WML directories to work on. It will modify any cfg and map files under those directories that need to be changed. Here is a summary of its options:

; -h, --help: Emit a help message and quit.
; -c, --clean: Clean up -bak files.
; -D, --diffs: Display diffs between converted and unconverted files.
; -d, --dryrun: List changes (-v) but don't perform them.
; -r, --revert: Revert the conversion from the -bak files.
; -m, --missing: Don't warn about tags without side= keys now applying to all sides.
; -s, --stripcr: Convert DOS-style CR/LF to Unix-style LF.
; -v, --verbose: Set verbosity; more details below.
; -K, --known: Suppress check for unknown unit types, recruits, races, scenarios, etc.
; -S, --nospellcheck: Suppress spellchecking
; --version: show program's version number and exit

The verbosity option works like this:

; -v: lists changes.
; -v -v: warns of maps already converted.
; -v -v -v: names each file before it's processed.
; -v -v -v -v: shows verbose parse details (developers only).

The recommended procedure is this:

# Run it with --dryrun first to see what it will do.
# If the messages look good, run without --dryrun; the old content will be left in backup files with a -bak extension.
# Eyeball the changes with the --diff option.
# Use wmlscope, with a directory path including the Wesnoth mainline WML, to check that you have no unresolved references.
# Test the conversion.
# Use either --clean to remove the -bak files or --revert to undo the conversion.

Additionally, wmllint tries to locate a spell checker on your system and spell-checks storyline and message strings. It will work automatically with any of [https://github.com/AbiWord/enchant enchant]'s spellchecking backends (including aspell, myspell, ispell, applespell, hunspell, nuspell, and so on, depending on the version of enchant), provided you have the <tt>enchant.py</tt> Python library installed. Note that the spellchecking results can vary depending on which backend enchant decides to use.

wmllint supports a number of magic comments to customize its behaviour and avoid false positives. All magic wmllint comments begin with the string <tt>wmllint:</tt>, followed by some additional keyword and potentially some arguments. In the below explanations, a string of the form <code>[a|b]</code> means you may use either <code>a</code> or <code>b</code> at that location, while a string of the form <code><arg></code> indicates free text substitution.

* <code>ignore</code>: Disables checking of terrains and translation marks on the current line only.
* <code>noconvert</code>: Disables conversion of terrains and image/sound filenames on the current line only.
* <code>markcheck [on|off]</code>: Enables or disables translation mark checking from the current (next?) line onward.
* <code>no-icon</code>: Prevents description insertions (what does that mean?)
* <code>recognize <name></code>: Indicates that the character with the given name exists even though a declaration (ie a <code>[unit]</code> or <code>[side]</code> tag) is not visible.
* <code>whofield <macro> <number></code>: Indicates that the specified macro declares a character whose name is given by the specified argument to the macro.
* <code>whofield clear <macro></code>: Removes the <code>whofield</code> definition for the specified macro.
* <code>who <macro> is <name> <name> ...</code>: Indicates that the specified macro declares one or more characters whose names are given as a space-separated list. This can also be used for macros that auto-recall a list of characters, some of which join later or may die at some point. If a definition for the macro already exists, then the specified names are appended to it. If a name is preceded by a double minus (<code>-- <name></code>) then it is removed from the definition.
* <code>unwho all|<name></code>: Removes the <code>who</code> definition for the specified macro, or all <code>who</code> definitions.
* <code>usage of "<unit>" is <class></code>: Declares the usage of the specified unit (the <code>usage=</code> key in the <code>[unit_type]</code> tag). Useful if you are using macros to generate several similar unit types.
* <code>usagetype <class></code>: Declares a valid usage type for units. <code>usagetypes</code> is also recognized, and a comma-separated list of usage types can be specified.
* <code>validate-[on|off]</code>: Enables or disables stack-based validation checks. Use when you have unbalanced tags in macros.
* <code>unbalanced-[on|off]</code>: Similar to above, the precise difference is unclear.
* <code>no translatables</code>: Suppresses warnings about a missing textdomain declaration in the current file. Make sure the file really does have no translatable strings!
* <code>display [on|off]</code>: Enable or disable warnings about newlines in messages.
* <code>notecheck [on|off]</code>: Enable or disable note consistency checks for unit descriptions.
* <code>deathcheck [on|off]</code>: Enable or disable the check for units speaking in their death events.
* <code>[general|directory|local] spellings <word> <word> ...</code>: Declares the specified space-separated list of words to be valid spellings in the specified context. The context <code>local</code> indicates the current file only, while <code>directory</code> means the current file and any siblings in the same directory or subdirectories. The <code>global</code> context indicates the spellings are valid anywhere.
* <code>no spellcheck</code>: Disables spell checking on the current line.
* <code>skip-side</code>: Indicates that there is a missing side declaration at this location that will be provided by a macro expansion.
* <code>match <string> with <notes_macro></code>: Indicates that uses of the specified string in a unit definition (usually a macro, including the curly braces) should be matched up with the specified special notes macro (which is also specified as the full macro with curly braces).
* <code>no ellipsecheck</code>: Disables checking of unit ellipses on the current line.

=== Explanations of <tt>wmllint</tt> diagnostics ===
Some <tt>wmllint</tt> diagnostics may require further explanation for UMC authors to understand; this section will be for providing such explanations, and descriptions of how to solve and/or silence them.

In these, <code>%s</code> will be replaced by a string. When the recommended solution also includes a <code>%s</code>, it's a suggestion to copy the string from the error message into your code.

* <code>nonstandard word-wrap style within message</code>: This message meant there was an unexpected newline character within a <code>[message]</code> tag. However, this check was removed in the 1.15.10 release. Pre-1.15.10, add-on developers could silence by putting a <code># wmllint: display on</code> comment before the string and a <code># wmllint: display off</code> comment after the string, however, post-1.15.10, this is no longer necessary.
* <code>%s is not a known unit type</code> (in cases where you'd think the unit type ''would'' be known): This means the unit has a type that was never defined in mainline or in the add-on. This is why you're supposed to always add Wesnoth's core directory as the first item to be checked when using <tt>wmllint</tt> (which is something that the GUI version of it will do automatically for you), so that it can load the mainline unit types. (You can also silence this warning by passing the <tt>-K</tt> flag to <tt>wmllint</tt>.)
* <code>unknown speaker '%s' of [message]</code>: use a <code># wmllint: recognize %s</code> magic comment, or, alternatively, if the speaker is created by a macro, use a magic comment of the form of either <code># wmllint: who MACRO is SPEAKER</code> or <code># wmllint: whofield MACRO NUMBER</code>, depending on whether the macro takes an argument for the unit's name or not.
* <code>unknown '%s' referred to by id</code>: use a <code># wmllint: recognize %s</code> magic comment, or, alternatively, if the unit is created by a macro, use a magic comment of the form of either <code># wmllint: who MACRO is UNIT</code> or <code># wmllint: whofield MACRO NUMBER</code>, depending on whether the macro takes an argument for the unit's name or not.
* <code>%s has unknown advancements</code> (in cases where you'd think the advancement ''would'' be known): This means the unit has an advancement that was never defined in mainline or in the add-on. This is why you're supposed to always add Wesnoth's core directory as the first item to be checked when using <tt>wmllint</tt> (which is something that the GUI version of it will do automatically for you), so that it can load mainline units for checking advancements. Note that it's also possible that you just made typo, too, so be sure to check your spelling. (You can also silence this warning by passing the <tt>-K</tt> flag to <tt>wmllint</tt>.)
* <code>.description may need hand fixup</code>: This one comes from mucking around with the <code>.description</code> field of unit data manually in a hackish fashion. There isn't really much of a way to work around it, besides just the "don't do that" solution.
* <code>tag stack nonempty (%s) at end of file.</code>: This means that you have unbalanced tags somewhere in the file, e.g. an opener without a closer, or vice versa. This can often be seen when defining macros for unit abilities. A way to fix this warning is to wrap the section with unbalanced tags with a <code># wmllint: unbalanced-on</code> magic comment beforehand and a <code># wmllint: unbalanced-off</code> magic comment afterwards. As having unbalanced tags will also cause issues for other WML maintenance tools, such as <tt>wmlindent</tt> and <tt>wmlxgettext</tt>, you may also want to add separate magic comments for each of them (see their documentation for the form they take).
* <code>unit declaration without side attribute</code>: the default side for a unit declaration when left implicit is side 1. Specify your unit sides explicitly to solve this.
* <code>no %s units recruitable at difficulty %s</code> (even when there are such units recruitable): This diagnostic has to do with matching the <code>usage</code> key of units recruitable by an AI side with their <code>recruitment_pattern</code>. It means the unit has a usage that was never defined in mainline or in the add-on. This is why you're supposed to always add Wesnoth's core directory as the first item to be checked when using <tt>wmllint</tt> (which is something that the GUI version of it will do automatically for you), so that it can know which mainline units are recruitable. (You can also silence this warning by passing the <tt>-K</tt> flag to <tt>wmllint</tt>.)
* <code>%s has unknown movement type</code> (even when you'd think that that movement type ''would'' actually be known): This means the unit has a movetype that was never defined in mainline or in the add-on. This is why you're supposed to always add Wesnoth's core directory as the first item to be checked when using <tt>wmllint</tt> (which is something that the GUI version of it will do automatically for you), so that it can load the mainline movement types. (You can also silence this warning by passing the <tt>-K</tt> flag to <tt>wmllint</tt>.)
* <code>%s has unknown race</code> (even when you'd think that that race ''would'' actually be known): This means the unit has a race that was never defined in mainline or in the add-on. This is why you're supposed to always add Wesnoth's core directory as the first item to be checked when using <tt>wmllint</tt> (which is something that the GUI version of it will do automatically for you), so that it can load the mainline races. (You can also silence this warning by passing the <tt>-K</tt> flag to <tt>wmllint</tt>.)
* <code>derivation of %s from %s does not resolve</code> (even when you'd think it would): This means that a unit using the [[UnitTypeWML#Other_tags|[base_unit]]] tag specifies a unit ID in that tag that was never defined in mainline or in the add-on. This is why you're supposed to always add Wesnoth's core directory as the first item to be checked when using <tt>wmllint</tt> (which is something that the GUI version of it will do automatically for you), so that it can load the core units for its derivation checks. (You can also silence this warning by passing the <tt>-K</tt> flag to <tt>wmllint</tt>.)
* <code>[advancefrom] needs to be manually updated to [modify_unit_type] and moved into the _main.cfg file</code>: This one is pretty self-explanatory: [[UnitTypeWML#Unit_Type|[advancefrom]]] was deprecated in [https://github.com/wesnoth/wesnoth/commit/3950f40f3f0483032bc70b3e57166bd355acd9fc commit 3950f40] due to [https://github.com/wesnoth/wesnoth/issues/3955 issue #3955], and in fact doesn't even work anymore (in 1.16) as per [https://github.com/wesnoth/wesnoth/issues/6204 issue #6204]. The main reason <tt>wmllint</tt> can't fix this automatically is because it could end up being too complicated for it to figure out which files to edit if there are multiple uses of <code>[advancefrom]</code>, and it also doesn't want to assume where to put the [[ModificationWML|[modify_unit_type]]] tag in <tt>_main.cfg</tt>.

== wmlindent ==

Call with no arguments to filter WML on standard input to reindented WML on
standard output. If arguments are specified, they are taken to be files to be
re-indented in place; a directory name causes reindenting on all WML
beneath it.

The indent unit is four spaces. Absence of an option to change this is
deliberate; the purpose of this tool is to ''prevent'' style wars, not encourage
them.

On non-empty lines, this code never modifies anything but leading and
trailing whitespace. Leading whitespace will be regularized to the
current indent; trailing whitespace will be stripped. After processing
all lines will end with a Unix-style <code>\n</code> end-of-line marker.

Runs of entirely blank lines will be reduced to one blank line, except
in two cases where they will be discarded: (a) before WML closing
tags, and (b) after WML opening tags.

It is possible to wrap a section of lines in special comments so that
<tt>wmlindent</tt> will ignore them. You may need to do this for unbalanced
macros (it's better, though, to get rid of those where possible).
Use '<code>wmlindent: {start,stop} ignoring</code>' anywhere in a comment.

It is also possible to declare custom openers an closers, e.g for macros
that are actually control constructs. To do this, use declarations

# wmlindent: opener "{EXCEPTIONAL_OPENER "
# wmlindent: closer "{EXCEPTIONAL_CLOSER "

The lines after an opener will be indented an extra level; a closer
and lines following will be indented one level less. Note that these
declare prefixes; any prefix match to the non-whitespace text of a line
will be recognized.

The public utility macros "<code>{FOREACH</code>" and "<code>{NEXT</code>" come as wired-in exceptions,
because it is not guaranteed that their indent declarations will be processed
before the macro library is reached.

Interrupting <tt>wmlindent</tt> ought to be safe, as each reindenting will be done to a copy
that is atomically renamed when it's done. If the output file is identical
to the input, the output file will simply be deleted, so the timestamp
on the input file won't be touched.

The <tt>--dryrun</tt> option detects and reports files that would be changed
without changing them. The <tt>--verbose</tt> or <tt>-v</tt> option enables reporting
of files that are (or would be, under <tt>--dryrun</tt>) changed. With <tt>-v -v</tt>,
unchanged files are also reported. The <tt>--exclude</tt> option takes a regexp
and excludes files matching it.

If you don't apply this tool to your own WML that you wish to submit, the
mainline-campaign maintainers will do it when and if your code is accepted into the tree.

Note: This tool does not include a parser. It will produce bad results on WML
that is syntactically unbalanced. Unbalanced double quotes that aren't part
of a multiline literal will also confuse it. You will receive warnings
if there's an indent open at end of file or if a closer occurs with
indent already zero; these two conditions strongly suggest unbalanced WML.

== GUI.pyw ==

Starting from version 1.11.15 and 1.13.0, a GUI (written in Tkinter, plus the themed widgets ttk) is available in the same directory as the other tools. To use it, you need to have a version of Python equal to or greater than 3.1.0 (the 3.0.x series doesn't include the ttk widgets, and as such is unsuitable for this script).

If you're on Linux, be sure to have installed the ''python3-tk'' module, '''or the application won't run at all'''. To install it in a Debian-based distro (like Ubuntu), type this line in a Terminal:
sudo apt install python3-tk

To start it, just double click on the GUI.pyw file. The interface is pretty much self-explanatory, and allows you to run wmllint, wmlscope, wmlindent and wmlxgettext, modify their options, select an add-on and save the tools' output as a text file.

== See Also ==
* [[Translation Maintenance Commands]] (for <tt>wmlxgettext</tt>)

[[Category:Create]]
[[Category:Tools]]

Cpp features blocked by version

2024-08-11T02:39:10Z

Egallager: /* Features */ link to GCC's "concepts" meta-bug

== Summary ==
This is a listing of C++ features that would be useful to have but can't yet be used. The Feature column is the language or standard library feature (https://en.cppreference.com/w/cpp/compiler_support is a good reference). The Benefit column is what having this feature will allow to be done. The remaining three columns are for the minimum requirements for the feature to be available on each platform. The minimum requirements can be anything - Visual Studio version, compiler version, OS version, etc.

== Benefits that don't justify version increases ==
This is a non-exhaustive list:
* Improving compile speed.
* Pretty much any standard library feature that we can just as well get through boost or other means.
* Core language features that allow writing more succinct code.

== Benefits that do justify version increases ==
This is a non-exhaustive list:
* Required to fix a bug that has a significant impact to players.
* Core language features that make classes of bugs impossible or significantly harder to accidentally introduce.
* Required to fix a relevant security vulnerability.
* A group of multiple smaller features that individually don't justify a version increase, if there's minimal to no impact to developers and players.

== Features ==
{| class="wikitable sortable"
|-
! Feature !! Benefit !! Windows !! macOS !! Linux !! Notes
|-
| Modules || Faster compile time || Unknown || Unknown || Unknown || While part of C++20, usable support seems to be progressing very slowly.
|-
| std::starts_with and ends_with || Simplies string checking in various places, including filesystem || MSVC STL 19.21 (VS 2019 16.1) || Apple Clang 10.0.0 (Xcode 10.0 beta (10L176w), 10.0 (10A255), 10.1 (10B61)) || GCC libstdc++ 9/Clang libc++ 6 || Boost offers similar functions.
|-
| std::format || Cleans up our numerous uses of manual string concatenation, especially with pango strings in the UI || Unknown || Unknown || Unknown || The wesnoth variable substitution facility offers similar functions, though with a little less versatility (but it could be extended).
|-
| std::span || Potential to reduce templates where we only need a container view || Unknown || Unknown || Unknown ||
|-
| Concepts || Cleaner template requirements (increased code clarity) || Unknown || Unknown || Unknown || https://gcc.gnu.org/bugzilla/show_bug.cgi?id=concepts
|-
| Standard feature check macros || Ability to enable features on an individual basis without doing a whole-language flag || Unknown || Unknown || Unknown || Clang and likely GCC already support them on older versions as an extension.
|-
| std::filesystem || || Unknown || Just need to target 10.15 || Unknown || We do have boost....
|}

ReferenceWML

2024-07-30T02:47:57Z

Egallager: /* WML toplevel tags */ minor formatting

{{WML Tags}}
== The Wesnoth Markup Language ==

The Wesnoth Markup Language (WML) is used to code almost everything in Wesnoth, including scenarios, units, savefiles, and the user interface layout. WML files are simple, human-readable text files, usually with the .cfg extension, with similarities to INI files and XML. A major feature in WML are macros, which are alike those found in the C language and similarily are handled by a preprocessor. Implementation-wise, WML files are handled mainly by the ''config'' class (and ''simple_wml'' in [[wesnothd]]).

This page is a collection of pointers to different common WML structures.

See [[BuildingScenarios]], [[BuildingCampaigns]] and [[BuildingUnits]]
for a tutorial style overview.

''Note: this reference may contain slight inaccuracies, might not list all existing keys and tags or might contain some deprecated syntax. If you find that this reference doesn't give you the answer to how to implement some feature in WML, the most reliable way is to look at the WML code of existing units and campaigns that have done so.''

== How WML works ==

* [[SyntaxWML]] Description of WML syntax
* [[VariablesWML]] How to use WML variables
* [[PreprocessorRef]] the WML preprocessor syntax
* [[GrammarWML]] A more formal definition of the WML syntax. More useful for implementing a WML parser than for writing WML documents.
* [[AddonsWML]] Content that can be published and downloaded via the add-ons server

== WML toplevel tags ==

The following covers most of the possible toplevel tags in a typical main WML file. Some minor and dev-oriented tags (not intended for use by UMC) are omitted.

* [[GameConfigWML]] the top level '''[game_config]''' tag
* [[UnitsWML]] the top level '''[units]''' tag
** [[AbilitiesWML]] a list of the different abilities a unit or weapon can have
** [[UnitTypeWML]] how to describe a unit type
** [[AnimationWML]] how to animate units
* [[CoreWML]] the top level '''[core]''' tag
* [[CampaignWML]] the top level '''[campaign]''' tag
** [[CreditsWML]] how to describe the credits (the '''[about]''' tag)
* [[ScenarioWML]] the top level tags '''[scenario]''', '''[multiplayer]''', and '''[test]'''
** [[EventWML]] how to describe an event (the '''[event]''' tag)
** [[SideWML]] how to describe a side (the '''[side]''' tag)
** [[MapGeneratorWML]] the random map generator
** [[TimeWML]] how to describe a day
** [[IntroWML]] how to describe the intro screen (the '''[story]''' and '''[part]''' tags)
* [[EraWML]] the top level '''[era]''' tag
* [[ModificationWML]] the top level '''[modification]''' and '''[resource]''' tags
* [[TerrainWML]] the top level '''[terrain_type]''' tag
* [[TerrainGraphicsWML]], the top level '''[terrain_graphics]''' tag
* [[ThemeWML]] the top level '''[theme]''' tag
* [[LanguageWML]] the top level '''[language]''' tag
* [[LocaleWML]] the top level '''[locale]''' tag
* [[HelpWML]] the top level '''[help]''' tag
* [[BinaryPathWML]] the top level '''[binary_path]''' tag
* [[FontsWML]] the top level '''[fonts]''' tag
* [[GettextForWesnothDevelopers#The_textdomain_tag|Textdomains]] the '''[textdomain]''' tag

Some other files use the WML format, but with different tags.

* [[AchievementsWML]] the '''[achievement_group]''' and '''[achievement]''' tags.
* [[SavefileWML]] a description of the format of savegames
** [[ReplayWML]] a description of the format of player actions such as moving a unit
** [[StatisticalScenarioWML]] used to generate statistics of a savegame
* [[PblWML]] a description of the format of server-uploadable campaigns
* [[SchemaWML]] a description of WML files that define the structure of other WML files
* [[DiffWML]] used to describe structural differences between preprocessed WML documents
* [[GUIToolkit]] gives an overview of Wesnoth's current UI system and how to create user interfaces with it.

== Other WML tags ==

* [[EventWML]] how to describe an event
** [[FilterWML]] the construct to filter on [[StandardUnitFilter|units]], [[StandardLocationFilter|locations]], [[StandardSideFilter|sides]], weapons, vision, and WML data.
** [[ActionWML]] to describe the actions which occur when the event is fired
*** [[ConditionalActionsWML]] actions that encapsulate conditional filters and the actions to execute if the conditions are met
*** [[DirectActionsWML]] actions that directly affect gameplay: for example, creating a unit
**** [[SingleUnitWML]] how to describe a unit (for uses such as placing one on the map with the '''[unit]''' tag)
*** [[InternalActionsWML]] actions that WML uses internally: for example, storing a variable
*** [[InterfaceActionsWML]] actions that do not affect gameplay: for example, displaying a message
*** [[LuaWML]] how to code actions with the Lua language (BfW 1.14 and earlier)
*** [[LuaAPI]] how to code actions with the Lua language (BfW 1.16 and later)
* [[AiWML]] how to describe parameters for AI (the '''[ai]''' tag)
* [[EffectWML]] the construct to modify a unit (the '''[effect]''' tag)
* [[DescriptionWML]] the structure of WML coded menus like the difficulty chooser of campaigns
* [[EditorWML]] tags controlling the post-1.4 editor's behavior
* [[MusicListWML]] for playing music (see also [[Available Music]] for a list of what's available)

== Predefined macros ==

Wesnoth ships with a library of predefined macros you should find useful in writing your own WML.
* [https://www.wesnoth.org/macro-reference.html WML Macros] - description of all such macros.

== Other ==

* [[ReferenceWMLSyntax]] how this wiki and the pages it links to should be formatted
* [[ConventionsWML]] how to make your WML more readable
* [[Wml_optimisation]] how to make your WML code more efficient
* [[UsefulWMLFragments]] Various pieces of WML for various purposes. If you have some WML you're proud of that you think others can use, add it here.
* [[Maintenance tools]] for wmlindent, wmllint, wmlscope
* [[CommandMode]] commands are not strictly speaking part of WML, but they are useful for debugging it, and could be a little hard to find, so linking to them here makes sense.
* [[MultiplayerServerWML]] is used when communicating with the multiplayer server.
* [[CampaignServerWML]] is used when managing contributed campaigns on the campaign server.
* [[ImagePathFunctions]] (IPFs) are used when applying the color function to images, such as marking units as belonging to a team or in TerrainGraphics.
* [[Pango formatting]] shows ways to enrich descriptions using pango markup, which can use basic html style formatting tags, such as <nowiki>, , </nowiki> and others.
* [[Wesnoth_Formula_Language|Wesnoth Formula Language (WFL)]] often used with $() formulas.
* [[PreprocessorRef|Syntax of preprocessor mini-language]] : symbols, macros, file inclusions...

== See Also ==

* [[BuildingMaps]] the text-based format for Wesnoth maps
* [[TerrainCodeTableWML]] a list of all terrains, and [[TerrainCodesWML]], on how to use them
* [[MultiHexTutorial]] a description of the multi-hex tiling system
* [[IGNFileFormat]] a description of the ignore file format
* [[CompatibilityStandards#Deprecation_levels_-_When_to_remove_deprecated_features|DeprecationLevels]]
* [[Environment_variables]] a cheat-sheet for CLI environment variables
* Back to [[Create]]

[[Category: WML Reference]]

Wesnoth AI Framework

2024-07-29T08:50:29Z

Egallager: additional "See Also"

== Wesnoth AI Framework: A Composite AI ==

The Wesnoth AI framework is that of a composite AI. In other words, rather than the AI being one huge monolithic block, it is composed of a variety of different components which can be combined in a modular fashion (almost) at will.

In its default configuration, Wesnoth provides a predefined combination of these components in the [[RCA AI]]. This configuration can be modified in a multitude of different ways. Due to the modular setup, it is not only possible to add new AI behavior to before or after the default AI moves, or replace the default AI entirely, but also to insert new behavior routines in between existing components. This can be done either in addition to or as substitutions for existing components.

This page describes the AI components and their configuration in a general sense. Check out [[RCA AI]] for a description of how these are assembled into the default AI and [[Wesnoth AI]] for a collection of links to pages explaining how to customize and modify the existing AI or write a completely new AI.

== Types of AI Components ==

The Wesnoth AI framework consists of the following types of components:

==== Stages====

These are the fundamental building blocks of the AI. The AI is set up as a series of stages which are executed in the order in which they are put into the AI configuration. In other words, all actions of the first stage are executed first, then all actions of the second stage, etc.

While there are six different types of stages, only one of them, called the ''main_loop'' stage, is used in the default AI. In fact, this stage is sufficient for the vast majority of custom AI applications as well. We therefore only describe the ''main_loop'' stage and its sub-components in detail.

==== The Candidate Actions of the ''main_loop'' Stage ====

The ''main_loop'' stage consists of a number of candidate actions (CAs), each of which contains an evaluation and an execution function. For each AI move, the evaluation functions of all CAs are called, with each of them returning a score. The execution function of the CA with the highest score is then called, which results in an AI move (or in some cases, several moves) to be done. Then all CAs are evaluated again (including the one that was just executed) and the highest scoring CA is executed, until no CA returns a valid (non-zero) score any more.

Combining candidate actions designed for specific tasks such as attacks or village grabbing, it is possible to create entire AIs in a modular fashion. The CAs can be put together in whatever order and combination best suits the needs of a scenario. They do not need to be sorted in order of their evaluation scores and can even return variable scores which adapt to the situation on the map.

For a summary of the candidate actions of the default AI, click [[RCA_AI#The_Candidate_Actions_.28CAs.29_of_the_main_loop_Stage_in_the_RCA_AI|here]].

==== Aspects and Goals====

Aspects are configurable input parameters used to customize a candidate action's behavior. They are implemented as the the return values of functions that are called by the CAs of the RCA AI. They can also be called and taken into account by custom CAs, but that is not necessarily always the case. For example, some of the [[Micro AIs]] respect some of the RCA AI aspects (such as ''avoid''), but not all do.

The return values of the aspect functions can be defined and/or customized using both [[AiWML|WML]] or [[LuaAI#Dynamic_Lua_Aspects|Lua]].

Goals are used similarly to aspects in that they also affect the behavior of the default AI. They can be used to customize the directions into which the default AI moves its units. However, both their [[AiWML#AI_Targets_and_Goals|syntax]] and their internal implementation (see below) are different from those of the aspects.

Check out the [[RCA AI]] page for details on which aspects and goals exist and how they are used by the default AI.

==== Engines====

Engines assemble the configurations provided for the individual components of the AI into usable code and execute this code. In recent Wesnoth versions, you do not need to worry about the engines any more, they are always defined and active by default. It is sufficient to know that the components can be written in three different languages, C++, Lua and Formula AI (FAI). Information on how to do this is provided in the links of the [[Wesnoth AI]] page.

It is worth noting that some stages are only set up for specific engines (see below), while the candidate actions, aspects and goals of the ''main_loop'' stage can be written in any of the three languages and can be combined arbitrarily.

== AI Configuration ==

The Wesnoth AIs are assembled from configurations provided in several different places:
* The default AI parameters in a variety of configuration files in the 'data/ai/' directory
* Optional [ai] or [modify_ai] tags in era configurations
* Optional [ai] or [modify_ai] tags in multiplayer faction configurations
* Optional [ai] or [modify_ai] tags in scenario configurations
* Optional [ai] tags in individual unit definitions (ie in the [unit] tag) - note that this option may be removed or drastically changed in the future

When the game is created, all these config snippets are merged into a single configuration stored in form of an [ai] tag. Then, aspects with the same ids are merged. During the game, whenever a [modify_ai] tag is acted upon (for example in an event), it is added into the existing AI configuration in the same way.

In the following, we describe the syntax of the [ai] tag. We first show the top-level keys and tags that can be used. Details on the use of the tags for the individual components follow after that, together with examples and links to more information for each component.

== The [ai] Tag — Top-level Elements ==

AI configurations are set up and stored using the [ai] tag. It has the following top-level elements, which are described in more detail in the remaining sections of this page.

*'''description'''="": (translatable string) This is the text displayed in the MP setup menu when choosing an AI for a computer player. It is only relevant for reusable AI configurations, for example in [[EraWML]].
*'''id'''="": (string) The id of the [ai] config snippet. This was originally meant to make it possible to remove [ai] configurations selectively during a game. However, due to the merging process described above, this information is lost. The id is therefore meaningless in the current implementation of the AI. {{DevFeature1.13|5}} This id can now be referenced by ''ai_algorithm'' in order to set the base AI algorithm to build on. It is only relevant for reusable AI configurations, for example in [[EraWML]].
*'''ai_algorithm''': (string) This used to instruct Wesnoth to load a different AI engine instead of the composite AI. {{DevFeature1.13|5}} It now specifies a default AI configuration to load; any AI available at the multiplayer select screen can be chosen, or AIs defined in other addons. It must reference the id attribute of another [ai] tag. It defaults to ai_default_rca; other possible values include experimental_ai and idle_ai. Specifying the ID of an AI defined in ''data/ai/ais/'' or ''/data/ai/dev/'' is roughly equivalent to macro-including that file in your side configuration just above the opening [ai] tag, except that the AI configuration will be loaded on the fly (similar to using [modify_side]switch_ai) rather than included in the preprocessed WML. Additional aspects, stages, and so on can still be added to the [ai] tag as normal.
*'''mp_rank''': (integer) {{DevFeature1.15|0}} A value that determines in which order available AIs are displayed in the multiplayer selection menu. AIs are listed in ascending order of mp_rank (smallest values first). The mainline default (RCA) AI and Experimental AI have values of 1000 and 1010, respectively, meaning that custom AIs with mp_rank less than 1000 will be listed before any of the default AIs. AIs that do not contain an mp_rank line are shown at the end of the list. It is only relevant for reusable AI configurations, for example in [[EraWML]].
*'''version'''="": (string) This key is currently still needed to distinguish whether aspects are defined using ''standard'' or ''composite'' syntax in the [ai] tag. If it is omitted, standard syntax is used. If set to '10703' or '10710', the engine uses composite syntax. However, '''we are in the process of removing this distinction'''. When that is done, both types of syntax can be used without needing the ''version'' key, even mixed together inside the same [ai] tag. We will also deprecate this key when that happens. {{DevFeature1.13|5}} The version key is no longer recognized and will be mistaken as an attempt to set a non-existent "version" aspect. The key should not normally be required even prior to 1.13.5, however.
*'''[stage]''': Configuration of the stage(s) used in the AI. Several [stage] tags can be used, even several stages of the same type. They are executed in the order in which they are put into the [ai] tag.
*'''[aspect]''': Configuration of the aspects to be used by the AI. These are in composite aspect format.
** Most aspects can also be provided using the simpler syntax explained at [[AiWML]].
*'''[goal]''': Configuration of the goals to be used by the AI.
*'''[engine]''': This tag used to be needed for the Lua AI engine. It is not required any more, the Lua engine is created automatically now, just as the two other engines. If you need information on how this works, check out the [[Lua_AI_Legacy_Methods_Howto|Lua AI legacy documentation]]. Note that this tag is still used internally, so it will almost certainly not be removed in the future.
*'''[modify_ai]''': The [modify_ai] tag can specify modifications to be applied to the AI immediately. This is the preferred way to add a candidate action to the RCA AI, but can also be used for any other type of modification that [[DirectActionsWML#.5Bmodify_ai.5D|modify_ai]] supports.
*'''[micro_ai]''': Add a [micro_ai] at initialization time. See [[Micro AIs]] for details. This is equivalent to adding the micro AI at prestart. The side and action keys are not supported here.
*'''formula'''="": (string) Formula AI code to be executed by the AI. We recommend not using this any more, and it is not guaranteed to continue working. See the [[Formula_AI_Howto|Formula AI legacy documentation]] for more information. {{DevFeature1.13|5}} As of version 1.13.5 this key is ''definitely not'' recognized at this level. It has likely not been recognized for some time prior to this, as well.
*'''time_of_day''', '''turns''', '''engine''': {{DevFeature1.13|5}} Specifies default values for aspects given as attributes or simple tags. (Simple tags are tags that do not contain either a value= attribute or a [value] subtag, with the exception that [attacks] is never a simple tag.) This is available prior to 1.13.5, but more limited; the engine attribute is probably more limited, and there might be problems mixing this syntax with fully-specified composite aspects in the same [ai] tag. (That can easily be worked around in a side configuration by splitting the [ai] tag in two.)
*'''Other tags and attributes''': {{DevFeature1.13|5}} Any other tag or attribute found is assumed to be a simplified aspect. More details about this syntax is given in the section on aspects later on this page. Some of this syntax is available prior to 1.13.5, but it has been generalized in 1.13.5 to automatically work for any compatible aspect. See [[AIWML]] for a list of these tags and attributes.

If no '''ai_algorithm''' is specified, normally the game will automatically load in the default AI, as if you had specified '''ai_algorithm=ai_default_rca'''. However, if there is a '''[stage]''' tag, then this behaviour is disabled and the AI will be built from a blank slate. This special behaviour only comes into play if '''ai_algorithm''' is omitted entirely.

== The [ai] Tag — Stages ==

The [ai] tag can contain one or several stages defined in [stage] tags. If the AI configuration contains several stages, they are executed in the order in which they are put into the [ai] tag.

While there are six different types of stages available, all AI functionality possible in Wesnoth can be achieved using only a single one, the candidate action evaluation loop stage. In the default setup, this stage has ''id'' 'main_loop' and we generally simply refer to it as the ''main_loop'' stage.

Other stages exist mostly for legacy reasons from the times in the AI development when the ''main_loop'' stage did not exist yet. They are currently still functional and kept for backward compatibility reasons, but they are not maintained any more and might be removed in a future Wesnoth release cycle. We therefore recommend that all custom AI development is done using the ''main_loop'' stage only.

All stages support the '''id''' and '''engine''' tags. The latter defaults to cpp, and can be omitted in this case; the former is a unique identifier which is required if you want to later remove or modify the stage with [modify_ai]. If '''engine'''=cpp, an additional '''name''' tag is required, which tells the game which C++ AI algorithm to use. Currently the only valid values are 'ai_default_rca::candidate_action_evaluation_loop' and 'empty'. The 'empty' stage does nothing at all and should generally not be required.

=== ''main_loop'' Stage Configuration ===

For the ''main_loop'' stage, the [ai] tag contains the following elements:

*'''name''': This must be set to 'ai_default_rca::candidate_action_evaluation_loop', so that the AI knows that this is the ''main_loop'' stage.
*'''id''': (string) This is the identifier of the AI. It is usually set to 'main_loop', but can take on any value. It only matters if you are planning to remove or modify the stage during a scenario. Note that adding or removing a candidate action counts as a modification.
*'''engine'''=cpp: (string) This must be set to 'cpp', which is also the default value. It can therefore be omitted.
*'''[candidate_action]''': Candidate action configuration tags. See [[#The_.5Bai.5D_Tag_.E2.80.94_Candidate_Actions|below]] for details.
*'''[args]''': {{DevFeature1.13|5}} Lua engine only; specifies arguments to pass to the stage's execution function. This works similarly to the [args] in candidate actions.

'''Notes:'''
* As an example, the configuration of the ''main_loop'' stage of the default AI is shown [[RCA_AI#RCA_AI_Stage_Configuration|here]].
* Candidate actions can use any of the three available engines. Just because the stage uses the ''cpp'' engine does not mean that the CAs need to do so as well. See [[#The_.5Bcandidate_action.5D_Tag|below]] for an example.
* While that should rarely ever be necessary, it is possible to include several ''main_loop'' stage definitions in the same [ai] tag.
** This is done by putting several [stage] tags into the same [ai] tag
** The AI engine then evaluates the CAs of the first stage in the usual way, until no CA returns a valid score any more.
** After the first stage is finished, it moves on to the second stage and repeats the process, until all stages have finished. This ends the AI turn.
** Obviously, this only makes sense if the sets of CAs of the different stages are not identical (although individual CAs might appear in several stages).

=== Recruitment Stage ===

There is a specialized configurable recruitment stage. However, this stage uses the recruitment functions of the old ''Default AI'' (the one used before the RCA AI existed). Anything that can be done with this stage, and more, can now also be done with the ''recruitment'' candidate action using the [[AI_Recruitment#Aspect_recruitment_instructions|''recruitment_instruction'' aspect]]. It should therefore never be necessary to use this stage and we do not describe it here.

{{DevFeature1.13|5}} This stage has now been removed. Any use of this stage within the old ''recruitment'' aspect should still continue to work, as the syntax of this stage is compatible with the ''recruitment_instructions'' aspect and ''recruitment'' is now considered a synonym of that newer aspect. Straight uses of this stage, however, will no longer function.

=== Legacy Stages ===

Four other stages are also available. They do, however, not provide any functionality that is not also possible with the ''main_loop'' stage, only different ways of achieving the same functionality. We therefore only list them here for completeness, with brief examples and links to legacy documentation.

Note that both this documentation and the stages themselves might be removed at some point.

==== Lua stage ====

Executes Lua code by calling a function created inside a Lua engine. Whatever element is returned by the code in the Lua [engine] tag is accessible here as an upvalue.
So, for example, <syntaxhighlight lang='lua' inline>(...):execute()</syntaxhighlight> calls <syntaxhighlight lang='lua' inline>whatever_is_returned_by_lua_engine:execute()</syntaxhighlight>.
<syntaxhighlight lang='wml'>
[stage]
engine="lua"
code= "(...):execute()"
[/stage]
</syntaxhighlight>

See the [[Lua_AI_Legacy_Methods_Howto#Using_the_Lua_Stage|Lua AI legacy documentation]].

==== Formula AI Side Formulas Stage ====

This stage executes a given Formula AI side formula. Example:
<syntaxhighlight lang='wml'>
[stage]
engine=fai
name=side_formulas
move="write_your_formula_here"
[/stage]
</syntaxhighlight>

See the [[Formula_AI_Howto#Setting_up_the_Formula_AI_side_formulas_Stage|Formula AI legacy documentation]].

==== Formula AI Unit Formulas Stage ====

This stage takes no parameters and executes all Formula AI formulas which are attached to units. Example:
<syntaxhighlight lang='wml'>
[stage]
engine=fai
name=unit_formulas
[/stage]
</syntaxhighlight>

See the [[Formula_AI_Howto#Setting_up_the_Formula_AI_unit_formulas_Stage|Formula AI legacy documentation]].

==== Fallback stage ====

Fall back to another AI. Example:
<syntaxhighlight lang='wml'>
[stage]
id=fallback
name=testing_ai_default::fallback
[ai]
ai_algorithm=default_ai
[/ai]
[/stage]
</syntaxhighlight>
This example shows how to set up a stage to fall back to the old ''Default AI''. This was useful when it was not clear yet how well the RCA AI would work and whether it would suddenly stop in the middle of the CA evaluation loop. There is really no reason to use a fallback stage any more these days, especially since it is also possible to simply add another stage to the AI configuration (without that having to be a fallback stage).

{{DevFeature1.13|5}} This stage has now been removed since the RCA AI is now the only algorithm and thus there's nothing else to fallback to.

== The [ai] Tag — Candidate Actions ==

The ''main_loop'' stage (and only this stage) can contain an assortment of candidate actions. They are evaluated and executed in the manner explained [[Wesnoth_AI_Framework#The_Candidate_Actions_of_the_main_loop_Stage|above]]. This section explains how to configure the [candidate_action] tag that goes into the [stage] tag of the ''main_loop'' stage.

All three engines can, in principle, be used to [[Creating_Custom_AIs#Setting_Up_a_Custom_AI|write custom CAs]]. However, only the use of Lua CAs is recommended for this purpose. Using the ''cpp'' engine has the obvious problem of requiring changes to the Wesnoth source code. Formula AI CAs are discouraged for the same reasons why we do not recommend using Formula AI stages any more.

=== The [candidate_action] Tag ===

The [candidate_action] tag can contain the following keys:

*'''engine''': This key is required for Wesnoth to know which engine the CA should be processed with. Possible values are 'cpp', 'lua' and 'fai'.
*'''id''': The id of the CA is, in principle, optional. However, it is needed if you want to remove or change the CA after its initial definition.
*'''name''': The CAs of the default AI are identified by their name, making this a required key for the ''cpp'' engine. Check [[RCA_AI#Available_Candidate_Actions|here]] for the names of the available default CAs. The key is optional for other engines.
*'''max_score''': The maximum score the CA evaluation function might return. This parameter is optional, but it is useful to reduce the AI move evaluation time. During each iteration through the evaluation loop, the ''main_loop'' stage only evaluates CAs with ''max_score'' larger than that of the highest-scoring CA found so far during this iteration. For that same reason, it also makes sense to order CAs by decreasing ''max_score'' in the [stage] tag, even though that is not technically necessary.
*'''score''': (''cpp'' engine only) The score returned by the CA. Note that this means that ''cpp'' engine CAs always have fixed scores.
*'''[filter_own]''': {{DevFeature1.15|3}} The AI units participating in this candidate action can be restricted to only the units defined in this tag. See the [[AiWML#Filtering_which_Units_Participate_in_which_Actions|AiWML page]] for more information and an example. The content of this tag is [[Creating_Custom_AIs#Creating_Custom_Candidate_Actions|available to both the evaluation and execution function as a WML table]]. This tag is optional. If it is omitted, all AI units are used. (''cpp'' and ''lua'' CAs only; ''fai'' CAs have a different mechanism.)

In addition, [[Creating_Custom_AIs#Creating_Custom_Candidate_Actions|Lua CAs]] also contain the following keys:
*'''location''': File name, including path, of the AI code for the CA.
*'''eval_parms''', '''exec_parms''': (deprecated) The parameters to be passed to the evaluation and execution functions of the AI. These need to be in form of a [[LuaWML#Encoding_WML_objects_into_Lua_tables|Lua table]], without the outer curly brackets. They are [[Creating_Custom_AIs#Creating_Custom_Candidate_Actions|passed to these functions]] as the second argument, ''cfg''.
*'''sticky''', '''unit_x''', '''unit_y''': Specifies that this is a [[Lua_AI_Legacy_Methods_Howto#Behavior_.28Sticky.29_Candidate_Actions|behavioral candidate action]] that is automatically removed once the unit on the given location dies.
*'''[args]''': {{DevFeature1.13|5}} This replaces eval_parms and exec_parms, which are now deprecated and will be removed in a later version. The content of this tag is available to both the evaluation and execution function as a WML table. Details at the link above.

'''Notes:'''

* The syntax for Lua CAs has evolved a fair bit, and some of the older syntaxes are still supported. They are deprecated, however, and may be removed in a future version.
** If you need information on the old syntax, check out the [[Lua_AI_Legacy_Methods_Howto|Lua AI legacy documentation]].
* The current syntax was originally called ''external Lua CAs''. However, as this has now become the standard, we drop the ''external'' and simply call them ''Lua CAs''.
* Formula AI CAs contain some additional keys. As we do not recommend using the ''fai'' engine any more, we do not describe this syntax here and refer to the [[Formula_AI_Howto|Formula AI legacy documentation]] instead.

Here are examples of [candidate_action] tag uses:

'''Combat CA''' of the default AI:
<syntaxhighlight lang='wml'>
[candidate_action]
id=combat
engine=cpp
name=ai_default_rca::combat_phase
max_score=100000
score=100000
[/candidate_action]
</syntaxhighlight>

'''Lua AI CA''':
<syntaxhighlight lang='wml'>
[candidate_action]
engine=lua
name=return_guardian_bob
id=return_guardian_bob
max_score=100010
location="~add-ons/my_addon/lua/return_guardian.lua"
[args]
id=Bob
return_x=10
return_y=15
[/args]
[/candidate_action]
</syntaxhighlight>

=== Available Candidate Actions ===

* '''''cpp''''' '''engine''': The available CAs of the default AI are given [[RCA_AI#Available_Candidate_Actions|here]].
* '''''lua''''' '''engine''': The [[Micro AIs]] are written using Lua CAs, which can be used either as they are or as templates for [[Creating_Custom_AIs#Setting_Up_a_Custom_AI|creating your own CAs]]. They can be found [https://github.com/wesnoth/wesnoth/tree/master/data/ai/micro_ais/cas here].
* '''''fai''''' '''engine''': As we said above, we do not recommend using the ''fai'' engine any more for creating custom CAs. However, if you want to do so, a few simple Formula AI CA examples can be found in the [[Formula_AI_Howto|Formula AI legacy documentation]].

== The [ai] Tag — Aspects ==

The values of aspects are used by the candidate actions of the default AI as parameters influencing the AI behavior. Thus, for the most part, they only apply to the CAs of the default AI. It is, however, possible to write Lua CAs which query certain aspects and take them into account. For example, some of the [[Micro AIs]] respect some of the default aspects.

A huge number of aspects are available for the default AI. They are therefore given [[AiWML|their own page]]. Only the syntax and internal structure of the aspect configuration is shown here.

There are two types of syntax for defining aspects. In the following, we slowly walk you through these using increasingly complex examples, with the full definition of all the possible key and tags listed at the end of this section.

The vast majority of aspects can be defined using a straight-forward syntax of simply defining their values using keys or tags. These are sometimes referred to as ''simple'' aspects, though the simplicity is in the syntax rather than a feature of the aspect. (In actual fact, this syntax defines facets of a ''composite'' aspect.) Examples are
<syntaxhighlight lang='wml'>
[ai]
time_of_day=dawn
aggression=0.765
[/ai]
</syntaxhighlight>
or
<syntaxhighlight lang='wml'>
[ai]
[avoid]
terrain=W*
[/avoid]
[ai]
</syntaxhighlight>
For simple aspect syntax, several additional keys are available in addition to the aspect names themselves, '''time_of_day''' (as shown in the example above), '''turns''' and {{DevFeature1.13|5}} '''engine'''. These are also explained at [[AiWML]], but these keys basically affect all aspects defined in this simple syntax. {{DevFeature1.13|5}} Currently, every aspect except the attacks aspect can be defined in this way. Prior to 1.13.5, there were also a few other aspects that could not be defined in this way.

{{DevFeature1.13|5}} Occasionally, a more complex structure is required. Any aspect name can be used as a tag which contains the contents of a [facet] tag. Thus, the above two examples could also be implemented like this:
<syntaxhighlight lang='wml'>
[ai]
[aggression]
time_of_day=dawn
value=0.765
[/aggression]
[avoid]
[value]
terrain=W*
[/value]
[/avoid]
[/ai]
</syntaxhighlight>
This syntax has the advantage of allowing you to set the facet ID as well as the invalidate keys, if desired. They are not affected by toplevel ''turns'', ''time_of_day'', and ''engine'' keys. However, they expand in a very similar way to the simpler syntax - that is, they define a facet of a composite aspect. In the case of aspects that require a tag in both syntaxes (such as ''avoid''), it's the presence of [value] that disambiguates them.

The third way of defining an aspect is to use the full syntax, which is sometimes called ''complex aspects'', though this is merely a feature of the syntax and not something inherent to any given aspect. All simple aspects expand to equivalent complex aspects, after all. A complex aspect uses the following keys:
*'''engine'''=cpp: The engine to use for this tag. This can usually be omitted.
*'''id''': A unique identifier for the aspect. This is mainly used for [modify_ai].
*'''name''': Only required for the ''cpp'' engine. Possible values are ''standard_aspect'', ''composite_aspect'', ''lua_aspect'', and ''ai_default_rca::aspect_attacks''. Most of these values are only valid with the cpp engine, while ''lua_aspect'' is only valid with the Lua engine. A sensible default is normally chosen, allowing this to be omitted. {{DevFeature1.13|5}} Prior to 1.13.5, some of these values would not work in certain contexts, but in 1.13.5, any valid value may be used here in any aspect context.
*'''invalidate_on_*''' keys: These four keys are primarily for advanced usage. They are described in more detail below.

A complex aspect contains additional keys and tags based on the value of its name attribute. Standard aspects contain either a '''value''' attribute or a '''[value]''' tag which specifies the attribute's value. The attack aspect contains the '''[filter_own]''' and '''[filter_enemy]''' tags, as described [[AiWML#Filtering_Combat_with_the_attacks_Aspect|here]]. Lua aspects contain additional keys as defined [[LuaAI#Dynamic_Lua_Aspects|here]]. And composite aspects contain the following additional tags:
*'''[facet]''': A sub-aspect which will be taken as the value of the aspect, unless its '''turns''' and '''time_of_day''' keys do not match. {{DevFeature1.13|5}} Formerly this had to be a standard aspect, but as of 1.13.5 it can be any type of aspect, such as a composite aspect or a Lua aspect.
*'''[default]''': A sub-aspect which will specifies the default value of the aspect, which is used if there are no facets or if all facets are inactive. {{DevFeature1.13|5}} Formerly this had to be a standard aspect, but as of 1.13.5 it can be any type of aspect, such as a composite aspect or a Lua aspect. '''Note: Overriding the default aspect is generally not recommended. It's just as easy to simply add an unconditional facet instead.'''

At the toplevel within the [ai] tag, complex aspects are defined by an [aspect] tag containing the various keys and tags that define the aspect. Typically, these toplevel aspects are composite aspects, meaning that they contain facets to specify the actual value of the aspect (though they can easily be changed to Lua aspects {{DevFeature1.13|5}} or standard aspects). The '''id''' attribute in an [aspect] tag ''must'' be a valid aspect name, otherwise it will give an error and be ignored.

Let's try to explain this using the aggression example from above. If we wanted to define that using the complex aspect syntax, it would look like this:
<syntaxhighlight lang='wml'>
[ai]
[aspect]
id=aggression
[facet]
id=custom_aggression # Can be used to remove this facet later
time_of_day=dawn
value=0.765
[/facet]
[/aspect]
[/ai]
</syntaxhighlight>

The most important part is that the composite aspect structure uses so-called ''facets'', which contain the value of the aspect. If the aspect is a single scalar value, such as in this example, that value is assigned using the '''value''' key. If it is a tag, such as [avoid], the content of the tag is added inside a '''[value]''' tag. For example:
<syntaxhighlight lang='wml'>
[facet]
engine=cpp
id=custom_avoid
name=standard_aspect
[value]
terrain=W*
[/value]
[/facet]
</syntaxhighlight>

That’s it for the most practical purposes, although there a few more parameters in the full aspect configuration:
<syntaxhighlight lang='wml'>
[aspect]
engine=cpp
id=aggression
invalidate_on_gamestate_change=no
invalidate_on_minor_gamestate_change=no
invalidate_on_tod_change=yes
invalidate_on_turn_start=yes
name=composite_aspect
[facet]
engine=cpp
id=
invalidate_on_gamestate_change=no
invalidate_on_minor_gamestate_change=no
invalidate_on_tod_change=yes
invalidate_on_turn_start=yes
name=standard_aspect
time_of_day=dawn
turns=
value=0.765
[/facet]
[default]
engine=cpp
id=custom_aggression
invalidate_on_gamestate_change=no
invalidate_on_minor_gamestate_change=no
invalidate_on_tod_change=yes
invalidate_on_turn_start=yes
name=standard_aspect
time_of_day=dawn
turns=
value=0.4
[/default]
[/aspect]
</syntaxhighlight>

Thus, the full list of keys and tags inside the [aspect] tag is as follows:
* '''engine'''=cpp: The engine processing the aspect. Most often this is 'cpp', which is also the default and can therefore be omitted, but it is also possible to define dynamic Lua aspects. These have the syntax [[Wesnoth_AI_Framework#Dynamic_Lua_Aspects|shown below]]. (Note: engine=fai is not supported for aspects.)
* '''id''': This must be set to the aspect name (yes, name) shown at [[AiWML]].
* '''name'''=composite_aspect: As described above.
* '''invalidate_on_turn_start'''="yes": (boolean) If "yes", the value of this aspect is invalidated at the start of each AI turn.
* '''invalidate_on_tod_change'''="yes": (boolean) If "yes", the value of this aspect is invalidated when the absolute time of day bonus changes anywhere on the map. This implies invalidate_on_turn_start. {{DevFeature1.13|5}} Before 1.13.5, this was not implemented.
* '''invalidate_on_gamestate_change'''="no": (boolean) If "yes", the value of this aspect is invalidated on each game state change (on turn start, move, attack, recruit, etc.). This implies invalidate_on_turn_start.
* '''invalidate_on_minor_gamestate_change'''="no": (boolean) If "yes", the value of this aspect is invalidated on each minor game state change (on set unit variable, etc). This implies invalidate_on_gamestate_change. (Currently this is not implemented.)
* '''code''': (Lua engine only) If the aspect is defined dynamically in Lua, this key contains the Lua code to be executed. See [[Wesnoth_AI_Framework#Dynamic_Lua_Aspects|below]].
* '''[facet]''' or '''[default]''': These tags define the aspect values. '''[default]''' contains the default value assigned to the aspect at the start of the game. It cannot be modified or deleted. '''[facet]''' tags contain the custom values for the aspect and override the value from [default]. If there are several [facet] tags, the most recent one active at the current time of day and turn number is applied. The tags contain the following keys:
** '''engine''': Same as above, overrides the key with same name in the [aspect] tag
** '''id''': This has a different meaning from the [aspect] tag ''id'' key. It can be freely chosen and is only needed if you plan to [[Modifying_AI_Components#Modifying_Standard_Aspects|modify or remove]] the aspect at a later time. If not, the ''id'' can be omitted. Not used in the [default] tag.
** The different '''invalidation keys''': They have the same meaning as those under the [aspect] tag, but apply only to this facet.
** '''name''': Possible values include 'standard_aspect' and 'composite_aspect', as described above. The engine chooses the correct value automatically, so you never have to worry about this unless you're doing something unusual.
** '''time_of_day''' and '''turns''': Define when the aspect is active. See [[AiWML#Defining_Aspects_and_Goals_of_the_RCA_AI|here]] for details. Not valid in '''[default]'''.
** '''value''' or '''[value]''': This, finally, is the actual value the facet returns. See the examples above for syntax.

All of this is admittedly a bit complex. This is done because there are a couple aspects which require all these keys and customization functionality. In the vast majority of cases, you do not have to worry about this and can simply use the ''standard'' aspect syntax of the first two examples.

'''Note:''' If unsure, the easiest way to see the full configuration for any given aspect (or any other AI component, in fact) is either in savefiles, or in-game by typing <code>:inspect</code> in debug mode and choosing 'ai config full' for a team.

==== Some more on the invalidation keys ====

A few of the aspects return a significant amount of information, as opposed to only a single value (such as ''aggression'') or an array of locations (such as ''avoid''). For example, the [[AiWML#Filtering_Combat_with_the_attacks_Aspect|''attacks'' aspect]] returns a list of possible attacks of the filtered attacker/target unit pairs, together with ratings for many different aspects of these attacks. This list, originally established at the beginning of the AI turn, is not valid any more after the first attack has been performed and needs to be reset. The AI does this by "invalidating" the aspect, after which the aspect information is calculated anew the next time the aspect is queried by a candidate action.

If you check out the default values of the invalidation keys, you see that, in the default configuration, information stored about aspects is reevaluated only at the beginning of each AI turn and when the time of day changes. It is not reevaluated by default after the game state changes (such as after an attack) during the AI turn. This works for most aspects, but not for the ''attacks'' aspect (and it might not be sufficient for all custom aspects either). This is the reason why <code>invalidate_on_gamestate_change=yes</code> needs to be set explicitly for the ''attacks'' aspect as [[AiWML#Filtering_Combat_with_the_attacks_Aspect|shown here]].

As a final comment, you can see at that link that the ''attacks'' aspect is also an exception in that its configuration and definition do not contain a value key or [value] tag, but '''[filter_own]''' and '''[filter_enemy]''' tags. If you look at the configuration in the inspector, you will also see that it has ''name=ai_default_rca::aspect_attacks'' instead of ''standard_aspect''. In other words, the attacks aspect is never a standard aspect (though it can be a composite or {{DevFeature1.13|5}} Lua aspect).

==== Dynamic Lua Aspects ====

It is also possible to [[LuaAI#Dynamic_Lua_Aspects|define aspects dynamically in Lua]]. In that case, no [default] and [facet] tags are added to the configuration. They are replaced by the '''code''' key used to define the aspect. For the second example given at the link above, the configuration looks like this:
<syntaxhighlight lang='wml'>
[aspect]
code=<<
local value = wesnoth.current.turn / 10.
return value
>>
engine=lua
id=aggression
invalidate_on_gamestate_change=no
invalidate_on_minor_gamestate_change=no
invalidate_on_tod_change=yes
invalidate_on_turn_start=yes
name=lua_aspect
[/aspect]
</syntaxhighlight>

It's also possible to put all of that ''in'' a [facet] tag, rather than in an [aspect] tag – this would allow the Lua aspect to take effect only at certain times of day, for example.

== The [ai] Tag — Goals ==

Goals are essentially a special type of aspect, in that they are used to customize the behavior of the default (RCA) AI. However as [[RCA_AI#RCA_AI_Aspect_and_Goal_Configuration|described here]], the default goals are not stored in configuration files. Similarly, custom goals are stored in a different format in the AI configuration than the aspects. Fortunately, this format is the same as that used for [[AiWML#Examples_of_.5Bgoal.5D_Tag_Usage|defining custom goals]]. See the examples given there for syntax.

== The [ai] Tag — Engines ==

As stated above, it is not necessary to define engines any more these days. Just for reference, we list the possible attributes of the [engine] tag here nevertheless.

* '''id''': (string) Optional id of the engine.
* '''engine'''=cpp: (string) The type of engine used to parse this [engine] config snippet. This will always be cpp, since the lua and fai engines are not equipped for parsing [engine] tags.
* '''name'''=cpp: (string) Name of the [engine]. Must be a valid engine name (cpp, lua, or fai).
* '''code''': If <code>name=lua</code> only. The Lua code to add to the engine. See the [[Lua_AI_Legacy_Methods_Howto#Lua_AI_Setup|old method for setting up custom Lua CAs]] for details. It should generally <code>return ...</code> or similar - if it doesn't, other components using the Lua engine may not be able to function correctly.

== See also ==
* [[Wesnoth AI]]
* [[AiWML]]

[[Category:AI]]

A Tale Of Two Brothers Story

2024-07-03T13:29:01Z

Egallager: /* The Chase */ number agreement

This is the story of [[A Tale of Two Brothers]].

Maghre was a sleepy, remote village in the western reaches of the Kingdom of Wesnoth. The wars and intrigue that plagued the Kingdom passed Maghre by with little impact. This sleepy existence was shattered when a dark mage moved into the area and began preying on the populace to satisfy the needs of his black magic.

Baran was a local mage whom the people looked up to. He organized the villagers' defense but knew that old swords and pitchforks would not be enough. Baran contacted his brother Arvith for help; Arvith was the leader of a small troop of horsemen earning a living as caravan guards.

Arvith heeded his brother's call and he and his company rushed to Baran's assistance.

In 1.18, Baran contacts Arvith by the village's non-magical trade beacon. Older versions involved a magical amulet.

== Rooting Out a Mage ==
Baran and Arvith set off to eliminate Mordak the Dark Mage. The plan is for Arvith's forces to distract Mordak's while Baran surprises the mage with a magical attack. All is going according to plan until Baran is captured and taken away to the north.

== The Chase ==

Arvith's chase of Baran's kidnappers leads him to an elf-occupied forest. The leader of the elves refuses passage and Arvith's company must defeat them before continuing after Baran's kidnappers. Arvith captures one of the kidnappers who reveals where Baran is being held.

Since 1.16, the elves' motivations are that they suspect Baran of himself being a necromancer. In older versions, the leader of the elves had made a pact with the necromancers.

== Guarded Castle ==

With a mixture of force and cunning, Arvith's men break into the castle and rescue Baran.

== Return to the Village ==

Upon returning to Maghre, the brothers discover than an opportunistic Orcish Warlord has attacked. The village's defenders were depleted by the departure of Arvith's expedition and are barely holding. After subduing the Warlord, Baran is faced with leading his village through a time of rebuilding. It would be an arduous task, but Baran knew his brother would always respond to his call should the need arise once more.

[[Category:Campaigns - Story Material]]
[[Category:Campaigns - A Tale of Two Brothers]]

StandardUnitFilter

2024-06-28T13:10:45Z

Egallager: link to the have_unit tag; clarify role of search_recall_list=yes key

{{WML Tags}}

From [[FilterWML]], this is the standard way of filtering units.

When a unit filter is applied to a map, first it applies to all units on the field,
based on their coordinates.
Next it applies to units in the recall list.
This is important to remember as it means, for example,
that the tag '''[kill]''' can be used to kill units in the recall list.

You can access the filtered unit within the filter as the ''$this_unit'' variable, see [[SingleUnitWML]] for the possible content of these variables

The term [[StandardUnitFilter]] means that the set of such keys and tags (see below) can appear at that point. Often a [[StandardUnitFilter]] needs to be included in a [filter] tag. But many tags take the [[StandardUnitFilter]] directly as an argument, like [[DirectActionsWML#.5Bkill.5D|[kill]]] and [[ConditionalActionsWML#.5Bhave_unit.5D|[have_unit]]] (which each accept a few additional keys of their own). See [[Special:WhatLinksHere/StandardUnitFilter]] for tags which can contain a StandardUnitFilter.

__TOC__

The following attributes and sub-tags are allowed:

* '''id''': unit matches the given id. This is the same as ''id'' in the [unit] tag. Note that it is independent of a unit's user-visible name, which can be internationalized independent of this (see [[SingleUnitWML]]). id= can be a comma-separated list, every unit with one of these ids matches.
* '''speaker''': alias for id (no comma-separated list supported)
* '''type''': matches the unit's type name (can be a list of types)
* '''type_adv_tree''': {{DevFeature1.13|7}} matches the type name of the unit and all its advancements (can be a list)
* '''race''': the race of the unit type. This can be a comma-separated list; the unit's race must match one of the given races. Mainline races are listed in data/core/units.cfg 
* '''variation''': the unit type variation id (can be a list of variation ids)
* '''has_variation''': matches if the unit type for the unit defines at least one of the variation ids provided as a comma-separated list
* '''upkeep''': {{DevFeature1.15|3}} The upkeep of the unit. Can be either a non-negative number or one of the special values ''loyal'', ''free'', ''full''. Note that while ''loyal'' and ''free'' are synonymous with an upkeep of 0, the value ''full'' is not synonymous with any single numeric value – it is equivalent to <code>$this_unit.level</code>.
* '''ability''': unit has an ability with the given id; see [[AbilitiesWML]]. This can be a comma-separated list. The unit must have at least one of the specified abilities.
* '''ability_type''': {{DevFeature1.13|7}} unit has an ability with the given type (tag name) - eg, ''ability_type=heals'' will match a unit with any healing ability.
* '''ability_type_active''': {{DevFeature1.13|8}} unit has an ''active'' ability with the given type (tag name).
* '''ability_id_active''': {{DevFeature1.15|13}} unit has an ''active'' ability with the given id; see [[AbilitiesWML]]
* '''trait''': {{DevFeature1.13|8}} This can be a comma-separated list. The unit must have at least one of the specified traits.
* '''status''': {{DevFeature1.13|0}} matches if the unit has the specified status active. This can be a comma-separated list, in which case the unit will match as long as it has one of the listed statuses active (note: possible statuses are listed on the [[SingleUnitWML]] page).
* '''side''': the unit is on the given side (can be a list)
* '''has_weapon''': the unit has a weapon with the given name {{DevFeature1.13|5}} Now deprecated
* {{anchor|has_attack|'''[has_attack]'''}}: {{DevFeature1.13|5}} the unit has a weapon matching the [[StandardWeaponFilter]]. If this is present, '''has_weapon''' is ignored.
* '''canrecruit''': yes if the unit can recruit (i.e. is a leader)
* '''gender''': female if the unit is female rather than the default of male
* '''role''': the unit has been assigned the given role; see '''[role]''', [[InternalActionsWML]]
* '''level''': the level of the unit (this can be a comma-separated list).
* '''defense''': current defense of the unit on current tile (chance to hit %, like in movement type definitions)
* '''movement_cost''': current movement cost of the unit on current tile. Can be a number, range, or comma separated range.
* '''x,y''': the position of the unit. Note: As a special case '''x,y=recall,recall''' matches units on the recall list. Note that the similar '''search_recall_list=yes''' key is only available as part of the '''[have_unit]''' condition tag, and is not otherwise considered part of a StandardUnitFilter.
* '''find_in''': name of an array or container variable; if present, the unit will not match unless a unit with the same '''id''' is already stored in the variable
* {{anchor|filter_vision|'''[filter_vision]'''}}: this tests whether or not the unit is currently visible
** '''visible''': yes or no, default yes. When "yes", this matches units that are not obscured by fog or shroud, and that are not hiding (via the {{tag|AbilitiesWML|hides}} ability). When "no", this matches units that are obscured by fog or shroud, or that are hiding.
** [[StandardSideFilter]] tags and keys. Filter for who may be able to see (or not see) the unit. If there is *at least one* matching side which can see the unit then the filter matches, and otherwise it fails to match.
* {{anchor|filter_wml|'''[filter_wml]'''}}: Converts the unit to WML (as if by '''[store_unit]''') and tests it against a [[FilterWML#Filtering_on_WML_data|WML filter]]. For a list of things in the WML that could be filtered on, see [[SingleUnitWML]] or open a saved game in a text editor. Note that this is slower than other methods, so if possible it's better to use other filter keys and tags; however, if the WML filter contains only a child '''[variables]''', then the unit is not converted to WML and the filter is matched only against the unit's variables (which are already WML).
* '''[and]''': an extra unit filter. Unless the unit also matches the [and] filter, then it will not count as a match. ''Note: [and],[or], and [not] filters are considered after the containing filter; they are then processed in the order encountered.''
* '''[or]''': an extra unit filter. If a unit matches the [or] filter, then it will count as a match regardless of conditions in previous filters or the containing filter.
* '''[not]''': an extra unit filter. If a unit matches the [not] filter, then that unit will not be considered a match by the containing filter.
* {{anchor|filter_adjacent|'''[filter_adjacent]'''}} with a StandardUnitFilter as argument; do not use a [filter] tag. If present the correct number of adjacent units must match this filter.
**'''StandardUnitFilter''' tags and keys
** '''count''': a number, range, or comma separated range; default "1-6"
** '''adjacent''': a comma separated list of directions; default "n,ne,se,s,sw,nw" (see [[StandardLocationFilter#Directions|notes]])
** '''is_enemy''': a boolean specifying whether the adjacent unit must be an enemy or an ally (optional)
** '''$other_unit''': {{DevFeature1.13|2}} Within [filter_adjacent], the special variable $other_unit refers to the filtered unit from the enclosing filter, while $this_unit refers (as with all StandardUnitFilters) to the unit being filtered on.
* '''[filter_location]''': [[StandardLocationFilter]] - the tile that the unit is standing on matches the location filter.
*'''[filter_side]''': The currently filtered unit's side must match this [[StandardSideFilter]] for the unit to match.
**[[StandardSideFilter]] tags and keys
* '''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>.
* {{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''.
* {{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].

== [[Wesnoth Formula Language]] ==

When using the '''formula''' key, the '''self''' and (if present) '''other''' objects support the following keys:

* '''x''', '''y''', '''loc''' - the latter is a '''location object''' such as what would be returned from [[Wesnoth_Formula_Language#loc|loc()]].
* '''id'''
* '''type'''
* '''name'''
* '''usage'''
* '''canrecruit''', '''leader'''
* '''undead''' - true if the unit has the ''not_living'' status
* '''attacks''' - a list of '''[[FilterWML#Filtering_Weapons|weapon objects]]'''
* '''abilities''' - a list of the ability IDs the unit possesses
* '''hitpoints''', '''max_hitpoints'''
* '''experience''', '''max_experience'''
* '''moves''', '''max_moves'''
* '''attacks_left''', '''max_attacks'''
* '''level''', '''full''' - '''full''' refers to the unit's level to support the formula <syntaxhighlight lang=wfl inline>upkeep = full</syntaxhighlight>
* '''traits''' - a list of the trait IDs
* '''objects''' {{DevFeature1.19|0}} - a list of the objects IDs
* '''advancements_taken''' {{DevFeature1.19|0}} - a list of the advancements taken IDs
* '''traits_count''' {{DevFeature1.19|0}} - number of traits used by unit regardless of IDs
* '''objects_count''' {{DevFeature1.19|0}} - number of objects used by unit regardless of IDs
* '''advancements_taken_count''' {{DevFeature1.19|0}} - number of advancements taken used by unit regardless of IDs
* '''extra_recruit'''
* '''advances_to'''
* '''status''' - a list of active statuses
* '''side_number'''
* '''cost'''
* '''upkeep'''
* '''loyal''' - a constant 0 to support the formula <syntaxhighlight lang=wfl inline>upkeep = loyal</syntaxhighlight>
* '''hidden'''
* '''petrified''' - true if the unit has the '''petrified''' status
* '''resting'''
* '''role'''
* '''race'''
* '''gender'''
* '''variation'''
* '''zoc'''
* '''alignment'''
* '''facing'''
* '''resistance''', '''movement_cost''', '''vision_cost''', '''jamming_cost''', '''defense''' - {{DevFeature1.15|3}} Maps containing the basic movetype data. The '''defense''' and '''resistance''' maps contain the actual defense and resistance values, rather than the values specified in the WML, so you do not need to subtract them from 100.
* '''flying''' {{DevFeature1.15|3}}
* '''vars''' - WFL variables owned by the unit, which can be set and used by FormulaAI
* '''wml_vars''' - the WML variables stored in the unit
* '''n''', '''s''', '''ne''', '''se''', '''nw''', '''sw''', '''lawful''', '''chaotic''', '''neutral''', '''liminal''', '''male''', '''female''' - these are all defined to be the equivalent string so that, for example, you can write a formula like <syntaxhighlight lang=wfl inline>alignment = liminal and gender = female</syntaxhighlight> without needing to quote the alignment and gender strings.

== A Note about Re-Using the Same Attribute ==
You are limited to having each attribute, such as '''id''', appear once or less in a [[StandardUnitFilter]]. However, this can be worked around. If you have several specific units you want excepted from matching, use a separate [or] subfilters for each one. Also you can use [not] subfilters. For example to kill ([kill] uses the standard unit filter) all units except Gwiti Ha'atel and Tanar you can do the following:

<syntaxhighlight lang='wml'>
[kill]
[not]
id=Gwiti Ha'atel
[/not]
[not]
id=Tanar
[/not]
[/kill]
</syntaxhighlight>

And similarly if you wanted to kill both Gwiti Ha'atel and Tanar, but no one else you could do the following:

<syntaxhighlight lang='wml'>
[kill]
id=Gwiti Ha'atel
[or]
id=Tanar
[/or]
[/kill]
</syntaxhighlight>

== Tutorial ==

* [[FilterWML/Examples_-_How_to_use_Filter|How To Use Filter (with examples)]]

== See Also ==

* [[FilterWML]]
* [[ReferenceWML]]

[[Category: WML Reference]]

How to Shade

2024-06-26T08:10:09Z

Egallager: minor copyediting

{| style="float:right; margin-left:1em;"
|__TOC__
|}

For artists seeking a better understanding of '''How to Shade''', here is a guide.

The only way that we are capable of seeing things is by light passing into our eyes. It is a good visualization to think of light as little particles - balls if you will, that are created at a light source (the filament of a lamp, for example, or the flame of a candle), and bounce around off of surfaces until they are absorbed by the retina of our eyes, or absorbed by the many surfaces around us. These little balls of light are called "photons".

One of the first things you must understand about light is that, for any scene you stand in, you only see an infinitesimally small portion of the light in that scene - you only see what passes into your eye. Many thousands of times more light never makes it in there, and hence, is never seen. It is absorbed by materials around you, and turned into heat, or ricocheted off into the distance.

All of the light that you see depends just as much on where YOU are, as on what it is like. Think about how the moon reflects off of water - have you ever noticed how it moves with you if you yourself move? It doesn't stop shining at the place it was shining before just to accommodate you - no, it's still shining there after you leave. In fact, it's shining everywhere around the water.

===Reflection===
When light bounces off of something, it follows the basic rule of reflection - the angle that the light comes in at is the same angle that the light travels away at. The easiest way to visualize this is by thinking of how a pool ball bounces off the side of a pool table.

http://gs295.sp.cs.cmu.edu/brennan/files/jetryl/tutorials/how-to-shade/shading-reflection1.png

The trick is - this is true in 3 dimensions as well as two. If you toss a rubber ball at the ground, it will bounce up at the same angle that it hit the ground at.

http://gs295.sp.cs.cmu.edu/brennan/files/jetryl/tutorials/how-to-shade/shading-reflection2.png

All of these angles have to be measured, though, from something called the '''normal angle''' - something perpendicular to the surface (which means the same thing in both 2 and 3 dimensions). In a game of pool, the normal angle to the side of the pool table would be a line drawn straight out from the side of the table. Each side has its own normal angle, just as each surface has its own normal angle.

If you are thinking of the floor, the normal angle to it would be something that is perpendicular to both north-south, AND east-west. The only option for that is either straight up or straight down. So, if you drop a ball straight down onto the floor, it will reflect off of that floor at the same angle as it hit the floor at. In this case, it hit the floor at 0°, and thus it will bounce straight back up - also at 0°. If you toss a ball forward, and it hits the ground at 45°, it will bounce back up, on the opposite side of the "normal" angle.

If you don't get this - ask your local math teacher. They do, and they'll be happy to teach you what a normal angle is. Have them teach it to you, and have them point out to you what the normal angle of a more complex object, like, say, a ball, is. Also have them show you how things reflect across a normal.

===Planar analysis===
Planar analysis is an oft-misunderstood technique taught in art studios. People teach it to help students visualize 3d forms, but really its best use is in approximating shading, by making it easy to find normal angles. I blather on and on about normal angles in this tutorial, but the concept doesn't make any sense for a surface that isn't flat.

The trick is, to realize that any round surface can be approximated by several flat surfaces. One of the wonderful examples that we have today, which artists of the past did not, is 3d videogames - especially the more primitive ones, like what were on the first generations of 3d consoles (eg. N64, Playstation). Notice how all of the round surfaces in those games are actually made up of flat surfaces, just like a crystal.

A flat surface is easy to find the normal of. And you can approximate any object by chopping it up into flat surfaces. Each one of these will have a different normal angle. To make the real drawing, as you cross between these little planes, or polygons, you blend the angles together (or "interpolate" them, or transition between them).

Consider the following two slides from a book by Andrew Loomis - the first showing rather clear planar analysis, and the second showing how it would get worked into a real drawing workflow.

http://gs295.sp.cs.cmu.edu/brennan/files/jetryl/tutorials/how-to-shade/shading-planar-analysis1.png
http://gs295.sp.cs.cmu.edu/brennan/files/jetryl/tutorials/how-to-shade/shading-planar-analysis2.png

===Approximations===
The easiest way to approximate the effects of light is to break how light bounces off of something into two categories: Diffuse, and Specular reflection.

Specular reflection works in the way I described above.

Diffuse reflection doesn't. It happens because surfaces are not perfectly smooth - and it happens because these surfaces are "apparently" breaking the law of reflection that I stated above. A surface which is not smooth will cause much of the light which lands on it to bounce off at a random angle, rather than at the same angle it came in at, but on the other side of the normal.

It's still following the law of reflection, but what's happening is that instead of hitting one cohesive surface, the bajillions of photons are bouncing off of tons of tiny little surfaces, each pointing in their own direction.

A surface that had purely specular reflection would look something like a mirror. A surface that had, not purely, but very diffuse reflection would look something like a piece of cotton, or charcoal. Real materials have a mix of both - shinier materials have stronger specular reflections, and weaker diffuse reflections, and vice-versa for dull materials.

Diffuse light accounts for the vast majority of what we are able to see on physical objects.

===How to draw this===
All this theory has been fine and dandy, but you need to put this on paper. How you do it, is that you imagine yourself as being a 3d rendering program, and you go through the same steps that it does.

Imagine your view as a camera, taking a picture of the scene. Your canvas is a square, and the camera is a point behind it. In order to choose whether something is lit up or not, you fire a ray out from your camera, through a point on your canvas. Yes, this is a position on the page you're drawing on - that page exists in both the real world, and is also a window into the world you're drawing.

You then see where that ray bounces off to, and see what kind of light it ends up hitting. Why? Because the light will follow the exact same path, except in reverse! Straight into your eye/ onto your page!

In order to tell whether something should be bright or not, for the specular light, you see if this line bounces straight into a light. For a simple, and classic scene, consider a ball sitting in empty space, with the sun shining over your left shoulder. There will be one single spot on the ball where you see the direct reflection of the sun. One shiny point. That's the specular reflection.

Now for the diffuse reflections. The level of brightness of a diffuse surface is proportional to how close that surface is to being at the right angle for reflection that I stated above. If a light is shining at a surface at 15°, it will look brightest at the opposite 15°. This is NOT when the surface is facing directly at the light - thinking that it is results in pillowshading. Pillowshading is only accurate when you, and light striking the surface are in a straight line with the surface. This is only true when you're using a camera flash in a pitch-dark room, or when you have the biggest source of light around. It might be true if the sun were shining over your shoulders, except that your shadow would likely get in the way.

The correct view is hard to intuit, and rather than flog it with words, I give you visual example. This is a diffuse-surfaced sphere hanging in empty space, with a light source. Notice something in this example - the brightest spot is NOT at the edge of the sphere. It would be, if the light were coming from the far side of the object, but the light is on the near side.

http://gs295.sp.cs.cmu.edu/brennan/files/jetryl/tutorials/how-to-shade/shading-diffuse-sphere2.png

For a second example, I give you a sphere with light coming, more or less, from behind and to the side of it. Note how one entire hemisphere is completely dark.

http://gs295.sp.cs.cmu.edu/brennan/files/jetryl/tutorials/how-to-shade/shading-diffuse-sphere1.png

==="Ambient" light===
Because so much of the light in Diffuse reflections bounces in random directions, a lot of it does NOT come straight from a source. There is enough bouncing off of other surfaces to illuminate things rather heavily. Consider the moon. You may have noticed that, with a crescent moon, you can see the dark side of the moon, as well as the light side. The light illuminating that dark side is not coming directly from the sun, rather it's bouncing off of the earth, hitting the moon, and then bouncing back down to us.

But don't, from that example, think of this as being a very weak effect - it's very powerful in more down-to-earth situations. One of the best is an overcast day. When you stand out in a field on such a day, all sides of you will have relatively equal illumination. This is from the diffuse, "ambient" light bouncing off of the clouds, and thus coming at you from all directions. Another good example is direct afternoon sunlight, mentioned below - in such a situation, you can still see the dark side of a person, and that's from the ambient light reflecting off of the ground, and then back to you.

The amount of surfaces facing an object determine how much it will be illuminated by this. Not the whole object, just whatever parts of it are facing other, illuminated, surfaces. The more directly these surfaces are facing the object, the more illuminated it will be.

===Directional light===
There is one more level of approximation necessary for doing a simple cell-shaded drawing, and that is directional light. The number one thing that makes this necessary is the sun, or any powerful light sources.

The sun lets out a torrent of light that hits an object, and then bounces off of it. Because the sun is so far away, all of this light is roughly coming in at the same angle.

One half of the object will be have tons of light hitting it - and its diffuse reflections (and specular reflections) will be very strong. The other half of the object will have only the light that was bouncing off the ground and then back towards you to account for it, and thus will have very weak diffuse and specular light.

The cut-off edge for this is determined by the rules of reflection I stated above. If the normal angle, for a surface of the object, is facing more than 90° away from the light, it will be dark.

===Conclusion===
I've only outlined a very complicated topic, here, but hopefully this can serve as a beginning for you. Try to recognize these things in the world around you, as you see them, and incorporate that into your drawings. Likewise, playing around with a 3d rendering program may serve to illustrate a number of the things I've only spoken about, here.

== See Also ==
* [[Create]]
* [[Art Tutorials]]

[[Category: Art Tutorials]]

Guide to UMC Content

2024-06-08T02:35:12Z

Egallager: /* Flight to Freedom */ add FtF 5.6.0

This is a guide to current-ish user-made content for players. It provides unfamiliar players with detailed information about campaigns (including story, completion, difficulty and playing style) as well as detailed information about eras. Feel free to edit this guide, as it is a wiki.

This list covers add-ons for the latest 2 stable releases (1.14 and 1.16) of Wesnoth. There are archived versions of this page for [[Guide_to_UMC_Content/1.10|1.10]] and [[Guide_to_UMC_Content/1.12|1.12]].

For content creators who loved an add-on that hasn't been added to 1.14 or 1.16 yet, and are wondering about taking it over, please ensure that its entry on the older (1.12 or 1.10) wiki page is up to date, add a link to the add-on's feedback thread in the forums, and generally do the tidy-up that doesn't need you to start changing the campaign, and then ask the old maintainer. (You should probably also wait a bit before assuming that a maintainer isn't already porting to 1.16).

If you are looking for even more campaigns, please see the links in at the bottom of this page.

== Instructions ==
When adding a campaign to the list, please place it in its alphabetically sorted location, ignoring any initial article ("A", "An", or "The").

=== Blueprint for Campaigns ===

* Description:

* Author:

* Maintainer: if not maintained by the author anymore.

* Status:
** Broken = Does not work at all
** Incomplete = Partially written, no progress
** WIP = Partially written, some progress
** Complete = Completely written, but buggy as well as potential balance issues.
** Finished = Completely written, minimal to no bugs, slight balance issues possible.

* Version campaign version on the add-ons server

* Length:

* Requirements: (only if needed)

* Difficulty:

Please note: Often campaigns introducing new mechanics are listed as expert level on the add-on server, here difficulty means the raw difficulty after the mechanics are understood.

** Unbalanced = If you can't beat the hard mode, it isn't necessarily unbalanced, but if the difficulty changes erratically from one scenario to the next and only people using the debug mode have seen the final, then it is.
** Easy
** Normal
** Hard

Please note: If you didn't play the campaign, write the difficulty written on the add-ons server.

* Style:

Please note: Many campaigns will feature more than one style. Please list the most significant ones. If you don't know which style is the campaign you are listing, don't write this.

** Skirmish = small to medium sized armies, your standard Wesnoth gameplay
** Dungeon = long and narrow tunnels (not every underground scenario is a dungeon, a dungeon isn't necessarily underground)
** RPG = role playing game elements such as talking with non-player-characters, item collection, dependency on a party of very few adventurers without or limited recruits
** Survival = being exposed to changing, spawning enemies while remaining on the same map
** Large Battle = large number of units on the battlefield, sizely maps
** Simulation = campaigns feat. terrain modification, alternative resources
** Boss battle = the challenge is to defeat a single powerful enemy unit
** Minigames = there are puzzles and minigames in the campaign that significantly differ from standard Wesnoth gameplay

* Faction/Era: Era for the whole campaign and more specifically the faction or unit composition you field.

* Custom units: Link to the unit tree for cases that don't feel sufficiently described by Faction / Era entry.

* Forum: Links to the feedback and development threads at forums.wesnoth.org

=== Blueprint for Eras ===

* Description:

* Author:

* Maintainer: if not maintained by the author anymore.

* Status 1.14/1.16:
** see the list of statuses in the campaign blueprint

* Faction Descriptions: Describe your individual factions here.

* Requirements: (only if needed)

* Forum: Links to the feedback and/or development threads at [https://forums.wesnoth.org/ forums.wesnoth.org].

== How to play for UMC factions ==

=== Southern Nations by Elvenisko ===
[[How_to_play_Death_Knights|Death Knights]] |
[[How_to_play_Southern_Drakes|Southern Drakes]] |
[[How_to_play_Southern_Dwarves|Southern Dwarves]] |
[[How_to_play_Southern_Elves|Southern Elves]] |
[[How_to_play_Southern_Mages|Southern Mages]] |
[[How_to_play_Southern_Mercenaries|Southern Mercenaries]] |
[[How_to_play_Southern_Orcs|Southern Orcs]] |
[[How_to_play_Southern_Swamplords|Southern Swamplords]] |
[[How_to_play_Southern_Nations|Comparison]] |
[https://units.wesnoth.org/1.17/Southern_Nations/en_US/era_southern.html All units (can be out of date)]

== Battle for Wesnoth 1.14 and newer ==

=== Campaigns ===

==== After the Storm ====

''Follow the journey of Galas and his band following the events of Invasion from the Unknown''

'''Author:''' shadowm/ShikadiQueen/Iris

'''Status:''' Finished, 0.10.11

'''Length:''' 3 episodes of 13 scenarios each, some of which are multi-part

'''Difficulty:''' Medium-hard

'''Style:''' Skirmish, Boss Battle, Dungeon

'''Faction/Era:''' Many custom units

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=32091]

'''GitHub:''' [//github.com/project-ethea/After_the_Storm]

'''Note:''' (vultraz) Long, very enjoyable campaign with great story. (Knyghtmare) The best UMC campaign ever!

'''[[Guide_to_UMC_Campaigns/Players_Reviews#After_the_Storm|Players’ Review(s)]]'''

====A Beastly Tale====

''When a small village is beset by troubles, its fate rests in the hands of a young woodsman and the animals he befriends.''

'''Author:''' GloccusV

'''Status:''' Complete

'''Version:''' 2.0.3

'''Length:''' 5 scenarios

'''Difficulty:''' Intermediate

'''Custom units:''' [//units.wesnoth.org/1.14/A_Beastly_Tale/en_US/A_Beastly_Tale.html Here]

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=41434&p=633612&hilit=A+Beastly+Tale#p579093 Here]

====A Song of the Winds====

''Every era has its heroes and heroines. Before the song of Myra, the odyssey of Akhen Wadjet and the aria of Tenma Yozora, there was the song of the winds that echoed in the mountains and halls at the heart of the Great Continent. Follow young Maat of Hiera'Shirsha and Prince Abhai of Garet-Desh in the war that set the stage for one of the greatest upheavals Irdya has ever witnessed.
(Prequel to the Dragon Trilogy)''

'''Author:''' revansurik

'''Status:''' Complete

'''Version:''' 1.0.0

'''Length:''' 43 scenarios (some of them dialogue-only)

'''Difficulty:''' Intermediate

'''Custom units:''' War of Legends + Custom factions

'''Forum:''' [//https://forums.wesnoth.org/viewtopic.php?f=8&t=53913 Here]

==== Bad Moon Rising ====

''An expedition to gather treasure from the cold north sets off compounding disaster.''

'''Author:''' Doofus-01

'''Status:''' Complete 1.10.0

'''Length:''' 20 scenarios

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Archaic Era

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=31348]

'''GitHub:''' [//github.com/doofus-01/wesnoth-Bad_Moon_Rising]

==== The Black Cross of Aleron ====

''A elvish school for druids comes under attack by goblins. It seems more than just a routine raid; is there something more sinister behind this attack? - In Beseiged Druids, you control Eärendil, the surviving teacher at the school, and the many and varied initiates. Not all of these are ordinary students; many have been experimenting with other forms of magic, while others are simply overachievers in some area of study. Unfortunately, they are not especially good at combat, at least initially. Together with a very small contingent of surviving guards, it is up to these students to save the island of Aleron from disaster.''

'''Author:''' Celtic Minstrel

'''Status:''' Complete 2.0.3

'''Length:''' 9 scenarios

'''Difficulty:''' Unbalanced

'''Style:''' Skirmish

'''Faction/Era:''' Default, Elves

'''[https://units.wesnoth.org/1.14/Black_Cross_of_Aleron/en_US/celmin-druid-siege.html Custom units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=37342

==== Danse Macabre ====

''Macabre is a rare zombie who has intelligence and will. What's he like? What's his purpose?''

'''Author:''' kamikaze

'''Maintainer:''' James_The_Invisible

'''Status:''' Completed, 1.3.2

'''Length:''' 12 scenarios

'''Difficulty:''' Unbalanced

'''Style:''' Large Battle

'''Faction/Era:''' Default, undead

'''[//units.wesnoth.org/1.14/Danse_Macabre/en_US/Danse_Macabre.html Custom units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=33745]

'''Note:''' While the campaign is playable on Wesnoth 1.14 without major issues, it is (still) in need of heavy re-balancing. Sadly, for various reasons I am not able to do it in near future but patches are always welcome, preferably in form of pull requests on [https://github.com/konecnyjakub/Danse_Macabre GitHub].

==== Dawn of Thunder ====

''A young elvish fighter is send to represent the Aethenwood at the Ka'lian. The adventure turns out to be bigger than expected.''

'''Author:''' Paulomat4

'''Maintainer:''' egallager

'''Status:''' [https://github.com/cooljeanius/dawn_of_thunder/issues/3 Incomplete], latest release on the BfW 1.16 add-on server is [https://github.com/cooljeanius/dawn_of_thunder/releases/tag/0.2.4 0.2.4].

'''Length:''' 18 scenarios

'''Difficulty:''' Challenging

'''Style:''' Skirmish, Large Battle, RPG-elements

'''Faction/Era:''' Default, Elves, Humans

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=39512 forums.wesnoth.org/viewtopic.php?f=8&t=39512]

==== A Fiery Birth ====

''A scholar of the Great Academy journeys to the land of the drakes to discover their secret origins.''

'''Author:''' Mathbrush

'''Status:''' Complete

'''Version:''' 1.2.0

'''Length:''' 9 scenarios

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=47861&p=623953 Here]

'''GitHub:''' [//github.com/brirush84/AFieryBirth]

==== The Final Exam ====

''Young mage Erika must find a magic book to become a true mage. But will it really be her final exam?''

'''Author:''' Elven

'''Status:''' Complete, 2.6.1

'''Length:''' 4 scenarios

'''Difficulty:''' Easy

'''Style:''' Skirmish, Minigames

'''Faction/Era:''' Default, Loyalists

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=23398]

'''Note:''' Short, easy campaign with varying objectives. Features female mage as leader.

==== [[FlightToFreedom|Flight to Freedom]] ====

''Flight to Freedom chronicles the story of the drake hero Malakar, and his desperate cross-country flight out of slavery.''

'''Authors:''' MadMax, Nova

'''Maintainer:''' egallager

'''Status:''' Complete

'''Length:''' 20 playable scenarios + 1 dialogue-only, for a total of 21 (may need an update now that the "B" branch has been reactivated)

'''Version:''' [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.2 5.4.2] (for BfW 1.16), or [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.5.0 5.5.0] (for BfW 1.17), or [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.6.0 5.6.0] (for BfW 1.18)

'''Difficulty:''' Expert

'''Style:''' Skirmish, Large Battle, Puzzle

'''Faction/Era:''' Drakes

'''Required Wesnoth version:''' 1.16+ or 1.17+ or 1.18+

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=1887 Development], [//forums.wesnoth.org/viewtopic.php?t=40195 Feedback]

'''GitHub:''' [//github.com/cooljeanius/Flight_Freedom github.com/cooljeanius/Flight_Freedom]

==== Inky's Quest ====

''The Cuttlefish Campaign''

''Are the cuttlefish mere beasts or something more? What stories would they tell if they could speak? This story provides one possible answer. The easiest difficulty provides hints for novice players.''

'''Author:''' Telchin

'''Status:''' Complete

'''Length:''' 12 scenarios + story-only epilogue, for a total of 13

'''Version:''' 1.5.6

'''Difficulty:''' Easy

'''Style:''' Skirmish

'''Faction/Era:''' Custom units (cuttlefish, tentacles, giant clams...). Enemies use both default era units and custom ones.

'''[//units.wesnoth.org/1.14/Inky_Quest/en_US/Inky_Quest.html Custom Units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=32501]

==== Invasion from the Unknown ====

''Episode I - Seeking the Light: Long after the Fall, the last forest elves are forced to abandon their safe valley, and find themselves resorting to the dark means of necromancy in order to survive the perils and challenges of this new harsh world. May they finally free the Great Continent from its chaos, or perish in the foolish attempt of restoring peace and life to the lands.''

''Episode II - Armageddon: As the shadow of Chaos covers the entire continent, an assorted group of foolish heroes prepares a counter-attack to the Empire, with one unique goal in their minds: defeat the evil Emperor, whoever it is. Lead these courageous living and non-living warriors to victory, and rediscover lost secrets of the history.''

'''Author:''' shadowm/ShikadiQueen/Iris

'''Status:''' Finished, 2.1.9

'''Difficulty:''' Normal

'''Style:''' Skirmish, Dungeon, Boss battle

'''Faction/Era:''' Unique. You play Elves and Undead throughout the campaign.

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=43309]

'''GitHub:''' [//github.com/project-ethea/Invasion_from_the_Unknown]

'''Walkthrough:''' [[IftU Walkthrough]]

''[[Guide_to_UMC_Campaigns/Players_Reviews#Invasion_from_the_Unknown|Players’ Review(s)]]'''

==== Leader of the Drakes ====

''Leader of the drakes is killed. His son tries to defend homeland against the orcs. He choosed to ally with saurians, but other clans of drakes disagrees. Will fast and unexperienced Morin win against orcs and rebel drakes alike?''

'''Author:''' Elven

'''Status:''' Complete, 1.02b

'''Length:''' 3 scenarios

'''Difficulty:''' Easy/Medium

'''Style:''' Skirmish, Minigames

'''Faction/Era:''' Default, Drakes

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=53951&start=15]

'''Note:''' Short, easy campaign with simple objectives. Features Drake Glider as leader and modified Drake Burner with cold and slowing blade.

==== Legend of the Invincibles ====

'''''Part I: Shrouded in Darkness''' (5 chapters, 90 scenarios) - A pair of heroes, after stopping an orcish threat, are outcast into caves, where they have no other choice than to become liches in order to survive. They preserved their original appearance and moral principles, and fight in various skirmishes against evil (although using evil methods sometimes), until the Fall, when they are buried alive under the ashes of the third sun.''

'''''Part II: Into the Light''' (5 chapters, 110 scenarios) - Long after the Fall, the lich heroes awaken. Searching for more power, they manage to resurrect themselves as living beings, but this time more powerful and ridden of the evil within. But the evil from inside them did not cease to exist, and started a campaign to conquer the world. Stopping the campaign caused an even worse disaster...''

'''Author:''' Dugi

'''Status:''' Complete

'''Length:''' 200 (+8 talk-only) scenarios

'''Difficulty:''' Normal

'''Style:''' mostly Skirmish and Dungeon (all other styles are present as well, but less frequently)

'''Faction/Era:''' Elves, Loyalists, Undead, Dwarves; but they advance past their usual maximum level

'''Forum:''' [//r.wesnoth.org/t32384]

'''GitHub:''' [//github.com/Dugy/Legend_of_the_Invincibles]

'''[[Guide_to_UMC_Campaigns/Players_Reviews#Legends_of_the_Invincibles|Players’ Review(s)]]'''

'''Note:''' The most unique feature of this campaign is its RPG-like unit development system, enemies drop items units can use, leaders are stronger than most usual units and all units get AMLA (after maximum level advancement) after reaching their maximum level (that is also increased by a load of additional level 4 units).

==== A New Order ====

''The old kingdom of Wesnoth has fallen before barbarian hordes. The occupying barbarians are on the brink of civil war, the seeds of Wesnothian rebellion are kept alive by old legends, while bandits and Dunefolk mercenaries roam the land. Can Gawen Hagarthen unite these disparate factions against a common foe?''

''Note: This campaign contains mature themes, some of which may be unsuitable for children.''

'''Author:''' szopen

'''Maintainers:''' nemaara (Yumi), egallager

'''Status:''' Finished

'''Version:''' [https://github.com/nemaara/A_New_Order/releases/tag/1.6.0 1.6.0]

'''Length:''' Hard to say as it is non-linear; it is advertised as having 45 scenarios, but the numbering only goes up to 30 due to some of the scenarios being alternates to one another.

'''Requirements:''' Requires BfW 1.16+. Also uses the "Akladian Music" add-on.

'''Difficulty:''' Advertised as intermediate; could be considered hard, though.

'''Style:''' Mostly Skirmish, some Large Battle

'''Faction/Era:''' mostly various human factions (including the Dunefolk), with the addition of the Akladian faction of humans

'''[//units.wesnoth.org/1.16/A_New_Order/en_US/A_New_Order.html Custom Units]'''

'''Forum threads:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=6486&sid=2e644284f54e65736b4f1543b7098ef9 Development], [//forums.wesnoth.org/viewtopic.php?t=36183 Feedback], [//forums.wesnoth.org/viewtopic.php?t=6174 Original (older) art thread], [//forums.wesnoth.org/viewtopic.php?t=36074 Current art thread]

'''GitHub:''' [//github.com/nemaara/A_New_Order github.com/nemaara/A_New_Order]

'''Note:''' (Pyrophorus) Certainly one of the most mature and well designed campaign in add-ons. A must.

''' [[Guide_to_UMC_Campaigns/Players_Reviews#A_New_Order|Players’ Review(s)]]'''

==== The North Wind ====

''Wesnoth's army was occupied fighting Mal Ravanal in the East, but there were whisperings of an orcish attack in the north. Konrad II must send Deoran, now an experienced rider and commander, with a small band of knights to hold off the orcs....''

''This campaign features unique gameplay characteristics such as a lack of recruiting and a 24-turn time-of-day cycle.''

'''Author:''' aelius, Deusite; pyndragon

'''Status:''' WIP, 0.3.0

'''Length:''' 1 playable scenario, 6 intended

'''Difficulty:''' Normal

'''Style:''' RPG, Skirmish, Survival

'''Faction/Era:''' Loyalists

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=42854]

==== The Ravagers====

'''Description:''' ''The Ravagers'' is a tale of pure revenge. A tale of justice served cold, told in a flashback-style point-of-view narrative, by a ranger in the Inn at Weldyn.
The campaign includes many new exciting gameplay features, fun mechanics such as drinking, hundreds of custom units, and many more.

'''Author:''' WhiteWolf

'''Status:''' Finished*

'''Length:''' 25 playable scenarios + 2 scene scenarios

'''Requirements:''' Akladian Music Pack, Underness Music Pack

'''Difficulty:''' Intermediate

'''Style:''' Skirmish + RPG / Flashback narrative

'''Faction/Era:''' Humans, Elves, Ravagers(dark humans)

'''[//units.wesnoth.org/1.14/The_Ravagers/en_US/The_Ravagers.html Custom Units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=44930]

'''*Notes:''' The main storyline is complete, but there are unfinished side-missions that are still in development. The campaign is aimed to become finished with version 1.2.0.

==== Return from the Abyss ====

''After taking part to a disastrous expedition, Khafir and his men are lost and isolated from their people, thousands of miles away from home, bound by a pact sealed with a powerful dwarvish king. Help him escape from the depth of Irdya and finding his way back, in an adventure across two worlds during the rise of a sinister force in the Great Continent.''

'''Author:''' skeptical_troll

'''Status:''' finished

'''Length:''' 19 playable scenario + 10 story only

'''Difficulty:''' Hard

'''Style:''' Skirmish, Dungeon

'''Faction/Era:''' Dunefolk/Default

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=44545]

==== Rise of the Dunefolk ====

''Adventure of Siabbin and Helare from small village in desert, who step by step made the foundation of the Dunefolk nation. Play a stunning adventure against many enemies in different maps - from sandstorm to swampy areas and caves. Defeat powerful lich lord and train one of the best dark mages in the world of Wesnoth.''

'''Author:''' Elven

'''Status:''' Completed

'''Length:''' 11 scenarios

'''Difficulty:''' Medium

'''Style:''' Skirmish, Minigames, Survival

'''Faction/Era:''' Default, Dunefolk and dark mage

'''Note:''' enjoable gameplay with every map different. Enough experience to upgrade your units.

==== The Return of the Darks ====

''The Darks are a race which left Wesnoth in the ancient times and lives on Isles in the sky. But now the Magic wich helped them to move the Isles in Sky got lost and the isles are about to fall down. Rumion an adventurer goes to Wesnoth and searchs for something that could help them.''

'''Author:''' thvk

'''Status:''' WIP

'''Length:''' 4 playable scenario + 2 story only

'''Difficulty:''' Easy

'''Style:''' Skirmish

'''Faction/Era:''' Default + some self made units

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=52731]

==== Secrets of the Ancients ====

''From the Journal of Ardonna of Tarrynth:''

''It's unfair that we humans must die after so few years. Though this is the natural order, we need not embrace it! The lords on the Green Isle knew how to live forever. Pursuit of that knowledge was declared illegal by King Haldric I, but I believe it is worth the risk: If I can rediscover the secrets of the ancients, not only will I cheat death, I will become a hero to the whole continent!''

'''Author:''' beetlenaut

'''Status:''' Mainlined (this is now one of the campaigns that is downloaded with Wesnoth itself)

'''Length:''' 18 playable scenarios + 3 story only

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Undead/Default

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=40545]

'''Walkthrough:''' [[Secrets of the Ancients Walkthrough]]

==== Swamplings ====

''Banished by Yushnak the Ponderer, a tribe of lowly swamp goblins endure in the deadly mire of Pogo Bog. Four centuries before the founding of Wesnoth, this is the story of the goblins' struggle against the intrigues and betrayals of the greater races, and the rise of the first wolf rider.''

'''Author:''' John Rawlins (boru)

'''Status:''' Complete

'''Length:''' 17 scenarios

'''Version:''' 1.2.0i

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction:''' Goblins

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=41254]

'''[[Guide_to_UMC_Campaigns/Players_Reviews#Swamplings|Players’ Review(s)]]'''

==== The Dark Hordes ====

''Lead fugitive dark sorcerer Gwiti Ha’atel to mastery of the undead hordes.''

'''Author:''' Circon

'''Maintainer:''' Various

'''Status:''' Incomplete/WIP

'''Length:''' 15 scenarios done so far

'''Version:''' 0.1.2

'''Difficulty:''' Unbalanced

'''Style:''' Skirmish

'''Faction/Era:''' Default undead

'''[//units.wesnoth.org/1.10/The_Dark_Hordes/en_US/The_Dark_Hordes_1.html Custom Units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=16576&]

==== The Tale of Vaniyera ====

''The expansionist Lavinian Legion, led by the Imperator himself, has invaded the northern forests of the Sidhe, or Wild Elves. It is up to Leithan the Thunderblade and his advisor Vaniyera to push its armies back where they came from...''

'''Author:''' oreb, turin

'''Maintainer:''' UnwiseOwl

'''Status:''' Finished 0.11.0

'''Length:''' 5 scenarios

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Imperial Era, Sidhe.

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=37880]

'''Walkthrough''' There is a video-walkthrough by the campaign maintainer that begins [https://www.youtube.com/watch?v=dGM1bjImvkI&list=PLZorLYWvUD7VIhaXxKwzO8iQANlp_TaF0 here].

'''Note:''' As of August 2014, all previous issues raised about this campaign have been addressed. If you've not played this campaign since 1.4 or 1.10, in this humble maintainers opinion, it's worth another go.

==== To Lands Unknown ====

''This is the story of Mehir, the Summoner, and his journey to lands unknown.''

'''Author:''' inferno8

'''Status:''' Complete

'''Length:''' 20 scenarios, 4 dialogue only

'''Difficulty:''' Intermediate (Era of Magic)

'''Style''': Skirmish, Dungeon

'''Era:''' Era of Magic

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=31799]

'''GitHub:''' [//github.com/inferno8/wesnoth-To_Lands_Unknown]

'''[[Guide_to_UMC_Campaigns/Players_Reviews#To_Lands_Unknown|Players’ Review(s)]]'''

==== A Vision Blinded ====

''Defend the northern forest against what appeared like a routine orcish raid, and unravel the greater conspiracies that lie below its waves.''

'''Author:''' LemonTea

'''Maintainer:''' Adamant14

'''Status:''' Complete, 1.0.14

'''Length:''' 13 playable scenarios + 1 dialogue-only

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default, Elves (+ Trolls, Outlaws)

'''[//units.wesnoth.org/1.10/A_Vision_Blinded/en_US/A_Vision_Blinded.html Custom units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=23463]

=== Eras ===

[[Category:Campaigns|*]]
[[Category:Eras|*]]

==== '''Southern nations''' ====

[[How_to_play_Southern_Nations|Everything about southern nations, including how to play series]]

==== '''War of Legends''' ====

'''Description:''' A multiplayer era focused on the Dark Irdya Campaigns. Contains 15 factions.

'''Author:''' Tahsin Jahin Khalid (Lord-Knyghtmare)

'''Maintainer:''' Tahsin Jahin Khalid (Lord-Knyghtmare)

'''Status:''' Complete, new features being added for the 1.15.x version of the add-on

'''Factions:'''

# Aragwaithi
# Windsong
# Human Alliance
# Orcish Union
# Southerners (Desert Elves)
# Outlaws
# Elementals
# Undead
# Drakes
# Dark Legion
# Sylvans
# Minotaurs
# Vampires
# Dunefolk
# Knalgan Alliance

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=19&t=30087 Development and Feedback Thread]

'''GitHub:''' [//github.com/knyghtmare/War_of_Legends]

==== Era of Magic(EoMa) ====

'''Description:''' Aiming at using the whole potential of Battle of Wesnoth's graphic engine, the Era of Magic is considered to have a most amazing special effects and attack animations in the BfW game. There are 8 playable factions with fully animated units and tons of special effects contained in the era, and the stories of them are told in the campaign "To Lands Unknown".

'''Author:''' Inferno8

'''Maintainer:''' Inferno8

'''Status:''' Finished, 3.1

'''Faction Descriptions:'''

Sky Kingdom - powerful magi of all kinds. Their knowledge allows them to cast amazing spells and summon creatures like unstopable Golems or mysterious Mus. Masters of Elements and Gurus are one of the most powerful human beings in the Era.

Al-Kamija - these proud people are good warriors and spell casters of the desert. They use magical circles and scrolls to summon amazing creatures like Jinns or elementals from other dimension called Abyss. These creatures can't be poisoned, which is a great advantage.
(The campaign "To Lands Unknown" is mainly about the story of this faction)

Tharis - fearsome Tharis faction is very dangerous especially at night. Cruel people of Tharis with their black magic and dreadful monsters like Hydra can demolish everything standing on their way. Being so powerful in attack, Tharis have no healer, so they need to push forward at all costs.

Kharos - this strange name is the name of a beautiful country ruled by prophets of light. These peaceful people are masters of defense and support. Their formations of healers and Shielders assisted by Silver Warriors, who can teleport between friendly villages, are very hard to destroy.

Barbarians - the best in hand-to-hand combat. This multi-cultural society divided into Goblins, Orcs, Cyclops and Trolls with their own advantages and disadvantages can be hard opponent, but separately they are very weak.

Runemasters - these Dwarves use runic magic and equipment and are well known of their protection against magic. The Runemasters create steam machines like Gyrocopters, Robots and even mighty Mechanical Dragons. Units from this faction are very resistant but slow.

Dark Blood Alliance - this faction is composed of agile lizards, giant frogs, wyverns swallowing enemies and salamanders, which have developed to perfection the art of disguise. At the head of the community stand shamans known for their water magic, which is used in the fight as well as in healing.

Destroyers - a terrifying undead creations consisting of civilizations long gone...

'''Version:''' 1.1.1 (February 18th, 2015)

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=19&t=20039 Development and Feedback Thread]

'''GitHub:''' [//github.com/inferno8/wesnoth-Era_of_Magic]

==== Ageless Era ====

'''Description:''' Ageless Era is a compilation of the most popular eras and factions on the add-on server. It is more an era pack than an era.

'''Author:''' mnewton1, Ravana and various

'''Maintainer:''' Ravana

'''Status:''' Finished, 4.19

'''Unit Tree:''' [//units.wesnoth.org/1.12/Ageless_Era/en_US/Ageless%20Era.html Ageless Unit Tree (for 1.12)]

'''Factions List:''' Currently there are 91 factions in the era:

Default: Loyalist, Rebels, Northerners, Undead, Knalgan Alliance, Drakes, Khalifate

Extended Era: Loyalist, Sylvans, Dwarves, Outlaws, Northerners, Undead, Chaos, Dark Elves

Archaic Era: Khthon, Phantoms, Despair, Primeval, South-Seas, Ukians, Northern Orcs

Era of Four Moons: Highlanders, Imperialists, Sea States, Darklanders, Dalefolk, Freemen, Pygmies, Whites

Era of the Future: Welkin, Brungar

BEEM: Anakes, Calidonians, Wood Warriors

Custom Factions: Yokai, Dark Legion, Desert Elves, Steelhive, Frozen

Era of Myths: Celestials, Devlings, Elementals, Therians, Vampires, The Warg, Windsong

Feudal Era: Aragwaithi, Ceresians, Clockwork Dwarves, High Elves, Orcish Khaganates

Imperial Era: Arendians, Cavernei, Issaelfr, Lavinian Legion, Marauders, Orcei Gladiatores, Sidhe

Era of Strife: Eventide, Triththa, Free Saurians, Eltireans, Minotaurs

Era of Magic: Barbarians, Dark Blood Alliance, Sky Kingdom, Kharos, Runemasters, Al-Kamija, Tharis, Destroyers

Mercenaries Era: Highlanders, Enchanters, Avians, Slavers, Mercenaries, Equestrians, Emperor's Guard, Oracles, Holy Order, The Cult, Fanatics, Tribalists, Hive, Infernai, Refugees, Blight

'''Git:''' [https://github.com/ProditorMagnus/Ageless-for-1-11 Ageless-for-1-11] and also for 1.12 and [https://github.com/ProditorMagnus/Ageless-for-1-14 1.14]

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=19&t=25274 Development and Feedback Thread]

==== Imperial Era (IE) ====

'''Description:''' One of the oldest maintained user eras, the Imperial Era brings together seven different factions in a completely re-imagined setting, the world of Orbivm, a very lethal world indeed. The era contains both mainline and development versions of each faction and can be used to play five campaigns, each featuring a different race.

'''Author:''' Orbivm Project (but really Turin)

'''Maintainer:''' UnwiseOwl

'''Status:''' Complete, 0.23

'''Faction Descriptions:'''

# Lavinian Legion - Based on the Roman Legion, the Lavinians have strong, versatile melee units in the legionaries and a range of support classes sourced from amongst the Lavinian population and various subjugated races. The legion are strong in the plains but weak when fighting in forested areas. The Lavinians are featured in "Fall of Silvium".
# Sidhe - The Sidhe are a group of forest-dwelling elves whose focus is stealth and fleet movement. Their mages are able to channel the lightning itself, and their various other units move almost as fast. The Sidhe feature in "Tale of Vaniyera".
# Marauders - Based on the Germanic peoples that eventually conquered Rome (hint, hint), the Marauders are equally as at home in the hills, forests and swamps of their homeland. Their hard-hitting melee units are practicalyl unstoppable during the night-time. The Marauders are the stars of the "Alfhelm the Wise" campaign.
# Orcei Gentorum - The orcs have been captured gladiators slaving away in the Lavinian arenas for generations.The life of an orc in Orbivm is harsh and brutal, just like the orcs themselves. The tale of the uprising of one such group of Orcs is told in "Up from Slavery".
# Cavernei - The Cavernei are a dwarvish race with similarities to the mainline Knalgans, but with a greater emphasis on the military uses of runesmithing. They get a campaign too, in "Gali's Contract"
# Issaelfr - The frost elves live on the fringes of the habitable lands of Evrosia, the main continent of Orbivm, and have become inured to difficult conditions and tuned in to their Fae natures. They don't have a campaign yet, but you could always write one.
# Arendians - The Arendians are horse-lords living on the Western steppes of Evrosia. A life of constant battle has developed a military-focused society where warriors are trained from a young age. They used to have a campaign, but it fell into disrepair a very long time ago.

'''Wiki:''' [[Orbivm]]

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?t=37920 Development and Feedback Thread]

==== Lonely Era (LE) ====

'''Description:''' The Lonely Era is a new collection of six selected superior solitary sides with interesting and unusual abilities, traits and attributes.

It has been extensively revised and rebalanced over the last few years from the original era and the constituent factions.

'''Author:''' Atreides. Based on work by Shield, Desert_Shyde, Brilliand, Stern, Cloud, Grigistian, mikoc5, Stopsignal, The_Gnat, Minnakht.

'''Maintainer:''' Atreides

'''Status 1.16:''' Finished

'''Faction Descriptions:'''

1) Santa's Helpers are his Elves as well as animated pine trees. They are an updated faction based on the Merry Christmas Campaign. Beware of Elves bearing gifts though, the presents are very distracting. They are unique in not having standard levels, they each can gain up to 4 special abilities via AMLA but always remain at level 1. Of course there are also Flying Reindeer and Christmas Seals.

2) Gremlins are an all teleporting race of elusive ethereal creatures. Individually fragile they work together using their tremendous mobility to swarm and overwhelm their enemies. Their mages are perhaps the ultimate glass cannons but if you can somehow keep one alive long enough it might even get to level 5 and become immortal.

3) Vaeringjar are a Viking faction allied with Wolfkin. The vikings eschew ranged weapons as well as sissy ideas like dodging blows but are a very, very hardy lot. They also have a unique herbalist unit that can inspire berserker rage in adjacent vikings for a turn. The wolfkin are lithe and armed with bows and teeth on the other hand. They are also very agile in contrast to the vikings. As nocturnal hunters they are devastating at night and almost helpless in the day.

4) Avians are cold loving, water hating bipedal birds. Their hollow bones and feathers make them vulnerable to fire and blunt weapons. They are unique in having cheap level 0 healers. Unusually their leaders are not drawn from the ranks but form a separate class only selectable as leaders. Tamed Albatrosses to patrol the awful waters.

5) The Deep Ones - Slimy, slippery, blasphemous fish-frogs of the nameless design - living and horrible - have now been sighted on the edge of Wesnoth. Mutants who slowly evolve from human to monster these creatures are nothing to be trifled with! An all water faction they are quite capable of holding their own against the landlubbers.

6) Jephrifs live far up in the sky, miles above land. Away from even the most basic things most other races take for granted, such as solid ground, their society developed to be quite alien indeed. In recent times, jephrifs began descending from the skies to participate in combat against other races - apparently for their own amusement, seeing life as a game.

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?t=42630 Development and Feedback Thread]

== Additional info ==
See also:
* [[Player_UMC_Reviews|Player UMC Reviews]]
* [[:Category:User-made Campaigns - Walkthroughs|Walkthroughs for user-made campaigns]]
* [//r.wesnoth.org/t37476 forum thread] for this page
* [[Guide_to_UMC_Content/1.12|Guide to user-made content (UMC) for Battle for Wesnoth 1.12]]
* [[Guide_to_UMC_Content/1.10|Guide to user-made content (UMC) for Battle for Wesnoth 1.10]]
* [//r.wesnoth.org/t36733 thread discussing 1.8 UMC that wasn't ported to 1.10]
* [//r.wesnoth.org/t48086 thread discussing all UMC that hasn't been ported to 1.14]
* [//addons.wesnoth.org the addon server]

FlightToFreedom

2024-06-08T02:33:29Z

Egallager: /* News */ add 5.6.0

<big>Flight to Freedom</big>


Last updated 1/27/24 (although before that, there was a long stretch where it hadn't been updated since 2/22/14, so much of the info on this page may still be out-of-date)

Flight to Freedom is a campaign featuring the Drakes. The hero, Malakar, and his tribe have been enslaved by humans,
and Malakar must free the tribe and take revenge on his oppressors.

Latest version is [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.2 5.4.2] (for Wesnoth 1.16.x+), or [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.5.0 5.5.0] (for Wesnoth 1.17.x+) 
The forum thread is [http://www.wesnoth.org/forum/viewtopic.php?f=8&t=1887 here]. 
Made by MadMax, Nova 
Currently maintained by [[User:egallager|egallager]] 

== News ==

9/6/04: 
News started, not that I expect much to come up.

Artists wanted [http://www.wesnoth.org/forum/viewtopic.php?t=2996 here] for a new Kogw graphic. 
Announce your loyalty to the Drake cause [http://www.wesnoth.org/forum/viewtopic.php?t=2976 here]!

9/7/04 
I need feedback to keep improving. Keep it coming.

9/13/04: 
Revision 27 released, with many changes. A major update.

9/17/04: 
Poll updated. Redeclare your loyalties [http://www.wesnoth.org/forum/viewtopic.php?t=3132 here]!

9/19/04: 
Poll updated again. Prove yourself [http://www.wesnoth.org/forum/viewtopic.php?t=3143 here]! 
Campaign is on campaign server (requires CVS). Unless any major bugs arise before 0.8.5 is released, all future updates
will take place on the campaign server.

9/23/04 
revision 28 released on campaign server. Contains new drakes, Kogw graphic, and several balance changes. Requires CVS
or better 
Need attack/defense animations for Kogw graphic, need indoor time graphic (the picture under the map)

9/24/04 
revision 28.3 on campaign server. This is necessary for compatibility with CVS as of 9/24/04 (when the Drake Slave was
removed). Also has many bug fixes, including the bug that caused scenario 2 to hang.

9/26/04 
revision 28.4 on server. Bug fixes, balancing, additions to River of Skulls (credit Wesvoid), and an easter egg (not
telling you what, but I will say it's randomly activated in Endgame).

10/5/04 
revision 29 released. 1.4MB. Major changes: 
many bug fixes 
thunder spirit spawn animation 
debugger unit for testing and cheating 
improvements to Rebellion, Manor, Exodus 
new sound in the victory sequence 
new Drakes 
Note that there are some nasty engine bugs (Savannah #10569, #10570) that cause the recall list to disappear in Open
Ocean, and the campaign to quit altogether in Drake Escape. If anyone can help, I would very much appreciate it.

10/8/04 
New version. This changes the pier tiles to bridge, and it adds the Drake Hatchling back and the Drake Guard required
in scenario 21, fixing a major bug involving recruitment.

10/15/04 
New version. Bug in Drake Escape (#10570) worked around, but recall bug (#10569) is still at large. I also have made
Kogw level two, and gave him a level 3.

11/21/04 
New version released on campaign server. (2.2) 
Improvements:

switched to the x.x.x version system 
neutral birds actually fly 
in Drake Escape, Goblin Pillagers can pillage 
balancing changes to many scenarios 
bug fixes in Rebellion

1/3/05 
Update: 
version 2.4:

bug fix 
storyline images for Survival and Rebellion 
balancing improvements in Endgame

1/19/05 
Update: 
version 2.5:

changes to Manor 
a major bugfix

1/20/05 
Update: 
version 2.5.1

minor bugfix in Manor

2/3/05 
Update: 
version 2.6

maps use new terrains where appropriate 
scenarios set on Morogor now have their location denoted on a [http://gs295.sp.cs.cmu.edu/brennan/wercator/index.html Wercator]-
created map ([http://gs295.sp.cs.cmu.edu/brennan/wercator/maps/Peoples_in_Decline.jpg here]) 
balance changes to Manor, River of Skulls, Return to Morogor, Liberation, Endgame 
minor bugfixes

2/19/05 
Update: 
version 2.6.1

directory structure updated 
balance changes to Endgame 
0.8.11 compatibility

2/27/05 
Update: 
version 2.6.2

major bugfix to Blockade, should be possible to win now

4/13/05 
Update: 
version 2.7

scenarios updated for compatibility with 0.9 
varied dialogue improvements 
balancing to River of Skulls (removed village in chokepoint) 
scenarios take advantage of new [objectives] tag, changing objectives added 
maps now use river ford and ruin terrains

5/14/05 
Update: 
version 2.8

translated into German and Swedish 
WML syntax updated for 0.9.1 (involving translations) 
portrait for Kogw

6/10/05 
Update: 
version 2.9

WML updated for 0.9.2 
WML optimizations, separate copies of drake unit.cfgs no longer needed 
portrait for Malakar added 
balancing changes to Survival 
pngcrush run on all images 
rock golem image updated

6/22/05 
NOTE: This update breaks all in-game saves (NOT beginning-of-scenario saves) for the following scenarios: 
Southern Shore 
Open Ocean 
Landfall 
Blockade

Update: 
version 2.9.1

SHOULD be compatible with 0.9.2CVS 
missing newline at end of Flight_Freedom.cfg fixed 
FtF's Pirate Galleon does not override the in-game Pirate Galleon 
new graphics for the Driver 
balancing changes to Rebellion and Manor, Malakar has leadership in those scenarios

7/03/05 
Update: 
version 2.9.2

balancing change to River of Skulls, second chokepoint added parallel to the first 
mid-scenario objectives changes work properly now 
enemies in Survival do not recruit infinite numbers of units 
in Caravan, the caravan's movement points reflects its actual movement

11/02/05 
I know it's been overdue for over a month, but here it is. I've finally got the underground scenarios balanced, but there are so many changes (and so little time to debug) that I have had to release a beta. Hopefully, unless any major bugs are found, I'll finalize FtF 3.0 in a week.

In the meantime, PLEASE reply if you find any bugs.

12/2/05 
UPDATE: 
version 3.0

FtF 3.0 finally released!

Many changes across the board, far too many to list, but here are the major changes (including those of the 3.0 beta): 
storyline changes 
Rebellion enhanced 
underground scenarios balanced 
bug fixes, dialogue changes in Landfall

12/3/05 
UPDATE: 
version 3.0.1

game-killing bug in Landfall fixed (map was not sent)

3/23/06 
UPDATE: 
version 3.1

updated for 1.12+, not backward compatible (beginning-of-scenario saves will still work) 
new terrain added: dark tiles, from UtBS (replaces some dirt, sand in caves) 
maps updated for new terrain 
image references updated to reflect 1.12 directory structure 
terrain code for lava bridge changed to ` instead of ' to avoid conflict 
Skeletal Dragon, Watch Tower moved into FtF from EI, SoTBE (credit Hanno for alerting me to this) 
old wesnoth-8.ogg moved into FtF 
soundtracks updated for music changes/removals 
balancing changes to Underground, River of Skulls, Endgame 
unit .cfgs updated for 1.12 compatibility 
easter egg temporarily commented out, pending consideration 

NOTE: due to technical differences between the old code and the 1.12+ compatible code, I was forced to split the campaign into two distributions, which are on their respective campaign servers. Because of this, however, the translations will not be current until the branch is created on wescamp (so that translators can update it).

8/20/06 
3.2 is on the campaign server. It [i]should[/i] be (almost) fully compatible with 1.18, but I can't guarantee that every animation will work right. I have also made balancing changes up until Exodus (level 16), but the cave levels are still buggy. 
Any feedback is appreciated!

12/22/06 
Hosted on http://warhangel.ru/wesnoth/campaigns/Flight_Freedom_1_x.zip . Special thanks to warhangel for hosting this campaign. 

1/5/07 
FtF 3.3 uploaded.

NPC AI should be fixed 
naga, saurian animations are working, graphics from Marsh Era 
two attack icons added, one by Xan, the other from the Extended Era 
balancing changes to Manor, Underground, River of Skulls and Blockade 
Rockfall fixed with RedLTeut's patch 
other fixes and tweaks which I have forgotten about 

3/20/07 
FtF 4.0 released, for Wesnoth 1.3 and up only. 
compatible with new terrain system, will make cave roads passable 
Manor enhanced 
Survival edited, but cutscene not implemented yet 
several dialogue changes 
Landfall bridge collapse softened 
new graphic for the enslaved Malakar 
several bugfixes 
Drake Guerillas/Revolutionaries have visible spear overlay 
losing text added if Unforgiver is sunk and Kogw has not disembarked 

4/21/07 
version 4.1 released 
many new storyline images added 
many dialogue changes 
extra enemy added to Survival, to shorten it 
balancing changes to Pirate Schooner and Clipper 
all ships have reasonably fitting hit and die sounds 
Manor recruitment bug precluded 
cutscene code moved to separate file (a purely internal change) 
rain added to Open Ocean 
ships should have names 

6/14/07 
version 4.2 released 
dragon in Underground is now friendly 
River of Skulls rebalanced, map edited 
several bugfixes 
Blockade enhanced 
new Malakar and Kamalar graphics 
terrain error messages fixed 
FtF will sort properly in campaign menu 
ships now have names 
experience gained in Survival by Malakar will carry over to Rebellion 

NOTE: This will break saves of River of Skulls. Other saves will work, but they may use the old Malakar (which should work fine). 

7/6/07 
version 4.2.1 released, for Wesnoth 1.3.3+ 
bug fixes in Underground and River of Skulls 
Manor enhanced 
minor dialogue changes 
a few minor bug and potential bug fixes 

7/20/07 
version 4.2.2 released, for Wesnoth 1.3.4+ 
dialogue changes 
storyline graphics updated for new Malakar graphics 
new storyline graphics for Underground and Rockfall 
Caravan elves nerfed 
Drake Escape enhanced 
at least one bugfix 

8/3/07 
version 4.3 released, for Wesnoth 1.3.4+ 
changes (dialogue and other) to Rockfall, Betrayal, Hordes of the Foul Undead, Gate of Storms, Exodus, Blockade and Return to Morogor 
two scenarios added (Swamps of the Jamolar and Council of War), part of a possible branch (accessed from Survival) 
attainable objective added to Survival 
experimental wave animations in Rebellion 
minor bugfixes 
time over events added to some scenarios 
non-expendable player characters are spawned with hero icon 
balancing changes to Betrayal and Blockade 

8/23/07 
version 4.3.1 released, for Wesnoth 1.3.6+ 
new scenario, Forest of Nightmares (in second branch) 
enhancements to Manor, includes irrevenant's indoors time-of-day image 
several bugfixes 
thunder spirits in Landfall and Drake Escape will not spawn on first turn 
multi-hex fireball attack code implemented (not used yet) 
victory music added to victory events 
lava transitions fixed 

9/1/07 
version 4.3.2 released, for Wesnoth 1.3.7+ 
critical 1.3.7 compatibility bug fixed 
new scenario, Hafwyt (still not 100% finished) 
savegames of cave levels will not show snapshots 

10/22/07 
version 4.3.3 released, for Wesnoth 1.3.9+ 
unit WML updated to 1.3.8+ standard 
new scenario: Mountain Crypt (in second branch) 
bugfixes 
turn limit of Forest of Nightmares reduced to 25 
balancing changes 

1/20/08 
version 4.4 released, for Wesnoth 1.3.14+ 
headers and borders added to all maps 
two links added in secondary branch to main branch 
sword-and-shield narrator icon replaced 
new cutscenes 
Mountain Crypt darkness code revised 
bugfixes 

8/19/08 
version 4.5 released, for Wesnoth 1.4+ 
scenario 19, Liberation, completely rewritten 
dialogue changes 
user team names added, so that the status table will show the names of sides in a level 
bugfixes 
levels use new Wesnoth music when appropriate 

2/20/09 
version 4.6 released, for Wesnoth 1.5.6+ 
compatibility with Wesnoth 1.5 branch 
bugfixes 

7/25/21 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.3.3 5.3.3] released, for Wesnoth 1.14+ 
egallager's first release since taking over as maintainer 

5/18/22 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.0 5.4.0] released, for Wesnoth 1.16+ 
first release on the 1.16 add-on server 

11/27/22 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.1 5.4.1] released, for Wesnoth 1.16+ 
see release notes for full changelog 

1/27/24 
versions [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.2 5.4.2] and [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.5.0 5.5.0] released, for Wesnoth 1.16+ and Wesnoth 1.17+ respectively. 
see each of their release notes for full changelogs 

6/7/24 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.6.0 5.6.0] released, for Wesnoth 1.18+. 
see release notes for full changelog 

== See Also ==
* [[Guide_to_UMC_Content]]
* [[CampaignFlightFreedom]]

[[Category:Campaigns - Development]]

NotSoEasyCoding

2024-06-06T20:08:09Z

Egallager: /* Gold graph */ replace GNA link with Wayback Machine backup

This page lists projects which are considered a good idea by the developers, but which have nobody working on them so far. The tasks here are significantly more difficult than the ones in the similar [[EasyCoding]] page. If you think you've got the required skill for one of the tasks listed here, go on, implement it, and you've got a high chance that it'll be accepted. The remaining barrier will only be that it's done well. :-)

If you are such a person, you should feel free to edit this page.

If you're not, you should post a feature request and discuss your idea on the forum or IRC or Discord. A coder with better knowledge of the code might give you the green light to add your feature here.

Anybody should feel free to add "clues" to any tasks, that is entry points, traps to avoid, person to contact to discuss and so on.

If you plan to work on a feature, write your name at the bottom of the feature, with the date. Note that if you spend too long at working on a feature we'll "free" it back (that is if you're not working on it. If you have problems implementing it, just tell us...). We sometimes forget to update this page so it is recommended that, before you start to work on a task, that you ask in irc/Discord whether its still considered a good idea.

If you are part of the Wesnoth dev team you can also add new entries to the list, a new entry must contain at least

1) A description of the problem.
2) A motivation why or in which situations this is important.
3) A link to a corresponding ticket on our bugtracker for discussion, if there is no ticket yet, then make one.

__TOC__

== Game engine ==

=== [[OpenGL port]] ===

While software rendering is all good and nice, Wesnoth's approach does not scale well as display resolutions increase and the need for supporting high DPI configurations is factored in. One can easily see that our zoom functionality is clunky and inefficient. Having support for OpenGL and shaders would also enable us to implement fancier graphical gimmicks such as particle effects and atmospheric lighting. The downside of adding OpenGL to the mix is that we'd need people with a specific skillset to help us maintain the graphics engine in the long term, as hardware and driver-specific quirks are inevitable. Some users are also concerned about changing Wesnoth's hardware requirements so that they would be unable to play using old or unsupported hardware/OS configurations.

For hardware rendering to be effective, in particular, Wesnoth would necessitate a complete rewrite of the graphics rendering code (the display and game_display classes), the image cache manager (used to abstract the process of loading images from disk and applying image path functions), and potentially GUI2's canvas code. All three would have to limit the amount of textures they allocate to the absolute minimum, using larger textures instead. For example, the image cache could be reimplemented to load images from an internal spritesheet generated during the game loading process. (WML/Lua support for spritesheets would be nice would defining an API for it would only distract from the actual task at hand.)

The greatest difficulty in handling this task probably lies in writing a new optimized rendering engine and updating all code that relies on the old display/game_display API and semantics accordingly. The GUI2 framework code is presently unmaintained and it would take some time for somebody to study and change the current implementation. Finally, as we don't have a graphics engine maintainer at this time, this task involves an implicit long-term commitment to the project that extends beyond whichever Wesnoth series that will see this project completed.

One of the many issues related to switching from software rendering to hardware rendering is Wesnoth's [[ImagePathFunctions]] mini-language. There is already a proof of concept [https://github.com/CelticMinstrel/wesnoth-ipf here] that converts most IPFs to OpenGL shader code, but quite a bit more work would need to be done to make something usable out of it. In particular, the ability to compile arbitrary [[Wesnoth Formula Language]] code into shaders would be needed, since some IPFs embed the language.

=== Improve WML error reporting ===

There are many programming bugs that give very unclear or cryptic error messages when using WML. Here are some examples:

* <strike>When calling a macro with the wrong number of arguments, Wesnoth tells the number it expected, and the number it got, and at which line number it was instantiated. However, it would be helpful if it would also tell the line number of the definition of the macro. This might be helpful if someone is redefining macros.</strike>

* For places where a standard unit filter is expected, if one is not found, the game should point out a problem. For places where such a filter is expected but [filter] child should not appear, if one does it should report an error and a line number. Many users have a hard time with this kind of thing.

* When doing scenario transitions in a campaign, if the side definitions don't match up exactly the game tends to give unintelligible error messages. For instance, if one is transitioning and there is an AI side which does not have a leader (but it has a starting location in the map) it must have "no_leader = yes" in its [side] tag, or else when the team_builder objects enter stage two, the game will try to create a unit with an empty type, and the constructor of class unit will fail giving the error message "game::game_error tried to create unit with empty type". This really needs to be much better. For instance, giving a line number of a problem, or suggesting that no_leader should be used. (Note that, it is often possible to debug problems like this by turning on --log-debug=team_construction at commandline but I doubt that there are any users that know about this, you would only learn from reading the C++... without such debug info, fixing things like this can literally take hours.) For that matter it's some question why the team_builder doesn't just stop trying to build a unit when it sees it doesn't have enough info...

* Recursive macros break the game, and not by stack overflow but by exhausting the heap (which usually takes forever on modern OSes and results in memory thrashing before resource starvation). It would be nice if we could catch this and report an error.

Many WML users are students or beginners to programming, so any improvements to WML error reporting are a big help for their learning process -- many veterans would appreciate the extra help as well. In part we need fixits here and there, but more broadly we need a smarter system that can figure out what's really wrong when things go wrong, and give helpful suggestions.

=== Don't store all events in savefiles ===

Currently all events in a scenario are stored twice in each savefile (in [snapshot] and it [replay_start]), specially on wml-heavy umc content this can make savefiles quite big, The proposed solution is that events are not stored in savefiles when they are the same as in the scenario/era/modification file (e.g. not dynamically added with actionwml).
In detail the savefile should for all events that have an id and are not generated dynamically ([event] actionwml), store dummy events like
[event]
id=event_id
is_unchanged=yes
[/event]
in the savefiles (instead of full events), where the event is then read from the scenario/era/modification tag when the scenario is loaded. This should only apply to campaigns/modifications/mp maps/eras that require download (which is usually the case for campaigns but not for mp maps)

See also https://github.com/wesnoth/wesnoth/issues/1512

== Multiplayer/replay features ==

=== Gold graph ===

Make a graph feature, presumably in a dialog, that helps depict the history of a Wesnoth match for the benefit of spectators of a live game or replay. For example it could display army value, army + bank value, number of villages tagged, luck swings... This would also be particularly helpful for AI tweaking development, by helping coders identify the AI's weaknesses and strengths in the context of a particular scenario.

A possible nice feature for this purpose would be to allow the user to click on the graph at key points which would trigger the "back to turn" mechanism to jump back in the replay, or automatically play the replay forwards from the beginning to that point... etc.

Related email on dev-talk: http://web.archive.org/web/20170505024430/https://mail.gna.org/public/wesnoth-dev/2014-02/msg00089.html

=== Automatically link up to wesnothd server on a local network ===

The feature request was to use ZeroConf technology, if available, to publish info of a running wesnothd instance to other machines on a local network. Then when they are searching to connect to an unofficial server, they won't have to learn the IP address.

The extra code should be guarded with preprocessor flags so that ZeroConf does not become a mandatory build dependency of Wesnoth.

https://github.com/wesnoth/wesnoth/issues/1162

=== Stock MP chat messages for language-independent communication ===

Wesnoth has seen a large acceptance by international communities, and many players don't speak English. It would be nice we could have a set of messages that could be chatted, but which will be translated by our translators and displayed always in the current locale on each client, to make it easier to communicate in mp games / on the mp server.

The easy part is adding the messages. They would ideally be stored in a WML file in the core data dir so they can be easily modified and translated like all other mainline WML. The hard part is devising the interaction mechanism so that a player can easily make use of these stock messages in the MP lobby or in game.

== GUI2 framework ==

As of 1.13.1+dev, GUI2's core and framework (including widgets and their APIs) are completely unmaintained. A prospective maintainer would have to be able to understand pretty advanced C++ making abundant use of template-based abstractions (most notably, the event handling code is almost completely implemented this way), multiple inheritance, and polymorphism. There is also some missing functionality (such as combo boxes and modeless dialogs) that the author did not get to implement, as well as work-in-progress functionality (new listbox and tooltip implementations, not enabled by default).

=== GUI2 themable in-game UI ===

The "themable" in-game UI refers to the gameplay UI including the sidebar, menu/status bar, and map view. Most of it is not implemented using proper GUI1 widgets at all, except for the various interactive buttons, menus (which are floating GUI1 listboxes), and the command and chat input boxes (floating GUI1 textboxes).

Moving the theme UI to GUI2 would probably require finishing up theme support in GUI2 (which is largely incomplete), and may benefit from a rendering engine redesign as is also required for porting the game to SDL 2; in particular so that the GUI aspects are more clearly separated from the game board rendering aspect.

'''Note:''' This task is here solely for the sake of completeness, and only somebody very well versed in the intricacies of Wesnoth's game rendering code and GUI2 should '''ever''' try to take it up. (And even then, I would not want to be anywhere near that person when they inevitably break down and fling one or more tables around upon realizing the sheer complexity of the task. -- Iris)

== Add-ons server and client ==

=== Passphrase hashing ===

The add-ons server ([[campaignd]]) uses a very dumb authentication scheme for uploading add-ons where an author sets a passphrase (or gets a random passphrase assigned by the game) the first time they upload to the server, and subsequent uploads of the same add-on are only allowed if the passphrase matches. The passphrase is stored in clear text form both client and server-side, which has [http://forums.wesnoth.org/viewtopic.php?f=62&t=42663 various implications].

Ideally, the server would store all passphrases in a hashed form.

=== Port redirection ===

Wesnoth's MP server (wesnothd) uses a single port (15000) for servicing most requests and redirects clients to different ports according to the game client's version number. This allows the server administrators to reassign ports freely without having to modify the game client.

The add-ons server (campaignd) and client instead have a hardcoded default port number for a Wesnoth version series. For example, 1.12.x is hardcoded to default to 15006. This becomes a maintainability issue as add-on servers get decommissioned and their port numbers can't be reused for fear of misdirecting obsolete client versions to the wrong instance with incompatible add-ons.

== Multiplayer server and client ==

=== Improve server WML processing ===

The server uses its own custom WML implementation separate from the main engine's to store and process WML objects for games -- see [[WesnothdDesign#simple_wml]]. This is intended to improve performance and reduce wesnothd's memory footprint with large numbers of games and complex scenarios. However, the simple_wml code sometimes messes up WML attribute translatability, resulting in MP scenarios/campaigns being untranslated for non-hosts in networked MP (https://github.com/wesnoth/wesnoth/issues/1420). Fixing this is not easy due to the aforementioned performance requirements.

== WML-related features ==
=== Game Information ===

* [query_location] - queries a location from the user
** variable
** [filter_location]
''Regarding [query_location]: probably a better name would be choose_location. This is used when a wml event is running and needs to get a target location hex from the user. For example, you right click on a catapult unit and choose the menu item "fire Catapult." Now a [message] says to click on any target within 5 hexes. Now [choose_location] is encountered and the mouse cursor changes to a target sign (possibly customizable). If the user's mouse drifts outside of the allowed locations it changes to a cancel icon. If the operation is cancelled then the variable is cleared and no location stored. --Sapient''

''This can be implemented in lua by using wesnoth.game_events.on_mouse_action and wesnoth.syncronize_choice''

https://github.com/wesnoth/wesnoth/issues/2325

NotSoEasyCoding

2024-06-06T20:03:08Z

Egallager: Copyedit a bit; link to corresponding EasyCoding page

This page lists projects which are considered a good idea by the developers, but which have nobody working on them so far. The tasks here are significantly more difficult than the ones in the similar [[EasyCoding]] page. If you think you've got the required skill for one of the tasks listed here, go on, implement it, and you've got a high chance that it'll be accepted. The remaining barrier will only be that it's done well. :-)

If you are such a person, you should feel free to edit this page.

If you're not, you should post a feature request and discuss your idea on the forum or IRC or Discord. A coder with better knowledge of the code might give you the green light to add your feature here.

Anybody should feel free to add "clues" to any tasks, that is entry points, traps to avoid, person to contact to discuss and so on.

If you plan to work on a feature, write your name at the bottom of the feature, with the date. Note that if you spend too long at working on a feature we'll "free" it back (that is if you're not working on it. If you have problems implementing it, just tell us...). We sometimes forget to update this page so it is recommended that, before you start to work on a task, that you ask in irc/Discord whether its still considered a good idea.

If you are part of the Wesnoth dev team you can also add new entries to the list, a new entry must contain at least

1) A description of the problem.
2) A motivation why or in which situations this is important.
3) A link to a corresponding ticket on our bugtracker for discussion, if there is no ticket yet, then make one.

__TOC__

== Game engine ==

=== [[OpenGL port]] ===

While software rendering is all good and nice, Wesnoth's approach does not scale well as display resolutions increase and the need for supporting high DPI configurations is factored in. One can easily see that our zoom functionality is clunky and inefficient. Having support for OpenGL and shaders would also enable us to implement fancier graphical gimmicks such as particle effects and atmospheric lighting. The downside of adding OpenGL to the mix is that we'd need people with a specific skillset to help us maintain the graphics engine in the long term, as hardware and driver-specific quirks are inevitable. Some users are also concerned about changing Wesnoth's hardware requirements so that they would be unable to play using old or unsupported hardware/OS configurations.

For hardware rendering to be effective, in particular, Wesnoth would necessitate a complete rewrite of the graphics rendering code (the display and game_display classes), the image cache manager (used to abstract the process of loading images from disk and applying image path functions), and potentially GUI2's canvas code. All three would have to limit the amount of textures they allocate to the absolute minimum, using larger textures instead. For example, the image cache could be reimplemented to load images from an internal spritesheet generated during the game loading process. (WML/Lua support for spritesheets would be nice would defining an API for it would only distract from the actual task at hand.)

The greatest difficulty in handling this task probably lies in writing a new optimized rendering engine and updating all code that relies on the old display/game_display API and semantics accordingly. The GUI2 framework code is presently unmaintained and it would take some time for somebody to study and change the current implementation. Finally, as we don't have a graphics engine maintainer at this time, this task involves an implicit long-term commitment to the project that extends beyond whichever Wesnoth series that will see this project completed.

One of the many issues related to switching from software rendering to hardware rendering is Wesnoth's [[ImagePathFunctions]] mini-language. There is already a proof of concept [https://github.com/CelticMinstrel/wesnoth-ipf here] that converts most IPFs to OpenGL shader code, but quite a bit more work would need to be done to make something usable out of it. In particular, the ability to compile arbitrary [[Wesnoth Formula Language]] code into shaders would be needed, since some IPFs embed the language.

=== Improve WML error reporting ===

There are many programming bugs that give very unclear or cryptic error messages when using WML. Here are some examples:

* <strike>When calling a macro with the wrong number of arguments, Wesnoth tells the number it expected, and the number it got, and at which line number it was instantiated. However, it would be helpful if it would also tell the line number of the definition of the macro. This might be helpful if someone is redefining macros.</strike>

* For places where a standard unit filter is expected, if one is not found, the game should point out a problem. For places where such a filter is expected but [filter] child should not appear, if one does it should report an error and a line number. Many users have a hard time with this kind of thing.

* When doing scenario transitions in a campaign, if the side definitions don't match up exactly the game tends to give unintelligible error messages. For instance, if one is transitioning and there is an AI side which does not have a leader (but it has a starting location in the map) it must have "no_leader = yes" in its [side] tag, or else when the team_builder objects enter stage two, the game will try to create a unit with an empty type, and the constructor of class unit will fail giving the error message "game::game_error tried to create unit with empty type". This really needs to be much better. For instance, giving a line number of a problem, or suggesting that no_leader should be used. (Note that, it is often possible to debug problems like this by turning on --log-debug=team_construction at commandline but I doubt that there are any users that know about this, you would only learn from reading the C++... without such debug info, fixing things like this can literally take hours.) For that matter it's some question why the team_builder doesn't just stop trying to build a unit when it sees it doesn't have enough info...

* Recursive macros break the game, and not by stack overflow but by exhausting the heap (which usually takes forever on modern OSes and results in memory thrashing before resource starvation). It would be nice if we could catch this and report an error.

Many WML users are students or beginners to programming, so any improvements to WML error reporting are a big help for their learning process -- many veterans would appreciate the extra help as well. In part we need fixits here and there, but more broadly we need a smarter system that can figure out what's really wrong when things go wrong, and give helpful suggestions.

=== Don't store all events in savefiles ===

Currently all events in a scenario are stored twice in each savefile (in [snapshot] and it [replay_start]), specially on wml-heavy umc content this can make savefiles quite big, The proposed solution is that events are not stored in savefiles when they are the same as in the scenario/era/modification file (e.g. not dynamically added with actionwml).
In detail the savefile should for all events that have an id and are not generated dynamically ([event] actionwml), store dummy events like
[event]
id=event_id
is_unchanged=yes
[/event]
in the savefiles (instead of full events), where the event is then read from the scenario/era/modification tag when the scenario is loaded. This should only apply to campaigns/modifications/mp maps/eras that require download (which is usually the case for campaigns but not for mp maps)

See also https://github.com/wesnoth/wesnoth/issues/1512

== Multiplayer/replay features ==

=== Gold graph ===

Make a graph feature, presumably in a dialog, that helps depict the history of a Wesnoth match for the benefit of spectators of a live game or replay. For example it could display army value, army + bank value, number of villages tagged, luck swings... This would also be particularly helpful for AI tweaking development, by helping coders identify the AI's weaknesses and strengths in the context of a particular scenario.

A possible nice feature for this purpose would be to allow the user to click on the graph at key points which would trigger the "back to turn" mechanism to jump back in the replay, or automatically play the replay forwards from the beginning to that point... etc.

Related email on dev-talk: https://mail.gna.org/public/wesnoth-dev/2014-02/msg00089.html

=== Automatically link up to wesnothd server on a local network ===

The feature request was to use ZeroConf technology, if available, to publish info of a running wesnothd instance to other machines on a local network. Then when they are searching to connect to an unofficial server, they won't have to learn the IP address.

The extra code should be guarded with preprocessor flags so that ZeroConf does not become a mandatory build dependency of Wesnoth.

https://github.com/wesnoth/wesnoth/issues/1162

=== Stock MP chat messages for language-independent communication ===

Wesnoth has seen a large acceptance by international communities, and many players don't speak English. It would be nice we could have a set of messages that could be chatted, but which will be translated by our translators and displayed always in the current locale on each client, to make it easier to communicate in mp games / on the mp server.

The easy part is adding the messages. They would ideally be stored in a WML file in the core data dir so they can be easily modified and translated like all other mainline WML. The hard part is devising the interaction mechanism so that a player can easily make use of these stock messages in the MP lobby or in game.

== GUI2 framework ==

As of 1.13.1+dev, GUI2's core and framework (including widgets and their APIs) are completely unmaintained. A prospective maintainer would have to be able to understand pretty advanced C++ making abundant use of template-based abstractions (most notably, the event handling code is almost completely implemented this way), multiple inheritance, and polymorphism. There is also some missing functionality (such as combo boxes and modeless dialogs) that the author did not get to implement, as well as work-in-progress functionality (new listbox and tooltip implementations, not enabled by default).

=== GUI2 themable in-game UI ===

The "themable" in-game UI refers to the gameplay UI including the sidebar, menu/status bar, and map view. Most of it is not implemented using proper GUI1 widgets at all, except for the various interactive buttons, menus (which are floating GUI1 listboxes), and the command and chat input boxes (floating GUI1 textboxes).

Moving the theme UI to GUI2 would probably require finishing up theme support in GUI2 (which is largely incomplete), and may benefit from a rendering engine redesign as is also required for porting the game to SDL 2; in particular so that the GUI aspects are more clearly separated from the game board rendering aspect.

'''Note:''' This task is here solely for the sake of completeness, and only somebody very well versed in the intricacies of Wesnoth's game rendering code and GUI2 should '''ever''' try to take it up. (And even then, I would not want to be anywhere near that person when they inevitably break down and fling one or more tables around upon realizing the sheer complexity of the task. -- Iris)

== Add-ons server and client ==

=== Passphrase hashing ===

The add-ons server ([[campaignd]]) uses a very dumb authentication scheme for uploading add-ons where an author sets a passphrase (or gets a random passphrase assigned by the game) the first time they upload to the server, and subsequent uploads of the same add-on are only allowed if the passphrase matches. The passphrase is stored in clear text form both client and server-side, which has [http://forums.wesnoth.org/viewtopic.php?f=62&t=42663 various implications].

Ideally, the server would store all passphrases in a hashed form.

=== Port redirection ===

Wesnoth's MP server (wesnothd) uses a single port (15000) for servicing most requests and redirects clients to different ports according to the game client's version number. This allows the server administrators to reassign ports freely without having to modify the game client.

The add-ons server (campaignd) and client instead have a hardcoded default port number for a Wesnoth version series. For example, 1.12.x is hardcoded to default to 15006. This becomes a maintainability issue as add-on servers get decommissioned and their port numbers can't be reused for fear of misdirecting obsolete client versions to the wrong instance with incompatible add-ons.

== Multiplayer server and client ==

=== Improve server WML processing ===

The server uses its own custom WML implementation separate from the main engine's to store and process WML objects for games -- see [[WesnothdDesign#simple_wml]]. This is intended to improve performance and reduce wesnothd's memory footprint with large numbers of games and complex scenarios. However, the simple_wml code sometimes messes up WML attribute translatability, resulting in MP scenarios/campaigns being untranslated for non-hosts in networked MP (https://github.com/wesnoth/wesnoth/issues/1420). Fixing this is not easy due to the aforementioned performance requirements.

== WML-related features ==
=== Game Information ===

* [query_location] - queries a location from the user
** variable
** [filter_location]
''Regarding [query_location]: probably a better name would be choose_location. This is used when a wml event is running and needs to get a target location hex from the user. For example, you right click on a catapult unit and choose the menu item "fire Catapult." Now a [message] says to click on any target within 5 hexes. Now [choose_location] is encountered and the mouse cursor changes to a target sign (possibly customizable). If the user's mouse drifts outside of the allowed locations it changes to a cancel icon. If the operation is cancelled then the variable is cleared and no location stored. --Sapient''

''This can be implemented in lua by using wesnoth.game_events.on_mouse_action and wesnoth.syncronize_choice''

https://github.com/wesnoth/wesnoth/issues/2325

Template:WML Tags

2024-04-08T01:28:05Z

Egallager: link to ReferenceWML

{| class="reference-sidebar"
|-
|
[[{{SERVER}}{{localurl:Template:WML Tags|action=edit}} edit]]'''WML Tags'''
|-
|''A:''
[[AbilitiesWML#The .5Babilities.5D tag|abilities]],
[[CreditsWML#.5Babout.5D|about]],
[[AchievementsWML#.5Bachievement.5D|achievement]],
[[AchievementsWML#.5Bachievement_group.5D|achievement_group]],
[[Lua_AI_Legacy_Methods_Howto#Behavior_.28Sticky.29_Candidate_Actions|add_ai_behavior]],
[[AdvancedPreferenceWML|advanced_preference]],
[[UnitTypeWML#advancefrom|advancefrom]],
[[UnitTypeWML#After_max_level_advancement_.28AMLA.29|advancement]],
[[StatisticalScenarioWML#The_.5Bteam.5D_tag|advances]],
[[AbilitiesWML#affect_adjacent|affect_adjacent]],
[[Wesnoth_AI_Framework#The_.5Bai.5D_Tag_.E2.80.94_Top-level_Elements|ai]],
[[StandardSideFilter#allied_with|allied_with]],
[[DirectActionsWML#.5Ballow_end_turn.5D|allow_end_turn]],
[[DirectActionsWML#.5Ballow_extra_recruit.5D|allow_extra_recruit]],
[[DirectActionsWML#.5Ballow_recruit.5D|allow_recruit]],
[[DirectActionsWML#.5Ballow_undo.5D|allow_undo]],
[[ConditionalActionsWML#Meta-Condition_Tags|and]],
[[InterfaceActionsWML#.5Banimate_unit.5D|animate]],
[[InterfaceActionsWML#.5Banimate_unit.5D|animate_unit]],
[[AnimationWML#The .5Banimation.5D tag|animation]],
[[Wesnoth_AI_Framework#The_.5Bai.5D_Tag_.E2.80.94_Aspects|aspect]],
attack ([[ReplayWML#attack|replay]], [[UnitTypeWML#Attacks|weapon]]),
[[AnimationWML#short-attack|attack_anim]],
attacks ([[AbilitiesWML#The_.5Bspecials.5D_tag|special]], [[StatisticalScenarioWML#The_.5Bteam.5D_tag|stats]]),
[[AiWML#avoid|avoid]];
|-
|''B:''
[[UnitTypeWML#base_unit|base_unit]],
[[IntroWML#.5Bbackground_layer.5D|background_layer]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|berserk]],
[[BinaryPathWML|binary_path]],
[[InternalActionsWML#Flow_control_actions|break]],
[[EditorWML#The_.5Bbrush.5D_tag|brush]];
|-
|''C:''
[[CampaignWML#The_.5Bcampaign.5D_tag|campaign]],
[[DirectActionsWML#.5Bcancel_action.5D|cancel_action]],
[[Wesnoth_AI_Framework#The_.5Bcandidate_action.5D_Tag|candidate_action]],
[[DirectActionsWML#.5Bcapture_village.5D|capture_village]],
[[ConditionalActionsWML#.5Bswitch.5D|case]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|chance_to_hit]],
[[InterfaceActionsWML#.5Bchange_theme.5D|change_theme]],
[[InterfaceActionsWML#.5Bchat.5D|chat]],
[[OptionWML#checkbox|checkbox]],
[[OptionWML#choice|choice]],
[[ReplayWML#choose|choose]],
[[PersistenceWML#WML Syntax|clear_global_variable]],
[[InterfaceActionsWML#.5Bclear_menu_item.5D|clear_menu_item]],
[[InternalActionsWML#.5Bclear_variable.5D|clear_variable]],
[[InterfaceActionsWML#.5Bcolor_adjust.5D|color_adjust]],
[[GameConfigWML#Color_Palettes|color_palette]],
[[GameConfigWML#Color_Palettes|color_range]],
command ([[ConditionalActionsWML#.5Bcommand.5D|action]], [[ReplayWML|replay]]),
[[InternalActionsWML#Flow_control_actions|continue]],
[[CreditsWML#.5Bcredits_group.5D|credits_group]],
[[AiWML#The_.5Bgoal.5D_Tag|criteria]];
|-
|''D:''
[[AbilitiesWML#The_.5Bspecials.5D_tag|damage]],
[[AnimationWML#short-death|death]],
[[StatisticalScenarioWML#The_.5Bteam.5D_tag|deaths]],
[[Wesnoth_AI_Framework#The_.5Bai.5D_Tag_.E2.80.94_Aspects|default]],
[[AnimationWML#short-defend|defend]],
[[StatisticalScenarioWML#The_.5Bteam.5D_tag|defends]],
[[UnitsWML#defense|defense]],
[[InterfaceActionsWML#.5Bdelay.5D|delay]],
[[InterfaceActionsWML#.5Bdeprecated_message.5D|deprecated_message]],
[[ReplayWML#attack|destination]],
[[CampaignWML#difficulty|difficulty]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|disable]],
[[DirectActionsWML#.5Bdisallow_end_turn.5D|disallow_end_turn]],
[[DirectActionsWML#.5Bdisallow_extra_recruit.5D|disallow_extra_recruit]],
[[DirectActionsWML#.5Bdisallow_recruit.5D|disallow_recruit]],
[[ConditionalActionsWML#.5Bwhile.5D|do]],
[[DirectActionsWML#.5Bdo_command.5D|do_command]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|drains]],
[[AnimationWML#short-draw_weapon|draw_weapon_anim]];
|-
|''E:''
[[EditorWML#The_.5Beditor_group.5D_tag|editor_group]],
[[EditorWML#The_.5Beditor_music.5D_tag|editor_music]],
[[EditorWML#The_.5Beditor_times.5D_tag|editor_times]],
[[EffectWML|effect]],
else ([[ConditionalActionsWML#.5Bif.5D|action]], [[AnimationWML#Conditional Branches|animation]]), [[ConditionalActionsWML#.5Bif.5D|elseif]],
[[DirectActionsWML#.5Bendlevel.5D|endlevel]],
end_turn ([[DirectActionsWML#.5Bend_turn.5D|action]], [[ReplayWML#end_turn|replay]]),
[[StandardSideFilter#enemy_of|enemy_of]],
[[Wesnoth_AI_Framework#The_.5Bai.5D_Tag_.E2.80.94_Engines|engine]],
entry ([[CreditsWML#.5Bentry.5D|credits]], [[OptionWML#entry|options]]),
[[EraWML|era]],
[[EventWML|event]],
[[StandardUnitFilter#filter_ability|experimental_filter_ability]],
[[StandardUnitFilter#filter_ability_active|experimental_filter_ability_active]],
[[AbilitiesWML#filter_specials|experimental_filter_specials]],
[[AnimationWML#short-extra|extra_anim]];
|-
|''F:''
[[Wesnoth_AI_Framework#The_.5Bai.5D_Tag_.E2.80.94_Aspects|facet]],
[[InterfaceActionsWML#.5Banimate_unit.5D|facing]],
[[InterfaceActionsWML#.5Bmove_units_fake.5D|fake_unit]],
[[ConditionalActionsWML#.5Bfalse.5D|false]],
[[PblWML#.5Bfeedback.5D|feedback]],
[[UnitTypeWML#variation|female]],
filter ([[FilterWML|concept]], [[EventWML#.5Bfilter.5D|event]]),
[[StandardUnitFilter#filter_adjacent|filter_adjacent]],
[[StandardLocationFilter#filter_adjacent_location|filter_adjacent_location]],
[[FilterWML#Filtering_Weapons|filter_attack]],
[[AbilitiesWML#filter_attacker|filter_attacker]],
[[AbilitiesWML#filter_base_value|filter_base_value]],
[[EventWML#.5Bfilter_condition.5D|filter_condition]],
[[AbilitiesWML#filter_defender|filter_defender]],
[[AiWML#Filtering_Combat_with_the_attacks_Aspect|filter_enemy]],
[[StandardLocationFilter|filter_location]],
[[AbilitiesWML#filter_opponent|filter_opponent]],
[[AiWML#Filtering_Combat_with_the_attacks_Aspect|filter_own]],
[[StandardLocationFilter#filter_owner|filter_owner]],
[[StandardLocationFilter#filter_radius|filter_radius]],
[[SingleUnitWML#filter_recall|filter_recall]],
[[StandardUnitFilter|filter_second]],
[[FilterWML#Filtering_Weapons|filter_second_attack]],
[[AbilitiesWML#filter_self|filter_self]],
[[StandardSideFilter|filter_side]],
[[AbilitiesWML#filter_student|filter_student]],
[[FilterWML#Filtering_Vision|filter_vision]],
[[FilterWML#Filtering_Weapons|filter_weapon]],
[[FilterWML#Filtering_on_WML_data|filter_wml]],
[[InternalActionsWML#.5Bfind_path.5D|find_path]],
[[InternalActionsWML#.5Bfire_event.5D|fire_event]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|firststrike]],
[[InterfaceActionsWML#.5Bfloating_text.5D|floating_text]],
[[ConditionalActionsWML#.5Bfound_item.5D|found_item]],
[[ConditionalActionsWML#.5Bfor.5D|for]],
[[ConditionalActionsWML#.5Bforeach.5D|foreach]],
[[AnimationWML#The .5Bframe.5D tag|frame]];
|-
|''G:''
[[GameConfigWML|game_config]],
[[PersistenceWML#WML Syntax|get_global_variable]],
[[AiWML#The_.5Bgoal.5D_Tag|goal]],
[[DirectActionsWML#.5Bgold.5D|gold]],
[[InterfaceActionsWML#objectives-gold_carryover|gold_carryover]];
|-
|''H:''
[[DirectActionsWML#.5Bharm_unit.5D|harm_unit]],
[[StandardSideFilter#has_ally|has_ally]],
[[StandardUnitFilter#has_attack|has_attack]],
[[StandardSideFilter#has_unit|has_unit]],
[[ConditionalActionsWML#.5Bhas_achievement.5D|has_achievement]],
[[ConditionalActionsWML#.5Bhave_location.5D|have_location]],
[[ConditionalActionsWML#.5Bhave_unit.5D|have_unit]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|heal_on_hit]],
[[DirectActionsWML#.5Bheal_unit.5D|heal_unit]],
[[AnimationWML#short-healed|healed_anim]],
[[AnimationWML#short-healing|healing_anim]],
[[AbilitiesWML#The_.5Babilities.5D_tag|heals]],
[[UnitsWML#.5Bhide_help.5D|hide_help]],
[[InterfaceActionsWML#.5Bhide_unit.5D|hide_unit]],
[[AbilitiesWML#The_.5Babilities.5D_tag|hides]];
|-
|''I:''
[[AnimationWML#short-idle|idle_anim]],
if ([[ConditionalActionsWML#.5Bif.5D|action]], [[AnimationWML#Conditional Branches|animation]], [[IntroWML|intro]]),
[[AbilitiesWML#The_.5Babilities.5D_tag|illuminates]],
image ([[IntroWML#.5Bimage.5D|intro]], [[TerrainGraphicsWML#The_.5Bimage.5D_subtag|terrain]]),
[[ReplayWML#init_side|init_side]],
[[VariablesWML#.5Binsert_tag.5D|insert_tag]],
[[InterfaceActionsWML#.5Binspect.5D|inspect]],
[[InterfaceActionsWML#.5Bitem.5D|item]],
[[EditorWML#The_.5Bitem_group.5D_tag|item_group]];
|-
|''J:''
[[UnitsWML#jamming_costs|jamming_costs]],
[[InternalActionsWML#join|join]];
|-
|''K:''
[[DirectActionsWML#.5Bkill.5D|kill]],
[[StatisticalScenarioWML#The_.5Bteam.5D_tag|killed]];
|-
|''L:''
[[InterfaceActionsWML#.5Blabel.5D|label]],
[[LanguageWML|language]],
[[SideWML#leader|leader]],
[[AiWML#leader_goal|leader_goal]],
[[AbilitiesWML#The_.5Babilities.5D_tag|leadership]],
[[AnimationWML#short-leading|leading_anim]],
[[AnimationWML#short-levelin|levelin_anim]],
[[AnimationWML#short-levelout|levelout_anim]],
[[DirectActionsWML#.5Blift_fog.5D|lift_fog]],
[[AI_Recruitment#instructions-limit|limit]],
[[InternalActionsWML#set_variables-literal|literal]],
[[AddonsWML#load_resource|load_resource]],
[[LocaleWML|locale]],
[[InterfaceActionsWML#.5Block_view.5D|lock_view]],
[[LuaWML|lua]];
|-
|''M:''
[[UnitTypeWML#variation|male]],
[[SavefileWML|menu_item]],
[[InterfaceActionsWML#.5Bmessage.5D|message]],
[[Micro AIs|micro_ai]],
[[AnimationWML#The .5Bframe.5D tag|missile_frame]],
[[ModificationWML|modification]],
[[SingleUnitWML#modifications|modifications]],
[[DirectActionsWML#.5Bmodify_ai.5D|modify_ai]],
[[DirectActionsWML#.5Bmodify_side.5D|modify_side]],
[[DirectActionsWML#.5Bmodify_turns.5D|modify_turns]],
[[DirectActionsWML#.5Bmodify_unit.5D|modify_unit]],
[[AddonsWML#modify_unit_type|modify_unit_type]],
[[ReplayWML#move|move]],
[[DirectActionsWML#.5Bmove_unit.5D|move_unit]],
[[InterfaceActionsWML#.5Bmove_unit_fake.5D|move_unit_fake]],
[[InterfaceActionsWML#.5Bmove_units_fake.5D|move_units_fake]],
[[AnimationWML#short-movement|movement_anim]],
[[UnitsWML#movement_costs|movement costs]],
[[UnitsWML#.5Bmovetype.5D|movetype]],
[[ScenarioWML#The_.5Bmultiplayer.5D_tag|multiplayer]],
[[EraWML#Defining_Factions|multiplayer_side]],
[[MusicListWML#.5Bmusic.5D|music]];
|-
|''N:''
[[ConditionalActionsWML#Meta-Condition_Tags|not]],
[[InterfaceActionsWML#objectives-note|note]];
|-
|''O:''
[[DirectActionsWML#.5Bobject.5D|object]],
[[InterfaceActionsWML#objectives-objective|objective]],
[[InterfaceActionsWML#.5Bobjectives.5D|objectives]],
[[DirectActionsWML#.5Bon_undo.5D|on_undo]],
[[InterfaceActionsWML#.5Bopen_help.5D|open_help]],
[[InterfaceActionsWML#.5Bmessage.5D|option]],
[[OptionWML|options]],
[[ConditionalActionsWML#Meta-Condition_Tags|or]];
|-
|''P:''
[[IntroWML#.5Bpart.5D|part]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|petrifies]],
[[DirectActionsWML#.5Bpetrify.5D|petrify]],
[[DirectActionsWML#.5Bplace_shroud.5D|place_shroud]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|plague]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|poison]],
[[AnimationWML#short-post_movement|post_movement_anim]],
[[AnimationWML#short-pre_movement|pre_movement_anim]],
[[InternalActionsWML#.5Bfire_event.5D|primary_attack]],
[[InternalActionsWML#.5Bfire_event.5D|primary_unit]],
[[InterfaceActionsWML#.5Bprint.5D|print]],
[[DirectActionsWML#.5Bprogress_achievement.5D|progress_achievement]],
[[DirectActionsWML#.5Bput_to_recall_list.5D|put_to_recall_list]];
|-
|''R:''
[[UnitsWML#.5Brace.5D|race]],
[[InternalActionsWML#.5Brandom_placement.5D|random_placement]],
recall ([[DirectActionsWML#.5Brecall.5D|action]], [[ReplayWML#recall|replay]]),
[[StatisticalScenarioWML#The_.5Bteam.5D_tag|recalls]],
[[ReplayWML#recruit|recruit]],
[[AnimationWML#short-recruit|recruit_anim]],
[[AnimationWML#short-recruiting|recruiting_anim]],
[[StatisticalScenarioWML#The_.5Bteam.5D_tag|recruits]],
[[InterfaceActionsWML#.5Bredraw.5D|redraw]],
[[AbilitiesWML#The_.5Babilities.5D_tag|regenerate]],
[[InternalActionsWML#.5Bremove_event.5D|remove_event]],
[[InterfaceActionsWML#.5Bremove_item.5D|remove_item]],
[[DirectActionsWML#.5Bremove_object.5D|remove_object]],
[[DirectActionsWML#.5Bremove_shroud.5D|remove_shroud]],
[[InterfaceActionsWML#.5Bremove_sound_source.5D|remove_sound_source]],
[[DirectActionsWML#.5Bremove_time_area.5D|remove_time_area]],
[[DirectActionsWML#.5Bremove_trait.5D|remove_trait]],
[[InterfaceActionsWML#.5Bremove_unit_overlay.5D|remove_unit_overlay]],
[[ConditionalActionsWML#.5Brepeat.5D|repeat]],
[[DirectActionsWML#.5Breplace_map.5D|replace_map]],
[[DirectActionsWML#.5Breplace_schedule.5D|replace_schedule]],
[[ReplayWML|replay]],
[[SavefileWML|replay_start]],
[[DirectActionsWML#.5Breset_fog.5D|reset_fog]],
resistance ([[AbilitiesWML#The_.5Babilities.5D_tag|ability]], [[UnitsWML#resistance|unit]]),
[[UnitsWML#.5Bresistance_defaults.5D|resistance_defaults]],
[[ThemeWML#The_toplevel_.5Btheme.5D_tag|resolution]],
[[ModificationWML#The_.5Bresource.5D_toplevel_tag|resource]],
[[InternalActionsWML#Flow_control_actions|return]],
[[InternalActionsWML#.5Brole.5D|role]],
[[TerrainMaskWML#rule|rule]];
|-
|''S:''
[[SavefileWML|save]],
[[ScenarioWML#The_.5Bscenario.5D_tag|scenario]],
[[InterfaceActionsWML#.5Bscreen_fade.5D|screen_fade]],
[[InterfaceActionsWML#.5Bscroll.5D|scroll]],
[[InterfaceActionsWML#.5Bscroll_to.5D|scroll_to]],
[[InterfaceActionsWML#.5Bscroll_to_unit.5D|scroll_to_unit]],
[[InternalActionsWML#.5Bfire_event.5D|secondary_attack]],
[[InternalActionsWML#.5Bfire_event.5D|secondary_unit]],
[[HelpWML#section|section]],
[[InterfaceActionsWML#.5Bselect_unit.5D|select_unit]],
[[ReplayWML#sequence|sequence]],
[[DirectActionsWML#.5Bset_achievement.5D|set_achievement]],
[[DirectActionsWML#.5Bset_extra_recruit.5D|set_extra_recruit]],
[[PersistenceWML#WML_Syntax|set_global_variable]],
[[InterfaceActionsWML#.5Bset_menu_item.5D|set_menu_item]],
[[DirectActionsWML#.5Bset_recruit.5D|set_recruit]],
[[EffectWML#set_specials|set_specials]],
[[InternalActionsWML#.5Bset_variable.5D|set_variable]],
[[InternalActionsWML#.5Bset_variables.5D|set_variables]],
[[AnimationWML#short-sheath_weapon|sheath_weapon_anim]],
show_if ([[InterfaceActionsWML#.5Bmessage.5D|message]],
[[InterfaceActionsWML#.5Bobjectives.5D|objective]],
[[InterfaceActionsWML#.5Bset_menu_item.5D|set_menu_item]]),
[[InterfaceActionsWML#.5Bshow_objectives.5D|show_objectives]],
[[SideWML|side]],
[[AbilitiesWML#The_.5Babilities.5D_tag|skirmisher]],
[[OptionWML#slider|slider]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|slow]],
[[SavefileWML|snapshot]],
[[InterfaceActionsWML#.5Bsound.5D|sound]],
[[InterfaceActionsWML#.5Bsound_source.5D|sound_source]],
source ([[ReplayWML#attack|replay]], [[DirectActionsWML#.5Btunnel.5D|teleport]]),
[[UnitTypeWML#Special Notes|special_note]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|specials]],
[[InternalActionsWML#set_variables-split|split]],
[[Wesnoth_AI_Framework#The_.5Bai.5D_Tag_.E2.80.94_Stages|stage]],
[[AnimationWML#short-standing|standing_anim]],
[[StatisticalScenarioWML#The_.5Bstatistics.5D_tag|statistics]],
[[SingleUnitWML#status|status]],
[[InternalActionsWML#.5Bstore_gold.5D|store_gold]],
[[InternalActionsWML#.5Bstore_items.5D|store_items]],
[[InternalActionsWML#.5Bstore_locations.5D|store_locations]],
[[InternalActionsWML#.5Bstore_map_dimensions.5D|store_map_dimensions]],
[[InternalActionsWML#.5Bstore_reachable_locations.5D|store_reachable_locations]],
[[InternalActionsWML#.5Bstore_relative_direction.5D|store_relative_direction]],
[[InternalActionsWML#.5Bstore_side.5D|store_side]],
[[InternalActionsWML#.5Bstore_starting_location.5D|store_starting_location]],
[[InternalActionsWML#.5Bstore_time_of_day.5D|store_time_of_day]],
[[InternalActionsWML#.5Bstore_turns.5D|store_turns]],
[[InternalActionsWML#.5Bstore_unit.5D|store_unit]],
[[InternalActionsWML#.5Bstore_unit_defense.5D|store_unit_defense]],
[[InternalActionsWML#.5Bstore_unit_defense_on.5D|store_unit_defense_on]],
[[InternalActionsWML#.5Bstore_unit_type.5D|store_unit_type]],
[[InternalActionsWML#.5Bstore_unit_type_ids.5D|store_unit_type_ids]],
[[InternalActionsWML#.5Bstore_villages.5D|store_villages]],
[[IntroWML|story]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|swarm]],
[[AchievementsWML#.5Bsub_achievement.5D|sub_achievement]],
[[ConditionalActionsWML#.5Bswitch.5D|switch]],
[[InternalActionsWML#.5Bsync_variable.5D|sync_variable]];
|-
|''T:''
[[DirectActionsWML#.5Btunnel.5D|target]],
[[StatisticalScenarioWML#The_.5Bteam.5D_tag|team]],
teleport ([[AbilitiesWML|ability]], [[DirectActionsWML#.5Bteleport.5D|action]]),
[[AnimationWML#short-teleport|teleport_anim]],
[[DirectActionsWML#.5Bterrain.5D|terrain]],
[[UnitsWML#.5Bterrain_defaults.5D|terrain_defaults]],
[[TerrainGraphicsWML|terrain_graphics]],
[[TerrainMaskWML|terrain_mask]],
[[TerrainWML|terrain_type]],
[[ScenarioWML#The_.5Btest.5D_tag|test]],
[[InterfaceActionsWML#.5Btest_condition.5D|test_condition]],
[[TestWML#The_.5Btest_do_attack_by_id.5D_tag|test_do_attack_by_id]],
[[InterfaceActionsWML#.5Bmessage.5D|text_input]],
[[GettextForWesnothDevelopers#The_textdomain_tag|textdomain]],
[[ThemeWML|theme]],
[[ConditionalActionsWML#.5Bif.5D|then]],
[[TerrainGraphicsWML|tile]],
[[TimeWML|time]],
[[DirectActionsWML#.5Btime_area.5D|time_area]],
[[HelpWML|topic]],
[[HelpWML|toplevel]],
[[UnitsWML#.5Btrait.5D|trait]],
[[DirectActionsWML#.5Btransform_unit.5D|transform_unit]],
[[InternalActionsWML#.5Bfind_path.5D|traveler]],
[[ConditionalActionsWML#.5Btrue.5D|true]],
[[DirectActionsWML#.5Btunnel.5D|tunnel]];
|-
|''U:''
[[InterfaceActionsWML#.5Bunhide_unit.5D|unhide_unit]],
[[SingleUnitWML|unit]],
[[InterfaceActionsWML#.5Bunit_overlay.5D|unit_overlay]],
[[UnitTypeWML|unit_type]],
[[InternalActionsWML#.5Bunit_worth.5D|unit_worth]],
[[UnitsWML|units]],
[[InterfaceActionsWML#.5Bunlock_view.5D|unlock_view]],
[[DirectActionsWML#.5Bunpetrify.5D|unpetrify]],
[[DirectActionsWML#.5Bunstore_unit.5D|unstore_unit]],
[[InternalActionsWML#.5Bunsynced.5D|unsynced]];
|-
| ''V:''
[[InternalActionsWML#.5Bset_variables.5D|value]],
[[ConditionalActionsWML#.5Bvariable.5D|variable]],
[[VariablesWML#The_.5Bvariables.5D_tag|variables]],
[[TerrainGraphicsWML|variant]],
[[UnitTypeWML#Other_tags|variation]],
[[AnimationWML#short-victory|victory_anim]],
[[SideWML|village]],
[[UnitsWML#.5Bmovetype.5D|vision_costs]],
[[InterfaceActionsWML#.5Bvolume.5D|volume]];
|-
| ''W:''
[[ConditionalActionsWML#.5Bwhile.5D|while]],
[[InterfaceActionsWML#.5Bwml_message.5D|wml_message]],
[[SchemaWML|wml_schema]];
|-
| ''Z:''
[[InterfaceActionsWML#.5Bzoom.5D|zoom]];
|}<includeonly>[[Category:WML Reference]]</includeonly><noinclude>A box with all the WML tags, each one linking to the page and section they are described in. This box should be included in each of the [[ReferenceWML|WML reference]] pages.</noinclude>

Template:WML Tags

2024-04-06T20:16:32Z

Egallager: add '''[resolution]'''

Art Programs

2024-03-29T17:41:34Z

Egallager: /* Free Image Post-Processors */ additional links

{| style="float:right; margin-left:1em;"
|__TOC__
|}
'''Big Note:''' It is mostly-possible to make wesnoth graphics with nothing more than MSPaint or Appleworks. However, there are two major and '''vital''' things lacking in those programs - first, these programs cannot make images with transparent pixels, and second, they may not be able to save in the PNG format used by Wesnoth. A program capable of those will have to be applied to images made with MSPaint when they are finished.

=== Free Image Editors ===
The following are free image editing programs which can be used to create graphics for wesnoth. These programs are Open-Source Software, like wesnoth, meaning they are free to use, and that you are free to look at the sourcecode.

[https://www.gimp.org/ '''The GIMP'''] (Windows, Linux & Mac OS X); the "Gnu Image Manipulation Program" is recommended. Works on Linux/Windows/MacOsX.

[https://www.aseprite.org/ '''Aseprite'''] is animated sprite editor & pixel art tool. Present in Linux packages (Debian/Ubuntu) and available in source on GitHub, but Windows/MacOsX binary is sold on home page.

[http://mtpaint.sourceforge.net/ '''mtPaint'''] intented to easily create pixel art and manipulate digital photos. Works on Linux/Windows.

[http://pulkomandy.tk/projects/GrafX2 '''GrafX2'''] is a bitmap paint program inspired by the Amiga programs Deluxe Paint and Brilliance. Specialized in 256-color drawing, it includes a very large number of tools and effects that make it particularly suitable for pixel art, game graphics, and generally any detailed graphics painted with a mouse. The program is mostly developed on Linux and Windows, but is also portable on many other platforms.

[https://www.pencil2d.org/ '''Pencil2D'''] lets you create traditional hand-drawn animation (cartoon) using both bitmap and vector graphics. Works on Linux/Windows/MacOsX.

[https://sourceforge.net/projects/seashore/ '''Seashore'''] (Mac OS X) this port of the the GIMP to a cocoa-based gui is recommended. Seashore provides the basic features of GIMP.

[https://opensword.org/pixen/ '''Pixen'''] (Mac OS X) is the OpenSword Group's tool for traditional SNES style sprite art - unlike most other editors, it has been designed for that specific task, and users may find it much less daunting than the Gimp or Photoshop. This program was written in cocoa, and has a very good interface - version 3 will even include built-in support for making animations.

[http://jdraw.sourceforge.net/index.php?page=6 '''JDraw'''] (for anything that can run Java - mac and windows included) is an image editor which has a subset of the features of Pixen, and a superset of the features of MSPaint. It is a simple, straightforward pixel editing program. If you use a mac, Pixen is probably a better idea.

[https://www.getpaint.net/ '''Paint.NET'''] (Windows) is generally regarded as inferior to the Gimp or Photoshop, but is easier to look at for those with shorter attention spans, so some might find it of interest.

[https://paintbrush.sourceforge.io/ '''Paintbrush'''] (Mac OS X) is a program intended to be a slightly modernized clone of the old MacPaint/MSPaint. Free/OSS, but note that though it is capable of saving PNGs, it is not capable of handling transparency.

=== Free Image Post-Processors ===

The '''utils/woptipng.py''' script is included in Wesnoth's source code. It runs the tools from ImageMagick/GraphicsMagick, OptiPNG and Advdef; links to all of these are below.

[https://imagemagick.org/ '''ImageMagick'''] and [http://www.graphicsmagick.org/ '''GraphicsMagick'''] are a pair of open-source projects that forked. The '''utils/woptipng.py''' script needs the '''convert''' tool from either of these projects to remove non-pixel data from the file.

[http://optipng.sourceforge.net/ '''OptiPNG'''] is an open-source image compressor.

[http://www.advancemame.it/comp-readme '''AdvanceCOMP'''] is another open-source image compressor.

[http://www.amake.us/software/pngcrusher/ '''PNGCrusher'''] (Mac OS X) is a handy lightweight tool that will compress your PNGs much more efficiently than Photoshop. It is best used in tandem with saving the files from GraphicConverter, with the PNG filtering options on. The tool it is based on, OptiPNG, is open source, and runs on both linux and windows.

[http://imageoptim.pornel.net/ '''ImageOptim'''] (Mac OS X) optimizes images so they take up less disk space and load faster. It provides GUI for various optimisation tools: AdvPNG from AdvanceCOMP, OptiPNG, [https://pmt.sourceforge.io/pngcrush/ Pngcrush], [https://www.kokkonen.net/tjko/projects.html JpegOptim], jpegtran from libjpeg, [https://www.lcdf.org/gifsicle/ Gifsicle], PNGOUT, [https://github.com/shssoichiro/oxipng OxiPNG], [https://pngquant.org/ pngquant], [https://github.com/mozilla/mozjpeg mozjpeg], [https://github.com/google/guetzli Guetzli], [https://github.com/google/zopfli Zopfli], [https://github.com/svg/svgo svgo], and [https://github.com/RazrFalcon/svgcleaner svgcleaner].

[https://imgbot.net/ '''Imgbot'''] is a GitHub bot that will automatically submit pull requests to compress your image files, if you store them in a GitHub repository. It runs ImageMagick under the hood. Note that there is an issue with it ([https://github.com/imgbot/Imgbot/issues/856 #856]) that can cause changes to image saturation, which has caused some add-on devs to reject pull requests from it, so be sure to decide whether you consider this acceptable or not before using it.

[https://trimage.org/ '''Trimage'''], a cross-platform GUI tool inspired by ImageOptim from above. It runs a subset of the same tools as ImageOptim (specifically optipng, pngcrush, advpng, and jpegoptim) under the hood.

=== Proprietary Image Editors ===

==== Shareware ====
[https://www.lemkesoft.de/ '''GraphicConverter'''] (Mac OS X) by Lemkesoft is an excellent program for preparing and compressing png images for the game, and may also be useful for the creation of images. The shareware fee is $30, although large parts of the program are fully functional for free.

[http://www.kanzelsberger.com/pixel/ '''Pixel Image Editor'''] (Mac OS X, Windows, Linux, BeOS, and others) is a very full-featured program, intended to fulfill the same function that photoshop does. It currently has a shareware fee of $32, though the final price once the product reaches v2.0, will be $79.

[http://www.ultimatepaint.com/ '''JTL Ultimate Paint'''] (Windows) is a basic painting program, following the tradition of the earlier "DeluxePaint". Geared at painting, it can use photoshop plugins. It currently costs $34 for a basic version. I do not know if this program can export PNG images, so ''caveat emptor''.

[https://www.cosmigo.com/pixel_animation_software '''Pro Motion'''] (Windows) is a commercial pixel editing program. It has many features tailored for animation and seamless square-tile creation, as well as features designed to ease the creation of images that would run in a game on the Game Boy Advance or a Mobile Phone platform. The price of the normal version is $78.

[https://graphicsgale.com/us/ '''GraphicsGale'''] (Windows) is a pixel editing program designed for animation. It is lightweight, portable, and entirely freeware. Supports many different image types, color palettes, and alpha channels.

==== Non-shareware ====
[http://www.adobe.com/ '''Photoshop or Photoshop Elements'''] (Windows and Mac OS X), these industry standard Adobe applications are available for approximately USD $100 and $700, respectively, depending on what version of the software you purchase and where you purchase it. You may be able acquire the use of these programs through a business or academic situation. Adobe Photoshop is extremely powerful, and is more than capable of some very advanced sprite techniques which elude simple bitmap programs - the price, however, can be a barrier to entry for some contributors. More advanced (and therefore more expensive) version of Photoshop should have little advantage over Elements (the entry-level version, usually available for approximately USD $100) for creating unit and terrain art. Photoshop (and presumably Elements) does not compactly save PNG files. For space savings, Adobe users are recommended to resave final PNGs through Adobe's companion application ImageReady, or another application such as GraphicConverter or PNGCrusher. Note - the ImageReady compression can also be used by saving the files through the "Save for Web..." menu command within Photoshop, if ImageReady is installed.

== See Also ==
* [[Create]]
* [[Art Tutorials]]

[[Category: Art Tutorials]]

GettextForTranslators

2024-02-29T20:20:20Z

Egallager: /* Tools */ add some additional links

== Gettext for translators ==

=== For the engine and mainline campaigns ===

The target audience of this page is anyone who wants to help with a language that's already in the list on [[WesnothTranslations]]. The files for these languages have already been set up, someone is already the maintainer, and the pages linked from that page say where to go and how to introduce yourself to the team. The effort is split with separate teams for each language, and each team can have its own working style.

Because each team can work in different ways, please do not submit translations as pull requests on Github. While that seems like a good idea, it causes potential complications, so we ask that everyone talks to their language's maintainer and submits changes in the way that the maintainer decides to use.

If you're starting a completely new translation, or taking over as the maintainer of a translation, then the next place to read would be the [[WesnothTranslationsHowTo]] page.

=== For add-ons ===

The target audience is anyone who wants to help translate an add-on, assuming the add-on's maintainer has already set it up for translation. Translations are shipped with the add-on, so it's up to the maintainer to choose how to receive the files and organise the workflow.

To translate an add-on, skip to the [[#Files_for_add-ons|Files for add-ons]] section.

If you are the maintainer of the add-on, the instructions for setting up the translation are on [[GettextForWesnothDevelopers]].

== Textdomains and getting the files to translate ==

The progress for each language is shown on https://www.wesnoth.org/gettext/ . Click on your language, and you'll see a breakdown into sections ''(textdomains)'', such as
* wesnoth
* wesnoth-editor
* wesnoth-help
* wesnoth-units
* wesnoth-lib (contains strings shared by game and editor)
* wesnoth-httt (the Heir to the Throne campaign)
* wesnoth-utbs (the Under the Burning Suns campaign)
* etc

Each has a separate file with a .po extension. For example, the Swedish translation has abbreviation ''sv'', and its translation of the editor's strings is in ''wesnoth-editor/sv.po''. The page on https://www.wesnoth.org/gettext/?view=langs&version=branch&lang=sv links to the current version in the main Git repository.

Although the .po files contain text, please send the complete files as email attachments (or whichever method your team uses), rather than cutting and pasting lines from the file into an email. The translated strings are
very sensitive to formatting and whitespace changes.

=== Files when running the game ===

When the game runs it will look for an .mo file, for example ''translations/sv/LC_MESSAGES/wesnoth-editor.mo''. If you want to test your text in-game and you're happy to modify your installation:

* Some .po editors can automatically generate .mo files.
* Deleting the .mo file will make the game look for ''translations/wesnoth-editor/sv.po'' instead.

However you can also send your untested .po file to the maintainer and they should check that it looks correct in-game.

=== Files for add-ons ===

This assumes the add-on has .po files rather than .mo files. The engine supports both, but only .po are editable. For example, an add-on called Son of Haldric that has a Swedish translation would likely store it in:

* ''data/add-ons/Son_of_Haldric/translations/wesnoth-Son_of_Haldric/sv.po'' .

That comes from:

* ''data/add-ons/Son_of_Haldric'' is where all files from the add-on are stored
* ''translations/wesnoth-Son_of_Haldric'' is configured by the maintainer
* ''sv'' is the language code for Swedish. The codes for each language are given in the big table on [https://www.wesnoth.org/gettext/ https://www.wesnoth.org/gettext/] .

If it's been set up for translation but hasn't yet been translated into Swedish, it may instead have a file called ''wesnoth-Son_of_Haldric.pot''. This is a template which you can copy to "sv.po", however first try opening the .pot file directly in your [[#Tools|translation tool]], as the it will likely prompt you to create a translation from the template.

After editing the file, either refresh the cache (press F5 on the title screen) or restart Wesnoth to see the changes.

Warning: files in the add-on directory will be overwritten or deleted if it's updated using the in-game Add-on Manager, so keep backups of files in a separate directory.

== How to translate ==

Now that you have the .po file to edit, it can be worked on using any of the programs listed in the [[#Tools|Tools section]]. The general preference in Wesnoth seems to be towards Poedit, but they all work on the same .po file format.

The general concept is that the GUI will show the strings in English, along with a text-box to add the translation.

=== Hints ===

In addition to the English text, most strings have some additional information which in Poedit will be shown in the bottom-right of the screen. For example, the tutorial's "... this quintain!" has "[message]: speaker=Delfador", meaning that it's [[InterfaceActionsWML#.5Bmessage.5D|said]] by the unit with id "Delfador". Sometimes the hint is less obvious, often lines will be "[message]: speaker=unit", normally meaning the unit whose move, attack, or death has triggered an event.

Some strings will have additional hints, such as "Addressing Konrad" or "Addressing Li'sar". The level of detail varies a lot between campaigns, please don't be afraid to point out when something needs to be improved.

The .po files also say which source file the string came from, in Poedit 3.4 this is found in a right-click menu (right-click on a string in the top-left pane of the GUI).

=== Carets ===

There are ambiguous strings which should be translated in a different way depending on where they appear. For example, we have "General" in the preferences as "General preferences" and we can also have "a General". These strings can have different translations for a given language, so we use "context" to solve this. The prefix only tries to give a hint about the string, and should be not translated, for example:

<syntaxhighlight lang=po>
msgid "Prefs section^General"
msgstr "General"
</syntaxhighlight>

As another example, these lines in the tutorial both have the hint "[message]: speaker=student"; they're spoken by Konrad and Li'sar respectively:
* "A quintain? You want me to fight a dummy?"
* "female^A quintain? You want me to fight a dummy?"

When an English string has a caret (the ^ symbol) in it, then everything before the first caret is removed before showing it to the player. In the translated strings, leave out everything before the caret.

These caret hints are very commonly used in Wesnoth for strings where the translation may depend on the gender of the speaker, or the person spoken to. They're also used for strings such as "Prefs section^General", where the string is the label on the "general preferences" tab, not a military rank.

If you forget to strip out the caret hint, it will be displayed to the user unless the entire string is identical to the source text. This means that it should be stripped out even if the text is otherwise identical, to avoid breaking it if it's later determined that the text needs to be changed. For example:
<syntaxhighlight lang=po>
# wrong but seems to work (shows as "Root")
msgid "filesystem_path_system^Root"
msgstr "filesystem_path_system^Root"
# wrong and shows as "filesystem_path_system^Wurzel"
msgid "filesystem_path_system^Root"
msgstr "filesystem_path_system^Wurzel"
</syntaxhighlight>

=== Warnings ===

Some editors can automatically detect inconsistencies between the English and the translated text, for example if the original ends with a full-stop and the translation ends with an exclamation mark. Poedit defaults to showing these above even the untranslated strings, but these can be false-positives - generally someone's already looked at these and decided that the translated text is better as-is.

=== Fuzzy strings ===

One of the downsides of Gettext is that spelling and grammar corrections in the English text break the link between the original and the translated text. The tools that generate .po files try to recover from this by using the old translation for the new English text, and marking the string as ''fuzzy''; in Poedit these are sorted below the completely untranslated strings, and shown with the "Needs Work" button lit along with a note about what the previous English text was.

Be wary, this mechanism can also generate incorrect suggestions. For example it may decide that "Landar left $number troops to guard the council" is a spelling correction of "Kalenz left $number troops to guard the council".

== Parts to leave untranslated ==

Some translatable strings mix text to be translated with placeholders that are handled by the engine before displaying the text to the player. The text of the placeholder needs to be left untranslated.

=== Dollar signs ===

Most placeholders start with a dollar sign (<code>$</code>), for example, <code>$number</code> or <code>$gold_amount</code>. The details are in [[VariablesWML#Variable Substitution|VariablesWML]], but for translation the general rules are:

Characters that appear in placeholders are letters, numbers, square brackets, underscores, full stops and question marks. Square brackets always appear in balanced pairs, and often enclose a secondary (nested) placeholder.

* After a dollar sign, every character in the list above is part of the placeholder.
* A space ends the placeholder, and the space is also displayed to the player.
* A vertical bar (<code>|</code>) ends the placeholder, and the vertical bar isn't displayed to the player.
* If you need to put a full stop or question mark immediately after a placeholder that doesn't end with a vertical bar, add a vertical bar to separate them. Although it's not ''always'' necessary, it ''never'' hurts to add the vertical bar to be on the safe side.
* A dollar sign at the end of the string, or directly followed by a vertical bar (<code>$|</code>), is displayed as a dollar sign.
* Obscure cases should have a hint about the string.

=== Markup ===

Some strings contain formatting markup. This comes in two styles. The most common is [[Pango formatting|Pango markup]], which is an HTML-like formatting language. The other is the custom help page markup, which looks superficially similar but is rather different, and is documented here.

Like HTML, help markup consists of tags enclosed in angle brackets (eg <code><italic></code>), with a slash added to the closing tag. The difference lies in what comes between the tags, which takes a key=value format where the value is usually enclosed in single quotes. There can be multiple key=value pairs, separated by spaces. Generally, all of that should be left untouched, with the exception of the <code>text</code> key. If you see something like <code><italic>text='some text'</italic></code>, the only part that should be translated is "some text". Or if you see <code><nowiki><ref>dst='movement' text='zones of control'</ref></nowiki></code>, then only "zones of control" should be translated, and the rest should be left untouched.

If you need to include a single quote within <code>text='...'</code>, you can add a backslash before it. However, most of the time it's preferred to use [[Typography_Style_Guide#Character_Usage_Summary|typographic punctuation]] instead.

== FAQ ==
* '''What are "Plural-forms"?'''
** Some languages have different word forms for different numbers of things (for example in English we have "1 thing" but "2 thing'''s'''"). The rules are different for different languages. You can find them [http://translate.sourceforge.net/wiki/l10n/pluralforms here].
* '''Who can I ask for further information?'''
** You can ask in [[Support|Discord or IRC]]. Ping Ivanovic in Discord's #development or IRC's #wesnoth-dev channel. If you don't like IRC, send a mail to crazy-ivanovic AT gmx DOT net, or pm him (ivanovic) at the forum.
* '''Why is the diff from the previous version so huge? I have only made a small change to the .po file with poedit.'''
** When saving a .po file, poedit unwraps all strings. Usually, all .po files are wrapped at 80 characters, so if you want smaller diffs and less merge conflicts, you can execute the following commands each time after editing with poedit:

msgattrib file.po > file.po1
mv file.po1 file.po

== Tools ==

There are several tools to work with .po files:
* [https://pofile.net/free-po-editor Free PO editor] (Web based)
* [http://userbase.kde.org/Lokalize Lokalize] (Unix KDE) (Formerly known as [https://directory.fsf.org/wiki/KBabel KBabel])
* [https://kate-editor.org/ Kate] (Unix KDE)
* [http://wiki.gnome.org/Apps/Gtranslator GTranslator] (Unix Gnome)
* [http://virtaal.translatehouse.org Virtaal] (Multiplatform)
* [http://www.poedit.net/ poEdit] (Multiplatform)
* [http://www.gnu.org/software/emacs/emacs.html Emacs with po-mode] (Multiplatform)
* [http://www.vim.org/ Vim] with [http://www.vim.org/scripts/script.php?script_id=695 PO plug-in] (Multiplatform)
* [https://www.geany.org/ Geany] with [https://plugins.geany.org/pohelper.html PoHelper plug-in] (GTK3 / Multiplatform)
* [https://pypi.org/project/translate-toolkit/ Translate toolkit] (Python)
* [https://pootle.translatehouse.org/ Pootle] (Web-based)
* [https://transdict.com/ TransDict] (Web-based)
* [https://docs.translatehouse.org/projects/localization-guide/en/latest/guide/tools/list.html Translatehouse web page with a list of more tools]

Of course, you can edit po files with any UTF-8 capable text editor, but the tools listed above have great advantages over any text editor regarding .po translation, like going to next fuzzy/untranslated string, searching only in specific fields (msgid, msgstr, comment), ...

== See Also ==

* [[WesnothTranslations]]
* [[WesnothTranslationsHowTo]]
* [[GettextForWesnothDevelopers]]
* [[TranslatorShellscript]]
* [http://www.wesnoth.org/gettext/ Translation statistics]

[[Category:Translations]]

GettextForTranslators

2024-02-19T20:15:02Z

Egallager: /* Tools */ Kate also shows up as listed explicitly in the "X-Generator:" field in some of Wesnoth's pofiles

GettextForTranslators

2024-02-19T17:19:49Z

Egallager: /* Tools */ Lokalize used to be KBabel

User:Egallager

2024-01-27T18:28:08Z

Egallager: /* Elsewhere on the web */ links to additional art repos (for ALA and TEG)

== Introduction ==
Hi, I am Eric Gallager. I am from New Hampshire.

== Forums ==
I also go by [https://forums.wesnoth.org/memberlist.php?mode=viewprofile&u=219741 egallager] on the forums.
Here are links to the topics I've either started, or that are for campaigns I've taken over:
* [https://forums.wesnoth.org/viewtopic.php?f=8&t=53597 Son of the Black Eye: Easy Edition]
* [https://forums.wesnoth.org/viewtopic.php?f=8&t=53601 A Tale of Two Brothers With a Third Difficulty]
* [https://forums.wesnoth.org/viewtopic.php?f=8&t=47885 A Little Adventure]
* [https://forums.wesnoth.org/viewtopic.php?f=8&t=26800 The Earth's Gut]
* [https://forums.wesnoth.org/viewtopic.php?f=8&t=1887 Flight to Freedom]
* [https://forums.wesnoth.org/viewtopic.php?f=31&t=24967 The War of Terrador]
* [https://forums.wesnoth.org/viewtopic.php?f=8&t=6486 A New Order]
* [https://forums.wesnoth.org/viewtopic.php?f=8&t=39512 Dawn of Thunder]
* [https://forums.wesnoth.org/viewtopic.php?f=7&t=54568 Call for translators (for my add-ons in general)]
* [https://forums.wesnoth.org/viewtopic.php?f=6&t=54369 Discussion of a Japanese "Let's Play" introduction to Wesnoth]
* [https://forums.wesnoth.org/viewtopic.php?t=57132 Word association]
* [https://forums.wesnoth.org/viewtopic.php?t=57215 Mainlining popular UMC tracks]
* [https://forums.wesnoth.org/viewtopic.php?t=57225 Categorizing UMC music by moods]

== Elsewhere on the web ==
I go by [https://github.com/cooljeanius "cooljeanius"] on GitHub (it's an old handle), and keep the sources for many of my Wesnoth things on there:
* [https://github.com/cooljeanius/wesnoth_mods generalized mods collection]
* [https://github.com/cooljeanius/Son_Of_The_Black_Eye_Easy_Edition Son of the Black Eye: Easy Edition]
* [https://github.com/cooljeanius/Saving_Elensefar Saving Elensefar]
* [https://github.com/cooljeanius/dawn_of_thunder Dawn of Thunder]
* [https://github.com/cooljeanius/Two_Brothers_With_A_Third_Difficulty A Tale of Two Brothers With a Third Difficulty]
* [https://github.com/cooljeanius/The_War_of_Terrador The War of Terrador]
* [https://github.com/cooljeanius/A_New_Order A New Order] (with a separate repo, [https://github.com/cooljeanius/ANO_art ANO_art], for the raw art assets used for it)
* [https://github.com/cooljeanius/A_Little_Adventure A Little Adventure] (with a separate repo, [https://github.com/cooljeanius/ALA_art ALA_art], for the raw art assets used for it)
* [https://github.com/cooljeanius/The_Earths_Gut The Earth's Gut] (with a separate repo, [https://github.com/cooljeanius/TEG_art TEG_art], for the raw art assets used for it)
* [https://github.com/cooljeanius/Flight_Freedom Flight to Freedom]
* [https://github.com/cooljeanius/Roboke Roboke]
I also use that handle elsewhere, such as on Wikipedia: [https://en.wikipedia.org/wiki/User:Cooljeanius https://en.wikipedia.org/wiki/User:Cooljeanius]

== This wiki ==
I have been editing (and intend to edit further) the following pages: [[ReferenceWML]], [[CharactersStorys]], [[Guide to UMC Content]], [[Glossary]], [[Maintenance tools]], and [[Available Music]].

FlightToFreedom

2024-01-27T05:49:40Z

Egallager: update

<big>Flight to Freedom</big>


Last updated 1/27/24 (although before that, there was a long stretch where it hadn't been updated since 2/22/14, so much of the info on this page may still be out-of-date)

Flight to Freedom is a campaign featuring the Drakes. The hero, Malakar, and his tribe have been enslaved by humans,
and Malakar must free the tribe and take revenge on his oppressors.

Latest version is [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.2 5.4.2] (for Wesnoth 1.16.x+), or [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.5.0 5.5.0] (for Wesnoth 1.17.x+) 
The forum thread is [http://www.wesnoth.org/forum/viewtopic.php?f=8&t=1887 here]. 
Made by MadMax, Nova 
Currently maintained by [[User:egallager|egallager]] 

== News ==

9/6/04: 
News started, not that I expect much to come up.

Artists wanted [http://www.wesnoth.org/forum/viewtopic.php?t=2996 here] for a new Kogw graphic. 
Announce your loyalty to the Drake cause [http://www.wesnoth.org/forum/viewtopic.php?t=2976 here]!

9/7/04 
I need feedback to keep improving. Keep it coming.

9/13/04: 
Revision 27 released, with many changes. A major update.

9/17/04: 
Poll updated. Redeclare your loyalties [http://www.wesnoth.org/forum/viewtopic.php?t=3132 here]!

9/19/04: 
Poll updated again. Prove yourself [http://www.wesnoth.org/forum/viewtopic.php?t=3143 here]! 
Campaign is on campaign server (requires CVS). Unless any major bugs arise before 0.8.5 is released, all future updates
will take place on the campaign server.

9/23/04 
revision 28 released on campaign server. Contains new drakes, Kogw graphic, and several balance changes. Requires CVS
or better 
Need attack/defense animations for Kogw graphic, need indoor time graphic (the picture under the map)

9/24/04 
revision 28.3 on campaign server. This is necessary for compatibility with CVS as of 9/24/04 (when the Drake Slave was
removed). Also has many bug fixes, including the bug that caused scenario 2 to hang.

9/26/04 
revision 28.4 on server. Bug fixes, balancing, additions to River of Skulls (credit Wesvoid), and an easter egg (not
telling you what, but I will say it's randomly activated in Endgame).

10/5/04 
revision 29 released. 1.4MB. Major changes: 
many bug fixes 
thunder spirit spawn animation 
debugger unit for testing and cheating 
improvements to Rebellion, Manor, Exodus 
new sound in the victory sequence 
new Drakes 
Note that there are some nasty engine bugs (Savannah #10569, #10570) that cause the recall list to disappear in Open
Ocean, and the campaign to quit altogether in Drake Escape. If anyone can help, I would very much appreciate it.

10/8/04 
New version. This changes the pier tiles to bridge, and it adds the Drake Hatchling back and the Drake Guard required
in scenario 21, fixing a major bug involving recruitment.

10/15/04 
New version. Bug in Drake Escape (#10570) worked around, but recall bug (#10569) is still at large. I also have made
Kogw level two, and gave him a level 3.

11/21/04 
New version released on campaign server. (2.2) 
Improvements:

switched to the x.x.x version system 
neutral birds actually fly 
in Drake Escape, Goblin Pillagers can pillage 
balancing changes to many scenarios 
bug fixes in Rebellion

1/3/05 
Update: 
version 2.4:

bug fix 
storyline images for Survival and Rebellion 
balancing improvements in Endgame

1/19/05 
Update: 
version 2.5:

changes to Manor 
a major bugfix

1/20/05 
Update: 
version 2.5.1

minor bugfix in Manor

2/3/05 
Update: 
version 2.6

maps use new terrains where appropriate 
scenarios set on Morogor now have their location denoted on a [http://gs295.sp.cs.cmu.edu/brennan/wercator/index.html Wercator]-
created map ([http://gs295.sp.cs.cmu.edu/brennan/wercator/maps/Peoples_in_Decline.jpg here]) 
balance changes to Manor, River of Skulls, Return to Morogor, Liberation, Endgame 
minor bugfixes

2/19/05 
Update: 
version 2.6.1

directory structure updated 
balance changes to Endgame 
0.8.11 compatibility

2/27/05 
Update: 
version 2.6.2

major bugfix to Blockade, should be possible to win now

4/13/05 
Update: 
version 2.7

scenarios updated for compatibility with 0.9 
varied dialogue improvements 
balancing to River of Skulls (removed village in chokepoint) 
scenarios take advantage of new [objectives] tag, changing objectives added 
maps now use river ford and ruin terrains

5/14/05 
Update: 
version 2.8

translated into German and Swedish 
WML syntax updated for 0.9.1 (involving translations) 
portrait for Kogw

6/10/05 
Update: 
version 2.9

WML updated for 0.9.2 
WML optimizations, separate copies of drake unit.cfgs no longer needed 
portrait for Malakar added 
balancing changes to Survival 
pngcrush run on all images 
rock golem image updated

6/22/05 
NOTE: This update breaks all in-game saves (NOT beginning-of-scenario saves) for the following scenarios: 
Southern Shore 
Open Ocean 
Landfall 
Blockade

Update: 
version 2.9.1

SHOULD be compatible with 0.9.2CVS 
missing newline at end of Flight_Freedom.cfg fixed 
FtF's Pirate Galleon does not override the in-game Pirate Galleon 
new graphics for the Driver 
balancing changes to Rebellion and Manor, Malakar has leadership in those scenarios

7/03/05 
Update: 
version 2.9.2

balancing change to River of Skulls, second chokepoint added parallel to the first 
mid-scenario objectives changes work properly now 
enemies in Survival do not recruit infinite numbers of units 
in Caravan, the caravan's movement points reflects its actual movement

11/02/05 
I know it's been overdue for over a month, but here it is. I've finally got the underground scenarios balanced, but there are so many changes (and so little time to debug) that I have had to release a beta. Hopefully, unless any major bugs are found, I'll finalize FtF 3.0 in a week.

In the meantime, PLEASE reply if you find any bugs.

12/2/05 
UPDATE: 
version 3.0

FtF 3.0 finally released!

Many changes across the board, far too many to list, but here are the major changes (including those of the 3.0 beta): 
storyline changes 
Rebellion enhanced 
underground scenarios balanced 
bug fixes, dialogue changes in Landfall

12/3/05 
UPDATE: 
version 3.0.1

game-killing bug in Landfall fixed (map was not sent)

3/23/06 
UPDATE: 
version 3.1

updated for 1.12+, not backward compatible (beginning-of-scenario saves will still work) 
new terrain added: dark tiles, from UtBS (replaces some dirt, sand in caves) 
maps updated for new terrain 
image references updated to reflect 1.12 directory structure 
terrain code for lava bridge changed to ` instead of ' to avoid conflict 
Skeletal Dragon, Watch Tower moved into FtF from EI, SoTBE (credit Hanno for alerting me to this) 
old wesnoth-8.ogg moved into FtF 
soundtracks updated for music changes/removals 
balancing changes to Underground, River of Skulls, Endgame 
unit .cfgs updated for 1.12 compatibility 
easter egg temporarily commented out, pending consideration 

NOTE: due to technical differences between the old code and the 1.12+ compatible code, I was forced to split the campaign into two distributions, which are on their respective campaign servers. Because of this, however, the translations will not be current until the branch is created on wescamp (so that translators can update it).

8/20/06 
3.2 is on the campaign server. It [i]should[/i] be (almost) fully compatible with 1.18, but I can't guarantee that every animation will work right. I have also made balancing changes up until Exodus (level 16), but the cave levels are still buggy. 
Any feedback is appreciated!

12/22/06 
Hosted on http://warhangel.ru/wesnoth/campaigns/Flight_Freedom_1_x.zip . Special thanks to warhangel for hosting this campaign. 

1/5/07 
FtF 3.3 uploaded.

NPC AI should be fixed 
naga, saurian animations are working, graphics from Marsh Era 
two attack icons added, one by Xan, the other from the Extended Era 
balancing changes to Manor, Underground, River of Skulls and Blockade 
Rockfall fixed with RedLTeut's patch 
other fixes and tweaks which I have forgotten about 

3/20/07 
FtF 4.0 released, for Wesnoth 1.3 and up only. 
compatible with new terrain system, will make cave roads passable 
Manor enhanced 
Survival edited, but cutscene not implemented yet 
several dialogue changes 
Landfall bridge collapse softened 
new graphic for the enslaved Malakar 
several bugfixes 
Drake Guerillas/Revolutionaries have visible spear overlay 
losing text added if Unforgiver is sunk and Kogw has not disembarked 

4/21/07 
version 4.1 released 
many new storyline images added 
many dialogue changes 
extra enemy added to Survival, to shorten it 
balancing changes to Pirate Schooner and Clipper 
all ships have reasonably fitting hit and die sounds 
Manor recruitment bug precluded 
cutscene code moved to separate file (a purely internal change) 
rain added to Open Ocean 
ships should have names 

6/14/07 
version 4.2 released 
dragon in Underground is now friendly 
River of Skulls rebalanced, map edited 
several bugfixes 
Blockade enhanced 
new Malakar and Kamalar graphics 
terrain error messages fixed 
FtF will sort properly in campaign menu 
ships now have names 
experience gained in Survival by Malakar will carry over to Rebellion 

NOTE: This will break saves of River of Skulls. Other saves will work, but they may use the old Malakar (which should work fine). 

7/6/07 
version 4.2.1 released, for Wesnoth 1.3.3+ 
bug fixes in Underground and River of Skulls 
Manor enhanced 
minor dialogue changes 
a few minor bug and potential bug fixes 

7/20/07 
version 4.2.2 released, for Wesnoth 1.3.4+ 
dialogue changes 
storyline graphics updated for new Malakar graphics 
new storyline graphics for Underground and Rockfall 
Caravan elves nerfed 
Drake Escape enhanced 
at least one bugfix 

8/3/07 
version 4.3 released, for Wesnoth 1.3.4+ 
changes (dialogue and other) to Rockfall, Betrayal, Hordes of the Foul Undead, Gate of Storms, Exodus, Blockade and Return to Morogor 
two scenarios added (Swamps of the Jamolar and Council of War), part of a possible branch (accessed from Survival) 
attainable objective added to Survival 
experimental wave animations in Rebellion 
minor bugfixes 
time over events added to some scenarios 
non-expendable player characters are spawned with hero icon 
balancing changes to Betrayal and Blockade 

8/23/07 
version 4.3.1 released, for Wesnoth 1.3.6+ 
new scenario, Forest of Nightmares (in second branch) 
enhancements to Manor, includes irrevenant's indoors time-of-day image 
several bugfixes 
thunder spirits in Landfall and Drake Escape will not spawn on first turn 
multi-hex fireball attack code implemented (not used yet) 
victory music added to victory events 
lava transitions fixed 

9/1/07 
version 4.3.2 released, for Wesnoth 1.3.7+ 
critical 1.3.7 compatibility bug fixed 
new scenario, Hafwyt (still not 100% finished) 
savegames of cave levels will not show snapshots 

10/22/07 
version 4.3.3 released, for Wesnoth 1.3.9+ 
unit WML updated to 1.3.8+ standard 
new scenario: Mountain Crypt (in second branch) 
bugfixes 
turn limit of Forest of Nightmares reduced to 25 
balancing changes 

1/20/08 
version 4.4 released, for Wesnoth 1.3.14+ 
headers and borders added to all maps 
two links added in secondary branch to main branch 
sword-and-shield narrator icon replaced 
new cutscenes 
Mountain Crypt darkness code revised 
bugfixes 

8/19/08 
version 4.5 released, for Wesnoth 1.4+ 
scenario 19, Liberation, completely rewritten 
dialogue changes 
user team names added, so that the status table will show the names of sides in a level 
bugfixes 
levels use new Wesnoth music when appropriate 

2/20/09 
version 4.6 released, for Wesnoth 1.5.6+ 
compatibility with Wesnoth 1.5 branch 
bugfixes 

7/25/21 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.3.3 5.3.3] released, for Wesnoth 1.14+ 
egallager's first release since taking over as maintainer 

5/18/22 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.0 5.4.0] released, for Wesnoth 1.16+ 
first release on the 1.16 add-on server 

11/27/22 
version [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.1 5.4.1] released, for Wesnoth 1.16+ 
see release notes for full changelog 

1/27/24 
versions [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.2 5.4.2] and [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.5.0 5.5.0] released, for Wesnoth 1.16+ and Wesnoth 1.17+ respectively. 
see each of their release notes for full changelogs 

== See Also ==
* [[Guide_to_UMC_Content]]
* [[CampaignFlightFreedom]]

[[Category:Campaigns - Development]]

Guide to UMC Content

2024-01-27T05:45:05Z

Egallager: /* Flight to Freedom */ new releases

This is a guide to current-ish user-made content for players. It provides unfamiliar players with detailed information about campaigns (including story, completion, difficulty and playing style) as well as detailed information about eras. Feel free to edit this guide, as it is a wiki.

This list covers add-ons for the latest 2 stable releases (1.14 and 1.16) of Wesnoth. There are archived versions of this page for [[Guide_to_UMC_Content/1.10|1.10]] and [[Guide_to_UMC_Content/1.12|1.12]].

For content creators who loved an add-on that hasn't been added to 1.14 or 1.16 yet, and are wondering about taking it over, please ensure that its entry on the older (1.12 or 1.10) wiki page is up to date, add a link to the add-on's feedback thread in the forums, and generally do the tidy-up that doesn't need you to start changing the campaign, and then ask the old maintainer. (You should probably also wait a bit before assuming that a maintainer isn't already porting to 1.16).

If you are looking for even more campaigns, please see the links in at the bottom of this page.

== Instructions ==
When adding a campaign to the list, please place it in its alphabetically sorted location, ignoring any initial article ("A", "An", or "The").

=== Blueprint for Campaigns ===

* Description:

* Author:

* Maintainer: if not maintained by the author anymore.

* Status:
** Broken = Does not work at all
** Incomplete = Partially written, no progress
** WIP = Partially written, some progress
** Complete = Completely written, but buggy as well as potential balance issues.
** Finished = Completely written, minimal to no bugs, slight balance issues possible.

* Version campaign version on the add-ons server

* Length:

* Requirements: (only if needed)

* Difficulty:

Please note: Often campaigns introducing new mechanics are listed as expert level on the add-on server, here difficulty means the raw difficulty after the mechanics are understood.

** Unbalanced = If you can't beat the hard mode, it isn't necessarily unbalanced, but if the difficulty changes erratically from one scenario to the next and only people using the debug mode have seen the final, then it is.
** Easy
** Normal
** Hard

Please note: If you didn't play the campaign, write the difficulty written on the add-ons server.

* Style:

Please note: Many campaigns will feature more than one style. Please list the most significant ones. If you don't know which style is the campaign you are listing, don't write this.

** Skirmish = small to medium sized armies, your standard Wesnoth gameplay
** Dungeon = long and narrow tunnels (not every underground scenario is a dungeon, a dungeon isn't necessarily underground)
** RPG = role playing game elements such as talking with non-player-characters, item collection, dependency on a party of very few adventurers without or limited recruits
** Survival = being exposed to changing, spawning enemies while remaining on the same map
** Large Battle = large number of units on the battlefield, sizely maps
** Simulation = campaigns feat. terrain modification, alternative resources
** Boss battle = the challenge is to defeat a single powerful enemy unit
** Minigames = there are puzzles and minigames in the campaign that significantly differ from standard Wesnoth gameplay

* Faction/Era: Era for the whole campaign and more specifically the faction or unit composition you field.

* Custom units: Link to the unit tree for cases that don't feel sufficiently described by Faction / Era entry.

* Forum: Links to the feedback and development threads at forums.wesnoth.org

=== Blueprint for Eras ===

* Description:

* Author:

* Maintainer: if not maintained by the author anymore.

* Status 1.14/1.16:
** see the list of statuses in the campaign blueprint

* Faction Descriptions: Describe your individual factions here.

* Requirements: (only if needed)

* Forum: Links to the feedback and/or development threads at [https://forums.wesnoth.org/ forums.wesnoth.org].

== How to play for UMC factions ==

=== Southern Nations by Elvenisko ===
[[How_to_play_Death_Knights|Death Knights]] |
[[How_to_play_Southern_Drakes|Southern Drakes]] |
[[How_to_play_Southern_Dwarves|Southern Dwarves]] |
[[How_to_play_Southern_Elves|Southern Elves]] |
[[How_to_play_Southern_Mages|Southern Mages]] |
[[How_to_play_Southern_Mercenaries|Southern Mercenaries]] |
[[How_to_play_Southern_Orcs|Southern Orcs]] |
[[How_to_play_Southern_Swamplords|Southern Swamplords]] |
[[How_to_play_Southern_Nations|Comparison]] |
[https://units.wesnoth.org/1.17/Southern_Nations/en_US/era_southern.html All units (can be out of date)]

== Battle for Wesnoth 1.14 and newer ==

=== Campaigns ===

==== After the Storm ====

''Follow the journey of Galas and his band following the events of Invasion from the Unknown''

'''Author:''' shadowm/ShikadiQueen/Iris

'''Status:''' Finished, 0.10.11

'''Length:''' 3 episodes of 13 scenarios each, some of which are multi-part

'''Difficulty:''' Medium-hard

'''Style:''' Skirmish, Boss Battle, Dungeon

'''Faction/Era:''' Many custom units

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=32091]

'''GitHub:''' [//github.com/project-ethea/After_the_Storm]

'''Note:''' (vultraz) Long, very enjoyable campaign with great story. (Knyghtmare) The best UMC campaign ever!

'''[[Guide_to_UMC_Campaigns/Players_Reviews#After_the_Storm|Players’ Review(s)]]'''

====A Beastly Tale====

''When a small village is beset by troubles, its fate rests in the hands of a young woodsman and the animals he befriends.''

'''Author:''' GloccusV

'''Status:''' Complete

'''Version:''' 2.0.3

'''Length:''' 5 scenarios

'''Difficulty:''' Intermediate

'''Custom units:''' [//units.wesnoth.org/1.14/A_Beastly_Tale/en_US/A_Beastly_Tale.html Here]

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=41434&p=633612&hilit=A+Beastly+Tale#p579093 Here]

====A Song of the Winds====

''Every era has its heroes and heroines. Before the song of Myra, the odyssey of Akhen Wadjet and the aria of Tenma Yozora, there was the song of the winds that echoed in the mountains and halls at the heart of the Great Continent. Follow young Maat of Hiera'Shirsha and Prince Abhai of Garet-Desh in the war that set the stage for one of the greatest upheavals Irdya has ever witnessed.
(Prequel to the Dragon Trilogy)''

'''Author:''' revansurik

'''Status:''' Complete

'''Version:''' 1.0.0

'''Length:''' 43 scenarios (some of them dialogue-only)

'''Difficulty:''' Intermediate

'''Custom units:''' War of Legends + Custom factions

'''Forum:''' [//https://forums.wesnoth.org/viewtopic.php?f=8&t=53913 Here]

==== Bad Moon Rising ====

''An expedition to gather treasure from the cold north sets off compounding disaster.''

'''Author:''' Doofus-01

'''Status:''' Complete 1.10.0

'''Length:''' 20 scenarios

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Archaic Era

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=31348]

'''GitHub:''' [//github.com/doofus-01/wesnoth-Bad_Moon_Rising]

==== The Black Cross of Aleron ====

''A elvish school for druids comes under attack by goblins. It seems more than just a routine raid; is there something more sinister behind this attack? - In Beseiged Druids, you control Eärendil, the surviving teacher at the school, and the many and varied initiates. Not all of these are ordinary students; many have been experimenting with other forms of magic, while others are simply overachievers in some area of study. Unfortunately, they are not especially good at combat, at least initially. Together with a very small contingent of surviving guards, it is up to these students to save the island of Aleron from disaster.''

'''Author:''' Celtic Minstrel

'''Status:''' Complete 2.0.3

'''Length:''' 9 scenarios

'''Difficulty:''' Unbalanced

'''Style:''' Skirmish

'''Faction/Era:''' Default, Elves

'''[https://units.wesnoth.org/1.14/Black_Cross_of_Aleron/en_US/celmin-druid-siege.html Custom units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=37342

==== Danse Macabre ====

''Macabre is a rare zombie who has intelligence and will. What's he like? What's his purpose?''

'''Author:''' kamikaze

'''Maintainer:''' James_The_Invisible

'''Status:''' Completed, 1.3.2

'''Length:''' 12 scenarios

'''Difficulty:''' Unbalanced

'''Style:''' Large Battle

'''Faction/Era:''' Default, undead

'''[//units.wesnoth.org/1.14/Danse_Macabre/en_US/Danse_Macabre.html Custom units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=33745]

'''Note:''' While the campaign is playable on Wesnoth 1.14 without major issues, it is (still) in need of heavy re-balancing. Sadly, for various reasons I am not able to do it in near future but patches are always welcome, preferably in form of pull requests on [https://github.com/konecnyjakub/Danse_Macabre GitHub].

==== Dawn of Thunder ====

''A young elvish fighter is send to represent the Aethenwood at the Ka'lian. The adventure turns out to be bigger than expected.''

'''Author:''' Paulomat4

'''Maintainer:''' egallager

'''Status:''' [https://github.com/cooljeanius/dawn_of_thunder/issues/3 Incomplete], latest release on the BfW 1.16 add-on server is [https://github.com/cooljeanius/dawn_of_thunder/releases/tag/0.2.4 0.2.4].

'''Length:''' 18 scenarios

'''Difficulty:''' Challenging

'''Style:''' Skirmish, Large Battle, RPG-elements

'''Faction/Era:''' Default, Elves, Humans

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=39512 forums.wesnoth.org/viewtopic.php?f=8&t=39512]

==== A Fiery Birth ====

''A scholar of the Great Academy journeys to the land of the drakes to discover their secret origins.''

'''Author:''' Mathbrush

'''Status:''' Complete

'''Version:''' 1.2.0

'''Length:''' 9 scenarios

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=47861&p=623953 Here]

'''GitHub:''' [//github.com/brirush84/AFieryBirth]

==== The Final Exam ====

''Young mage Erika must find a magic book to become a true mage. But will it really be her final exam?''

'''Author:''' Elven

'''Status:''' Complete, 2.6.1

'''Length:''' 4 scenarios

'''Difficulty:''' Easy

'''Style:''' Skirmish, Minigames

'''Faction/Era:''' Default, Loyalists

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=23398]

'''Note:''' Short, easy campaign with varying objectives. Features female mage as leader.

==== [[FlightToFreedom|Flight to Freedom]] ====

''Flight to Freedom chronicles the story of the drake hero Malakar, and his desperate cross-country flight out of slavery.''

'''Authors:''' MadMax, Nova

'''Maintainer:''' egallager

'''Status:''' Complete

'''Length:''' 20 playable scenarios + 1 dialogue-only, for a total of 21

'''Version:''' [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.4.2 5.4.2] (for BfW 1.16), or [https://github.com/cooljeanius/Flight_Freedom/releases/tag/5.5.0 5.5.0] (for BfW 1.17)

'''Difficulty:''' Expert

'''Style:''' Skirmish, Large Battle, Puzzle

'''Faction/Era:''' Drakes

'''Required Wesnoth version:''' 1.16+ or 1.17+

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=1887 Development], [//forums.wesnoth.org/viewtopic.php?t=40195 Feedback]

'''GitHub:''' [//github.com/cooljeanius/Flight_Freedom github.com/cooljeanius/Flight_Freedom]

==== Inky's Quest ====

''The Cuttlefish Campaign''

''Are the cuttlefish mere beasts or something more? What stories would they tell if they could speak? This story provides one possible answer. The easiest difficulty provides hints for novice players.''

'''Author:''' Telchin

'''Status:''' Complete

'''Length:''' 12 scenarios + story-only epilogue, for a total of 13

'''Version:''' 1.5.6

'''Difficulty:''' Easy

'''Style:''' Skirmish

'''Faction/Era:''' Custom units (cuttlefish, tentacles, giant clams...). Enemies use both default era units and custom ones.

'''[//units.wesnoth.org/1.14/Inky_Quest/en_US/Inky_Quest.html Custom Units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=32501]

==== Invasion from the Unknown ====

''Episode I - Seeking the Light: Long after the Fall, the last forest elves are forced to abandon their safe valley, and find themselves resorting to the dark means of necromancy in order to survive the perils and challenges of this new harsh world. May they finally free the Great Continent from its chaos, or perish in the foolish attempt of restoring peace and life to the lands.''

''Episode II - Armageddon: As the shadow of Chaos covers the entire continent, an assorted group of foolish heroes prepares a counter-attack to the Empire, with one unique goal in their minds: defeat the evil Emperor, whoever it is. Lead these courageous living and non-living warriors to victory, and rediscover lost secrets of the history.''

'''Author:''' shadowm/ShikadiQueen/Iris

'''Status:''' Finished, 2.1.9

'''Difficulty:''' Normal

'''Style:''' Skirmish, Dungeon, Boss battle

'''Faction/Era:''' Unique. You play Elves and Undead throughout the campaign.

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=43309]

'''GitHub:''' [//github.com/project-ethea/Invasion_from_the_Unknown]

'''Walkthrough:''' [[IftU Walkthrough]]

''[[Guide_to_UMC_Campaigns/Players_Reviews#Invasion_from_the_Unknown|Players’ Review(s)]]'''

==== Leader of the Drakes ====

''Leader of the drakes is killed. His son tries to defend homeland against the orcs. He choosed to ally with saurians, but other clans of drakes disagrees. Will fast and unexperienced Morin win against orcs and rebel drakes alike?''

'''Author:''' Elven

'''Status:''' Complete, 1.02b

'''Length:''' 3 scenarios

'''Difficulty:''' Easy/Medium

'''Style:''' Skirmish, Minigames

'''Faction/Era:''' Default, Drakes

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=53951&start=15]

'''Note:''' Short, easy campaign with simple objectives. Features Drake Glider as leader and modified Drake Burner with cold and slowing blade.

==== Legend of the Invincibles ====

'''''Part I: Shrouded in Darkness''' (5 chapters, 90 scenarios) - A pair of heroes, after stopping an orcish threat, are outcast into caves, where they have no other choice than to become liches in order to survive. They preserved their original appearance and moral principles, and fight in various skirmishes against evil (although using evil methods sometimes), until the Fall, when they are buried alive under the ashes of the third sun.''

'''''Part II: Into the Light''' (5 chapters, 110 scenarios) - Long after the Fall, the lich heroes awaken. Searching for more power, they manage to resurrect themselves as living beings, but this time more powerful and ridden of the evil within. But the evil from inside them did not cease to exist, and started a campaign to conquer the world. Stopping the campaign caused an even worse disaster...''

'''Author:''' Dugi

'''Status:''' Complete

'''Length:''' 200 (+8 talk-only) scenarios

'''Difficulty:''' Normal

'''Style:''' mostly Skirmish and Dungeon (all other styles are present as well, but less frequently)

'''Faction/Era:''' Elves, Loyalists, Undead, Dwarves; but they advance past their usual maximum level

'''Forum:''' [//r.wesnoth.org/t32384]

'''GitHub:''' [//github.com/Dugy/Legend_of_the_Invincibles]

'''[[Guide_to_UMC_Campaigns/Players_Reviews#Legends_of_the_Invincibles|Players’ Review(s)]]'''

'''Note:''' The most unique feature of this campaign is its RPG-like unit development system, enemies drop items units can use, leaders are stronger than most usual units and all units get AMLA (after maximum level advancement) after reaching their maximum level (that is also increased by a load of additional level 4 units).

==== A New Order ====

''The old kingdom of Wesnoth has fallen before barbarian hordes. The occupying barbarians are on the brink of civil war, the seeds of Wesnothian rebellion are kept alive by old legends, while bandits and Dunefolk mercenaries roam the land. Can Gawen Hagarthen unite these disparate factions against a common foe?''

''Note: This campaign contains mature themes, some of which may be unsuitable for children.''

'''Author:''' szopen

'''Maintainers:''' nemaara (Yumi), egallager

'''Status:''' Finished

'''Version:''' [https://github.com/nemaara/A_New_Order/releases/tag/1.6.0 1.6.0]

'''Length:''' Hard to say as it is non-linear; it is advertised as having 45 scenarios, but the numbering only goes up to 30 due to some of the scenarios being alternates to one another.

'''Requirements:''' Requires BfW 1.16+. Also uses the "Akladian Music" add-on.

'''Difficulty:''' Advertised as intermediate; could be considered hard, though.

'''Style:''' Mostly Skirmish, some Large Battle

'''Faction/Era:''' mostly various human factions (including the Dunefolk), with the addition of the Akladian faction of humans

'''[//units.wesnoth.org/1.16/A_New_Order/en_US/A_New_Order.html Custom Units]'''

'''Forum threads:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=6486&sid=2e644284f54e65736b4f1543b7098ef9 Development], [//forums.wesnoth.org/viewtopic.php?t=36183 Feedback], [//forums.wesnoth.org/viewtopic.php?t=6174 Original (older) art thread], [//forums.wesnoth.org/viewtopic.php?t=36074 Current art thread]

'''GitHub:''' [//github.com/nemaara/A_New_Order github.com/nemaara/A_New_Order]

'''Note:''' (Pyrophorus) Certainly one of the most mature and well designed campaign in add-ons. A must.

''' [[Guide_to_UMC_Campaigns/Players_Reviews#A_New_Order|Players’ Review(s)]]'''

==== The North Wind ====

''Wesnoth's army was occupied fighting Mal Ravanal in the East, but there were whisperings of an orcish attack in the north. Konrad II must send Deoran, now an experienced rider and commander, with a small band of knights to hold off the orcs....''

''This campaign features unique gameplay characteristics such as a lack of recruiting and a 24-turn time-of-day cycle.''

'''Author:''' aelius, Deusite; pyndragon

'''Status:''' WIP, 0.3.0

'''Length:''' 1 playable scenario, 6 intended

'''Difficulty:''' Normal

'''Style:''' RPG, Skirmish, Survival

'''Faction/Era:''' Loyalists

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=42854]

==== The Ravagers====

'''Description:''' ''The Ravagers'' is a tale of pure revenge. A tale of justice served cold, told in a flashback-style point-of-view narrative, by a ranger in the Inn at Weldyn.
The campaign includes many new exciting gameplay features, fun mechanics such as drinking, hundreds of custom units, and many more.

'''Author:''' WhiteWolf

'''Status:''' Finished*

'''Length:''' 25 playable scenarios + 2 scene scenarios

'''Requirements:''' Akladian Music Pack, Underness Music Pack

'''Difficulty:''' Intermediate

'''Style:''' Skirmish + RPG / Flashback narrative

'''Faction/Era:''' Humans, Elves, Ravagers(dark humans)

'''[//units.wesnoth.org/1.14/The_Ravagers/en_US/The_Ravagers.html Custom Units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=44930]

'''*Notes:''' The main storyline is complete, but there are unfinished side-missions that are still in development. The campaign is aimed to become finished with version 1.2.0.

==== Return from the Abyss ====

''After taking part to a disastrous expedition, Khafir and his men are lost and isolated from their people, thousands of miles away from home, bound by a pact sealed with a powerful dwarvish king. Help him escape from the depth of Irdya and finding his way back, in an adventure across two worlds during the rise of a sinister force in the Great Continent.''

'''Author:''' skeptical_troll

'''Status:''' finished

'''Length:''' 19 playable scenario + 10 story only

'''Difficulty:''' Hard

'''Style:''' Skirmish, Dungeon

'''Faction/Era:''' Dunefolk/Default

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=44545]

==== Rise of the Dunefolk ====

''Adventure of Siabbin and Helare from small village in desert, who step by step made the foundation of the Dunefolk nation. Play a stunning adventure against many enemies in different maps - from sandstorm to swampy areas and caves. Defeat powerful lich lord and train one of the best dark mages in the world of Wesnoth.''

'''Author:''' Elven

'''Status:''' Completed

'''Length:''' 11 scenarios

'''Difficulty:''' Medium

'''Style:''' Skirmish, Minigames, Survival

'''Faction/Era:''' Default, Dunefolk and dark mage

'''Note:''' enjoable gameplay with every map different. Enough experience to upgrade your units.

==== The Return of the Darks ====

''The Darks are a race which left Wesnoth in the ancient times and lives on Isles in the sky. But now the Magic wich helped them to move the Isles in Sky got lost and the isles are about to fall down. Rumion an adventurer goes to Wesnoth and searchs for something that could help them.''

'''Author:''' thvk

'''Status:''' WIP

'''Length:''' 4 playable scenario + 2 story only

'''Difficulty:''' Easy

'''Style:''' Skirmish

'''Faction/Era:''' Default + some self made units

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=52731]

==== Secrets of the Ancients ====

''From the Journal of Ardonna of Tarrynth:''

''It's unfair that we humans must die after so few years. Though this is the natural order, we need not embrace it! The lords on the Green Isle knew how to live forever. Pursuit of that knowledge was declared illegal by King Haldric I, but I believe it is worth the risk: If I can rediscover the secrets of the ancients, not only will I cheat death, I will become a hero to the whole continent!''

'''Author:''' beetlenaut

'''Status:''' Mainlined (this is now one of the campaigns that is downloaded with Wesnoth itself)

'''Length:''' 18 playable scenarios + 3 story only

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Undead/Default

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=40545]

'''Walkthrough:''' [[Secrets of the Ancients Walkthrough]]

==== Swamplings ====

''Banished by Yushnak the Ponderer, a tribe of lowly swamp goblins endure in the deadly mire of Pogo Bog. Four centuries before the founding of Wesnoth, this is the story of the goblins' struggle against the intrigues and betrayals of the greater races, and the rise of the first wolf rider.''

'''Author:''' John Rawlins (boru)

'''Status:''' Complete

'''Length:''' 17 scenarios

'''Version:''' 1.2.0i

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction:''' Goblins

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=41254]

'''[[Guide_to_UMC_Campaigns/Players_Reviews#Swamplings|Players’ Review(s)]]'''

==== The Dark Hordes ====

''Lead fugitive dark sorcerer Gwiti Ha’atel to mastery of the undead hordes.''

'''Author:''' Circon

'''Maintainer:''' Various

'''Status:''' Incomplete/WIP

'''Length:''' 15 scenarios done so far

'''Version:''' 0.1.2

'''Difficulty:''' Unbalanced

'''Style:''' Skirmish

'''Faction/Era:''' Default undead

'''[//units.wesnoth.org/1.10/The_Dark_Hordes/en_US/The_Dark_Hordes_1.html Custom Units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=16576&]

==== The Tale of Vaniyera ====

''The expansionist Lavinian Legion, led by the Imperator himself, has invaded the northern forests of the Sidhe, or Wild Elves. It is up to Leithan the Thunderblade and his advisor Vaniyera to push its armies back where they came from...''

'''Author:''' oreb, turin

'''Maintainer:''' UnwiseOwl

'''Status:''' Finished 0.11.0

'''Length:''' 5 scenarios

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Imperial Era, Sidhe.

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=37880]

'''Walkthrough''' There is a video-walkthrough by the campaign maintainer that begins [https://www.youtube.com/watch?v=dGM1bjImvkI&list=PLZorLYWvUD7VIhaXxKwzO8iQANlp_TaF0 here].

'''Note:''' As of August 2014, all previous issues raised about this campaign have been addressed. If you've not played this campaign since 1.4 or 1.10, in this humble maintainers opinion, it's worth another go.

==== To Lands Unknown ====

''This is the story of Mehir, the Summoner, and his journey to lands unknown.''

'''Author:''' inferno8

'''Status:''' Complete

'''Length:''' 20 scenarios, 4 dialogue only

'''Difficulty:''' Intermediate (Era of Magic)

'''Style''': Skirmish, Dungeon

'''Era:''' Era of Magic

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=31799]

'''GitHub:''' [//github.com/inferno8/wesnoth-To_Lands_Unknown]

'''[[Guide_to_UMC_Campaigns/Players_Reviews#To_Lands_Unknown|Players’ Review(s)]]'''

==== A Vision Blinded ====

''Defend the northern forest against what appeared like a routine orcish raid, and unravel the greater conspiracies that lie below its waves.''

'''Author:''' LemonTea

'''Maintainer:''' Adamant14

'''Status:''' Complete, 1.0.14

'''Length:''' 13 playable scenarios + 1 dialogue-only

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default, Elves (+ Trolls, Outlaws)

'''[//units.wesnoth.org/1.10/A_Vision_Blinded/en_US/A_Vision_Blinded.html Custom units]'''

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=8&t=23463]

=== Eras ===

[[Category:Campaigns|*]]
[[Category:Eras|*]]

==== '''Southern nations''' ====

[[How_to_play_Southern_Nations|Everything about southern nations, including how to play series]]

==== '''War of Legends''' ====

'''Description:''' A multiplayer era focused on the Dark Irdya Campaigns. Contains 15 factions.

'''Author:''' Tahsin Jahin Khalid (Lord-Knyghtmare)

'''Maintainer:''' Tahsin Jahin Khalid (Lord-Knyghtmare)

'''Status:''' Complete, new features being added for the 1.15.x version of the add-on

'''Factions:'''

# Aragwaithi
# Windsong
# Human Alliance
# Orcish Union
# Southerners (Desert Elves)
# Outlaws
# Elementals
# Undead
# Drakes
# Dark Legion
# Sylvans
# Minotaurs
# Vampires
# Dunefolk
# Knalgan Alliance

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=19&t=30087 Development and Feedback Thread]

'''GitHub:''' [//github.com/knyghtmare/War_of_Legends]

==== Era of Magic(EoMa) ====

'''Description:''' Aiming at using the whole potential of Battle of Wesnoth's graphic engine, the Era of Magic is considered to have a most amazing special effects and attack animations in the BfW game. There are 8 playable factions with fully animated units and tons of special effects contained in the era, and the stories of them are told in the campaign "To Lands Unknown".

'''Author:''' Inferno8

'''Maintainer:''' Inferno8

'''Status:''' Finished, 3.1

'''Faction Descriptions:'''

Sky Kingdom - powerful magi of all kinds. Their knowledge allows them to cast amazing spells and summon creatures like unstopable Golems or mysterious Mus. Masters of Elements and Gurus are one of the most powerful human beings in the Era.

Al-Kamija - these proud people are good warriors and spell casters of the desert. They use magical circles and scrolls to summon amazing creatures like Jinns or elementals from other dimension called Abyss. These creatures can't be poisoned, which is a great advantage.
(The campaign "To Lands Unknown" is mainly about the story of this faction)

Tharis - fearsome Tharis faction is very dangerous especially at night. Cruel people of Tharis with their black magic and dreadful monsters like Hydra can demolish everything standing on their way. Being so powerful in attack, Tharis have no healer, so they need to push forward at all costs.

Kharos - this strange name is the name of a beautiful country ruled by prophets of light. These peaceful people are masters of defense and support. Their formations of healers and Shielders assisted by Silver Warriors, who can teleport between friendly villages, are very hard to destroy.

Barbarians - the best in hand-to-hand combat. This multi-cultural society divided into Goblins, Orcs, Cyclops and Trolls with their own advantages and disadvantages can be hard opponent, but separately they are very weak.

Runemasters - these Dwarves use runic magic and equipment and are well known of their protection against magic. The Runemasters create steam machines like Gyrocopters, Robots and even mighty Mechanical Dragons. Units from this faction are very resistant but slow.

Dark Blood Alliance - this faction is composed of agile lizards, giant frogs, wyverns swallowing enemies and salamanders, which have developed to perfection the art of disguise. At the head of the community stand shamans known for their water magic, which is used in the fight as well as in healing.

Destroyers - a terrifying undead creations consisting of civilizations long gone...

'''Version:''' 1.1.1 (February 18th, 2015)

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=19&t=20039 Development and Feedback Thread]

'''GitHub:''' [//github.com/inferno8/wesnoth-Era_of_Magic]

==== Ageless Era ====

'''Description:''' Ageless Era is a compilation of the most popular eras and factions on the add-on server. It is more an era pack than an era.

'''Author:''' mnewton1, Ravana and various

'''Maintainer:''' Ravana

'''Status:''' Finished, 4.19

'''Unit Tree:''' [//units.wesnoth.org/1.12/Ageless_Era/en_US/Ageless%20Era.html Ageless Unit Tree (for 1.12)]

'''Factions List:''' Currently there are 91 factions in the era:

Default: Loyalist, Rebels, Northerners, Undead, Knalgan Alliance, Drakes, Khalifate

Extended Era: Loyalist, Sylvans, Dwarves, Outlaws, Northerners, Undead, Chaos, Dark Elves

Archaic Era: Khthon, Phantoms, Despair, Primeval, South-Seas, Ukians, Northern Orcs

Era of Four Moons: Highlanders, Imperialists, Sea States, Darklanders, Dalefolk, Freemen, Pygmies, Whites

Era of the Future: Welkin, Brungar

BEEM: Anakes, Calidonians, Wood Warriors

Custom Factions: Yokai, Dark Legion, Desert Elves, Steelhive, Frozen

Era of Myths: Celestials, Devlings, Elementals, Therians, Vampires, The Warg, Windsong

Feudal Era: Aragwaithi, Ceresians, Clockwork Dwarves, High Elves, Orcish Khaganates

Imperial Era: Arendians, Cavernei, Issaelfr, Lavinian Legion, Marauders, Orcei Gladiatores, Sidhe

Era of Strife: Eventide, Triththa, Free Saurians, Eltireans, Minotaurs

Era of Magic: Barbarians, Dark Blood Alliance, Sky Kingdom, Kharos, Runemasters, Al-Kamija, Tharis, Destroyers

Mercenaries Era: Highlanders, Enchanters, Avians, Slavers, Mercenaries, Equestrians, Emperor's Guard, Oracles, Holy Order, The Cult, Fanatics, Tribalists, Hive, Infernai, Refugees, Blight

'''Git:''' [https://github.com/ProditorMagnus/Ageless-for-1-11 Ageless-for-1-11] and also for 1.12 and [https://github.com/ProditorMagnus/Ageless-for-1-14 1.14]

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?f=19&t=25274 Development and Feedback Thread]

==== Imperial Era (IE) ====

'''Description:''' One of the oldest maintained user eras, the Imperial Era brings together seven different factions in a completely re-imagined setting, the world of Orbivm, a very lethal world indeed. The era contains both mainline and development versions of each faction and can be used to play five campaigns, each featuring a different race.

'''Author:''' Orbivm Project (but really Turin)

'''Maintainer:''' UnwiseOwl

'''Status:''' Complete, 0.23

'''Faction Descriptions:'''

# Lavinian Legion - Based on the Roman Legion, the Lavinians have strong, versatile melee units in the legionaries and a range of support classes sourced from amongst the Lavinian population and various subjugated races. The legion are strong in the plains but weak when fighting in forested areas. The Lavinians are featured in "Fall of Silvium".
# Sidhe - The Sidhe are a group of forest-dwelling elves whose focus is stealth and fleet movement. Their mages are able to channel the lightning itself, and their various other units move almost as fast. The Sidhe feature in "Tale of Vaniyera".
# Marauders - Based on the Germanic peoples that eventually conquered Rome (hint, hint), the Marauders are equally as at home in the hills, forests and swamps of their homeland. Their hard-hitting melee units are practicalyl unstoppable during the night-time. The Marauders are the stars of the "Alfhelm the Wise" campaign.
# Orcei Gentorum - The orcs have been captured gladiators slaving away in the Lavinian arenas for generations.The life of an orc in Orbivm is harsh and brutal, just like the orcs themselves. The tale of the uprising of one such group of Orcs is told in "Up from Slavery".
# Cavernei - The Cavernei are a dwarvish race with similarities to the mainline Knalgans, but with a greater emphasis on the military uses of runesmithing. They get a campaign too, in "Gali's Contract"
# Issaelfr - The frost elves live on the fringes of the habitable lands of Evrosia, the main continent of Orbivm, and have become inured to difficult conditions and tuned in to their Fae natures. They don't have a campaign yet, but you could always write one.
# Arendians - The Arendians are horse-lords living on the Western steppes of Evrosia. A life of constant battle has developed a military-focused society where warriors are trained from a young age. They used to have a campaign, but it fell into disrepair a very long time ago.

'''Wiki:''' [[Orbivm]]

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?t=37920 Development and Feedback Thread]

==== Lonely Era (LE) ====

'''Description:''' The Lonely Era is a new collection of six selected superior solitary sides with interesting and unusual abilities, traits and attributes.

It has been extensively revised and rebalanced over the last few years from the original era and the constituent factions.

'''Author:''' Atreides. Based on work by Shield, Desert_Shyde, Brilliand, Stern, Cloud, Grigistian, mikoc5, Stopsignal, The_Gnat, Minnakht.

'''Maintainer:''' Atreides

'''Status 1.16:''' Finished

'''Faction Descriptions:'''

1) Santa's Helpers are his Elves as well as animated pine trees. They are an updated faction based on the Merry Christmas Campaign. Beware of Elves bearing gifts though, the presents are very distracting. They are unique in not having standard levels, they each can gain up to 4 special abilities via AMLA but always remain at level 1. Of course there are also Flying Reindeer and Christmas Seals.

2) Gremlins are an all teleporting race of elusive ethereal creatures. Individually fragile they work together using their tremendous mobility to swarm and overwhelm their enemies. Their mages are perhaps the ultimate glass cannons but if you can somehow keep one alive long enough it might even get to level 5 and become immortal.

3) Vaeringjar are a Viking faction allied with Wolfkin. The vikings eschew ranged weapons as well as sissy ideas like dodging blows but are a very, very hardy lot. They also have a unique herbalist unit that can inspire berserker rage in adjacent vikings for a turn. The wolfkin are lithe and armed with bows and teeth on the other hand. They are also very agile in contrast to the vikings. As nocturnal hunters they are devastating at night and almost helpless in the day.

4) Avians are cold loving, water hating bipedal birds. Their hollow bones and feathers make them vulnerable to fire and blunt weapons. They are unique in having cheap level 0 healers. Unusually their leaders are not drawn from the ranks but form a separate class only selectable as leaders. Tamed Albatrosses to patrol the awful waters.

5) The Deep Ones - Slimy, slippery, blasphemous fish-frogs of the nameless design - living and horrible - have now been sighted on the edge of Wesnoth. Mutants who slowly evolve from human to monster these creatures are nothing to be trifled with! An all water faction they are quite capable of holding their own against the landlubbers.

6) Jephrifs live far up in the sky, miles above land. Away from even the most basic things most other races take for granted, such as solid ground, their society developed to be quite alien indeed. In recent times, jephrifs began descending from the skies to participate in combat against other races - apparently for their own amusement, seeing life as a game.

'''Forum:''' [//forums.wesnoth.org/viewtopic.php?t=42630 Development and Feedback Thread]

== Additional info ==
See also:
* [[Player_UMC_Reviews|Player UMC Reviews]]
* [[:Category:User-made Campaigns - Walkthroughs|Walkthroughs for user-made campaigns]]
* [//r.wesnoth.org/t37476 forum thread] for this page
* [[Guide_to_UMC_Content/1.12|Guide to user-made content (UMC) for Battle for Wesnoth 1.12]]
* [[Guide_to_UMC_Content/1.10|Guide to user-made content (UMC) for Battle for Wesnoth 1.10]]
* [//r.wesnoth.org/t36733 thread discussing 1.8 UMC that wasn't ported to 1.10]
* [//r.wesnoth.org/t48086 thread discussing all UMC that hasn't been ported to 1.14]
* [//addons.wesnoth.org the addon server]

ReferenceWML

2024-01-16T18:26:59Z

Egallager: /* Other WML tags */ be a bit more explicit about which tags go with which pages

{{WML Tags}}
== The Wesnoth Markup Language ==

The Wesnoth Markup Language (WML) is used to code almost everything in Wesnoth, including scenarios, units, savefiles, and the user interface layout. WML files are simple, human-readable text files, usually with the .cfg extension, with similarities to INI files and XML. A major feature in WML are macros, which are alike those found in the C language and similarily are handled by a preprocessor. Implementation-wise, WML files are handled mainly by the ''config'' class (and ''simple_wml'' in [[wesnothd]]).

This page is a collection of pointers to different common WML structures.

See [[BuildingScenarios]], [[BuildingCampaigns]] and [[BuildingUnits]]
for a tutorial style overview.

''Note: this reference may contain slight inaccuracies, might not list all existing keys and tags or might contain some deprecated syntax. If you find that this reference doesn't give you the answer to how to implement some feature in WML, the most reliable way is to look at the WML code of existing units and campaigns that have done so.''

== How WML works ==

* [[SyntaxWML]] Description of WML syntax, and how to use variables
* [[PreprocessorRef]] the WML preprocessor syntax
* [[GrammarWML]] A more formal definition of the WML syntax. More useful for implementing a WML parser than for writing WML documents.

== WML toplevel tags ==

The following covers most of the possible toplevel tags in a typical main WML file. Some minor and dev-oriented tags (not intended for use by UMC) are omitted.

* [[GameConfigWML]] the top level '''[game_config]''' tag
* [[UnitsWML]] the top level '''[units]''' tag
** [[AbilitiesWML]] a list of the different abilities a unit or weapon can have
** [[UnitTypeWML]] how to describe a unit type
** [[AnimationWML]] how to animate units
* [[CoreWML]] the top level '''[core]''' tag
* [[AddonsWML]] the entry point for an add-on module
** [[CampaignWML]] the top level '''[campaign]''' tag
*** [[CreditsWML]] how to describe the credits (the '''[about]''' tag)
** [[ScenarioWML]] the top level tags '''[scenario]''', '''[multiplayer]''', and '''[test]'''
*** [[EventWML]] how to describe an event (the '''[event]''' tag)
*** [[SideWML]] how to describe a side (the '''[side]''' tag)
*** [[MapGeneratorWML]] the random map generator
*** [[TimeWML]] how to describe a day
*** [[IntroWML]] how to describe the intro screen (the '''[story]''' and '''[part]''' tags)
** [[EraWML]] the top level '''[era]''' tag
** [[ModificationWML]] the top level '''[modification]''' and '''[resource]''' tags
* [[TerrainWML]] the top level '''[terrain_type]''' tag
* [[TerrainGraphicsWML]], the top level '''[terrain_graphics]''' tag
* [[ThemeWML]] the top level '''[theme]''' tag
* [[LanguageWML]] the top level '''[language]''' tag
* [[LocaleWML]] the top level '''[locale]''' tag
* [[HelpWML]] the top level '''[help]''' tag
* [[BinaryPathWML]] the top level '''[binary_path]''' tag
* [[FontsWML]] the top level '''[fonts]''' tag
* [[GettextForWesnothDevelopers#The_textdomain_tag|Textdomains]] the '''[textdomain]''' tag

Some other files use the WML format, but with different tags.

* [[AchievementsWML]] the [achievement_group] and [achievement] tags.
* [[SavefileWML]] a description of the format of savegames
** [[ReplayWML]] a description of the format of player actions such as moving a unit
** [[StatisticalScenarioWML]] used to generate statistics of a savegame
* [[PblWML]] a description of the format of server-uploadable campaigns
* [[SchemaWML]] a description of WML files that define the structure of other WML files
* [[DiffWML]] used to describe structural differences between preprocessed WML documents
* [[GUIToolkit]] creating dialogs

== Other WML tags ==

* [[EventWML]] how to describe an event
** [[FilterWML]] the construct to filter on [[StandardUnitFilter|units]], [[StandardLocationFilter|locations]], [[StandardSideFilter|sides]], weapons, vision, and WML data.
** [[ActionWML]] to describe the actions which occur when the event is fired
*** [[ConditionalActionsWML]] actions that encapsulate conditional filters and the actions to execute if the conditions are met
*** [[DirectActionsWML]] actions that directly affect gameplay: for example, creating a unit
**** [[SingleUnitWML]] how to describe a unit (for uses such as placing one on the map with the '''[unit]''' tag)
*** [[InternalActionsWML]] actions that WML uses internally: for example, storing a variable
*** [[InterfaceActionsWML]] actions that do not affect gameplay: for example, displaying a message
*** [[LuaWML]] how to code actions with the Lua language (BfW 1.14 and earlier)
*** [[LuaAPI]] how to code actions with the Lua language (BfW 1.16 and later)
* [[AiWML]] how to describe parameters for AI (the '''[ai]''' tag)
* [[EffectWML]] the construct to modify a unit (the '''[effect]''' tag)
* [[DescriptionWML]] the structure of WML coded menus like the difficulty chooser of campaigns
* [[EditorWML]] tags controlling the post-1.4 editor's behavior
* [[MusicListWML]] for playing music (see also [[Available Music]] for a list of what's available)

== Predefined macros ==

Wesnoth ships with a library of predefined macros you should find useful in writing your own WML.
* [https://www.wesnoth.org/macro-reference.html WML Macros] - description of all such macros.

== Other ==

* [[ReferenceWMLSyntax]] how this wiki and the pages it links to should be formatted
* [[ConventionsWML]] how to make your WML more readable
* [[Wml_optimisation]] how to make your WML code more efficient
* [[UsefulWMLFragments]] Various pieces of WML for various purposes. If you have some WML you're proud of that you think others can use, add it here.
* [[Maintenance tools]] for wmlindent, wmllint, wmlscope
* [[CommandMode]] commands are not strictly speaking part of WML, but they are useful for debugging it, and could be a little hard to find, so linking to them here makes sense.
* [[MultiplayerServerWML]] is used when communicating with the multiplayer server.
* [[CampaignServerWML]] is used when managing contributed campaigns on the campaign server.
* [[ImagePathFunctions]] (IPFs) are used when applying the color function to images, such as marking units as belonging to a team or in TerrainGraphics.
* [[Pango formatting]] shows ways to enrich descriptions (pango markup, which can generate basic html tags like <nowiki>, , </nowiki> and others).
* [[Wesnoth_Formula_Language]] (WFL) often used with $() formulas.
* [[PreprocessorRef|Syntax of preprocessor mini-language]] : symbols, macros, file inclusions...

== See Also ==

* [[BuildingMaps]] the text-based format for Wesnoth maps
* [[TerrainCodeTableWML]] a list of all terrains, and [[TerrainCodesWML]], on how to use them
* [[MultiHexTutorial]] a description of the multi-hex tiling system
* [[IGNFileFormat]] a description of the ignore file format
* [[CompatibilityStandards#Deprecation_levels_-_When_to_remove_deprecated_features|DeprecationLevels]]
* Back to [[Create]]

[[Category: WML Reference]]