Skip to content
Dennis edited this page Nov 12, 2024 · 3 revisions

Unity-Custom-Folder-Icons Wiki

Welcome to the Unity-Custom-Folder-Icons Wiki! This Unity editor extension allows you to assign custom icons to folders within the Unity Project window, making it easier to organize and visually distinguish assets. This guide provides instructions for installation, usage, and customization options.


Installation

Step 1: Download the Unity Package

Navigate to the Releases section of this repository on GitHub, and download the latest .unitypackage file for Unity-Custom-Folder-Icons.

Step 2: Import the Package into Your Unity Project

  1. Open your Unity project.
  2. Go to Assets > Import Package > Custom Package....
  3. Select the downloaded .unitypackage file, and import all included files.

Step 3: Access the Menu in Unity

Once the package is imported, you’ll find the new menu items for managing folder icons under Assets > CustomFolderIcons in the Unity Editor.


Usage

Setting a Custom Icon for a Folder

  1. Select a Folder: In the Unity Project window, select the folder you want to customize.
  2. Open Custom Icon Menu: Go to Assets > Mineral > Custom Icon.
  3. Choose an Icon: Use the Object Picker to select a sprite as the folder icon. The selected icon will now be displayed on the chosen folder.

Setting a Predefined Icon (e.g., Red Icon)

  1. Select a Folder: Select a folder in the Project window.
  2. Set Red Icon: Go to Assets > Mineral > Red. The folder icon will change to a predefined red icon.
  3. Resetting the Folder Icon

Select a Folder:

  1. Choose the folder you wish to reset.
  2. Reset Icon: Go to Assets > Mineral > Reset Icon. This will restore the folder’s icon to the default Unity icon.

image


CustomizationOptions

Folder Icon Storage

  • Data Path: Custom icon data is saved in a JSON file located at Assets/CustomFolderIcons/Data/MineralData.txt. This file stores icon preferences, ensuring that custom icons persist between Unity sessions.

Adding New Icon

To add new icon :

  1. Place New Icons: Save new icon sprites in the Assets/CustomFolderIcons/Icons folder.