ReferenceWML

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.

This page is a collection of pointers to different common WML structures. See AlphabeticalWML for a quick listing of all WML tags. The more comprehensive BuildingScenariosIndex lists tags and keys.

See BuildingScenarios, BuildingCampaigns, BuildingUnits and CreatingNewUnits for a tutorial style overview.

How WML works

• PreprocessorRef the WML preprocessor syntax
  • UtilWML utility macros defined in utils.cfg
• SyntaxWML the language syntax.
  • VariablesWML how to use WML variables

WML toplevel tags

• GameConfigWML the top level [game_config] tag
• UnitsWML the top level [units] tag
  • UnitWML how to describe a unit type
  • AnimationWML how to animate units
• CampaignWML the top level [campaign] tag
• ScenarioWML the top level tags [scenario], [multiplayer], [test], and [tutorial]
  • EventWML how to describe an event
  • SideWML how to describe a side
  • MapGeneratorWML the random map generator
  • TimeWML how to describe a day
  • IntroWML how to describe the intro screen
• 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
• EraWML the top level [era] tag
• TerrainWML the top level [terrain] tag
• TerrainGraphicsWML, the top level [terrain_graphics] tag
• ThemeWML the top level [theme] tag
• LanguageWML the top level [language] tag
• HelpWML the top level [help] tag
• BinaryPathWML the top level [binary_path] tag
• FontsWML the top level [fonts] tag

Other WML tags

• EventWML how to describe an event
  • FilterWML the construct to filter on units, locations, and weapons
  • DirectActionsWML actions that directly affect gameplay: for example creating a unit
  • InternalActionsWML actions that WML uses internally: for example storing a variable
  • InterfaceActionsWML actions that do not affect gameplay: for example displaying a message
• SingleUnitWML how to describe a unit
• AiWML how to describe parameters for AI
• EffectWML the construct to modify a unit
• AbilitiesWML a list of the different abilities a unit or weapon can have
• DescriptionWML the structure of WML coded menus like the difficulty chooser of campaigns

Other

• ReferenceWMLSyntax how this wiki and the pages it links to should be formatted
• ConventionsWML how to make your WML more readable
• 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.
• CommandMode commands are not strictly speaking part of WML, these could be a little hard to find so there's a link here.
• CampaignServerWML is used when managing contributed campaigns on the campaign server.

See Also

• BuildingMaps the text-based format for Wesnoth maps
• TerrainLettersWML a list of all terrains
• MultiHexTutorial a description of the multi-hex tiling system