GameResource Extensions - s&box Assets Documentation

GameResource Extensions

Extend GameResource types with additional data. Create extensions that attach to existing resources like models or sounds.

Creating a ResourceExtension

Create an extension class:

[GameResourceExtension( "model" )]
public class ClothingExtension : GameResourceExtension
{
    public List<ClothingItem> Clothing { get; set; }
    public int CostToUnlock { get; set; }
}

Extending Assets

Attach to assets in the editor:

1. Select a model in Asset Browser
2. Look for the extension in the inspector
3. Fill in the extension data
4. Save the asset

Accessing a ResourceExtension

FindForResourceOrDefault

Get extension or create default:

var ext = ClothingExtension.FindForResourceOrDefault( model );

FindForResource

Get extension only if it exists:

var ext = ClothingExtension.FindForResource( model );
if ( ext != null )
{
    // Use extension data
}

FindAllForResource

Get all extensions of a type:

var allExts = ClothingExtension.FindAllForResource( model );

FindDefault

Get the default extension:

var default = ClothingExtension.FindDefault();

Use Cases

• Clothing data for characters
• Weapon stats
• Sound variations
• Asset metadata