Blender Archetype Library
Workflow
- Choose an archetype by desired feel: wobble, flow, hard, or bullet.
- Select background/foreground/mask effects per archetype from the lists below.
- Ensure 1-2 reactive layers; avoid 0 or 3 reactive layers.
- Tune brightness and speed by role (background low, foreground primary, mask structural).
- Apply scene-specific overrides only on schema-supported keys.
Blender Layer Rules
Background → ambient texture (low brightness ≤ 0.7, low reactivity ≤ 0.3)
Foreground → primary visual (main color/motion)
Mask → MUST be audio-reactive (controls pixel reveal)
⛔ Never use as mask: gradient, fade, singleColor, rainbow, random_flash
(These are Non-Reactive in LedFX — they produce static, lifeless blenders)
Effect Selection by Role
✅ Valid Mask Effects (audio-reactive)
Beat-locked (tightest): bar, strobe, real_strobe, multiBar
Frequency spectrum: energy, equalizer, wavelength, bands, spectrum, pitchSpectrum, filter, magnitude
Color zones: scroll, scroll_plus, hierarchy, rain
Subtle: vumeter, glitch
✅ Good Foreground Effects
Flowing: fire, lava_lamp, melt, water, crawler, energy2, melt_and_sparkle, marching
Directional: scan, scan_and_flare, scan_multi, scroll, blade_power_plus
2D matrix: plasma2d, plasmawled, concentric, flame2d, equalizer2d, soap2d
Beat-driven: bar, strobe, keybeat2d, power
✅ Good Background Effects
Non-reactive (pure ambient): gradient, fade, singleColor, rainbow
Soft reactive: lava_lamp (low reactivity), fire (low intensity), noise2d, blocks, digitalrain2d
Archetypes
Wobble Bed
- Feel: calm, musical, warm
- Background:
gradient or fade
- Foreground:
lava_lamp or melt
- Mask:
wavelength or scroll
Flow Mist
- Feel: soft, flowing, melodic
- Background:
fade or gradient
- Foreground:
water or crawler
- Mask:
hierarchy or energy
Hard Cut Reactor
- Feel: contrast, aggressive, rhythmic
- Background:
singleColor or blocks
- Foreground:
melt_and_sparkle or energy2
- Mask:
bar or strobe
Bullet Tunnel
- Feel: directional, high-velocity, laser
- Background:
gradient or singleColor
- Foreground:
scan or scroll
- Mask:
equalizer or scroll_plus
Guardrails
- Avoid dual strobe behavior in foreground + mask simultaneously.
- Keep mask for structure, not constant noise.
- Keep background readable and not dominant.
- For 2D virtuals only: can use Matrix effects (
plasma2d, plasmawled, waterfall2d, concentric) in any role.
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: blender-archetype-library3description: Apply reusable blender scene archetypes (wobble, flow, hard, bullet) with controlled layer behavior. Use when designing or refactoring LedFX blender scenes and masks for readable yet high-impact DJ visuals. Use when this capability is needed.4---56# Blender Archetype Library78## Workflow91. Choose an archetype by desired feel: wobble, flow, hard, or bullet.102. Select background/foreground/mask effects per archetype from the lists below.113. Ensure 1-2 reactive layers; avoid 0 or 3 reactive layers.124. Tune brightness and speed by role (background low, foreground primary, mask structural).135. Apply scene-specific overrides only on schema-supported keys.1415## Blender Layer Rules16```17Background → ambient texture (low brightness ≤ 0.7, low reactivity ≤ 0.3)18Foreground → primary visual (main color/motion)19Mask → MUST be audio-reactive (controls pixel reveal)20```2122**⛔ Never use as mask**: `gradient`, `fade`, `singleColor`, `rainbow`, `random_flash` 23(These are `Non-Reactive` in LedFX — they produce static, lifeless blenders)2425## Effect Selection by Role2627### ✅ Valid Mask Effects (audio-reactive)28**Beat-locked (tightest):** `bar`, `strobe`, `real_strobe`, `multiBar` 29**Frequency spectrum:** `energy`, `equalizer`, `wavelength`, `bands`, `spectrum`, `pitchSpectrum`, `filter`, `magnitude` 30**Color zones:** `scroll`, `scroll_plus`, `hierarchy`, `rain` 31**Subtle:** `vumeter`, `glitch`3233### ✅ Good Foreground Effects34**Flowing:** `fire`, `lava_lamp`, `melt`, `water`, `crawler`, `energy2`, `melt_and_sparkle`, `marching` 35**Directional:** `scan`, `scan_and_flare`, `scan_multi`, `scroll`, `blade_power_plus` 36**2D matrix:** `plasma2d`, `plasmawled`, `concentric`, `flame2d`, `equalizer2d`, `soap2d` 37**Beat-driven:** `bar`, `strobe`, `keybeat2d`, `power`3839### ✅ Good Background Effects40**Non-reactive (pure ambient):** `gradient`, `fade`, `singleColor`, `rainbow` 41**Soft reactive:** `lava_lamp` (low reactivity), `fire` (low intensity), `noise2d`, `blocks`, `digitalrain2d`4243## Archetypes4445### Wobble Bed46- **Feel**: calm, musical, warm47- **Background**: `gradient` or `fade`48- **Foreground**: `lava_lamp` or `melt`49- **Mask**: `wavelength` or `scroll`5051### Flow Mist52- **Feel**: soft, flowing, melodic53- **Background**: `fade` or `gradient`54- **Foreground**: `water` or `crawler`55- **Mask**: `hierarchy` or `energy`5657### Hard Cut Reactor58- **Feel**: contrast, aggressive, rhythmic59- **Background**: `singleColor` or `blocks`60- **Foreground**: `melt_and_sparkle` or `energy2`61- **Mask**: `bar` or `strobe`6263### Bullet Tunnel64- **Feel**: directional, high-velocity, laser65- **Background**: `gradient` or `singleColor`66- **Foreground**: `scan` or `scroll`67- **Mask**: `equalizer` or `scroll_plus`6869## Guardrails70- Avoid dual strobe behavior in foreground + mask simultaneously.71- Keep mask for structure, not constant noise.72- Keep background readable and not dominant.73- For 2D virtuals only: can use Matrix effects (`plasma2d`, `plasmawled`, `waterfall2d`, `concentric`) in any role.7475---76> Converted and distributed by [TomeVault](https://tomevault.io/claim/abossard) — claim your Tome and manage your conversions.77<!-- tomevault:4.0:skill_md:2026-04-13 -->