1 Minetest Texture Pack Reference
2 ===============================
4 Texture packs allow you to replace textures provided by a mod with your own
7 Texture pack directory structure
8 --------------------------------
12 | |-- texture_pack.conf
16 | |-- your_texture_1.png
17 | |-- your_texture_2.png
18 `-- Another Texture Pack
21 This is a directory containing the entire contents of a single texture pack.
22 It can be chosen more or less freely and will also become the name of the
23 texture pack. The name must not be “base”.
25 ### `texture_pack.conf`
26 A key-value config file with the following keys:
28 * `title` - human readable title
29 * `description` - short description, shown in the content tab
32 **Deprecated**, you should use texture_pack.conf instead.
34 A file containing a short description of the texture pack to be shown in the
38 A preview image showing an in-game screenshot of this texture pack; it will be
39 shown in the texture packs tab. It should have an aspect ratio of 3:2 and a
40 minimum size of 300×200 pixels.
42 ### `your_texture_1.png`, `your_texture_2.png`, etc.
43 Any other PNG files will be interpreted as textures. They must have the same
44 names as the textures they are supposed to override. For example, to override
45 the apple texture of Minetest Game, add a PNG file named `default_apple.png`.
47 The custom textures do not necceessarily require the same size as their
48 originals, but this might be required for a few particular textures. When
49 unsure, just test your texture pack in-game.
54 See lua_api.txt for texture modifiers
59 These texture names are hardcoded into the engine but can also be overwritten
60 by texture packs. All existing fallback textures can be found in the directory
65 * `bubble.png`: the bubble texture when the player is drowning
67 * `crack_anylength.png`: node overlay texture when digging
70 * the crosshair texture in the center of the screen. The settings
71 `crosshair_color` and `crosshair_alpha` are used to create a cross
72 when no texture was found
74 * `halo.png`: used for the node highlighting mesh
76 * `heart.png`: used to display the health points of the player
78 * `minimap_mask_round.png`: round minimap mask, white gets replaced by the map
79 * `minimap_mask_square.png`: mask used for the square minimap
80 * `minimap_overlay_round.png`: overlay texture for the round minimap
81 * `minimap_overlay_square.png`: overlay texture for the square minimap
82 * `object_marker_red.png`: texture for players on the minimap
83 * `player_marker.png`: texture for the own player on the square minimap
85 * `player.png`: front texture of the 2D upright sprite player
86 * `player_back.png`: back texture of the 2D upright sprite player
88 * `progress_bar.png`: foreground texture of the loading screen's progress bar
89 * `progress_bar_bg.png`: background texture of the loading screen's progress bar
91 * `moon.png`: texture of the moon. Default texture is generated by Minetest
92 * `moon_tonemap.png`: tonemap to be used when `moon.png` was found
93 * `sun.png`: texture of the sun. Default texture is generated by Minetest
94 * `sun_tonemap.png`: tonemap to be used when `sun.png` was found
95 * `sunrisebg.png`: shown sky texture when the sun rises
97 * `smoke_puff.png`: texture used when an object died by punching
99 * `unknown_item.png`: shown texture when an item definition was not found
100 * `unknown_node.png`: shown texture when a node definition was not found
101 * `unknown_object.png`: shown texture when an entity definition was not found
103 * `wieldhand.png`: texture of the wieldhand
105 ### Mainmenu textures
107 * `menu_bg.png`: used as mainmenu background when the clouds are disabled
108 * `menu_header.png`: header texture when no texture pack is selected
110 * `no_screenshot.png`
111 * texture when no screenshot was found for a texture pack or mod
113 * `server_flags_creative.png`: icon for creative servers
114 * `server_flags_damage.png`: icon for enabled damage on servers
115 * `server_flags_favorite.png`: icon for your favorite servers
116 * `server_flags_pvp.png`: icon for enabled PvP on servers
133 * `inventory_btn.png`
134 * `rangeview_btn.png`
138 * `rare_controls.png`
143 You can override the textures of a node from a texture pack using
144 texture overrides. To do this, create a file in a texture pack
147 Each line in an override.txt file is a rule. It consists of
149 nodename face-selector texture
153 default:dirt_with_grass sides default_stone.png
155 You can use ^ operators as usual:
157 default:dirt_with_grass sides default_stone.png^[brighten
159 Here are face selectors you can choose from:
161 | face-selector | behavior |
162 |---------------|---------------------------------------------------|
169 | sides | x-, x+, z-, z+ |
170 | all | All faces. You can also use '*' instead of 'all'. |