doc/texture_packs.txt

   1 Minetest Texture Pack Reference
   2 ===============================
   3
   4 Texture packs allow you to replace textures provided by a mod with your own
   5 textures.
   6
   7 Texture pack directory structure
   8 --------------------------------
   9
  10     textures
  11     |-- Texture Pack
  12     |   |-- screenshot.png
  13     |   |-- description.txt
  14     |   |-- override.txt
  15     |   |-- your_texture_1.png
  16     |   |-- your_texture_2.png
  17     `-- Another Texture Pack
  18
  19 ### Texture Pack
  20 This is a directory containing the entire contents of a single texture pack.
  21 It can be chosen more or less freely and will also become the name of the
  22 texture pack. The name must not be “base”.
  23
  24 ### `description.txt`
  25 A file containing a short description of the texture pack to be shown in the
  26 texture packs tab.
  27
  28 ### `screenshot.png`
  29 A preview image showing an in-game screenshot of this texture pack; it will be
  30 shown in the texture packs tab. It should have an aspect ratio of 3:2 and a
  31 minimum size of 300×200 pixels.
  32
  33 ### `your_texture_1.png`, `your_texture_2.png`, etc.
  34 Any other PNG files will be interpreted as textures. They must have the same
  35 names as the textures they are supposed to override. For example, to override
  36 the apple texture of Minetest Game, add a PNG file named `default_apple.png`.
  37
  38 The custom textures do not necceessarily require the same size as their
  39 originals, but this might be required for a few particular textures. When
  40 unsure, just test your texture pack in-game.
  41
  42 Texture modifiers
  43 -----------------
  44
  45 See lua_api.txt for texture modifiers
  46
  47 Texture Overrides
  48 -----------------
  49
  50 You can override the textures of a node from a texture pack using
  51 texture overrides. To do this, create a file in a texture pack
  52 called override.txt
  53
  54 Each line in an override.txt file is a rule. It consists of
  55
  56         nodename face-selector texture
  57
  58 For example,
  59
  60         default:dirt_with_grass sides default_stone.png
  61
  62 You can use ^ operators as usual:
  63
  64         default:dirt_with_grass sides default_stone.png^[brighten
  65
  66 Here are face selectors you can choose from:
  67
  68 | face-selector | behavior                                          |
  69 |---------------|---------------------------------------------------|
  70 | left          | x-                                                |
  71 | right         | x+                                                |
  72 | front         | z-                                                |
  73 | back          | z+                                                |
  74 | top           | y+                                                |
  75 | bottom        | y-                                                |
  76 | sides         | x-, x+, z-, z+                                    |
  77 | all           | All faces. You can also use '*' instead of 'all'. |