Description

Animated Screwdriver 🔗

Rotates nodes like the screwdriver, but the node animates its rotation instead of snapping instantly.

If the screwdriver mod is enabled, your existing screwdriver just gains the animation - no new item or recipe needed. Otherwise this mod adds its own screwdriver with the same recipe as the original (unless configured otherwise by setting)

Not every node type supports the animation yet - full nodes and nodeboxes are fully supported. Unsupported ones still rotate normally, just without the spin.

Compatible with Minetest Game, VoxeLibre, and Mineclonia.

Also provides an API (see below) to use in other rotation mods to animate them.

Commands 🔗

• /animate_rotations on - turn the rotation animation on for yourself (default state)
• /animate_rotations off - turn it off for yourself so rotations become instant again

Settings 🔗

• animated_screwdriver_animation_time - how long the rotation animation takes, in seconds (default 0.4, range 0.2 to 2.0)
• animated_screwdriver_register_tool - whether to register a screwdriver tool when none already exists (default true); turn off if you only want the API for other mods to use

For modders 🔗

See the API documentation in init.lua under: "Public API" for full parameters and ret values.

Other mods can use the API to trigger the animations:

• animated_screwdriver.animate_rotation(pos, new_param2, player) - rotate the node at pos to new_param2, same as the screwdriver itself does.

• animated_screwdriver.animate_swap(pos, new_node, rot_data) - lower level function: swap the node out for a spinning entity, then swap new_node in once it finishes. Lets other mods animate a node change that isn't a screwdriver-style rotation.

License 🔗

See LICENSE file for license information.