Pick and place tool for minetest

Features

• Select and place areas on the fly
• Configure an area with "handles" to pick and place them quickly
• Rotation around the y-axis

Screenshots

Howto

Quick pick-and-place

Simple copy+paste operation

• Use the green pick_and_place:pick tool to select the area to use
• First click for first position and second click for the second position
• This will convert the pick-tool to a blue pick_and_place:place tool in your inventory
• Use the place-tool to place your build anywhere in the world with the help of the preview-overlay
• The schematic can be rotated around the y-axis with the menu that pops up on right-click

Pro-tip: hold the aux key to switch to removal-mode

Configure a template area

Create a template for frequent reuse

• Use the white pick_and_place:configure tool to select an area for your template
• First click for first position and second click for the second position
• This will create "handle" nodes on every corner of the build
• Right-click one of corners to create a placement-tool for the template
• Place as needed

Replacements

The pick_and_place:replacement node can be used to randomize node placement.

If you pick-and-place a replacement node the default node-placement is replaced with the configured inventory- and group-configuration.

• Inventory: Upon placement a random slot of the replacement inventory is selected and placed instead of the node
• The param2 value is preserved and rotateable
• A "group" can be specified to place the same randomized slot across the whole group and placement

Note: holding the "zoom" button on place disables the replacement engine

Snapping to grid

Grid-snapping can be enabled with /pnp_snap on while holding a place-tool. Disabling it can be done with /pnp_snap off

Modding api

pick_and_place.register_on_place(fn)

register a function callback for after placement

local mynodeid = minetest.get_content_id("my:node")
pick_and_place.register_on_place(function(pos1, pos2, nodeids)
    if nodeids[mynodeid] then
        -- nodeid matches, do something after the schematic has been placed into the world
    end
end)

pick_and_place.register_on_before_place(fn)

register a function callback for after placement

local mynodeid = minetest.get_content_id("my:node")
pick_and_place.register_on_before_place(function(pos1, pos2, nodeids)
    if nodeids[mynodeid] then
        -- nodeid matches, do something before the schematic has been placed into the world
        -- note: nodeids are from the to-be-placed schematic, not the current world-data
    end
end)

pick_and_place.register_on_remove(fn)

register a function callback for after area removal

pick_and_place.register_on_remove(function(pos1, pos2, nodeids)
    -- TODO: cleanup stuff here
end)

pick_and_place.register_on_before_remove(fn)

register a function callback for before area removal

pick_and_place.register_on_before_remove(function(pos1, pos2, nodeids)
    -- TODO: cleanup stuff here (nodes and metadata are still present in-world)
end)

Portability

The placement tool can be shared across worlds if the nodes are available there.

Limitations

The schematic data is stored in the tool and may not scale well beyond a certain size

Licenses

• Code: MIT
• Media: CC-BY-SA 3.0