aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorrubenwardy <rubenwardy@gmail.com>2016-07-29 15:39:36 +0100
committerparamat <mat.gregory@virginmedia.com>2016-07-30 03:08:56 +0100
commit927adf9bdd2620789d09f29f122fe7cf032226b2 (patch)
treee7634edace80de3d5644fa553b983fda67306974
parent573b50ab2c964466c67739406c7eae0dd302b106 (diff)
downloadminetest-927adf9bdd2620789d09f29f122fe7cf032226b2.tar.gz
minetest-927adf9bdd2620789d09f29f122fe7cf032226b2.tar.bz2
minetest-927adf9bdd2620789d09f29f122fe7cf032226b2.zip
Documentation: Create texture_packs.txt
Combine texture_overrides.txt and sections of lua_api.txt
-rw-r--r--doc/lua_api.txt36
-rw-r--r--doc/texture_overrides.txt35
-rw-r--r--doc/texture_packs.txt77
3 files changed, 78 insertions, 70 deletions
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'. |