<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en-GB">
	<id>https://wiki.shroudforge.net/index.php?action=history&amp;feed=atom&amp;title=Mod%3A_World_Editor%2Fen-gb</id>
	<title>Mod: World Editor/en-gb - Revision history</title>
	<link rel="self" type="application/atom+xml" href="https://wiki.shroudforge.net/index.php?action=history&amp;feed=atom&amp;title=Mod%3A_World_Editor%2Fen-gb"/>
	<link rel="alternate" type="text/html" href="https://wiki.shroudforge.net/index.php?title=Mod:_World_Editor/en-gb&amp;action=history"/>
	<updated>2026-11-21T15:53:13Z</updated>
	<subtitle>Revision history for this page on the wiki</subtitle>
	<generator>MediaWiki 1.46.2</generator>
	<entry>
		<id>https://wiki.shroudforge.net/index.php?title=Mod:_World_Editor/en-gb&amp;diff=4075&amp;oldid=prev</id>
		<title>FuzzyBot: Updating to match new version of source page</title>
		<link rel="alternate" type="text/html" href="https://wiki.shroudforge.net/index.php?title=Mod:_World_Editor/en-gb&amp;diff=4075&amp;oldid=prev"/>
		<updated>2026-11-18T00:15:31Z</updated>

		<summary type="html">&lt;p&gt;Updating to match new version of source page&lt;/p&gt;
