MathiasDecrock-PlanBuild icon

PlanBuild

PlanBuild enables you to plan, copy and share your building creations in Valheim with ease. Includes terrain tools and immersion items.

Last updated a week ago
Total downloads 61846
Total rating 16 
Categories Server-side Client-side Utility
Dependency string MathiasDecrock-PlanBuild-0.10.6
Dependants 104 other mods depend on this mod

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.1901 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured and includes unstripped Unity DLLs.

Preferred version: 5.4.1901
ValheimModding-Jotunn-2.7.7 icon
ValheimModding-Jotunn

Jötunn (/ˈjɔːtʊn/, 'giant'), the Valheim Library was created with the goal of making the lives of mod developers easier. It enables you to create mods for Valheim using an abstracted API so you can focus on the actual content creation.

Preferred version: 2.7.7
ValheimModding-HookGenPatcher-0.0.3 icon
ValheimModding-HookGenPatcher

Generates MonoMod.RuntimeDetour.HookGen's MMHOOK file during the BepInEx preloader phase.

Preferred version: 0.0.3

README

BIG REVAMP

Version 0.10.0 of PlanBuild comes with a big internal code refactor and many changes to the handling of plans and blueprints. Please make sure to check out the documentation below. The biggest changes in a nutshell:

  • Instead of switching plan and blueprint mode on the rune, you now have two distinct tools, the Plan Hammer and the Blueprint Rune.
  • Lots of improvements to the Selection tools. You can add and remove parts of your buildings to a selection and need to use the Edit Selection tool or the selection.gui console command to save or copy your blueprint.
  • You can copy+paste blueprints directly without having to save them (clipboard).
  • Most actions can be reversed and replayed using the bp.undo and bp.redo console commands.
  • New save dialogue which lets you enter a category and description directly
  • The configuration was redesigned for more clarity. Please revise your configuration once after installing this version.

PlanBuild

PlanBuild enables you to plan, copy and share your building creations in Valheim with ease. The mod adds two new tools to the game. The Plan Hammer is used to plan your creations before actually gathering all the materials. When you are happy with your build, you can add the required building materials one by one or use a custom totem to automatically build the pieces for you. The Blueprint Rune lets you copy, save or delete your creations as a single building piece which can also be shared with other players using the mod and also includes terrain modification tools for quick and more precise terraforming without using the Hoe or Cultivator.

Planning

Plan mode

Introducing a new item, the Plan Hammer, which can be crafted from a single log of wood and the blessing of Odin shining upon you.

PlanHammer

Plan the construction of pieces without the need to gather the resources first. Anyone can add the required resources to the planned structure later and finish the construction after it was placed.

The Plan Hammer is compatible with custom piece tables from other mods. All custom pieces will be incorporated into the runes table for the planned pieces. You still need a Hammer and the required crafting station to finish the construction.

Planned pieces that are unsupported can not be finished. These pieces are also slightly more transparent so you can see what is and isn't supported. The planned pieces themselves do not require support, so you can build forever (if you can reach far enough).

Real pieces also snap to the planned pieces, so you could even use them as spacers or rulers.

Plan Totem

Plan Totem

Build a Plan Totem near your planned structures to be able to add resources in a centralized location for all individual pieces on the plan.

It will also protect existing structures. Any piece that is destroyed (not removed by the Hammer) will be replaced with a plan for that same piece in the same place!

This needs to be built with the vanilla Hammer tool and costs you 1 Wood and 1 Grey Dwarf Eye.

Skuld Crystal

Skuld Crystal

Includes the Skuld Crystal, a wearable item that removes the shader effect from the blueprints, so you can see what the construction will look like when completed.

Create it from a single Grey Dwarf Eye.

Watch your step! The pieces are still not really there, and will not support you!

Blueprinting

Blueprint mode

Introducing a new item, the Blueprint Rune, which can be crafted from a single stone and festering willpower given to you by the gods.

BlueprintRune

Copy existing structures into Blueprints and rebuild them as planned or regular pieces all at once. The blueprints are saved in and loaded from the filesystem as .blueprint files. Also supports .vbuild files (you can load and build your BuildShare saves with this mod)! After switching to the blueprint mode, the piece table of the Blueprint Rune offers three different categories:

Tools

Blueprint tools

