
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
Quick answer
Which BuildWright release should I use?
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.
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.
Install ImGui first. We found matching files for this game-version and loader setup.
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.
- 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.
- 02
Bring the mods it needs
Install ImGui first. We found matching files for this game-version and loader setup.
- 03
Put it on the correct side
It must be installed on the client. Do not install it on the dedicated server.
- 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
Bto open the workspace andVto switch between window interaction and player control. - Schematic file management: Supports
.vsbpZIP schematics, native Vintage Story.jsonimport/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
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: RotateCtrl+Shift+G: Cycle display modesCtrl+Shift+T: Open placement toolsCtrl+Shift+F: Open schematic libraryCtrl+Shift+E: Open materialsCtrl+Shift+D: View differencesCtrl+Shift+Arrow Keys: Move relative to the playerPageUp/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切换窗口交互与玩家控制。 - 蓝图文件管理: 支持
.vsbpZIP 蓝图、原生 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.
1.22.7
1 loader build1.22.6
1 loader build1.22.5
1 loader build1.22.4
1 loader build1.22.3
1 loader buildCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
BuildWright versions and loaders
1.0.3
buildwright-1.0.3.zip
30 Oct 2026
Looking for an older file? The official Vintage Story Mod DB project page is in Resources.