Skip to content

Expansions Tab

Jump to bottom
BellaStrangeVR edited this page Jul 3, 2026 · 3 revisions

Expansions Tab

The Expansions system allows for modular add-ons that extend Strange Toolkit's functionality.

How Expansions Work

Expansions are self-contained feature packs that live in the Expansions/ folder. Each expansion can provide:

  • UdonSharp behaviors for in-world functionality
  • Editor tools and inspectors
  • Configuration assets

Viewing Installed Expansions

The tab displays:

  1. Expansion Name - Display name from config
  2. Version - Current version number
  3. Description - What the expansion does
  4. Available Behaviors - UdonSharp components you can add to your scene

Status indicators:

  • Green dot - Expansion is properly configured
  • Yellow dot - Expansion folder exists but Config.asset is missing

Adding Expansion Components

  1. Open the Expansions tab
  2. Find the expansion you want to use
  3. Click Add to Scene next to any behavior
  4. Configure the component in the Inspector

Expansion Structure

Each expansion requires:

Expansions/
└── MyExpansion/
    ├── Config.asset          # Required: ExpansionConfig ScriptableObject
    ├── MyExpansion.asmdef    # Recommended: Assembly definition
    ├── Scripts/
    │   └── MyBehavior.cs     # UdonSharp behaviors
    └── Editor/
        └── MyEditor.cs       # Optional: Custom inspectors

ExpansionConfig Properties

Property Description
displayName Name shown in the toolkit
description Brief explanation of features
version Version string (e.g., "1.0.0")
author Creator name
icon Optional texture icon
documentationUrl Optional help link

Creating Your Own Expansion

Step 1: Create the Folder

Create a new folder in Expansions/ with your expansion name.

Step 2: Create the Config

  1. Right-click in your expansion folder
  2. Create > Strange Toolkit > Expansion Config
  3. Fill in the details

Step 3: Add Your Scripts

Create UdonSharp behaviors in your expansion folder. They'll automatically appear in the Expansions tab.

Step 4: Optional Assembly Definition

For better compilation and dependency management:

  1. Create an .asmdef file
  2. Reference VRC.Udon and UdonSharp.Runtime
  3. Reference StrangeToolkit if using toolkit features

Sharing Expansions

Expansions are designed to be shareable:

  1. Zip your expansion folder
  2. Users extract to their Expansions/ folder
  3. The toolkit automatically detects it

Tips for Expansion Developers

Dependencies

  • Check for required components at runtime
  • Provide clear error messages if dependencies are missing
  • Document requirements in your config description

Compatibility

  • Test with the latest Strange Toolkit version
  • Use assembly definitions to manage dependencies
  • Avoid modifying core toolkit files

Documentation

  • Use the documentationUrl field to link to detailed docs
  • Include example setups in your expansion
  • Provide clear instructions in the description

Troubleshooting

Expansion not appearing

  • Ensure Config.asset exists and is a valid ExpansionConfig
  • Check for compile errors in your scripts
  • Verify the folder is directly inside Expansions/

"No expansions found" message

This is normal if you haven't installed any expansions. The base toolkit doesn't include expansions by default.

Scripts not compiling

  • Check assembly definition references
  • Ensure VRChat SDK is properly installed
  • Look for missing using statements

Clone this wiki locally