The Blueprint Rune comes with a handful of tools to handle blueprint creation and terraforming.

  • Create new Blueprint: Directly create a blueprint from a selection indicated by the circle marker.

    • Hold Ctrl to highlight all pieces which will be saved into the blueprint
    • Use the Scroll Wheel to change the selection radius
    • Use Shift + Scroll to adjust the camera distance.
  • Add to selection: Add pieces to the current selection. Currently selected pieces will be highlighted in green. Per default only the hovered piece will be added to the selection. You can use various modifiers to change that behaviour.

    • Press Q to quickly switch to the "Remove from selection" tool
    • Hold Alt and click to add all connected pieces. This uses a flood fill to find connected pieces.
    • Hold Ctrl and click to add pieces in a radius
    • Use the Scroll Wheel while holding Ctrl to change the selection radius
    • Hold Shift and click once to define a "starting piece" and click again on another piece to select every piece in between those two.
    • Use Shift + Scroll to adjust the camera distance.
  • Remove from selection: Remove pieces from the current selection. Currently selected pieces will be highlighted in green. Per default only the hovered piece will be removed from the selection. You can use various modifiers to change that behaviour.

    • Press Q to quickly switch to the "Add to selection" tool
    • Hold Alt and click to remove all connected pieces. This uses a flood fill to find connected pieces.
    • Hold Ctrl and click to remove pieces in a radius
    • Use the Scroll Wheel while holding Ctrl to change the selection radius
    • Hold Shift and click to clear the current selection
    • Use Shift + Scroll to adjust the camera distance.
  • Edit selection: Left click to open a menu. From here you can choose what to do with your current selection:

    • Copy with custom SnapPoints: Make a temporary blueprint of your current selection. It will copy all pieces in the selection into a new building piece and automatically select that piece for you to build. The copy is also saved into the "Clipboard" category of the rune for you to access until you log out from the current world.
    • Copy with vanilla SnapPoints: Make a temporary blueprint of your current selection which also includes all vanilla snap points of the pieces selected.
    • Save: Save the current selection as a new blueprint into the file system. These blueprints are kapt between game sessions and can also be used in the marketplace and shared with other players.
    • Delete: Delete all pieces in the current selection. This removes all the pieces without refunding the building materials.
    • Cancel: Exit the menu without any action.
  • Snap point marker: Add snap point markers to all points you want to have as snap points in your blueprint. The rotation of the markers does not matter, only the center point. We highly suggest that you also use Snap points made easy so you can cycle through the snap points when placing the blueprint. Note: You have to select the marker piece in order to capture it in the blueprint. Markers placed while having an active selection will automatically be added to that selection.

    • Use Remove to delete a placed marker again (just like you would delete a piece with the hammer).
    • Use Shift + Scroll to adjust the camera distance.
  • Center point marker: Add a center point marker to your blueprint to determine the center of the blueprint. This is where it will be anchored while placing it. If a blueprint does not have a center point marker, a bottom corner of the blueprint is found and used as the center. Note: You have to select the marker piece in order to capture it in the blueprint. Markers placed while having an active selection will automatically be added to that selection.

    • Use Remove to delete a placed marker again (just like you would delete a piece with the hammer).
    • Use Shift + Scroll to adjust the camera distance.
  • Remove planned pieces: Delete planned pieces again. Per default only the hovered piece will be deleted. But you can use various modifiers to change that behaviour.

    • Press Ctrl to delete plans in a radius, can be used to clean up after using it to measure distances, or as a general cleanup tool. Resources that were already added to the unfinished plans will be refunded.
    • Use the Scroll Wheel while holding Ctrl to change the deletion radius.
    • Use Shift + Scroll to adjust the camera distance.
  • Terrain Tools: Allows you to "flatten" the terrain in a chosen radius or remove previously made modifications. Uses Valheim's TerrainCompiler and is 100% compatible with the vanilla game and modifications made with the Hoe for example.

    • Press Q to switch between a circle and a square shaped marker.
    • Press Ctrl to add smooth edges to the flattened area
    • Press Alt to remove terrain modifications.
    • Use the Scroll Wheel to change the tool radius.
    • Use Ctrl + Scroll to rotate the square marker.
    • Use Alt + Scroll to move the marker on the Y-axis.
    • Use Shift + Scroll to adjust the camera distance.
  • Delete Objects: Allows you to remove vegetation objects in a chosen radius.

    • Press Ctrl to remove all objects including Pieces and Items (Warning: Very destructive).
    • Use the Scroll Wheel to change the tool radius.
    • Use Shift + Scroll to adjust the camera distance.
  • Paint terrain: Allows you to reset the terrain "paint" per biome (grass in the Meadows, sand at beaches, etc). Can also paint dirt or paved onto every terrain. Can be used as a "brush" by holding down the Attack button continously.

    • Press Q to switch between a circle and a square shaped marker.
    • Press Ctrl to paint "dirt".
    • Press Alt to paint "paved".
    • Use the Scroll Wheel to change the tool radius.
    • Use Ctrl + Scroll to rotate the square marker.
    • Use Shift + Scroll to adjust the camera distance.

