Difference between revisions of "Distributing content"

From The Battle for Wesnoth Wiki
(The Add-on Server: Suggest MyCampaign.pbl as a filename)
m (See Also: added Guide to UMC Campaigns)
Line 47: Line 47:
* [[IGNFileFormat]]
* [[IGNFileFormat]]
* [[Wesnoth:Copyrights]]
* [[Wesnoth:Copyrights]]
* [http://wiki.wesnoth.org/Guide_to_UMC_Campaigns Guide to UMC Campaigns]

Revision as of 22:23, 1 June 2013

The Forum

The BFW forum is a good way to distribute small creations, like single multiplayer maps. Larger creations, like multiplayer eras or campaigns, should be compressed before uploading them. Note that you may encounter a size limit on attachments.

Also, there is a legal announcement that you should read before distributing anything on the forum. Basically, by posting you say that you own the license to what you are posting, and that you are licensing it under the General Public License.

The Add-on Server

The add-on server is the preferred way to distribute your creations, but it is more suited for larger projects. It currently lacks advanced organization features such as reviewing (although it does have a filter text box), so adding hundreds of little things makes it harder to find anything. Basically, the server should not be used to post single maps, units, songs, or artwork, but map packs, campaigns, entire eras, music packs, and unit packs are fine.

Once you are ready to publish, here is how you access the add-on server:

  1. Open Wesnoth
  2. Select "Add-ons" from the main menu
  3. Connect to the default add-ons.wesnoth.org add-on server
  4. Select "Publish add-on: Your Add-on Name" (the last entry in the list of add-ons)

Anything you distribute on the server will be uploaded from and downloaded to the userdata/data/add-ons directory regardless of what it is (units, maps, campaign, etc). For this reason, you need three things in the add-ons directory to distribute via the server:

  1. A folder, for example MyCampaign
  2. A .cfg file MyCampaign/_main.cfg
  3. A .pbl file MyCampaign.pbl or MyCampaign/_server.pbl

Note that only the contents of your add-on directory (in this case, MyCampaign) will get uploaded, nothing else, so you need to have all the necessary files inside that directory.

The following files and directories will not be uploaded: those that begin with '.' and those that end in '~'. Also, the GNU GPL version 2 will be added in the file COPYING.txt.

General Reading

Content-specific instructions


Whenever you upload or update your content pack, you will have to say "OK" to this statement: "All add-ons uploaded to this server must be licensed under the terms of the GNU General Public License (GPL). By uploading content to this server, you certify that you have the right to place the content under the conditions of the GPL, and choose to do so."

See Also