Add-on Configuration Proposal (umcd)

################################################################################
#
# _main.cfg
#

# Some .pbl WML attributes have been moved to .addon in this file.
# The game rejects loading add-ons without this node.

[textdomain]
	# Standard old .textdomain definition here.
[/textdomain]

# .addon below contains translatable strings which come from the add-on's
# textdomain.

#textdomain wesnoth-After_the_Storm

# FIXME: maybe #textdomain should be changed to always use the wesnoth- prefix
# without requiring the author to do so explicitly? Also, some sanity checks
# for WesCamp-i18n usage would be nice. In the same vein, maybe the parser
# should be made to reject empty translatable strings literals.

[addon]
	# Ids may not contain blanks, and must match the directory name.
	id=After_the_Storm
	name= _ "After the Storm"
	description= _ "Test description"
	version="1.0.1"               # Required for dependency checks

	type="campaign"               # Required, may enable specific behavior later.

	image="empty.png~BASE64(...)" # New functor to replace the original surface
	                              # with a PNG loaded from a Base64-encoded
	                              # string.
	                              # The same functor could be used in MP add-ons
	                              # to build eras and scenarios that do not
	                              # require installation for displaying custom
	                              # graphics.
	                              # Base64 data can contain plus signs (+), so
	                              # it always needs to be quoted so it doesn't
	                              # get mangled by the preprocessor.
	                              # The image attribute is optional.

	# .depends[] is used for add-ons that MUST be installed for this add-on
	# to be installed (or loaded, when installed outside of wesnoth) at all.
	[depends]
		id=Project_Y_resources
		version_greater_than_or_equal="0.1.0"
	[/depends]
	# .depends[] items without a specified id are assumed to be the Wesnoth
	# engine version.
	[depends]
		version_greater_than_or_equal="1.11.4"
	[/depends]
	# .conflicts[] defines add-ons that shouldn't be installed at the same
	# time as this one. It's not possible to install this add-on without
	# asking the user to remove the conflicting ones, and this add-on won't
	# be loaded when there are conflicts either.
	[conflicts]
		id=Invasion_from_the_Unknown
		version_less_than="1.100.0"
	[/conflicts]
	# .recommends[] defines add-ons that are not required to be installed
	# for loading or installing this one, but enhance its functionality,
	# and are therefore suggested when selecting it in the add-ons manager.
	[recommends]
		id=Wesnoth_UMC_Music
		version_greater_than_or_equal="1.0"
	[/recommends]
	# .replaces[] is used for add-ons which must be uninstalled before
	# installing this add-on. It could be used when renaming add-ons, for
	# example. (FIXME: not sure if there would be other uses or whether
	# this should be handled by .conflicts[] instead?)
	[replaces]
		id=Not_Really_After_the_Storm
		version=* # default when .version is missing
	[/replaces]
[/addon]

# Add-ons can be enabled or disabled by the user as they deem convenient
# (i.e. eras). Preprocessor symbols of the form ADDON:<addon_id> are defined
# with empty contents for add-ons that are enabled.

#ifdef ADDON:After_the_Storm

# .campaign behaves as usual, perhaps some defaults could be inherited from
# .addon for add-ons that only contain a single campaign (add-ons such as
# IftU, AtS and BMR really contain multiple campaigns).

[campaign]
	# ...
[/campaign]

# .era also behaves as usual

[era]
	# ...
[/era]

# An add-on could theoretically contain both a campaign and an era in the
# same package, but should the user be warned about it by the engine or
# should that be the maintainer's responsibility?

# Usual campaign business:

#ifdef CAMPAIGN_AFTER_THE_STORM

# Or usual MP business:

#ifdef MULTIPLAYER

################################################################################
#
# _server.pbl
#
# Its presence implies the add-on dir is a maintainer copy, thus
# exempting the add-on from upgrade checks and requiring confirmation
# before installing from add-ons server to avoid overwriting local
# changes.
#

username="shadowmaster"     # Forum username or some umcd-specific account username?
password="swordfish"        # Account password, instead of per-add-on passphrases.
# Email addresses are no longer associated to individual add-ons but to the
# account used for uploading instead.
translate="true"            # Maybe separate the add-on from its translations so the
                            # latter can be automatically managed by umcd without
                            # requiring the maintainer to handle updating the.

# Much less information than before, as the rest is required to be in
# _main.cfg permanently for all users.