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 * `progress_bar.png`: foreground texture of the loading screen's progress bar
80 * `progress_bar_bg.png`: background texture of the loading screen's progress bar
82 * `moon.png`: texture of the moon. Default texture is generated by Minetest
83 * `moon_tonemap.png`: tonemap to be used when `moon.png` was found
84 * `sun.png`: texture of the sun. Default texture is generated by Minetest
85 * `sun_tonemap.png`: tonemap to be used when `sun.png` was found
86 * `sunrisebg.png`: shown sky texture when the sun rises
88 * `smoke_puff.png`: texture used when an object died by punching
90 * `unknown_item.png`: shown texture when an item definition was not found
91 * `unknown_node.png`: shown texture when a node definition was not found
92 * `unknown_object.png`: shown texture when an entity definition was not found
94 * `wieldhand.png`: texture of the wieldhand
98 * `menu_bg.png`: used as mainmenu background when the clouds are disabled
99 * `menu_header.png`: header texture when no texture pack is selected
101 * `no_screenshot.png`
102 * texture when no screenshot was found for a texture pack or mod
104 * `server_flags_creative.png`: icon for creative servers
105 * `server_flags_damage.png`: icon for enabled damage on servers
106 * `server_flags_favorite.png`: icon for your favorite servers
107 * `server_flags_pvp.png`: icon for enabled PvP on servers
124 * `inventory_btn.png`
125 * `rangeview_btn.png`
129 * `rare_controls.png`
134 You can override the textures of a node from a texture pack using
135 texture overrides. To do this, create a file in a texture pack
138 Each line in an override.txt file is a rule. It consists of
140 nodename face-selector texture
144 default:dirt_with_grass sides default_stone.png
146 You can use ^ operators as usual:
148 default:dirt_with_grass sides default_stone.png^[brighten
150 Here are face selectors you can choose from:
152 | face-selector | behavior |
153 |---------------|---------------------------------------------------|
160 | sides | x-, x+, z-, z+ |
161 | all | All faces. You can also use '*' instead of 'all'. |