Back to mods
BuildWright project artwork

Vintage Story Mod DB · Vintage Story mod

BuildWright

Buildwright Buildwright is a blueprint, projection, and build-progress mod for Vintage Story by VSCN-Studio. It targets Vintage Story 1.22.3. The client provides the user interface and projections; the companion server package performs world operations that r

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which BuildWright release should I use?

Updated today
Latest stable file 1.0.3
Game version 1.22.3, 1.22.4, 1.22.5
Loader Built-in Vintage Story mod system

BuildWright 1.0.3 targets 1.22.3, 1.22.4, 1.22.5. It must be installed on the client. Do not install it on the dedicated server. All 1 required mods have matching files.

Where it goes

Is BuildWright required on the client, server, or both?

It must be installed on the client. Do not install it on the dedicated server.

Client Required
Dedicated server Not supported
Loader for this release Built-in Vintage Story mod system
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

This Vintage Story file is marked client-only.

What else does BuildWright 1.0.3 need?

1.0.3. Change the file and its required mods may change too.

All 1 required mods have matching files

Install ImGui first. We found matching files for this game-version and loader setup.

ImGui Needed by BuildWright 1.0.3
required
Matching file found Matched file: 1.2.7

We only count dependency files that match this setup. A file for another loader does not fill the gap.

Before you install it

Add BuildWright without breaking your instance.

Built for BuildWright 1.0.3. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use 1.0.3. It targets 1.22.3, 1.22.4, 1.22.5; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    Install ImGui first. We found matching files for this game-version and loader setup.

  3. 03

    Put it on the correct side

    It must be installed on the client. Do not install it on the dedicated server.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside 1.0.3. It opens that exact file at the source.

About this project

What does BuildWright add?

Buildwright

Buildwright is a blueprint, projection, and build-progress mod for Vintage Story by VSCN-Studio. It targets Vintage Story 1.22.3. The client provides the user interface and projections; the companion server package performs world operations that require server authority.

Installation

Buildwright 1.0.3 requires VSImGui 1.2.7 on the client.

Install Buildwright Server on a server when authoritative Buildwright world operations are needed. The server package is also used by the single-player Creative workflow.

Install the client and server ZIPs as separate mod packages. Do not keep older packages with the same mod id in the Mods folder.

Features

  • Two-corner area selection: Select areas using two corners and an anchor face. Supports blocks, fluids, decorations, BlockEntity trees, and Chisel/MicroBlock voxel metadata.
  • Resizable ImGui windows: Includes workspace, selection, files, placement, building, area tools, schematic library, materials, differences, and diagnostics. Press B to open the workspace and V to switch between window interaction and player control.
  • Schematic file management: Supports .vsbp ZIP schematics, native Vintage Story .json import/export, rotating backups, copies, templates, metadata inspection, and a root-restricted local file browser.
  • Non-destructive editing: Crop, extend or shrink along all six directions, adjust anchors and internal origin offsets, batch-replace block codes, and compare two schematics including Chisel voxel changes.
  • Ghost placement: Snap placement to the crosshair, automatic orientation, locking, precise movement, player-relative movement, rotation, three-axis mirroring, layer visibility, clipping, and opacity adjustment.
  • Placement display modes: Full, missing, wrong, and difference modes detect missing, incorrect, and extra blocks in real time and report build completion.
  • Matching modes: Loose, medium, and strict matching. Strict mode compares BlockEntity trees and Chisel voxel data after placement transforms are applied.
  • Material requirements: Displays required materials and inventory quantities, supports sorting and clipboard/text export, and provides a material-based build-progress HUD.
  • Diagnostics: Checks schematic versions, dependencies, and unknown blocks.
  • Model export: Exports Item Shape JSON, Blockbench JSON, Blender GLB with embedded basic textures, and 3D-printable STL.
  • Creative operations: In single-player Creative mode, confirmed operations can place missing blocks, remove extra blocks, and clone, move, rotate, mirror, fill, or clear an area.

Commands

Commands and controls

Enter .bw help in-game to view the complete command list. Common commands include:

.bw corner1
.bw corner2
.bw save house [overwrite]
.bw load house [loose|medium|strict]
.bw place
.bw rotate [quarterTurns]
.bw move-relative <forward> <right> <up>
.bw mirror
.bw display <full|missing|wrong|difference>
.bw clip <x|y|z> <min> <max>
.bw opacity <0.05-1>
.bw materials
.bw materials-copy
.bw workspace
.bw library
.bw info house
.bw status
.bw cancel

