texture_packs.txt 5.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161
  1. Minetest Texture Pack Reference
  2. ===============================
  3. Texture packs allow you to replace textures provided by a mod with your own
  4. textures.
  5. Texture pack directory structure
  6. --------------------------------
  7. textures
  8. |-- Texture Pack
  9. | |-- screenshot.png
  10. | |-- description.txt
  11. | |-- override.txt
  12. | |-- your_texture_1.png
  13. | |-- your_texture_2.png
  14. `-- Another Texture Pack
  15. ### Texture Pack
  16. This is a directory containing the entire contents of a single texture pack.
  17. It can be chosen more or less freely and will also become the name of the
  18. texture pack. The name must not be “base”.
  19. ### `description.txt`
  20. A file containing a short description of the texture pack to be shown in the
  21. texture packs tab.
  22. ### `screenshot.png`
  23. A preview image showing an in-game screenshot of this texture pack; it will be
  24. shown in the texture packs tab. It should have an aspect ratio of 3:2 and a
  25. minimum size of 300×200 pixels.
  26. ### `your_texture_1.png`, `your_texture_2.png`, etc.
  27. Any other PNG files will be interpreted as textures. They must have the same
  28. names as the textures they are supposed to override. For example, to override
  29. the apple texture of Minetest Game, add a PNG file named `default_apple.png`.
  30. The custom textures do not necceessarily require the same size as their
  31. originals, but this might be required for a few particular textures. When
  32. unsure, just test your texture pack in-game.
  33. Texture modifiers
  34. -----------------
  35. See lua_api.txt for texture modifiers
  36. Special textures
  37. ----------------
  38. These texture names are hardcoded into the engine but can also be overwritten
  39. by texture packs. All existing fallback textures can be found in the directory
  40. `textures/base/pack`.
  41. ### Gameplay textures
  42. * `bubble.png`: the bubble texture when the player is drowning
  43. * `crack_anylength.png`: node overlay texture when digging
  44. * `crosshair.png`
  45. * the crosshair texture in the center of the screen. The settings
  46. `crosshair_color` and `crosshair_alpha` are used to create a cross
  47. when no texture was found
  48. * `halo.png`: used for the node highlighting mesh
  49. * `heart.png`: used to display the health points of the player
  50. * `minimap_mask_round.png`: round minimap mask, white gets replaced by the map
  51. * `minimap_mask_square.png`: mask used for the square minimap
  52. * `minimap_overlay_round.png`: overlay texture for the round minimap
  53. * `minimap_overlay_square.png`: overlay texture for the square minimap
  54. * `object_marker_red.png`: texture for players on the minimap
  55. * `player_marker.png`: texture for the own player on the square minimap
  56. * `player.png`: front texture of the 2D upright sprite player
  57. * `player_back.png`: back texture of the 2D upright sprite player
  58. * `progress_bar.png`: foreground texture of the loading screen's progress bar
  59. * `progress_bar_bg.png`: background texture of the loading screen's progress bar
  60. * `moon.png`: texture of the moon. Default texture is generated by Minetest
  61. * `moon_tonemap.png`: tonemap to be used when `moon.png` was found
  62. * `sun.png`: texture of the sun. Default texture is generated by Minetest
  63. * `sun_tonemap.png`: tonemap to be used when `sun.png` was found
  64. * `sunrisebg.png`: shown sky texture when the sun rises
  65. * `smoke_puff.png`: texture used when an object died by punching
  66. * `unknown_item.png`: shown texture when an item definition was not found
  67. * `unknown_node.png`: shown texture when a node definition was not found
  68. * `unknown_object.png`: shown texture when an entity definition was not found
  69. * `wieldhand.png`: texture of the wieldhand
  70. ### Mainmenu textures
  71. * `menu_bg.png`: used as mainmenu background when the clouds are disabled
  72. * `menu_header.png`: header texture when no texture pack is selected
  73. * `no_screenshot.png`
  74. * texture when no screenshot was found for a texture pack or mod
  75. * `server_flags_creative.png`: icon for creative servers
  76. * `server_flags_damage.png`: icon for enabled damage on servers
  77. * `server_flags_favorite.png`: icon for your favorite servers
  78. * `server_flags_pvp.png`: icon for enabled PvP on servers
  79. ### Android textures
  80. * `down_arrow.png`
  81. * `left_arrow.png`
  82. * `right_arrow.png`
  83. * `up_arrow.png`
  84. * `drop_btn.png`
  85. * `fast_btn.png`
  86. * `fly_btn.png`
  87. * `jump_btn.png`
  88. * `noclip_btn.png`
  89. * `camera_btn.png`
  90. * `chat_btn.png`
  91. * `inventory_btn.png`
  92. * `rangeview_btn.png`
  93. * `debug_btn.png`
  94. * `gear_icon.png`
  95. * `rare_controls.png`
  96. Texture Overrides
  97. -----------------
  98. You can override the textures of a node from a texture pack using
  99. texture overrides. To do this, create a file in a texture pack
  100. called override.txt
  101. Each line in an override.txt file is a rule. It consists of
  102. nodename face-selector texture
  103. For example,
  104. default:dirt_with_grass sides default_stone.png
  105. You can use ^ operators as usual:
  106. default:dirt_with_grass sides default_stone.png^[brighten
  107. Here are face selectors you can choose from:
  108. | face-selector | behavior |
  109. |---------------|---------------------------------------------------|
  110. | left | x- |
  111. | right | x+ |
  112. | front | z- |
  113. | back | z+ |
  114. | top | y+ |
  115. | bottom | y- |
  116. | sides | x-, x+, z-, z+ |
  117. | all | All faces. You can also use '*' instead of 'all'. |