PblWML

From The Battle for Wesnoth Wiki
Revision as of 02:45, 13 October 2005 by Bruno (talk | contribs)

.pbl files

To upload a campaign you have made, you need a .pbl file. This is a file with name data/campaigns/campaign-name.pbl. When you upload a campaign, the file data/campaigns/campaign-name.cfg and the directory data/campaigns/campaign-name/ will be published. Your campaign must be based entirely on these files. This may cause your campaign not to upload properly, for example, if you have custom campaign units in data/units/.

The following keys are recognized for .pbl files:

  • icon an image, displayed leftmost on the "download campaigns" screen. It must be a standard Wesnoth graphic and not a custom one. (Note that the icon used to display your campaign for when it is played can be custom; for more information see CampaignWML.)
  • title displayed to the right of the icon, it is just text. It should usually be the same as the name of your campaign when it is played.
  • version displayed to the right of the title, it is also just text. However the prefered format is x.y.z where x, y and z are numbers and x > 0 implies the campaign is complete and balanced.
  • author displayed to the right of the version, it is also text. Put your name or nickname here. If several people have contributed significantly to the campaign you should list all of their names and perhaps describe what each person was responsible for.
  • passphrase not displayed, it prevents others from modifying the version of your campaign on the campaign server. You do not need to input a passphrase when initially publishind a campaign; if you do not, one will be randomly generated for you.
  • description is not displayed in the client. However it is visible on the web interface to the campaign server for downloading campaigns. It can be used to give a brief description of your campaign and for pre 1.0 versions let people know how playable it is.

Example:

title="My Campaign"
icon="misc/ball.png"
verson="0.1.2"
author="Me, artwork by myself"
passphrase="This is like a password"
description="You get to kill a lot of bad guys. But only the first map is done."

The campaign server keeps track of some other information about uploaded campaigns, including when they were uploaded, what languages they have been at least partly translated into, how large they are on the server and the number of times they have been downloaded. For more information about this you can read CampaignServerWML.

See Also