Commands that modify the world require the literal argument confirm and are rejected outside single-player Creative mode.

.bw execute confirm
.bw clone 10 0 0 confirm

Placement hotkeys

  • Ctrl+Shift+R: Rotate
  • Ctrl+Shift+G: Cycle display modes
  • Ctrl+Shift+T: Open placement tools
  • Ctrl+Shift+F: Open schematic library
  • Ctrl+Shift+E: Open materials
  • Ctrl+Shift+D: View differences
  • Ctrl+Shift+Arrow Keys: Move relative to the player
  • PageUp/PageDown: Cycle visible schematic layers

Vanilla stick and tool modes

Hold the vanilla stick (game:stick, item id 2644) to activate contextual world tools. Without an active placement, left-click sets selection corner 1 and right-click sets corner 2. With an active placement, clicking a target block places and locks the schematic.

Hold Ctrl and scroll while holding the stick to cycle tool modes. Ctrl+Shift+[ and Ctrl+Shift+] also cycle modes; Ctrl+Shift+O toggles tool input. Middle-click or Ctrl+Shift+C cycles the active corner. Hold Alt while scrolling to move that corner, or Alt+Ctrl to move the whole selection.

Tool mode Stick controls Execute (Ctrl+Shift+Enter)
Area Selection Left/right-click to set corners; middle-click to inspect status None
Schematic Placement Left/right-click to adjust placement None
Fill Set corners; Ctrl+middle-click samples the fill block Fill the selected area
Replace Block Set corners; sample target/source blocks with the documented Ctrl combinations Replace source blocks
Paste Schematic Left/right-click to position and lock Paste the complete schematic
Grid Paste Left/right-click to set grid boundaries Tile the locked schematic
Move Set corners; middle-click sets the destination anchor Move the selected area
Delete Left/right-click to set corners Clear the selected area
Rebuild Left/right-click to position and lock Fill only missing schematic blocks

Copyright and licenses

Copyright (c) 2026 VSCN-Studio. Original Buildwright source code is released under the MIT License. Keep the copyright and license notice when copying, modifying, or redistributing it.

The client adapts portions of Fieldwright by Jeffrey Lueken (Venah), including selection, ghost rendering, matching, configuration, BlockEntity mesh reconstruction, and selection/paste workflow code. Those portions remain under the Fieldwright MIT License; the complete notice is included in LICENSE-Fieldwright.txt.

Vintage Story, VSImGui, ImGui.NET, Dear ImGui, and other external dependencies retain their respective owners' rights and licenses. Blueprints, player creations, geometry, and textures retain their respective owners' rights. Exporting a format does not grant permission to redistribute or commercially use third-party materials.

Buildwright

Buildwright 是由 VSCN-Studio 开发的 Vintage Story 蓝图、投影和建造进度模组,目标游戏版本为 Vintage Story 1.22.3。客户端负责界面和投影,配套服务端模组负责需要服务器权限的世界操作。

安装

Buildwright 1.0.3 要求客户端安装 VSImGui 1.2.7。

需要服务器权限的世界操作请安装 Buildwright Server;单人创造模式工作流也需要服务端包。

客户端和服务端 ZIP 是两个独立模组包,请分别放入 Mods 目录。更新时不要保留相同 modid 的旧包。

功能特性

  • 两角区域选择: 通过两个角点和锚定面选择区域,支持方块、流体、装饰物、方块实体树以及 Chisel/MicroBlock 体素元数据。
  • 可调整的 ImGui 窗口: 包含工作台、选择、文件、投影、建造、区域工具、蓝图库、材料、差异和诊断窗口。按 B 打开工作台,按 V 切换窗口交互与玩家控制。
  • 蓝图文件管理: 支持 .vsbp ZIP 蓝图、原生 Vintage Story .json 导入导出、滚动备份、副本、模板、元数据检查和受根目录限制的本地文件浏览器。
  • 非破坏性编辑: 支持裁剪、沿六个方向延伸或缩减、调整锚点和内部原点偏移、批量替换方块代码,以及包含 Chisel 体素变化的蓝图对比。
  • 幽灵投影: 支持吸附准星、自动朝向、锁定、精确移动、相对玩家移动、旋转、三轴镜像、分层、裁剪和透明度调节。
  • 投影显示模式: 支持完整、缺失、错误和差异模式,实时检测缺失、错误和多余方块并判断建造完成。
  • 匹配模式: 支持宽松、中等和严格匹配。严格模式会在应用投影变换后比较方块实体树和 Chisel 体素数据。
  • 材料需求: 显示材料需求和背包数量,支持排序、剪贴板/文本导出,并提供按材料统计的建造进度 HUD。
  • 蓝图诊断: 检查蓝图版本、依赖项和未知方块。
  • 模型导出: 支持物品 Shape JSON、Blockbench JSON、内嵌基础纹理的 Blender GLB 和 3D 打印 STL。
  • 创造模式操作: 单人创造模式下,经确认后可放置缺失方块、清除多余方块,以及克隆、移动、旋转、镜像、填充和清空区域。

