بدون توضیح

Vankata453 6496de2a55 Remove "Toufix's Levels" from latest indexes per creator's request 5 ماه پیش
langpacks 25dbd9f7fe Re-organize addons 2 سال پیش
repository 01cb6075b2 Update "Skitt-land" 1 سال پیش
src @ 4eda00d61f a6d911364d src: move to submodule 8 سال پیش
translations @ d2d9dfcef8 8cd5223c79 Change worldmap titles of Serano's Islands 8 سال پیش
unused 9acd4ac5d5 Move index.nfo used in versions before 0.3.5 to "unused" 2 سال پیش
.gitignore 4d620cf780 Added *~ to .gitignore 9 سال پیش
.gitmodules a6d911364d src: move to submodule 8 سال پیش
README.md cadb2c6e4a Include addon maintenance information in README 2 سال پیش
extract_strings.py 55cb3a4ba1 Update makepot.sh file to search for strings in scripts 9 سال پیش
index-0_3_5.nfo e4e1c3544d Revert "Mattie's World" to an older version for 0.5.x and below 2 سال پیش
index-0_4_0.nfo e4e1c3544d Revert "Mattie's World" to an older version for 0.5.x and below 2 سال پیش
index-0_5.nfo e4e1c3544d Revert "Mattie's World" to an older version for 0.5.x and below 2 سال پیش
index-0_6.nfo 6496de2a55 Remove "Toufix's Levels" from latest indexes per creator's request 5 ماه پیش
index-0_7.nfo 6496de2a55 Remove "Toufix's Levels" from latest indexes per creator's request 5 ماه پیش
make_lang_addon.sh bf07a53e89 Change title of all language add-ons to 2 character code 9 سال پیش
makepot.sh ac5b55604e Replace \r\n with \n in source strings 9 سال پیش
ver_info.nfo 98db15b752 Version info file to indicate new game releases (#43) 2 سال پیش

README.md

SuperTux Addons

Packaging your addon

To package your addon, you can use the "Package Add-on" option in the main level editor menu.

Additional information for addon .nfo files
Addon .nfo files look like this:
(supertux-addoninfo
  (id "octo-levels")
  (version 1)
  (type "worldmap")
  (title "Octo's Levels")
  (author "Octo")
  (license "GPL 2+ / CC-by-sa 3.0")
)

The id is a identifier for this addon, it has to be unique across all addons, as it is used to compare the addons with new ones from other sources to find updates. It is recomment to use something like "{author}-{title}". The id must be all lowercase and only contain characters of the set "[a-z][0-9]-", underscore is not allowed as it is used for the version number.

The version number is a simple integer, it should be increased each time the addon is changed.

The type gives an indication of what is contained within the addon, valid values are "worldmap", "world", "levelset". At the moment this is only a description for the user and doesn't have any impact on how the addon is handled.

The .nfo file itself needs to be stored in the top-level directory of the addon and should be named by the unique id of the addon, i.e. /octo-levels.nfo in this example.

Adding/Updating an addon

To update an addon in the repository, you would need to submit a pull request. The pull request should contain two commits:

  1. Adds/replaces the archive of your addon, contained in the repository/ directory with a new one, which contains your changes.
  2. Edits the index.nfo for the latest SuperTux version, by adding/modifying the entry for your addon. This will allow it to be downloaded from the in-game addon manager.

An addon data entry looks like this:

(supertux-addoninfo
    (id "addon-id")
    (version addon-version)
    (type addon-type)
    (title "addon-title")
    (author "addon-author")
    (license "addon-license")
    (url "https://raw.githubusercontent.com/SuperTux/addons/addon-commit-hash/repository/addon-file-name")
    (md5 "addon-md5-checksum")
)
  • addon-commit-hash represents the full commit hash of your first commit, which adds/replaces your addon in the repository/ directory. This is important to include, because it allows the current SuperTux release to always get its versions of all addons for backwards compatibility.
  • addon-md5-checksum represents your new, modified addon archive's MD5 checksum hash. This needs to be updated every time the addon is updated, because the game will not be able to download your addon otherwise. The MD5 checksum is being used for checking the integrity of the addon.
  • For the rest of the entries, the rules listed above for addon .nfo files also apply here.