KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #cli #open-source #ai #claude-code #codex #developer-tools #react #windows #deepseek-harness #ai-agent

godot-asset-placer

★ 236 Open GitHub ↗

Godot 3D Asset Placer And Manager

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![](https://dcbadge.limes.pink/api/server/https://discord.gg/UyYCp53Hym)](https://discord.gg/UyYCp53Hym)

![GitHub Release](https://img.shields.io/github/v/release/levinzonr/godot-asset-placer)
![Godot4](https://img.shields.io/badge/Godot-4.6-blue)
![Godot4](https://img.shields.io/badge/Godot-4.5-blue)
![Godot4](https://img.shields.io/badge/Godot-4.4-blue)
![Godot4](https://img.shields.io/badge/Godot-4.3-blue)

# Godot Asset Placer

This is Godot Editor plugin that allows for quick asset placement and management when working with large 3D Scenes.

> Please report any issues you encounter. Feature suggestions are welcome as well.

## Features

- One-Click Asset Placement with Snapping to Ground, Collision shapes and Terrain3D Surfaces
- [Quick Preview Node Transformations Before Placement](https://github.com/levinzonr/godot-asset-placer/blob/main/README.md#transforming-assets-before-placement)
- **In Place Transform Mode** - Apply transformations to existing nodes in the scene using Asset Placer workflow
- **Settings Panel** - Comprehensive customization options including key bindings, preview materials, and transform steps
- **Random Asset Placement** - Automatically select random assets from filtered list after each placement
- **Advanced Placement Options** - Normal alignment and scene bottom alignment controls
- Organize Assets into collections for quick access and filtering
- **Auto-Grouping** - Automatically group placed assets under nodes named after their primary collection
- **Parent from selection** - Optionally derive the Assets Parent from the selected `Node3D` so new assets are placed as siblings (see Options)
- **Folder Rules** - Configure rules to automatically assign collections when syncing asset folders
- **Asset palettes** - Shortcuts to your most used assets right under your fingertips (same asset can live in multiple palettes; active palette shown in the viewport overlay)
- **Toggle Asset Placer** - Enable or disable placement mode from the 3D viewport with a configurable shortcut (default: `Shift+A`)
- **Asset library sorting** - Sort assets by name, date added, or last placed, with ascending or descending order
- **Custom thumbnail rendering** - Generated previews with cache storage and a regeneration option in Settings
- Filter Assets by their name and collection
- Grid snapping when placing assets
- Randomize asset Rotation and Scale on placement
- Undo-Redo Integration
- In Editor Update when new release is published on GitHub

![addon_preview.png](https://raw.githubusercontent.com/levinzonr/godot-asset-placer/main/docs/assets/addon_preview.png)

## Installation

1. There are several ways to install the addon:

- [Godot Asset Store](https://store.godotengine.org/asset/levinzonr/godot-asset-placer/) — search for "Godot Asset Placer" on the store
- [Godot Asset Library](https://godotengine.org/asset-library/asset/4244) (in-editor) or by searching for "Godot Asset Placer"
- [GitHub Releases page](https://github.com/levinzonr/godot-asset-placer/releases) — download the latest release
- Manually by cloning the repository

No matter which method you choose, the remaining steps are the same

2. Copy the `addons/asset_placer` folder into your Godot project under the `addons` directory. (The Godot Asset Store and Asset Library will do this automatically.)
3. Enable the plugin in the Godot Editor by going to `Project` -> `Project Settings` -> `Plugins` and enabling the `Asset Placer` plugin.

## Usage

### Adding Assets

Right now the plugin relies on user selecting the folders where your assets are located so that not every scene is added automatically.
You can folders to sync by either Drag And Droping the folder or  using "Add folder button" within Folders Tab
![addon_folders.png](https://raw.githubusercontent.com/levinzonr/godot-asset-placer/main/docs/addon_folders.png)

On the **Assets** tab you can sort the library by name, date added, or last placed, and flip between ascending and descending order using the sort controls.

### Folder Rules

> Available since version 1.3.0

Folder Rules allow you to automate actions when syncing asset folders. Rules are configured per-folder and can be combined to create powerful workflows.

![](https://raw.githubusercontent.com/levinzonr/godot-asset-placer/main/docs/assets/folder_rules_preview.png)

**Available Rules:**

- **Add to Collection** - Automatically assign synced assets to a specific collection
- **Filter by Name** - Only include assets whose filename contains specified text

To configure rules, click the "Rules" button on any folder in the Folders tab to expand the rules panel.

### Asset Palettes

Asset Palettes give you quick-access rows of your most-used assets. Configure them in the dock, then switch and place from the 3D viewport without returning to the asset library.

#### Configuration

Open the **Palette** tab in the Asset Placer dock to define palettes and assign assets to numbered slots.

![](https://raw.githubusercontent.com/levinzonr/godot-asset-placer/main/docs/assets/palette_panel.png)

- Each palette has **10 numbered slots** (keys **1**–**9**, then **0**)
- Click a slot to pick an asset from the library; **right-click** a filled slot to clear it
- Use **New Palette** to add another row; the same asset may appear in more than one palette
- Delete a palette with the trash control; deleting the last palette **clears its slots** instead of removing the row
- Adjust slot size with **Asset Palette Item Scale** in [Settings](#settings-panel) (default: 1.0)

Palette data is saved with your Asset Placer configuration.

#### Viewport overlay

While placement mode is active, the viewport overlay shows the active palette and its slot shortcuts so you can swap assets without opening the dock.

![](https://raw.githubusercontent.com/levinzonr/godot-asset-placer/main/docs/assets/overlay.png)

- The header shows which palette is active (for example, **Palette #1**)
- Press **1** through **9**, then **0**, to select the asset in that slot
- When you have more than one palette, cycle with **Tab** / **Shift+Tab** (configurable in Settings); cycling skips palettes with no assets assigned
- Use **Toggle Asset Placer** (default: **Shift+A**) to turn placement mode on or off from the viewport

### Placing Assets

Godot Asset Placer provides various placement modes. All methods rely on RayCasting to determine where to place the asset.

Placement Modes can be cycled using `Q` Shortcut

#### Surface Collisions (Default)

This mode requires your scene to have Collision Objects (StaticBody3D, CollisionShape3D, etc.) in order to place assets on surfaces. This mode is useful when your scene already has some kind of physical floor and you want your assets placed directly onto it.

#### Plane Collisions

This mode allows you to place assets on an infinite plane at a specified height. This is useful for quickly placing assets in an empty scene or when you want to place assets at a specific height without relying on existing geometry. This plane has a configurable Normal and Point Of origin.
You can quickly enter this mode by pressing `Q` while in placement mode.

If you want to configure Plane Options (Normal and Origin) you can do so within Options Sub View or with `W` Translate Mode
This will allow to move the plane origin using Mouse Wheel along selected Axis

#### Terrain 3d Placement

This mode allows you to place assets directly onto a Terrain3D surface. When selected you will be prompted to select your Terrain3D node. After that the plugin will user Terrain3D surfaces to resolve placement location.

#### Placement Steps

To place an asset, follow these steps:

1. Navigate to the 3D Scene of your choice
2. Optional: Change Placement Mode. By default, the Plugin uses Surface Collision mode, you can change it within Options Sub View
3. Open Asset Placer Dock window and select the asset you want to place from the Assets tab
4. Optional: Set **Assets Parent** under the selected root, or enable **Use selection for parent** so the parent is taken from the current `Node3D` selection (sibling placement). Picking **Assets Parent** disables selection-based mode.
5. Optional: Configure Placement Options:
   - **Align Normals** - Enable to align assets with surface normals for natural placement on sloped surfaces
   - **Use Assets Origin** - Enable to place using asset's local origin point, or disable to use the asset's actual bottom
6. At this point you will see a preview of the asset in the 3D viewport
7. Press `Left Mouse Button` to place the asset at the location of the mouse cursor
8. If you want to modify the asset after placement, you can press `Shift` + `Left Mouse Button` to Place And Focus on the Placed Asset. This allows you to move, rotate, or scale the asset using the standard Godot Editor tools.

#### Random Asset Placement

You can enable random asset placement in the Asset Placement Options. When enabled, after each placement, a new asset will be randomly selected from the currently filtered list of assets in the Assets Panel. This is useful for quickly populating scenes with varied assets.

> ⚠️ This feature is experimental and may require further improvements in the future.

#### Auto-Grouping by Collection

> Available since version 1.3.0

When enabled in the Asset Placement Options, placed assets will automatically be grouped under Node3D nodes named after their **primary collection**. This keeps your scene tree organized without manual effort.

For example, if you have assets assigned to "Trees" and "Rocks" collections:

```
- Parent (your selected parent node)
	- Trees (auto-created group)
		- Tree(1)
		- Tree(2)
	- Rocks (auto-created group)
		- Rock(1)
		- Rock(2)
```

Assets without a primary collection will be placed directly under the parent node. See [Primary Collections](#primary-collections) for how to set the primary collection for your assets.

#### Transforming Assets Before Placement

1.1.0 introduces the ability to modify the preview of the asset before placement. This includes options for rotation and scaling, allowing users to visualize how the asset will appear in the scene prior to placement, do quick and precise adjustment modifications.
![addon_viewport_controls.png](https://raw.githubusercontent.com/levinzonr/godot-asset-placer/main/docs/addon_viewport_controls.png)
Specific transformation mode can be enabled by pressing button while in placement mode (Asset is selected) and transformations can be applied by Mouse Wheel:

- `Mouse Wheel Up`: "Positive" transformation
- `Mouse Wheel Down`: "Negative" transformation

Following transformations are supported:

- `E` to rotate (Default axis is Y)
- `R` to scale (Uniform Scale by default, All axis at once)
- `W` to translate (Default axis is Y) - Activates `Plane Placement Mode`

This also requires an ability to select active Axis for the transformation. This can be done by pressing following keys:

- `X` to select X axis
- `Y` to select Y axis
- `Z` to select Z axis

#### In Place Transform Mode

1.2.0 introduces **In Place Transform Mode**, which allows you to apply transformations to existing nodes in your scene using the same Asset Placer transformation workflow. This is useful when you want to adjust nodes that are already placed in your scene.

To use In Place Transform Mode:

1. Select a Node3D in the scene tree
2. Press `Shift+E` (default shortcut, configurable in Settings) to enter In Place Transform Mode
3. Use the same transformation shortcuts (`E` for rotate, `R` for scale, `W` for translate) to modify the selected node
4. Use `X`, `Y`, `Z` keys to select the transformation axis
5. Apply transformations with Mouse Wheel Up/Down

The viewport overlay will display the current transformation mode and active axis, just like in preview placement mode.

### Organizing Assets

You can organize your assets into Collections. Collections is a simple way to "group" assets together by some criteria. For example, you can create a collection for all the trees in your scene, or all the rocks, etc.
To create a collection navigate to the Collections tab, choose a name and color. Then you can assign assets into one or more collections, either by using a options menu or dragging and dropping assets into the window while Collection Filter is active.

![](https://raw.githubusercontent.com/levinzonr/godot-asset-placer/main/docs/assets/collections_panel.png)

#### Collection Management

> Available since version 1.3.0

The Collection Management dialog provides a streamlined way to assign and remove collections from multiple assets at once.

![](https://raw.githubusercontent.com/levinzonr/godot-asset-placer/main/docs/assets/cm_preview.png)

**Features:**

- **Batch Selection** - Select multiple assets using Shift+Click (range) or Ctrl/Cmd+Click (multi-select)
- **Quick Assignment** - Add or remove collections from all selected assets with one click
- **Visual Feedback** - See which collections are fully assigned, partially assigned, or available

To open the Collection Management dialog:

- Click "Manage Collections" button in the Collections tab
- Right-click an asset and select "Manage Collections"

#### Primary Collections

> Available since version 1.3.0

Each asset can have one **primary collection** that determines how it's grouped when using [Auto-Grouping](#auto-grouping-by-collection).

![](https://raw.githubusercontent.com/levinzonr/godot-asset-placer/main/docs/assets/manage_collections.png)

**Setting a Primary Collection:**

- In the Collection Management dialog, assigned collections show a star icon
- Click the star to set that collection as primary / Click Again to reset it

When multiple assets are selected, the star button is always visible for easy batch assignment of primary collections.

### Settings Panel

Version 1.2.0 introduced a dedicated Settings Panel for comprehensive customization of the Asset Placer plugin.
![](https://raw.githubusercontent.com/levinzonr/godot-asset-placer/main/docs/assets/settings_panel.png)

#### General Settings

- **Preview Material** - Choose your own Material3D resource or disable preview materials entirely
- **Plane Material** - Customize the appearance of the plane used in Plane Placement Mode (Project-level setting)
- **Transform Step** - Configure the amount of rotation/scale applied per Mouse Wheel step
  - Rotation Step (default: 5 degrees)
  - Scale/Translate Step (default: 0.1 units)
- **Thumbnail UI Scale** - Adjust the size of thumbnails in the Assets Panel (default: 1.0)
- **Regenerate Thumbnails** - Rebuild generated asset previews from Settings when needed
- **Asset Palette Item Scale** - Adjust the size of palette buttons in both the Palette tab and viewport overlay (default: 1.0)
- **Plane Mode Toggle** - Configure plane placement mode behavior
- **Asset Library Path** - Set a custom location for the `asset_library.json` file, useful for version control and team sharing
- **Update channel** - Choose Stable, Beta, or Alpha so in-editor update checks match the release tier you follow. More detail: [development lifecycle](https://levinzonr.github.io/godot-asset-placer/development-lifecycle/)

#### Key Bindings

Customize shortcuts for all Asset Placer actions:

- Rotate (Default: `E`)
- Scale (Default: `R`)
- Translate (Default: `W`)
- Cycle Placement Modes (Default: `Q`)
- Toggle Snapping (Default: `S`)
- Toggle X, Y, Z Axis (Default: `X`, `Y`, `Z`)
- Transform Apply (Default: Mouse Wheel Up/Down)
- In Place Transform Mode (Default: `Shift+E`)
- Palette Next (Default: `Tab`)
- Palette Previous (Default: `Shift+Tab`)
- Toggle Asset Placer (Default: `Shift+A`)

Key bindings support Mouse Button and Modifier Combinations (Ctrl, Shift, Alt), allowing you to avoid conflicts with existing Godot shortcuts. The Settings Panel includes conflict detection that will highlight conflicting keys in red.

All settings are persisted across Godot sessions within EditorSettings and apply to all your projects.

## Known Issues

- So far the plugin only supports placeable scenes and models with these extensions: `tscn`, `scn`, `glb`, `gltf`, `obj`, `fbx`, and `blend`. If you would like other formats supported, please open an issue.
- Some generated thumbnails may still look imperfect depending on asset complexity, materials, and scene setup

## Contributing

Found a problem or have an idea?

- [🐛 Report a bug](https://github.com/levinzonr/godot-asset-placer/issues/new?template=bug_report.md&labels=bug&title=%5BBUG%5D%20)
- [✨ Request a feature](https://github.com/levinzonr/godot-asset-placer/issues/new?template=feature_request.md&labels=enhancement&title=%5BFeature%5D%20)
- [📖 Contributing guidelines](CONTRIBUTING.md)

## Changelog

See the [CHANGELOG.md](CHANGELOG.md) for a full list of changes and updates.

godot-asset-placer

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README