mirror of
https://git.minetest.land/VoxeLibre/VoxeLibre.git
synced 2024-08-23 02:17:25 +02:00
1.0 KiB
1.0 KiB
Screwdriver API
The screwdriver API allows you to control a node's behaviour when a screwdriver is used on it. NOTE: This API is compatible with Minetest Game 5.1.0, but has some extensions.
To use it, add the on_rotate
function to the node definition.
on_rotate(pos, node, user, mode, new_param2)
pos
: Position of the node that the screwdriver is being used onnode
: that nodeuser
: The player who used the screwdrivermode
:screwdriver.ROTATE_FACE
orscrewdriver.ROTATE_AXIS
new_param2
the new value ofparam2
that would have been set ifon_rotate
wasn't there- return value: false to disallow rotation, nil to keep default behaviour, true to allow it but to indicate that changed have already been made (so the screwdriver will wear out)
- use
on_rotate = false
to always disallow rotation - use
on_rotate = screwdriver.rotate_simple
to allow only face rotation - use
on_rotate = screwdriver.rotate_3way
(MineClone 2 extension) for pillar-like nodes that should only have 3 possible orientations)