mirror of
https://git.minetest.land/MineClone2/MineClone2.git
synced 2024-12-05 17:23:16 +01:00
1.2 KiB
1.2 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
(VoxeLibre extension) for pillar-like nodes that should only have 3 possible orientations)
after_rotate(pos)
(VoxeLibre extension)
Called after the rotation has been completed
pos
: Position of the node that the screwdriver was used on