Installing Plugins

Installing from the Marketplace

1. In the editor, open Plugins in the left toolbar (puzzle-piece icon), or go to View → Plugins
2. Switch to the Marketplace tab
3. Browse or search the catalog
4. Click the plugin card to see its detail page — read the description, permission list, and reviews
5. Click Install (for free plugins) or Buy & Install (for paid plugins)
6. The plugin activates immediately in the current project — no editor restart required

Alternatively, install from the Dashboard:

1. Go to Account → Plugins → Browse Marketplace
2. Click Install — the plugin is added to your library and becomes available in all projects

Installing a Plugin to a Specific Project

By default, an installed plugin is added to your library but not auto-enabled in existing projects. To enable it in a project:

1. Open the project in the editor
2. Open Plugins → Installed tab
3. Find the plugin in your library and click Add to project
4. Configure any required settings in the plugin's inspector panel

Private Plugins

If you've built a custom plugin using the Plugin SDK, you can upload it to your account:

1. Package your plugin with shapebox-cli build
2. Go to Account → Plugins → My Plugins → Upload
3. Drag the .sbpkg file into the upload area
4. After a brief automated check, the plugin appears in your library

Private plugins are only visible to you (or your Team workspace if you choose to share them).

Plugin Configuration

Many plugins require or offer configuration. After adding a plugin to a project:

1. Open the Plugins panel in the editor
2. Click the gear icon next to the plugin name
3. Fill in the global plugin settings (e.g., API keys, default values)

Per-object settings are configured through the Inspector when an object is selected — plugins can add their own sections to the Inspector.

Enabling and Disabling

You can disable a plugin in a project without uninstalling it. Disabled plugins have no effect on the scene and consume no resources.

1. Open Plugins → Installed in the editor
2. Toggle the switch next to the plugin name

Re-enabling restores all previously configured settings.

Uninstalling

To remove a plugin from your library entirely:

1. Go to Account → Plugins → My Plugins
2. Find the plugin and click Uninstall

Note: Uninstalling a plugin won't retroactively break scenes that used it — missing plugin behaviors are gracefully ignored at runtime. However, custom objects or properties added by the plugin may lose their visual configuration in the editor.