命令

命令和控制

在游戏内输入 .bw help 查看完整命令列表。常用命令包括:

.bw corner1
.bw corner2
.bw save house [overwrite]
.bw load house [loose|medium|strict]
.bw place
.bw rotate [quarterTurns]
.bw move-relative <forward> <right> <up>
.bw mirror
.bw display <full|missing|wrong|difference>
.bw clip <x|y|z> <min> <max>
.bw opacity <0.05-1>
.bw materials
.bw materials-copy
.bw workspace
.bw library
.bw info house
.bw status
.bw cancel

所有修改世界的命令都必须包含字面参数 confirm,并且在单人创造模式以外会被拒绝执行。

.bw execute confirm
.bw clone 10 0 0 confirm

投影快捷键

  • Ctrl+Shift+R:旋转
  • Ctrl+Shift+G:切换显示模式
  • Ctrl+Shift+T:打开投影工具
  • Ctrl+Shift+F:打开蓝图库
  • Ctrl+Shift+E:打开材料面板
  • Ctrl+Shift+D:查看差异
  • Ctrl+Shift+方向键:相对玩家移动
  • PageUp/PageDown:切换可见蓝图层

原版木棍和工具模式

手持原版木棍(game:stick,物品 ID 2644)启用情境式世界工具。没有激活投影时,左键设置选择角点 1,右键设置角点 2;激活投影后,点击目标方块会将投影放置到该位置并锁定。

手持木棍并按住 Ctrl 滚动鼠标滚轮可切换工具模式;Ctrl+Shift+[ 和 Ctrl+Shift+] 也可切换,Ctrl+Shift+O 切换工具输入。中键或 Ctrl+Shift+C 切换活动角点。按住 Alt 滚动移动活动角点,按住 Alt+Ctrl 滚动移动整个选区。

工具模式 木棍操作 执行(Ctrl+Shift+Enter)
区域选择 左键/右键设置角点;中键查看状态 无
蓝图放置 左键/右键调整投影位置 无
填充 设置角点;Ctrl+中键采样填充方块 填充选定区域
替换方块 设置角点并采样目标/源方块 替换源方块
粘贴蓝图 左键/右键定位并锁定 粘贴完整蓝图
网格粘贴 左键/右键设置网格边界 平铺已锁定蓝图
移动 设置角点;中键设置目标锚点 移动选定区域
删除 左键/右键设置角点 清空选定区域
重建 左键/右键定位并锁定 仅填充蓝图中缺失的方块

版权与许可

Copyright (c) 2026 VSCN-Studio。Buildwright 原创源代码按照 MIT License 发布。复制、修改或再分发时请保留版权和许可声明。

客户端改编了 Jeffrey Lueken(Venah)Fieldwright 的部分选择、幽灵渲染、匹配、配置、方块实体网格重建以及选择/粘贴流程代码。这些部分继续遵守 Fieldwright MIT License,完整声明随包保留在 LICENSE-Fieldwright.txt。

Vintage Story、VSImGui、ImGui.NET、Dear ImGui 和其他外部依赖仍归各自权利人所有。蓝图、玩家作品、模型几何和贴图的权利归各自权利人;导出格式不会自动授予第三方素材的再分发或商业使用权限。

Project description from Vintage Story Mod DB.

Pick your setup

BuildWright releases for each Vintage Story version.

Choose the version and loader you play, then open the matching release.

5 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

BuildWright versions and loaders

1 of 1 releases match

Looking for an older file? The official Vintage Story Mod DB project page is in Resources.