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 --------------------------------
15 | |-- your_texture_1.png
16 | |-- your_texture_2.png
17 `-- Another 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”.
25 A file containing a short description of the texture pack to be shown in the
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.
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`.
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.
45 See lua_api.txt for texture modifiers
50 These texture names are hardcoded into the engine but can also be overwritten
51 by texture packs. All existing fallback textures can be found in the directory
56 * `bubble.png`: the bubble texture when the player is drowning
58 * `crack_anylength.png`: node overlay texture when digging
61 * the crosshair texture in the center of the screen. The settings
62 `crosshair_color` and `crosshair_alpha` are used to create a cross
63 when no texture was found
65 * `halo.png`: used for the node highlighting mesh
67 * `heart.png`: used to display the health points of the player
69 * `minimap_mask_round.png`: round minimap mask, white gets replaced by the map
70 * `minimap_mask_square.png`: mask used for the square minimap
71 * `minimap_overlay_round.png`: overlay texture for the round minimap
72 * `minimap_overlay_square.png`: overlay texture for the square minimap
73 * `object_marker_red.png`: texture for players on the minimap
74 * `player_marker.png`: texture for the own player on the square minimap
76 * `player.png`: front texture of the 2D upright sprite player
77 * `player_back.png`: back texture of the 2D upright sprite player
79 * `moon.png`: texture of the moon. Default texture is generated by Minetest
80 * `moon_tonemap.png`: tonemap to be used when `moon.png` was found
81 * `sun.png`: texture of the sun. Default texture is generated by Minetest
82 * `sun_tonemap.png`: tonemap to be used when `sun.png` was found
83 * `sunrisebg.png`: shown sky texture when the sun rises
85 * `smoke_puff.png`: texture used when an object died by punching
87 * `unknown_item.png`: shown texture when an item definition was not found
88 * `unknown_node.png`: shown texture when a node definition was not found
89 * `unknown_object.png`: shown texture when an entity definition was not found
91 * `wieldhand.png`: texture of the wieldhand
95 * `menu_bg.png`: used as mainmenu background when the clouds are disabled
96 * `menu_header.png`: header texture when no texture pack is selected
99 * texture when no screenshot was found for a texture pack or mod
101 * `server_flags_creative.png`: icon for creative servers
102 * `server_flags_damage.png`: icon for enabled damage on servers
103 * `server_flags_favorite.png`: icon for your favorite servers
104 * `server_flags_pvp.png`: icon for enabled PvP on servers
121 * `inventory_btn.png`
122 * `rangeview_btn.png`
126 * `rare_controls.png`
131 You can override the textures of a node from a texture pack using
132 texture overrides. To do this, create a file in a texture pack
135 Each line in an override.txt file is a rule. It consists of
137 nodename face-selector texture
141 default:dirt_with_grass sides default_stone.png
143 You can use ^ operators as usual:
145 default:dirt_with_grass sides default_stone.png^[brighten
147 Here are face selectors you can choose from:
149 | face-selector | behavior |
150 |---------------|---------------------------------------------------|
157 | sides | x-, x+, z-, z+ |
158 | all | All faces. You can also use '*' instead of 'all'. |