Library

The Library is your workspace's shelf of files: characters, outfits, vehicles, props, plants, sets, texture sets, HDRIs and references that every member can find and reuse in any project. It appears in the left rail once Root has turned it on for your workspace.

Each file in the Library is an item. An item has a name, a category, tags and info fields (a character's body type and height, a vehicle's livery, a plant's species). An item keeps its versions: v1, v2, v3 and so on. One version is current, and that is the one everyone gets unless they choose another.

1. Open Library from the left rail.
2. Under Upload a file, pick a file, give it a name, a category and tags, and press Upload.
3. Search by name, category, tag, Collection or an info field, and press Search. Order puts the items by Last changed or Name. Clear empties the search. More shows the next page.
4. Open an item to see its current version, edit its Details (name, tags, Description and info fields) and press Save.

On an item's page, Versions lists every version with its note. Upload a new version under New version, with a note such as "new livery". Make current is ticked, so it becomes the current one; untick it to keep the current one as it is. Each older version has Make v current with its number (Make v2 current, say), which puts it back. Every change is in the Change log, with who and when.

Links say how items belong together. On an item's page, under Links, pick what This item is: Variant of, Outfit for, Lower detail version of or Texture set for. Then find the Item, Pick it and press Link. Unlink removes one.

An outfit can only be an outfit for a character, a lower detail version must be in the same category, and links can't go round in a loop. The other item's page lists the link too, as Outfits for this character, Variants, Lower detail versions or Texture sets.

Collections group items. On the Library page, type a New collection name, pick its Kind and press Create. A kit is a collection of parts meant to be put together, such as the walls of a set.

Open a collection to see only its items, or press Delete collection; deleting it never deletes its items. On an item's page, Add to a collection and press Add, or Remove it from one. In a kit, give each part a role, such as wall corner, and press Save role.

An item's page lists the projects it is Used in. Pick a Project and press Add to project to use the item there by reference. The project then follows the current version, so a fix made once in the library reaches it. Keep this project on v3, say, holds that project to one version; Follows the current version lets it follow again. Remove from project ends the use.

Copy into project instead gives the project its own copy of the file, no longer linked to the library. A project the item is used in but you can't open is counted, never named.

Add to library on a file in a project's Assets copies that file into the Library. It works on a tile, a 3D model or a project file, as a New item or as a New version of an item. The file stays in its project. A file from a private project shows "Everyone in the workspace will be able to see this file." first, because everyone in the workspace can see the Library.

Library categories, in Settings, is where a workspace admin adds, renames, moves and removes categories (Move up, Move down, Rename, Remove), and adds or removes info fields. Type a New field name, pick its type (for a list, type its Choices), and press Add field; type a New category name and press Add category. A field can be text, a number with a unit, one of a list, several of a list, or yes or no. Changing a field never changes what is already stored; a value that no longer fits shows as needs checking on its item.

Delete item and Delete on a version can be undone for 30 days (Undo, or Deleted in the last 30 days on the Library page). Deleted files still count toward your storage until then. The current version can't be deleted: make another version current first. Anyone can add and edit items; deleting an item is for the person who added it and workspace admins.