celeron55
/
minetest
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Improve doc/lua_api.txt

master
Perttu Ahola 2012-04-07 19:59:03 +03:00
parent dca28b9e12
commit 2eec788544
1 changed files with 30 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

40
doc/lua_api.txt
View File

@ -172,27 +172,47 @@ Examples of sound parameter tables:
loop = true, -- only sounds connected to objects can be looped loop = true, -- only sounds connected to objects can be looped
} }
Representations of simple things Nodes
-------------------------------- ------
MapNode representation: Nodes are the bulk data of the world: cubes and other things that take the
{name="name", param1=num, param2=num} space of a cube. Huge amounts of them are handled efficiently, but they
are quite static.
MapNodes do not directly have any other data associated with them. The definition of a node is stored and can be accessed by name in
If you want to access the definition of the node, you access
minetest.registered_nodes[node.name] minetest.registered_nodes[node.name]
param1 and param2 are 8 bit and 4 bit integers, respectively. They Please note that for unknown nodes (eg. a node of an uninstalled mod) the
are reserved for certain automated functions. If you don't use these minetest.registered_nodes field for the node is nil.
Nodes are passed by value in Lua. They are represented by a table:
{name="name", param1=num, param2=num}
param1 and param2 are 8 bit and 4 bit integers, respectively. The engine
uses them for certain automated functions. If you don't use these
functions, you can use them to store arbitrary values. functions, you can use them to store arbitrary values.
param1 is reserved for the engine when: The functions of param1 and param2 are determined by certain fields in the
paramtype != "none" node definition:
param1 is reserved for the engine when paramtype != "none":
paramtype = "light"
^ The value stores light with and without sun in it's
upper and lower 4 bits.
param2 is reserved for the engine when any of these are used: param2 is reserved for the engine when any of these are used:
liquidtype == "flowing" liquidtype == "flowing"
^ The level and some flags of the liquid is stored in param2
drawtype == "flowingliquid" drawtype == "flowingliquid"
^ The drawn liquid level is read from param2
drawtype == "torchlike" drawtype == "torchlike"
drawtype == "signlike" drawtype == "signlike"
paramtype2 == "wallmounted"
^ The rotation of the node is stored in param2. You can make this value
by using minetest.dir_to_wallmounted().
paramtype2 == "facedir"
^ The rotation of the node is stored in param2. Furnaces and chests are
rotated this way. Can be made by using minetest.dir_to_facedir().
Representations of simple things
--------------------------------
Position/vector: Position/vector:
{x=num, y=num, z=num} {x=num, y=num, z=num}
Currently the API does not provide any helper functions for addition, Currently the API does not provide any helper functions for addition,