Build a Prefab Library With Prefab Packages

In Foxel, reusable Prefabs are organized in Prefab Packages.

A package is the shared container. The individual Prefabs inside it are the reusable pieces you build, organize, and place later.

Why This Matters

Prefab Packages keep reusable voxel content organized across projects.

Over time, a package can become a reusable object library for props, modular pieces, scene elements, or other voxel content.

Where Prefabs Are Managed

Prefab Packages and their Prefabs are managed on the Prefabs page of the workspace.

On the Prefabs page:

• The left side shows available Prefab Packages.
• The right side shows the Prefabs of the currently open package.

Create or Open a Prefab Package

To create a new Prefab Package:

1. Open the Prefabs page.
2. Use the package controls on the left side.
3. Click New Package.

New Prefab Packages are stored in Foxel's shared files folder, which makes them available across multiple projects.

You can also use the left side of the Prefabs page to open, rename, or delete packages.

Use separate packages to keep reusable content organized. For example, you might keep props, architecture, environment pieces, or project-specific reusable parts in different packages.

Add a Prefab From the Current Selection

Prefabs are created from the current object selection in the scene.

To create a Prefab from selected objects:

1. Select one or more objects in the scene.
2. Make sure the correct Prefab Package is open.
3. Create the Prefab in one of these ways:
   • Open the Prefabs page and click the + button on the right side.
   • Use Object > Create Prefab From Selection.
4. Configure the Prefab in the dialog.
5. Click OK.

Using Object > Create Prefab From Selection lets you stay on the Scene page and use the Hierarchy to select objects.

Foxel generates voxel data from the selected objects and stores the result as a new Prefab in the open package.

Important Dialog Options

In the Create Prefab From Selection dialog, give the Prefab a clear Name.

The most important generation options are:

• Include Descendants: Includes child objects of the selected objects.
• Grid Origin: Controls how the generated Prefab is anchored inside its voxel grid.

You can also add category and description metadata. This becomes useful when a package grows into a larger library or is shared with other users.

Manage Prefabs Inside a Package

The right side of the Prefabs page shows the Prefabs of the currently open package.

There you can select, delete, rename, or open the properties of Prefabs.

Prefab previews are rendered using the colors stored in each Prefab.

Use this area to keep the package tidy as you add more reusable content.

What To Remember

• Prefabs are organized inside Prefab Packages.
• Packages are managed on the Prefabs page.
• New packages are shared resources across projects.
• New Prefabs are created from the current object selection.
• The Prefab is added to the currently open package.
• Include Descendants is important when selected objects contain relevant child objects.
• Grid Origin affects how the Prefab is positioned when placed later.
• Prefab metadata helps keep larger libraries organized.