Skip to content

Kaifungamedev/godot_local_assets_browser

Repository files navigation

Local assets browser

An asset browser for local assets
image

Usage

  1. Click the folder icon in the top right and select the folder that all your assets are in.
  2. Wait for all the assets to appear.
  3. Find the asset you want and click import.
  4. The assets will be in res://Assets/{asset_name}.

Settings

Editor Setting Description
Local_Assets/asset_dir directory to look for the assets. mainly used to keep the same directory across projects
Local_Assets/File_preview_names An array of names for preview files. files must be images.
Local_Assets/use_first_image_found If a file in a does not match any name in Local_Assets/File_preview_names and no Assets.json file is found it will take the first image file it finds and use that.
Local_Assets/use_uniform_image_size force all images to be a uniform size.
Local_Assets/uniform_image_size overrides all image sizes. Requires Local_Assets/use_uniform_image_size to be on.

Troubleshooting

  1. If assets don't show up this could be because the addon looks for image files with a specific name if it can't find a file with that name it skips it. You can add file names in EditorSettings -> Local_Assets -> File_preview_names.
    Alternatively, you can force a directory to be an asset by putting a file named Assets.json in the folder you want to be an asset.
    The Assets.json file must contain the following properties:
          - path - the base path for the asset everything in here will be copied to your project
          - name - the name of the asset that will appear in the browser
          - (Optional) image_path - Preview image
          - (Optional) tags - asset tags image

Upcoming Features

  • Customizable install directory.
  • Tags. (Was implemented but somehow got removed ¯\_(ツ)_/¯)

Have an idea? suggest it here.

Known Issues

None. 😃