/editprefab
misc

The commands for editing prefabs and creating new ones

Syntax

/editprefab [exit] [saveui] [tp]
RequiredOptional

Parameters

exitOptionalstring

Exit the prefab editing world, losing any unsaved changes

saveuiOptionalstring

Open the save UI to configure and save prefabs in the edit session

tpOptionalstring

Open the teleport UI to teleport to a loaded prefab in the edit session

Subcommands

/editprefab info

Gives general information about the prefab you are selecting

/editprefab kill

Despawn all entities in the currently selected prefab

/editprefab load

Create an empty world and paste a prefab in it to begin editing

Parameters:

axis- The axis to stack multiple prefabs along
name- The name of the prefab you want to load
--recursive- Recursively explore all subdirectories to find prefabs in the directories specified to load
/editprefab load.alignment

How to align the location of the prefabs, either with front sides aligned or anchors aligned

Parameters:

default- Align the anchors
/editprefab load.loadChildren

Load child prefabs

/editprefab load.loadEntities

Load entities

/editprefab load.numBlocksToSurface

The number of blocks between the base of the prefab and the ground

Parameters:

default- 0 Blocks
/editprefab load.pasteLevelGoal

The Y-Axis height that you want to attempt to paste the prefab at. The prefabs may be pasted lower if they do not fit.

Parameters:

default- Y-level 55
/editprefab load.path

The base directory for prefab assets

Parameters:

default- The Server prefab base directory
/editprefab load.spacing

The number of blocks of air between each pasted prefab

Parameters:

default- 15 blocks
/editprefab load.worldGenType

The type of world generator to use for the created world

Parameters:

default- A flat world
/editprefab modified

List all modified prefabs with unsaved changes

/editprefab new

Create an empty world to build a new prefab in from the ground up

Parameters:

name- The name of the prefab you want to create
/editprefab save

Save the prefab using the existing area or the currently selected area, also executing any cleanup tasks

Parameters:

absolute- If specified, computes the anchor using absolute positioning instead of relative positioning
entities- If specified, will also save entities within the selection
noEntities- If specified, will NOT save entities within the selection (entities are saved by default)
overwrite- If specified, will allow overwriting existing files during the save
saveAll- If specified, will save all prefabs that are currently loaded
--empty- If specified, will save air blocks as Empty blocks
/editprefab save.confirm

If specified, confirms saving read-only prefabs to the server prefabs directory

/editprefab save.path

The base directory to save the prefab in

Parameters:

default- The Server prefab base directory
/editprefab save.repairFillers

If specified, will repair fillers during the save

/editprefab save.saveAs

Specifies a different save location for the prefab with respect to the servers prefab directory

/editprefab saveAs

Save a selected prefab into a different file

Parameters:

noUpdate- If specified, will not update the loaded prefab to have the new path and name
/editprefab select

Select the pre-existing area of the prefab that you are looking at, within 200 blocks

Parameters:

--nearest- Change the prefab selection method to highlight the prefab that you are closest to
/editprefab setbox

Set the bounding box of the currently selected prefab

/editprefab setbox.confirm

Specify this flag in order to delete the anchor if it is outside the new selection

Server Messages

ui.savedConfigs.noneSelected

None Selected

ui.worldGenType.flat

Flat

ui.worldGenType.void

Void

ui.alignment.anchor

By Anchor

ui.alignment.zero

Against Zero

ui.rootDirectory.server

Server

ui.rootDirectory.asset

Assets Prefab

ui.rootDirectory.worldGen

WorldGen

ui.rootDirectory.assetRoot

Assets Root

ui.rowSplit.byAllSubfolders

Split by Subfolders

ui.rowSplit.bySpecifiedFolder

Split by Specified Folders

ui.rowSplit.none

Don't Split (Single Line)

prefabNotFound

Could not find a prefab with the name '{name}'

loading

Loading prefabs and creating world..

notInEditSession

You are not in an prefab editing session

noPrefabSelected

You do not have any prefab selected. Please select one with the "/editprefab select" command

unselected

Prefab unselected

noSelection

You have no current BuilderTools selection made

somethingWentWrong

Something has gone wrong trying to parse settings

finishProcessingError

Error while processing prefabs: {error}

noPrefabsInPath

No prefab files found, searched paths

save.error.multipleAnchors

This prefab has more than one anchor block. Anchors found at these locations: {anchors}

save.error.unknownBlockIdKey

