From 927adf9bdd2620789d09f29f122fe7cf032226b2 Mon Sep 17 00:00:00 2001 From: rubenwardy Date: Fri, 29 Jul 2016 15:39:36 +0100 Subject: [PATCH] Documentation: Create texture_packs.txt Combine texture_overrides.txt and sections of lua_api.txt --- doc/lua_api.txt | 36 +----------------- doc/texture_overrides.txt | 35 ------------------ doc/texture_packs.txt | 77 +++++++++++++++++++++++++++++++++++++++ 3 files changed, 78 insertions(+), 70 deletions(-) delete mode 100644 doc/texture_overrides.txt create mode 100644 doc/texture_packs.txt diff --git a/doc/lua_api.txt b/doc/lua_api.txt index 5a2f370ef..ce40e082c 100644 --- a/doc/lua_api.txt +++ b/doc/lua_api.txt @@ -235,40 +235,6 @@ stripping out the file extension: * e.g. `foomod_foothing.png` * e.g. `foomod_foothing` -Texture pack directory structure --------------------------------- - - textures - |-- Texture Pack - | |-- screenshot.png - | |-- description.txt - | |-- your_texture_1.png - | |-- your_texture_2.png - `-- Another Texture Pack - -### Texture Pack -This is a directory containing the entire contents of a single texture pack. -It can be chosen more or less freely and will also become the name of the -texture pack. The name must not be “base”. - -### `description.txt` -A file containing a short description of the texture pack to be shown in the -texture packs tab. - -### `screenshot.png` -A preview image showing an in-game screenshot of this texture pack; it will be -shown in the texture packs tab. It should have an aspect ratio of 3:2 and a -minimum size of 300×200 pixels. - -### `your_texture_1.png`, `your_texture_2.png`, etc. -Any other PNG files will be interpreted as textures. They must have the same -names as the textures they are supposed to override. For example, to override -the apple texture of Minetest Game, add a PNG file named `default_apple.png`. - -The custom textures do not necceessarily require the same size as their -originals, but this might be required for a few particular textures. When -unsure, just test your texture pack in-game. - Texture modifiers ----------------- There are various texture modifiers that can be used @@ -1997,7 +1963,7 @@ Call these functions only at load time! * `minetest.register_privilege(name, definition)` * `definition`: `"description text"` * `definition`: `{ description = "description text", give_to_singleplayer = boolean}` - the default of `give_to_singleplayer` is true + the default of `give_to_singleplayer` is true * To allow players with basic_privs to grant, see basic_privs minetest.conf setting. * `minetest.register_authentication_handler(handler)` * See `minetest.builtin_auth_handler` in `builtin.lua` for reference diff --git a/doc/texture_overrides.txt b/doc/texture_overrides.txt deleted file mode 100644 index 1a4e11a3c..000000000 --- a/doc/texture_overrides.txt +++ /dev/null @@ -1,35 +0,0 @@ -Texture Overrides -================= - -You can override the textures of a node from a texture pack using -texture overrides. To do this, create a file in a texture pack -called override.txt - -Basic Format ------------- - -Each line in an override.txt file is a rule. It consists of - - nodename face-selector texture - -For example, - - default:dirt_with_grass sides default_stone.png - -You can use ^ operators as usual: - - default:dirt_with_grass sides default_stone.png^[brighten - -Face Selectors --------------- - -| face-selector | behavior | -|---------------|---------------------------------------------------| -| left | x- | -| right | x+ | -| front | z- | -| back | z+ | -| top | y+ | -| bottom | y- | -| sides | x-, x+, z-, z+ | -| all | All faces. You can also use '*' instead of 'all'. | diff --git a/doc/texture_packs.txt b/doc/texture_packs.txt new file mode 100644 index 000000000..44871ebba --- /dev/null +++ b/doc/texture_packs.txt @@ -0,0 +1,77 @@ +Minetest Texture Pack Reference +=============================== + +Texture packs allow you to replace textures provided by a mod with your own +textures. + +Texture pack directory structure +-------------------------------- + + textures + |-- Texture Pack + | |-- screenshot.png + | |-- description.txt + | |-- override.txt + | |-- your_texture_1.png + | |-- your_texture_2.png + `-- Another Texture Pack + +### Texture Pack +This is a directory containing the entire contents of a single texture pack. +It can be chosen more or less freely and will also become the name of the +texture pack. The name must not be “base”. + +### `description.txt` +A file containing a short description of the texture pack to be shown in the +texture packs tab. + +### `screenshot.png` +A preview image showing an in-game screenshot of this texture pack; it will be +shown in the texture packs tab. It should have an aspect ratio of 3:2 and a +minimum size of 300×200 pixels. + +### `your_texture_1.png`, `your_texture_2.png`, etc. +Any other PNG files will be interpreted as textures. They must have the same +names as the textures they are supposed to override. For example, to override +the apple texture of Minetest Game, add a PNG file named `default_apple.png`. + +The custom textures do not necceessarily require the same size as their +originals, but this might be required for a few particular textures. When +unsure, just test your texture pack in-game. + +Texture modifiers +----------------- + +See lua_api.txt for texture modifiers + +Texture Overrides +----------------- + +You can override the textures of a node from a texture pack using +texture overrides. To do this, create a file in a texture pack +called override.txt + +Each line in an override.txt file is a rule. It consists of + + nodename face-selector texture + +For example, + + default:dirt_with_grass sides default_stone.png + +You can use ^ operators as usual: + + default:dirt_with_grass sides default_stone.png^[brighten + +Here are face selectors you can choose from: + +| face-selector | behavior | +|---------------|---------------------------------------------------| +| left | x- | +| right | x+ | +| front | z- | +| back | z+ | +| top | y+ | +| bottom | y- | +| sides | x-, x+, z-, z+ | +| all | All faces. You can also use '*' instead of 'all'. | -- 2.25.1