Clipboard

Blueprint tools

You can find all of the temporary blueprints you make using the "Copy" command of the "Edit Selection" tool here. These are reset on every logout.

Blueprints

Blueprint tools

Place a blueprint as planned pieces. Select your previously saved blueprint and place it anywhere in the world. This works just like any other vanilla building piece. Additionally there are some extra controls to make placing your structures exactly as you want them as easy as possible:

  • Use Scroll to rotate the blueprint.
  • Use Ctrl + Scroll to move the blueprint on the Z-axis.
  • Use Alt + Scroll to move the blueprint on the X-axis.
  • Use Ctrl + Alt + Scroll to move the blueprint on the Y-axis.
  • Use Q to reset the offset on all axes.
  • Use Shift + Scroll to adjust the camera distance.
  • There is a (server enforced) config option to allow placing the blueprints as regular pieces, so you can configure per server if you want to allow "cheating" structures without resources. When enabled, build your structures without building costs by pressing Ctrl while placing the blueprint. Admins are always allowed to "direct build". You can change the default building behaviour in the config file.

Undo/Redo

The Blueprint Rune features an undo/redo mechanic for most of its actions. Placed blueprints, terrain/paint modifications and object deletions can be reversed using the bp.undo console command. A reversed action can also be replayed using the bp.redo console command. For easy access we recommend binding those commands to a key of your liking. To bind those commands to your mouse's "back" and "forth" keys for example type this into the game's console:

bind mouse3 bp.undo
bind mouse4 bp.redo

Blueprint Marketplace

Blueprint mode

Manage and share your blueprints through a custom GUI added to the game. Per default the marketplace is accessible via End key. Rename your local blueprints, assign a Category for them (which will create a new tab on your Blueprint rune for those blueprints) or add a description to them. If a server has this feature enabled, upload your local blueprints to that server so others can download and build your creations as well. Players with admin rights on a server can also manage the server side list through that interface.

Marketplace Pieces

Blueprint pieces

You can place one of two new rune themed pieces in the world which provide access to your own blueprints and the market on the server. If you want to completely stop clients from accessing the server blueprints via Hotkey, there is a server enforced config which disables that Hotkey for all clients.

Installing

It is recommended to use a mod manager to install PlanBuild and all of its dependencies.

If you want to install it manually, load all of these mods as they are all required for PlanBuild to function and install them according to their respective install instructions:

Finally extract all of the contents of the PlanBuild mod archive into <Valheim>\BepInEx\plugins\PlanBuild

It is possible for clients not using PlanBuild to connect to a server using it. Those clients won't see any planned pieces but are still able to play. You can not connect to a server without PlanBuild when the mod is installed on your local game for griefing reasons.

Compatibility

Fully compatible with:

The Hammer's PieceTable is scanned automatically, mods that add Pieces should be compatible. If you find a mod that adds pieces to the Hammer and they don't show up, please post a bug report with a link to the mod or join the Jötunn Discord and ping @Jules or @MarcoPogo.

Configuration