Could not find asset id for block key: {key}

info.format

Prefab Info ----\nPath: {path}\nDimensions: {dimensions}\nModified: {dirty}

info.dirty.yes

Yes (unsaved changes)

info.dirty.no

No

load.error.prefabNotFound

There was no prefab found at the specified path: {path}

new.errors.notAFile

The specified path is a directory, not a file

new.success

Creating a new prefab with path {path}. Note: The prefab will not exist until you save it.

exit.notEditingAPrefab

Not currently editing a prefab!

exit.unsavedWarning.title

Unsaved Changes

exit.unsavedWarning.message

You have {count} prefab(s) with unsaved changes. Are you sure you want to exit? All unsaved changes will be lost.

exit.unsavedWarning.confirmExit

Exit Without Saving

exit.unsavedWarning.cancel

Continue Editing

exit.unsavedWarning.saveAndExit

Open Save Dialog

modified.none

No modified prefabs found. All prefabs are saved.

modified.header

Modified Prefabs ({count} of {total}):

modified.entry

- {path}

select.error.noBlockFound

You are not looking at a block that belongs to a prefab within 200 blocks of you

select.error.noPrefabFound

Could not find a prefab to select

anchor.error.noAnchorFound

You are not looking at a block that belongs to a prefab within 10 blocks of you

anchor.success

Set anchor

save.saveAll.start

Starting saving {amount} prefabs.

save.saveAll.success

Finished saving all loaded prefabs. Successful saves: {successes}. Failed saves: {failures}.

save.success

Finished saving prefab: {name}

save.failure

There was an error while saving prefab: {name}. Please see above for more information

save.selectionMismatch

The prefab you have selected has a bounding box that is not up-to-date with your buildertools selection, please run '/pedit setbox' if you want to update the bounding box, or reselect the prefab if you did not intend to resize the bounding box of the prefab

setbox.success

Updated bounding box for prefab to your current selection

setbox.success.movedAnchor

Note: Anchor was outside of bounding box, and confirm argument was provided, so we have set the anchor to the lower corner of the prefab

setbox.anchorOutsideNewSelection

The anchor position is outside of your new selection. You could set the anchor within your new selection and run the command, or you could run the command again with the "--confirm" argument to set the new selection and set the anchor to the lower corner

kill.done

Despawned {amount} entities in prefab selection

saveAs.errors.notAFile

Must specify a non-directory filename

loading.phase.initializing

Initializing...

loading.phase.creatingWorld

Creating world...

loading.phase.loadingPrefabs

Loading prefab {current} of {total}...

loading.phase.pastingPrefabs

Pasting prefab {current} of {total}...

loading.phase.finalizing

Finalizing...

loading.phase.complete

Complete!

loading.phase.error

An error occurred

loading.phase.cancelling

Cancelling...

loading.phase.shuttingDownWorld

Shutting down world...

loading.phase.deletingWorld

Deleting world...

loading.phase.shutdownComplete

Shutdown complete

error.processingFailed

Failed to process prefab settings

error.noPrefabsFound

No prefabs found to load

error.existingSession

You already have an active edit session

error.alreadyBeingEdited

Prefab is already being edited: {details}

error.createDirectoryFailed

Failed to create directory: {details}

error.loadFailed

Failed to load prefab

error.prefabLoadFailed

Failed to load prefab: {details}

error.pasteFailed

Failed to paste prefab: {details}

error.exception

Error: {details}

error.failedToStart

Failed to start loading

error.absolutePathNotAllowed

Absolute paths are only allowed in singleplayer

error.pathTraversal

Path traversal is not allowed outside prefab directories

error.shutdownFailed

Failed to shut down the prefab editor world

error.loadingInProgress

Another loading operation is in progress. Please wait for it to complete or cancel.

tp.noPrefabsLoaded

There are no prefabs loaded in your current edit session

save.noPrefabsLoaded

There are no prefabs loaded in your current edit session

save.noPrefabsSelected

No prefabs selected to save

save.noPrefabsFound

No matching prefabs found to save

save.noEditedPrefabs

No modified prefabs found

save.saving

Saving prefabs...

save.progress

Saving prefab {current} of {total}...

save.error

An error occurred while saving

Related Commands

/ambience

Manage ambience in worlds

/assets

Commands related to assets

/backup

Run a backup of the universe

/block

Block-related commands

/blockset

List the block sets and contents

Back to all commands