From The Battle for Wesnoth Wiki
Revision as of 13:07, 15 November 2017 by Amir (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

A number of external utilities not included in the main Battle for Wesnoth release exist to ease the creation of scenarios, campaigns, and Wesnoth graphics. Most, but not all, are Perl scripts. Herein lie brief descriptions of each utility and relevant links. This page was started as a result of this thread.

Some of these are included in the utils/ directory in the official distribution. Some binary packagers have chosen to leave this directory out of their packages, so get the scripts from the forum or the source-code repository.


by Darth Fool

A Perl script which takes a Wesnoth directory, parses the files in data/scenarios/, and produces a web page that you can use to see which scenarios lead to which other scenarios, including links to the scenario files. In addition, inside of [side] tags is listed, as well as the images of units defined or recruitable in all non-human controlled sides. Note that surprises (like in the Ford of Abez) are not displayed.


by Allefant

NOTE: This tool was designed for ver1.2 of Wesnoth. It is currently OUTDATED.

Aspires to be the full-fledged but elusive campaign editor. It will allow a user to generate a campaign without knowing WML, making Wesnoth's extensibility accessible to a wider audience.


by ott

dr is a Perl script which generates damage reports in order to allow one to compare damage and resistance types across the different times of day.


by ott

st is a Perl script which generates savefile statistics summaries.


by ott

tagfind is another Perl script, which finds WML tags used in game files, together with their attributes. Mostly useful for maintaining the Wiki page on AlphabeticalWML.

revmaph and revmapv

by ott

revmaph/revmapv are Perl scripts which flip map files horizontally or vertically, respectively.


by dacyn

rotate is a simple C++ program that will take a map and rotate it 60 degrees clockwise. The extra space is filled with shroud.


by Darth Fool

advance.pl is meant as a tool to allow modifying large numbers of units at once to use after max level advancement options.


by ott

Calculates the probabilities that either unit kills the other in a skirmish. More general than the in-game Damage Calculations, which are based on the method used by an earlier version of this script. Includes full documentation; also available in utils/.


by Dave

Perl modules to parse WML, currently only used by some sample scripts to interact with the campaign server. Most of the scripts listed above would be much shorter and simpler if they were modified to use these modules.


by DDR

A windows executable file to convert 1.3.x+ maps to 1.2.x- maps, for use on the forum with the [map] tag.

Wesnoth Map Symmetrizer

by Segfaulthunter

A tool, written in the Python programming language, to create symmetric maps. Has a Graphical User Interface for easy use.

Wesmap 2.7

by Sid6.7

a cheesy random map maker thats about 99% done, you still need to use campgen or wesnoth editor to customize it to your liking.

written in QBasic 4.5

Unit File Creator

by Niborelf

A PHP-based tool which creates basic .cfg files for units.

Note: The links are not functional now so just ignore this


by mercurius999

A tool to create a working skelatal campaing

Maintenance Tools

See MaintenanceTools for WMLLint, WMLScope and WMLIndent.


by bzame-wif

This utility provides a GUI to create unit files. The user sets the unit properties from the GUI of the utility. Once all the properties have been set, it is possible to export them into a .cfg which will be read by the game.

Currently features are:

  • attack creation;
  • move type creation;
  • unit creation;
  • trait creation;
  • race creation;
  • open/save work;
  • wml export (in a .cfg file);
  • different look and feels;
  • different languages interface.

Further details can be found in the project wiki. Translators instructions and the list of available translations can be found at the following links:

The project is hosted on SourceForge at the following address: http://sourceforge.net/projects/wesworkshop/.

A (minimalist) website can be found at the following address: http://wesworkshop.altervista.org/.

The program history can be read on the following pages:


by amir

This tool converts WML files (scenarios and replays) to XML. See the github page for more details

See Also

This page was last edited on 15 November 2017, at 13:07.