A lot aspects of this mod are configurable either through the config file found in your game folder (<Valheim>\BepInEx\configs\marcopogo.PlanBuild.cfg) or using the BepInEx ConfigurationManager:

  • Server Settings (enforced on all clients connecting to a server)
    • Allow direct build: Allow placement of blueprints without materials on this server. Admins are always allowed to use it. (default false)
    • Allow terrain tools: Allow usage of the terrain modification tools on this server. Admins are always allowed to use them. (default false)
    • Allow serverside blueprints: Allow sharing of blueprints on this server. (default false)
    • Allow clients to use the GUI toggle key: Allow clients to use the Hotkey to access server blueprints. Admins are always allowed to use it. (default true)
    • Excluded plan prefabs: Comma separated list of prefab names to exclude from the planned piece table on this server. Admins are always allowed to build them.
  • Blueprints
    • Default build mode: Default build mode when placing blueprints. (default Plan)
    • Unlimited health: Set Piece health to its maximum value when directly building blueprints. (default false)
    • Place distance: Place distance while using the Blueprint Rune. (default 50)
    • Camera offset increment: Camera height change when holding the camera modifier key and scrolling. (default 2)
    • Invert camera offset scroll: Invert the direction of camera offset scrolling. (default false)
    • Placement offset increment: Placement height change when holding the modifier key and scrolling. (default 0.1)
    • Invert placement height change scroll: Invert the direction of placement offset scrolling. (default false)
    • Selection increment: Selection radius increment when scrolling. (default 1)
    • Invert selection scroll: Invert the direction of selection scrolling. (default false)
    • Selection connected check margin: Distance of the shell used to check for connectedness. (default 0.01)
    • Show the transform bound grid: Shows a grid around the blueprints' bounds to visualize the blueprints' edges. (default false)
    • Tooltip enabled: Show a tooltip with a bigger thumbnail for blueprint pieces. (default true)
    • Tooltip Color: Set the background color for the tooltip on blueprint pieces.
    • Undo queue name: Global name of the blueprint undo queue used for bp.undo and bp.redo commands. Can be set to the same value as other mods' config (if supported) to combine their undo queues. (default blueprintqueue)
    • Add player prefix to file name: Add your current player profile name to any blueprint file created with that player. (default true)
  • Directories
    • Blueprint search directory Base directory to scan (recursively) for blueprints and vbuild files, relative paths are relative to the valheim.exe location (default .)
    • Save directory: Directory to save blueprint files, relative paths are relative to the valheim.exe location (default BepInEx/config/PlanBuild/blueprints)
  • Keybindings
    • Blueprint Marketplace GUI toggle key: Hotkey to show the blueprint marketplace GUI (default End)
    • ShiftModifier: First modifier key to change behaviours on various tools (default LeftShift)
    • CtrlModifier: Second modifier key to change behaviours on various tools (default LeftCtrl)
    • AltModifier: Third modifier key to change behaviours on various tools (default LeftAlt)
    • Toggle: Key to switch between modes on various tools. (default Q)
  • Plans:
    • Plan unknown pieces: Show all plans, even for pieces you don't know yet. (default false)
    • Plan totem build radius: Build radius of the plan totem (default 30)
    • Plan totem particle effects: Show particle effects when building pieces with the plan totem. (default true)
  • Visual
    • Transparent Ghost Placement: Apply plan shader to ghost placement (currently placing piece). (default true)
    • Unsupported color: Color of unsupported plan pieces.
    • Supported color: Color of supported plan pieces.
    • Transparency: Additional transparency for finer control. (default 30%)
    • Plan totem glow color: Color of the glowing lines on the Plan totem.

Console commands

PlanBuild adds some new console commands to the game:

  • plan.blacklist.print - Print out the server's plan blacklist
  • plan.blacklist.add - [prefab_name] Add a prefab to the server's plan blacklist
  • plan.blacklist.remove - [prefab_name] Removes a prefab from the server's plan blacklist
  • bp.local - Get the list of your local blueprints
  • bp.remove - [blueprint_id] Remove a local blueprint
  • bp.push - [blueprint_id] Upload a local blueprint to the current connected server
  • bp.server - Get the list of the current connected servers blueprints
  • bp.pull - [blueprint_id] Load a blueprint from the current connected server and add it to your local blueprints
  • bp.thumbnail - [blueprint_id] ([rotation]) Create a new thumbnail for a blueprint from the actual blueprint data, optionally provide additional rotation of the blueprint on the thumbnail
  • bp.regenthumbnails - Create a new thumbnail for all local blueprints
  • bp.undo - Undo your last rune action (build, delete or terrain)
  • bp.redo - Redo your last undone rune action (build, delete or terrain)
  • bp.clearclipboard - Clear the clipboard category of all saved blueprints
  • selection.gui - Show the selection GUI
  • selection.clear - Clears the current selection
  • selection.copy - Copy the current selection as a temporary blueprint
  • selection.copywithsnappoints - Copy the current selection as a temporary blueprint including the vanilla snap points
  • selection.save - Save the current selection as a blueprint
  • selection.delete - Delete all prefabs in the current selection

Building Community

Head over to the Valheimians page to find a community of builders and share your own creations. PlanBuild blueprints are supported.

Credits

The original PlanBuild mod was created by MarcoPogo

Blueprint functionality originally created by Algorithman & Jules

Blueprint Marketplace GUI created by Dreous

All further coding by MarcoPogo & Jules

Special thanks to Jere for exchanging code and ideas

Made with Löve and Jötunn

Contact

Source available on GitHub: https://github.com/sirskunkalot/PlanBuild. All contributions welcome!

