This page has been translated automatically.
Video Tutorials
Interface
Essentials
Advanced
How To
Professional (SIM)
UnigineEditor
Interface Overview
Version Control
Settings and Preferences
Working With Projects
Adjusting Node Parameters
Setting Up Materials
Setting Up Properties
Lighting
Sandworm
Using Editor Tools for Specific Tasks
Extending Editor Functionality
Built-in Node Types
Nodes
Objects
Effects
Decals
Light Sources
Geodetics
World Nodes
Sound Objects
Pathfinding Objects
Players
Programming
Fundamentals
Setting Up Development Environment
Usage Examples
C++
C#
UnigineScript
UUSL (Unified UNIGINE Shader Language)
Plugins
File Formats
Materials and Shaders
Rebuilding the Engine Tools
GUI
Double Precision Coordinates
API
Containers
Common Functionality
Controls-Related Classes
Engine-Related Classes
Filesystem Functionality
GUI-Related Classes
Math Functionality
Node-Related Classes
Objects-Related Classes
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
IG Plugin
CIGIConnector Plugin
Rendering-Related Classes
Content Creation
Content Optimization
Materials
Material Nodes Library
Miscellaneous
Input
Math
Matrix
Textures
Art Samples
Tutorials
Warning! This version of documentation is OUTDATED, as it describes an older SDK version! Please switch to the documentation for the latest SDK version.
Warning! This version of documentation describes an old SDK version which is no longer supported! Please upgrade to the latest SDK version.

Cleaner

While working with a project, you create, copy, move, inherit, rename, and delete assets. As a result, an enormous amount of unnecessary files can be created.

Cleaner is a tool used to optimize your project and save disk space by deleting assets that won’t later be used in the final build. Cleaner also checks for corrupted references to assets.

Notice

Cleaner checks each asset that your project contains and displays irregularly used assets divided in three parts:

  • Unused Assets — assets that are not used in any of the files included in your project (worlds, layers, nodes, meshes, materials) and not referenced from code in any of your source files stored in your project source/ folder, but still exist in the project.

    Cleaner shows the file name and asset type for unused assets. As you click an unused asset in Cleaner, it is displayed in the Asset Browser and the Parameters window.
    You can delete any or all of the displayed assets by using the Cleaner functionality.

    The Unused Assets list also includes all assets that were referenced from the unused assets.

  • Lost Assets — the assets referenced to by GUID but are not available in the project.

    As you click a lost asset, the asset containing a reference to it, is displayed in the Asset Browser and the Parameters window. Fixing of lost assets is possible only manually.

    The table in the Lost Assets section has three columns:

    • Lost Asset — shows the GUID of the lost asset.
    • Asset File — shows the name of the file containing the reference to the lost asset.
    • Node Name — shows the name of the node, if the file containing the reference includes the node that actually has a reference to the lost asset.
  • Lost Runtimes — the runtime files generated for the assets that are not available in the project, but referenced by a node/nodes in the scene.

    The table in the Lost Runtimes section has three columns:

    • Runtime Path — shows the path to the lost runtime file.
    • Asset — shows the name of the file containing the reference to the asset, for which the lost runtime file was generated.
    • Node Name — shows the name of the node, if the file containing the reference includes the node that actually has a reference to the asset, for which the lost runtime file was generated.

Information on time spent to complete the Cleaner processes can be printed to the console and the log file: you just need to set the UNIGINE_EDITOR_TIME_TRACE environment variable.

Using Cleaner#

To open the Cleaner window, choose Tools -> Cleaner on the Menu Bar of UnigineEditor.

The Cleaner window will open:

Recommended Workflow#

  1. Click Refresh to check the project for lost and unused assets.

    You can narrow the search scope by specifying a directory in the Directory field: Cleaner will display and manage the lost and unused assets from the specified directory only. To see results after setting (or resetting ) the directory, click Refresh once again.

    After analyzing assets in your project, Cleaner shows the following details.

  2. Manage Unused Assets using the buttons available in the top part of the section:

    • Delete Selected — deletes only the selected assets from the list of unused assets. This option is also available by right-clicking the selected files in Cleaner.
    • Delete Listed — deletes the whole list of currently displayed assets.

      Warning
      Use delete buttons carefully. Deleted assets cannot be restored.
    • Show Ignore List... — displays the ignore list that already contains the default list of wildcards used to define the scope of check by Cleaner. This list can be extended by the user.

      Warning
      If a filename in your project is generated in code (for example, a string concatenated from several words), add such cases to the Ignore List. Otherwise, such files will be deleted.

      Upon clicking the Check button, all project files left after applying the ignore list (i.e. the ones that are not ignored by Cleaner and, thus, will be checked) are displayed in the bottom part of the Ignore List window.

  3. Click Refresh to update the list. Deleting unused assets can reduce the number of lost assets.
  4. Fix Lost Assets. Fixing of lost assets is possible only manually — by checking each asset displayed in the second or third column.
  5. Manage Lost Runtimes using the buttons available in the top part of the section. The buttons are the same as for the Unused Assets:

    • Delete Selected — deletes only the selected runtimes from the list of unused runtimes. This option is also available by right-clicking the selected files in Cleaner.
    • Delete Listed — deletes the whole list of currently displayed runtimes.

      Warning
      Use delete buttons carefully. Deleted files cannot be restored.

Video Tutorial#

Watch the video below to learn how to delete unused assets with the Cleaner tool.

Last update: 2023-08-02
Build: ()