ThemeEngine

Event-driven theme management system for Unity. Change sprites, audio, and text at runtime with automatic UI updates.

Quick Start

1. Create a Theme Config

Right-click in Project → Create > ThemeEngine > Theme Config

Add your theme assets:

• Sprites: Add keys like "background", "button", "icon"
• Audio Clips: Add keys like "bgm", "click_sound"
• Text: Add keys like "title", "score_label"
• Video Clips: Add keys like "intro_video", "background_video"

2. Add Handlers to GameObjects

For Sprites:

1. Select GameObject with SpriteRenderer
2. Add Component → ThemeSpriteHandler
3. Assign your ThemeConfig
4. Set the key (e.g., "background")

For Audio:

1. Select GameObject with AudioSource
2. Add Component → ThemeAudioHandler
3. Assign your ThemeConfig
4. Set the key (e.g., "bgm")

For Text:

1. Select GameObject with Text component
2. Add Component → ThemeTextHandler
3. Assign your ThemeConfig
4. Set the key (e.g., "title")

For Video:

1. Select GameObject with VideoPlayer
2. Add Component → ThemeVideoHandler
3. Assign your ThemeConfig
4. Set the key (e.g., "intro_video")

Done! The handlers automatically update when theme values change.

Change Theme at Runtime

using Amanotes.Core;

[SerializeField] private ThemeConfig theme;

// Change values - handlers update automatically
theme.SetSprite("background", newSprite);
theme.SetAudio("bgm", newClip);
theme.SetText("title", "New Title");
theme.SetVideo("intro_video", newVideoClip);

// Or get values directly
Sprite bg = theme.GetSprite("background");
AudioClip music = theme.GetAudio("bgm");
string title = theme.GetText("title");
VideoClip video = theme.GetVideo("intro_video");

Listen to Changes (Optional)

void OnEnable()
{
    theme.OnSpriteChanged += HandleSpriteChange;
    theme.OnAudioChanged += HandleAudioChange;
    theme.OnTextChanged += HandleTextChange;
    theme.OnVideoChanged += HandleVideoChange;
}

void OnDisable()
{
    theme.OnSpriteChanged -= HandleSpriteChange;
    theme.OnAudioChanged -= HandleAudioChange;
    theme.OnTextChanged -= HandleTextChange;
    theme.OnVideoChanged -= HandleVideoChange;
}

void HandleSpriteChange(string key)
{
    if (key == "background")
    {
        // Custom logic here
    }
}

Components

• ThemeConfig - ScriptableObject that stores all theme data
• ThemeSpriteHandler - Auto-updates SpriteRenderer
• ThemeAudioHandler - Auto-updates AudioSource
• ThemeTextHandler - Auto-updates Text component
• ThemeVideoHandler - Auto-updates VideoPlayer