You can find us at the Jötunn Discord (Jules#7950 and MarcoPogo#6095).

Available versions

Please note that the install buttons only work if you have compatible client software installed, such as the Thunderstore Mod Manager. Otherwise use the zip download links instead.

Upload date Version number Downloads Download link  
2022-8-7 0.10.6 1176 Version 0.10.6 Install
2022-8-4 0.10.5 755 Version 0.10.5 Install
2022-8-2 0.10.4 501 Version 0.10.4 Install
2022-7-21 0.10.3 1944 Version 0.10.3 Install
2022-7-15 0.10.2 1414 Version 0.10.2 Install
2022-7-4 0.10.1 1908 Version 0.10.1 Install
2022-6-26 0.10.0 1932 Version 0.10.0 Install
2022-3-20 0.9.5 10120 Version 0.9.5 Install
2022-3-3 0.9.4 2903 Version 0.9.4 Install
2022-1-2 0.9.3 6529 Version 0.9.3 Install
2021-12-9 0.9.2 2512 Version 0.9.2 Install
2021-11-18 0.9.0 2667 Version 0.9.0 Install
2021-11-14 0.8.5 554 Version 0.8.5 Install
2021-11-8 0.8.4 801 Version 0.8.4 Install
2021-11-3 0.8.2 759 Version 0.8.2 Install
2021-11-2 0.8.1 318 Version 0.8.1 Install
2021-11-2 0.8.0 159 Version 0.8.0 Install
2021-10-14 0.7.1 1791 Version 0.7.1 Install
2021-10-14 0.7.0 98 Version 0.7.0 Install
2021-10-14 0.6.14 144 Version 0.6.14 Install
2021-10-13 0.6.13 362 Version 0.6.13 Install
2021-10-11 0.6.12 484 Version 0.6.12 Install
2021-10-11 0.6.11 105 Version 0.6.11 Install
2021-10-11 0.6.10 115 Version 0.6.10 Install
2021-10-3 0.6.9 1218 Version 0.6.9 Install
2021-9-27 0.6.8 1074 Version 0.6.8 Install
2021-9-26 0.6.7 716 Version 0.6.7 Install
2021-9-25 0.6.6 434 Version 0.6.6 Install
2021-9-25 0.6.5 434 Version 0.6.5 Install
2021-9-21 0.6.4 929 Version 0.6.4 Install
2021-9-21 0.6.3 236 Version 0.6.3 Install
2021-9-19 0.6.2 667 Version 0.6.2 Install
2021-9-16 0.6.0 812 Version 0.6.0 Install
2021-9-10 0.5.2 606 Version 0.5.2 Install
2021-8-31 0.5.1 929 Version 0.5.1 Install
2021-8-20 0.5.0 1142 Version 0.5.0 Install
2021-8-17 0.4.2 517 Version 0.4.2 Install
2021-8-15 0.4.1 329 Version 0.4.1 Install
2021-8-14 0.4.0 215 Version 0.4.0 Install
2021-7-31 0.3.5 875 Version 0.3.5 Install
2021-7-27 0.3.4 329 Version 0.3.4 Install
2021-7-21 0.3.3 468 Version 0.3.3 Install
2021-7-16 0.3.2 413 Version 0.3.2 Install
2021-7-4 0.3.1 793 Version 0.3.1 Install
2021-7-3 0.3.0 205 Version 0.3.0 Install
2021-6-9 0.2.13 1336 Version 0.2.13 Install
2021-6-9 0.2.12 147 Version 0.2.12 Install
2021-6-8 0.2.11 240 Version 0.2.11 Install
2021-6-6 0.2.10 304 Version 0.2.10 Install
2021-6-3 0.2.9 406 Version 0.2.9 Install
2021-6-2 0.2.7 258 Version 0.2.7 Install
2021-5-30 0.2.6 481 Version 0.2.6 Install
2021-5-28 0.2.5 348 Version 0.2.5 Install
2021-5-27 0.2.4 201 Version 0.2.4 Install
2021-5-26 0.2.2 211 Version 0.2.2 Install
2021-5-26 0.2.1 66 Version 0.2.1 Install
2021-5-23 0.1.8 512 Version 0.1.8 Install
2021-5-18 0.1.7 629 Version 0.1.7 Install
2021-5-15 0.1.6 495 Version 0.1.6 Install
2021-5-15 0.1.5 147 Version 0.1.5 Install
2021-5-13 0.1.4 438 Version 0.1.4 Install
2021-5-11 0.1.3 443 Version 0.1.3 Install
2021-5-9 0.1.2 315 Version 0.1.2 Install
2021-5-8 0.1.0 319 Version 0.1.0 Install
2021-5-1 0.0.4 693 Version 0.0.4 Install
2021-4-29 0.0.3 204 Version 0.0.3 Install
2021-4-28 0.0.2 158 Version 0.0.2 Install
2021-4-28 0.0.1 103 Version 0.0.1 Install