Skip to content

badjano/Favourites

 
 

Repository files navigation

Unity Favourites Panel

A Unity editor extension that adds a Favourites panel with a Tree View where you can add categories and drag-and-drop objects from the Hierarchy or Project panel.

Features

  • Tree View Interface: Organize your favourite assets in a hierarchical tree structure
  • Drag & Drop Support: Easily drag objects from Hierarchy or Project panel into categories
  • Category Management: Add and remove categories with the [+] and [-] buttons
  • Quick Access: Double-click items to open them, right-click to locate in Project/Hierarchy
  • Cross-Panel Integration: Drag items from Favourites to other Unity panels (Inspector, etc.)
  • User-Specific Storage: Each user has their own favourites saved in the persistent data path
  • Persistent Data: Favourites are automatically saved and persist between Unity sessions

Installation

Via Git URL (Recommended)

  1. Open Unity Package Manager (Window > Package Manager)
  2. Click the '+' button and select "Add package from git URL"
  3. Enter: git@github.com:badjano/Favourites.git

Via Local Package

  1. Download or clone this repository
  2. In Unity Package Manager, click the '+' button and select "Add package from disk"
  3. Navigate to the package folder and select the package.json file

Usage

Opening the Panel

  • Go to Tools > Favourites > Show Favourites Window in the Unity menu bar
  • The Favourites panel will open as a dockable window
  • The panel automatically refreshes when the Hierarchy or Project changes

Adding Categories

  • Click the [+] button in the Favourites panel toolbar
  • Enter a name for your new category
  • Press Enter or click OK

Adding Items

  • Drag and drop objects from the Hierarchy or Project panel into any category
  • Items will be automatically organized under their respective categories

Managing Items

  • Remove Item: Select an item and click the [-] button
  • Remove Category: Select a category and click the [-] button (removes category and all its items)
  • Open Item: Double-click on any item to open it
  • Expand/Collapse: Double-click on a category to expand or collapse it
  • Locate Item: Right-click on an item to locate it in the Project or Hierarchy panel
  • Drag to Inspector: Drag items from Favourites to component properties in the Inspector
  • Search: Use the search field to filter items by name

Organization

  • Create multiple categories to organize different types of assets
  • Drag items between categories to reorganize
  • Use descriptive category names for better organization

Migration from Old System

If you were using the previous version with ScriptableObject storage:

  • Go to Tools > Favourites > Migrate from ScriptableObject to transfer your existing favourites
  • After migration, you can safely delete the old ScriptableObject assets
  • Your favourites will now be stored in the persistent data path for each user

Data Management

  • View Data Location: Tools > Favourites > Show Data Location
  • Clear All Favourites: Tools > Favourites > Clear All Favourites
  • Migrate from ScriptableObject: Tools > Favourites > Migrate from ScriptableObject
  • Validate Data: Tools > Favourites > Validate ScriptableObject Data
  • Debug Data: Tools > Favourites > Debug Current Data
  • Clean Invalid Entries: Tools > Favourites > Clean Invalid Entries
  • Data is stored at: {Application.persistentDataPath}/FavouritesData.json

Requirements

  • Unity 2021.3 or later
  • No additional dependencies required
  • Editor-only functionality (not included in builds)

License

This project is released into the public domain under the Unlicense.

Contributing

Contributions are welcome! Feel free to submit issues, feature requests, or pull requests.

Changelog

See CHANGELOG.md for version history and updates.

About

Unity Favourites Panel

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C# 100.0%