Groundworks

Players

• Breaking: Next Assembly and Reverse Next Assembly are now Next Choice and Reverse Next Choice, still V and Shift+V, which step the held item's choice; a held Key steps through its Assemblies and the Key alone as before. Their key mapping ids are now key.groundworks.next_choice and key.groundworks.reverse_next_choice, so a player who rebound either must bind it again. (#77)
• Blueprints: copy a box of blocks with a sheet of paper and paste it elsewhere. A sneak-click on a block stores the first Corner, drawn wherever you aim, with the box from it to your aim outlined; a click on a block captures the box, both Corners included, onto one sheet off the stack, which then stands alone in its stack. A sheet holding a Copy draws its paste at the aim, resting on the aimed face in the orientation it was captured in, air skipped, and a click lays it whole or not at all: refused where a position it places is taken, charged in survival as the item you would pick each block with, a block already standing as wanted kept uncharged, and free in creative. Anyone holding the sheet may paste it, in any dimension, again and again. A sneak-use in the air clears a stored Corner or the sheet's Copy. A capture is refused over the server's maxSelection, 32,768 positions by default, or reaching a chunk that isn't loaded. Pack developers choose the sheets through the groundworks:blueprints item tag, shipped with paper. (#78)
• Blueprints can paste air: Next Choice (V, or Shift+V) on a sheet holding a Blueprint switches between skipping its air, the default, and pasting it, and the sheet keeps the choice. Pasting air clears what stands where the Blueprint has air, as you would break it, drawn in amber; its drops, a chest's contents among them, go to your inventory and the rest drops at your feet, and creative hands nothing back. A block there you could not break, such as bedrock, refuses the whole paste. (#82)
• A Copy's paste stands as it was captured: torches, rails, carpets and whatever else hangs or stands on another block are laid after what they need, and a door or a bed is placed whole by its lower half or foot, charged once. A Copy carries no block's contents, so a chest pastes empty and a sign blank; in survival it lays waterlogged blocks dry and skips water, lava and fire and any other block with no item of its own, which creative's paste lays. A block that can't stand where it lands, such as a torch whose wall stayed outside the box, is left out, uncharged and outlined red, and the rest is laid. (#80)
• A Blueprint's capture leaves out what it can't take whole, and says so: a block standing partly outside the Selection, such as a door or bed with one half in it or a Footprint partly inside, is left out whole, and the capture's message gives how many were left out and why, naming one. While a Corner is stored, the blocks the capture would leave out are outlined red in the Selection. Blocks in the groundworks:blueprint_deny block tag are left out silently; it ships with bedrock, piston heads, end portal frames and #minecraft:portals, and pack developers change it through data. (#81)
• A held Blueprint's paste follows Rotate, Raise and Lower: Rotate and Reverse Rotate turn it a quarter at a time from the orientation it was captured in, each block's own facing turned with it, and Raise and Lower move it up and down within your reach. The turn and the height stay on the sheet. A blank sheet isn't turned, so Rotate turns the block under the crosshair, as with any item that isn't rotatable. (#79)
• Undo Paste, on U by default, takes back the latest paste of the Copy on the sheet in your main hand, one per press, up to its last ten pastes. It takes up only the blocks still standing as the paste laid them, leaving any placed or changed since, breaking each as you would, and hands back what they drop, a chest's contents among it, as a Dismantle does, into the inventory first and then at your feet; nothing in creative. What the paste cleared or replaced isn't put back. It is refused, with its reason, in another dimension than the paste's, over a chunk that isn't loaded, or with no paste left to undo; clearing a Copy clears its history, which is kept with the world's saved data. (#84)
• Cut: Next Choice (V, or Shift+V) on a blank sheet switches between capturing a Copy, the default, and a Cut, keeping a stored Corner. A Cut takes its blocks out of the world silently, with no drops and with what they hold, so a chest moves with its contents; what stood outside the box on them falls or breaks as vanilla says, and fluids outside flow in. It leaves out, outlined red and with a message, blocks you could not break, such as unbreakable blocks or blocks a claim guards. A Cut is pasted once, uncharged, with its contents, and the sheet is blank again; a block of it that can't stand where it lands drops at your feet with what it held. A Cut can't be cleared by a sneak-use or undone, and its sheet survives fire and lava and never despawns. (#83)
• A Blueprint's Copy no one has held or pasted for the server's pruneCopiesAfterDays, 30 by default, is pruned from the world data as the server starts and hourly while it runs, and its sheet is blank again once held, saying so. Holding a sheet or pasting it keeps its Copy. A Cut is never pruned. Operators (permission level 2) can recover a Cut whose sheet was lost: /groundworks blueprint lists every Cut not yet pasted with its owner, its size, how long ago it was captured and how long it has gone unused, and /groundworks blueprint give <id>, offered by clicking an id, gives a sheet naming it. Whichever of a Cut's sheets is pasted first takes it, and the other then finds it gone and turns blank, held, pasted or sneak-used. (#85)
• An Assembly, a Stretch, a Fast Replace or a Blueprint's paste that puts a door's upper half or a bed's head where you may not build, such as on ground a claim guards, is now refused, as it is where its other blocks go.

Consumers

• The next_assembly payload is now next_choice: a client and server must both be on this version. (#77)
• Blueprints.sheets states which held stacks are Blueprint sheets, as the vanilla Consumer does for groundworks:blueprints, and Blueprints.denies which blocks a capture leaves out silently, as it does for groundworks:blueprint_deny. The Feature order a click walks asks a sheet's Blueprint first. A world gains Groundworks' first saved data, data/groundworks/blueprints.dat; a client is sent the new blueprint payload while it holds a sheet holding a Blueprint, and sends the new undo_paste payload when Undo Paste is pressed. A capture of a Cut by a player fires NeoForge's BreakBlockEvent for each of its blocks, and leaves out each one whose event is cancelled. (#78, #81, #83, #84)
• PlacementPlan gains leftOut, the positions a plan leaves out each alone while the rest is laid, which the preview outlines red; its former canonical constructor stays, leaving nothing out. (#80)
• A plan laid by a click now fires NeoForge's BlockEvent.EntityPlaceEvent at each of its Companions' positions too, as it does at its blocks', and is refused where one is cancelled.
• Groundworks registers its first command, /groundworks, through NeoForge's RegisterCommandsEvent. (#85)