&lt;p&gt;&lt;b&gt;New page&lt;/b&gt;&lt;/p&gt;&lt;div&gt;&amp;lt;languages /&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;!-- ShroudForge Modloader Wiki Post&lt;br /&gt;
title: Mod: World Editor&lt;br /&gt;
description: Guide to blueprint capture, library management, placement, multiplayer operation, settings, and recovery.&lt;br /&gt;
language: en-GB&lt;br /&gt;
picture:World-Editor-Manage.png&lt;br /&gt;
creator: Bonsaibauer&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&lt;br /&gt;
[[File:World-Editor-Manage.png|thumb|right|World Editor blueprint management.]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
World Editor is a standalone ShroudForge mod for capturing, saving, rotating, previewing, placing, and undoing world blueprints. Its package ID is &amp;lt;code&amp;gt;world-editor&amp;lt;/code&amp;gt;. It is disabled by default and targets the client and Dedicated Server.&lt;br /&gt;
&lt;br /&gt;
The mod implements its own editor, blueprint format, selection, rotation, placement plan, paste logic, and undo journal. It uses ShroudForge&amp;#039;s public runtime APIs for world, voxel, entity, asset, settings, logging, and export access. It does not use fixed game addresses, function hashes, executable hooks, or private loader patches.&lt;br /&gt;
&lt;br /&gt;
== Client and Dedicated Server ==&lt;br /&gt;
&lt;br /&gt;
The client provides the editor window and blueprint library. The Dedicated Server runs the same mod headlessly and owns server-side world edits. Install and enable the package in both the client and the Dedicated Server when editing a dedicated world.&lt;br /&gt;
&lt;br /&gt;
The editor uses ShroudForge&amp;#039;s shared Network module and Steam P2P. The client sends a validated blueprint operation. The server authorizes and queues the request, then runs the same native capture, paste, verification, and undo path used for local edits. The server returns ordered capture data or operation progress to the client. Process-local entity handles never cross the network.&lt;br /&gt;
&lt;br /&gt;
Transfers are limited to 32 MiB per blueprint. Local files are limited to 256 MiB. The server serializes capture, paste, and undo requests in a FIFO queue. It allows up to 32 waiting requests, one waiting request per peer, and a separate 32 MiB upload budget. Requests expire after 45 accumulated callback seconds and recheck authorization and world state before execution. Queue progress is reported every two seconds. The server retains the last 128 terminal request receipts.&lt;br /&gt;
&lt;br /&gt;
Each client has its own latest in-memory undo journal, with up to 32 clients retaining journals in one world session. One client&amp;#039;s paste or undo does not replace another client&amp;#039;s journal. A confirmed placement permits another paste. A partial placement keeps that client&amp;#039;s next paste locked until recovery or explicit release. Restarting the server discards its journals.&lt;br /&gt;
&lt;br /&gt;
== Capture and save a blueprint ==&lt;br /&gt;
&lt;br /&gt;
# Select the building hammer and a single voxel.&lt;br /&gt;
# Mark the two corners of the source area. The editor uses these marks for the selection.&lt;br /&gt;
# Choose a combined voxel-and-prop capture or a props-only capture.&lt;br /&gt;
# Capture and save the blueprint. The new file is selected in the library.&lt;br /&gt;
# Select an existing blueprint from the library to make it active for placement.&lt;br /&gt;
&lt;br /&gt;
Online capture sends the two marked positions to the server. The server runs the native capture path and returns the complete V7 blueprint in ordered chunks. The client checks the sender, request ID, byte count, checksum, and file structure before saving it locally. Partial or stale responses are not saved as files. Reset or release cancels a pending remote capture without discarding an unrelated placement journal.&lt;br /&gt;
&lt;br /&gt;
Prop capture scans incrementally. Each native scan slice checks at most 8,192 entity pointers and yields after about 2 milliseconds of scan time. An incomplete scan is never saved. A changed ECS epoch, unavailable world, 30 seconds without scan progress, or a 120-second overall deadline aborts capture.&lt;br /&gt;
&lt;br /&gt;
== Blueprint files and placement ==&lt;br /&gt;
&lt;br /&gt;
The persistent file format is &amp;lt;code&amp;gt;SHROUDFORGE_WORLD_BLUEPRINT_V7&amp;lt;/code&amp;gt;. A blueprint can contain a voxel channel plus props or props alone. Voxel cells store their value and coverage state: Unknown, Empty, or Occupied. The file also stores selection extent, voxel offset, item IDs, native template UUIDs, prop transforms, and the up axis used during capture.&lt;br /&gt;
&lt;br /&gt;
The cursor&amp;#039;s world position is the placement anchor. Voxel placement is refused when the resulting voxel-channel origin does not align to the active grid. Props-only blueprints do not require voxel-grid metadata and can use the live cursor, a marked target, or the manual world-coordinate fields.&lt;br /&gt;
&lt;br /&gt;
Choose whether to replace target voxels or add only occupied source cells. In replace mode, Empty source cells clear the target. In add mode, Empty source cells are skipped. Choose whether to keep existing props or replace intersecting props. Replacement is refused if a prop&amp;#039;s recipe, native template identity, or transform cannot be safely verified.&lt;br /&gt;
&lt;br /&gt;
Use Preview placement plan to resolve the target and write planned dimensions and counts to the ShroudForge log. This is a non-destructive plan preview. It does not draw a three-dimensional ghost or schematic in the world. Paste active blueprint and Paste at cursor write to the world.&lt;br /&gt;
&lt;br /&gt;
== Blueprint library and editor window ==&lt;br /&gt;
&lt;br /&gt;
The editor window shows a contextual instruction line and the blueprint cards. Its configured window shortcut shows or hides the single editor window. Other shortcuts perform editor actions without toggling window visibility. The library discovers new or copied &amp;lt;code&amp;gt;.sfbp&amp;lt;/code&amp;gt; files in the export folder. The dashed New blueprint tile remains at the left of the library. Recently selected or created blueprints appear first after it.&lt;br /&gt;
&lt;br /&gt;
The blueprint manager can rename, duplicate, or delete files and their image. It can browse an Enshrouded screenshot folder, preview supported images, and copy a selected image into the blueprint library as a PNG cover and thumbnail. It never edits the original screenshot. Common screenshot folders are detected, and the selected folder is remembered.&lt;br /&gt;
&lt;br /&gt;
The default action shortcuts are F3 through F8 for rotation, undo, marking the next selection corner, reset or release, paste at cursor, and capture and save. They are declared as keybind settings and can be changed in the mod&amp;#039;s Keyboard shortcuts settings or Compatibility → Hotkeys. An empty binding disables that action. The key must be held until the 100 ms update observes it. The input is not consumed by the editor.&lt;br /&gt;
&lt;br /&gt;
== Settings ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Group !! Setting !! Default !! Meaning or range&lt;br /&gt;
|-&lt;br /&gt;
| Overlay || Blueprint panel width || 1180 || Logical pixels, 760–1920.&lt;br /&gt;
|-&lt;br /&gt;
| Overlay || Blueprint panel height || 190 || Logical pixels, 140–400.&lt;br /&gt;
|-&lt;br /&gt;
| Overlay || Panel position X || −1 || Logical pixels. −1 centers the panel.&lt;br /&gt;
|-&lt;br /&gt;
| Overlay || Panel position Y || 92 || Logical pixels from the top of the game window.&lt;br /&gt;
|-&lt;br /&gt;
| Shortcuts || Rotate blueprint 90° || &amp;lt;code&amp;gt;SDL:60&amp;lt;/code&amp;gt; || Advances active blueprint rotation by one quarter turn.&lt;br /&gt;
|-&lt;br /&gt;
| Shortcuts || Undo last paste || &amp;lt;code&amp;gt;SDL:61&amp;lt;/code&amp;gt; || Restores the client&amp;#039;s latest placement when safe.&lt;br /&gt;
|-&lt;br /&gt;
| Shortcuts || Mark next selection corner || &amp;lt;code&amp;gt;SDL:62&amp;lt;/code&amp;gt; || Marks the next source corner, then the other corner.&lt;br /&gt;
|-&lt;br /&gt;
| Shortcuts || Reset / release stuck server operation || &amp;lt;code&amp;gt;SDL:63&amp;lt;/code&amp;gt; || Requests release of a stalled or incomplete remote operation.&lt;br /&gt;
|-&lt;br /&gt;
| Shortcuts || Paste at cursor || &amp;lt;code&amp;gt;SDL:64&amp;lt;/code&amp;gt; || Pastes the active blueprint at the live cursor position.&lt;br /&gt;
|-&lt;br /&gt;
| Shortcuts || Capture and save blueprint || &amp;lt;code&amp;gt;SDL:65&amp;lt;/code&amp;gt; || Captures the current selection and saves a new blueprint.&lt;br /&gt;
|-&lt;br /&gt;
| Blueprint creation || Maximum props per blueprint || 60,000 || Range 1–1,000,000. Larger captures, files, or placements are refused, not truncated.&lt;br /&gt;
|-&lt;br /&gt;
| Blueprint creation || Source cell X, Y, Z || 0, 0, 0 || Manual source cell coordinates when cursor corners are not both marked.&lt;br /&gt;
|-&lt;br /&gt;
| Blueprint creation || Size X, Y, Z || 8, 8, 8 || Manual voxel-cell dimensions, each 1–65,536.&lt;br /&gt;
|-&lt;br /&gt;
| Blueprint creation || Persistent blueprint name || &amp;lt;code&amp;gt;my_blueprint&amp;lt;/code&amp;gt; || Name used for a new saved blueprint, 1–64 characters.&lt;br /&gt;
|-&lt;br /&gt;
| Blueprint creation || New name for rename or duplicate || &amp;lt;code&amp;gt;my_blueprint_copy&amp;lt;/code&amp;gt; || Destination name for a library rename or duplicate, 1–64 characters.&lt;br /&gt;
|-&lt;br /&gt;
| Blueprint placement || Initial paste rotation || 0 || Quarter turns, 0–3, equivalent to 0°, 90°, 180°, or 270°.&lt;br /&gt;
|-&lt;br /&gt;
| Blueprint placement || Blueprint up axis || Y || X, Y, or Z. Stored in the blueprint when captured.&lt;br /&gt;
|-&lt;br /&gt;
| Blueprint placement || Voxel mode || Replace target voxels || Replace target cells or add occupied source cells.&lt;br /&gt;
|-&lt;br /&gt;
| Blueprint placement || Props at target || Keep existing props || Keep existing props or replace intersecting props that can be verified safely.&lt;br /&gt;
|-&lt;br /&gt;
| Blueprint placement || Target cell X, Y, Z || 0, 0, 0 || Manual voxel-cell target when no cursor or marked target is used.&lt;br /&gt;
|-&lt;br /&gt;
| Blueprint placement || Props-only target world X, Y, Z || 0, 0, 0 || Manual world-coordinate target for a props-only blueprint.&lt;br /&gt;
|-&lt;br /&gt;
| Entity operations || Opaque entity handle || 0 || Process-local runtime handle for advanced actions. Valid only in the current process.&lt;br /&gt;
|-&lt;br /&gt;
| Entity operations || Template UUID high and low || &amp;lt;code&amp;gt;0000000000000000&amp;lt;/code&amp;gt; each || Hexadecimal halves of a native entity-template UUID for advanced spawn.&lt;br /&gt;
|-&lt;br /&gt;
| Entity operations || Tracking ID || 0 || ItemInfo placement tracking value used by advanced spawn and placement.&lt;br /&gt;
|-&lt;br /&gt;
| Entity operations || Material feedback ID || 0 || ItemInfo placement feedback value. Required for advanced placement, not removal.&lt;br /&gt;
|-&lt;br /&gt;
| Entity operations || Position X, Y, Z || 0, 0, 0 || World coordinates used by advanced spawn, placement, or removal actions.&lt;br /&gt;
|-&lt;br /&gt;
| Entity operations || Bounds minimum X, Y, Z || 0, 0, 0 || Minimum bounds used by advanced native placement and removal.&lt;br /&gt;
|-&lt;br /&gt;
| Entity operations || Bounds maximum X, Y, Z || 0, 0, 0 || Maximum bounds used by advanced native placement and removal.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
The advanced Entity operations controls are for manual native operations. Normal blueprint capture and placement do not require users to enter UUIDs or runtime handles.&lt;br /&gt;
&lt;br /&gt;
== Undo, errors, and recovery ==&lt;br /&gt;
&lt;br /&gt;
Undo checks target voxels and props before restoring the saved snapshot. It pauses if cells changed after placement. It also checks the live handle and transform of each placed prop before removing it. If a native operation fails, the mod attempts to restore its pre-paste snapshot. If the result cannot be verified, it keeps recovery state for another undo attempt.&lt;br /&gt;
&lt;br /&gt;
If a server operation stops reporting progress for 10 seconds, the client marks it as potentially stuck and offers Reset / release. The client keeps paste locked until the server confirms it discarded the operation&amp;#039;s recovery journal and released its lock. Releasing an operation may leave partial terrain or props behind, and the abandoned operation can no longer be undone. If confirmation is lost, request release again. An unreachable server leaves paste paused until release is confirmed.&lt;br /&gt;
&lt;br /&gt;
Progress and operation results are written to the role-appropriate ShroudForge log under the &amp;lt;code&amp;gt;world-editor&amp;lt;/code&amp;gt; source. The editor has no separate UI log. A successful live readback confirms the in-world result. It does not prove that the game save persists after reload.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
[[Category:Mods]]&lt;/div&gt;</summary>
		<author><name>FuzzyBot</name></author>
	</entry>
</feed>