Resource Browser

Godot Editor Addon which adds configurable resource browser panel(s) to the Editor bottom panel.

For Godot 4 stable

Features

• Drag and drop support; Adding resource filesystem locations to panels and drag and dropping resources to scenes etc. (Everywhere that a drag and drop from the stock FileSystem panel can.)
• Configurable amount of panels.
• Each panel is separate and has separate search results. Each panel is configured separately. Configuration includes:
  • Panel name
  • Locations/directories where to search files.
  • Filters, possible to filter by file extension0 (eg. mesh, tres) or type (eg. Mesh, Material).

Installation

1. Download this repository
2. copy addons/ to your projects addons folder
3. Enable the addon in the Project Settings

Not in AssetLib for now.

Usage & configuration

Videos below!

A new panel called "Resource Browser" should appear in the bottom panel after enabling this addon.

On each panel, you can search items, and filter what kind of files the panel shows by setting filters. Each panel has it's own configuration of search paths and filters.

Adding, removing and modifying panels

The Addon creates a single panel by default. By Clicking on the "Cog" button on the panels top right, you can open global settings dialog.

From there you can modify, add and remove panels, as well as change some settings.

Currently the settings are:

• Parse custom resource classes: whether to parse files for custom resource classes when filtering by type.
  • Only parses classes from resources which are in text format (eg. the file starts with [gd_resource .)
  • Disabled by default because it is slower and can take too long with many files.
  • Reason being that EditorFileSystem does not give a method to get scripted class from a file, thus requiring to parse the file manually

Configuring panels

Panels themselves can be configured by unlocking the panel by clicking the lock button located on the panels top left corner.

After unlocking the panel, you can drag and drop folders from the editor filesystem to the Resource Browser locations tree, which is on the left side of the panel.

On each panel, You can search items, and filter what kind of files the panel shows by setting filters. Each panel has it's own set of filters which can filter results by file extension (mesh, tres), or type (Mesh, Material).

All filters can be added/removed when the panel is unlocked:

• File extension filters are added by opening the filter menu with "Extension Filters" button, and typing the name in the input box there, and submitting the text (Enter).
  • Removing filter happens by clicking the filter entry in the list
• File type filters are added by writing in to the input box right of the "Type Filters" button. The panel the suggests types to add. The desired type can be selected from the list with mouse, or arrow keys and accept button (Enter).
  • After adding a type, it is visible in the menu that appears when clicking the "Type Filters" button.
  • Removing a type filter likewise happens by selecting the filter name in the "Type Filters" menu.

The filters are meant to be set once per panel, and not to be changed with every search. The idea is to add multiple panels for multiple file types, for example a "Model Browser", and a "Material Browser".

Note: Each browser has its configuration saved at res://addons/resource-browser/browser_config_<panel_internal_name>.json, while the global browser list is saved at res://addons/resource-browser/browsers.json

Quick usage example videos:

Configuration and search usage:

Drag and drop from panel to scenes:

License

Copyright © 2023 Okxa & contributors.

Unless otherwise specified, files in this repository are licensed under the MIT license. See file LICENSE for more information.