Add-Ons

General

Since Widelands version 1.1 the game has an add-on manager where one can provide his own add-on to other players. Add-ons can be accessed, installed and uploaded via the button in the main menu.

Categories

Add-ons are splitted into categories. By default all add-ons are shown in the add-ons manager. They can be filtered by category, quality and by entering a search term.

Category Name Description
Maps Add-ons containing either a single map or a set of maps
Map Generator Add-ons to modify the in game random map generator
Campaigns Add-ons containing a campaign or scenario to play
World Add-ons defining new terrains and/or immovables
Win Conditions Add-ons containing new win conditions
Starting Conditions Add-ons defining new starting conditions
Tribes Add-ons defining new tribes
Scripts Add-ons providing helper scripts for game play
UI-Plugins Add-ons providing scripts together with ui elements like windows and buttons
Theme Add-ons changing the look and feel of widelands, e.g. window borders, fonts and colors

Uploading a new add-on

You'll need a different password

In order to upload a new add-on you have to add a new password, the password for this website is not sufficient. Set a password here.

Maps

If you just want to provide a single map as an add-on you can upload it directly in the map editor by using the menu entry "Publish Map Online" in the main menu. If you have created several maps and want to bundle them to a map-set you'll have to use the add-ons manager, see below.

Upload an add-on in the add-on manager

To upload anything else than a single map you have to use the "Development" tab in the add-on manager. Because add-ons can contain malicious code they have to be reviewed and this can take some time. So don't worry if your new add-on isn't shown up Immediately in the list of add-ons.

Creating add-ons

Please refer to the documentation. For a beginner it might be easy to adjust an already existing add-on to your liking. Installed add-ons can be found in the subfolder "addons" where maps savegames and replays are located.
If you have any questions please ask in the forum ADD-ONS.


Discuss this wiki article

Tagged with: addons, Development