ThemeFiles: mandatory files
authorWuzzy
Sun, 27 Mar 2016 20:24:09 +0100
changeset 809 dc80e414585a
parent 808 a6c6a92dc83f
child 810 5f0a6fb3a63a
ThemeFiles: mandatory files
ThemeFiles.wiki
--- a/ThemeFiles.wiki	Sun Mar 27 20:03:39 2016 +0100
+++ b/ThemeFiles.wiki	Sun Mar 27 20:24:09 2016 +0100
@@ -3,7 +3,7 @@
 
 = File structure of themes =
 == Introduction ==
-This page explains the meaning of the several files which are used by themes. Please note that not all files are neccessary to create a theme, many files have default fallback versions with identical names in `Data/Graphics` of your Hedgewars installation.
+This page explains the meaning of the several files which are used by themes. Please note that not all files are neccessary to create a theme, many files have default fallback versions with identical names in `Data/Graphics` or `Data/Graphics/SuddenDeath` of your Hedgewars installation.
 
 To create a theme, you need a bunch of graphics and a `theme.cfg` (explained under [Theme]). All graphics mentioned here have to in the PNG format.
 
@@ -11,9 +11,23 @@
 
 Careful! All file names are case-sensitive on case-sensitive platforms! Please ensure you used the correct casing if you want to share your theme online.
 
+== Mandatory files ==
+Only a very few files are mandatory, almost everything has a default image. Of course, using defaults only does not make a good theme, so you should add enough images for your theme until you got a decent theme.
+
+All themes need at least `theme.cfg`.
+
+`icon.png` or `icon@2x.png` are required for the theme to show up in the list of selectable themes in Hedgewars.
+
+For full themes, these additional files are mandatory:
+
+* `LandTex.png`
+* `Border.png`
+
+But those files are not required if you use a theme only as in combination with an [[PresetMaps image map]] or in fort mode, as those modes do not require a land texture.
+
 == Basic files ==
 === `icon.png` and `icon@2x.png` ===
-A preview icon for the theme. It is used in the frontend. The presence of this file also determines wheather the theme is visible in Hedgewars for selection. The theme will only be visible if this file is present. The icon comes in two sizes.
+A preview icon for the theme. It is used in the frontend. This is not mandatory for the theme to work, but the presence of it determines wheather the theme is visible in Hedgewars for selection. The theme will only be visible if the icon is present. The icon comes in two sizes.
 
 ==== `icon.png` ====
 Small version of the icon. It must be of size 33×32 pixels.
@@ -30,19 +44,22 @@
 
 Ideally, you would want to make sure this texture tiles well and is seamless in both axes.
 
+This file is mandatory for full themes but not for themes only to be used as background for maps.
+
 === `LandBackTex.png` ===
-This is similar to `LandTex.png`, but this image is for the terrain background. This texture becomes visible when a piece of landscape has been destroyed.
+This is similar to `LandTex.png`, but this image is for the terrain background. This texture becomes visible when a piece of landscape has been destroyed. By default, no terrain background is used.
 
 === `Border.png` ===
 Border of the landscape. 128×32 pixels in size. This is used to “paint over” the borders of the landscape. This image consists of two parts: the upper half is used for the floor, the lower half for the ceiling.
 
+This file is mandatory for full themes but not for themes only to be used as background for maps.
+
 === `Girder.png` ===
 An optional image for the landscape girders, large horizontal constructions which are added to the landscape when it is enabled in the game scheme.
 This image will be repeated horizontally, so for a better theme quality, make sure this image has no seams horizontally.
 
 If unspecified, `Data/Graphics/Girder.png` is used.
 
-
 === `Chunk.png` ===
 A sprite sheet of 4 images for “chunks”. These images appear and “fall off” when some piece of landscape has been blown away. The image has a size of 64×64 and the images are in a raster of 2×2 images.