el4cteo/blender-skills

blender-facial-shapekeys

Facial rigs and shape keys in Blender 5.3 - ARKit 52 blendshapes, visemes for lip-sync, sculpting expressions, splitting symmetric shapes into Left/Right, mirroring, corrective and combination shapes, drivers and control rigs, bone+blendshape hybrids, expor…

Ver código-fonte

Como usar

  1. Copie o comando e verifique o pacote antes de instalar no seu ambiente de agente.
  2. Consulte no original as ferramentas, credenciais e ambientes necessários.
  3. Descreva os dados de entrada e a entrega esperada; confira a saída com as fontes.
npx skills add https://github.com/el4cteo/blender-skills --skill blender-facial-shapekeys

Antes de começar

  • A instalação não inclui assinatura de modelo, franquia API ou acesso aos seus arquivos.
  • Estrelas e instalações indicam atividade, não um teste independente de qualidade ou segurança.
Documento original do Skill

Renderizado do repositório de origem, preservando títulos, exemplos, código, tabelas, links e imagens.

Facial Rig & Shape Keys

The execution model is in blender-core. The body rig is in blender-character-rigging.

Choose the approach

ApproachUseNotes
Blendshapes (ARKit 52)games, VTubers, mocap (iPhone/Live Link Face), web/VRMthe industry interchange set; each shape is sculpted
Bones (jaw, eyes, lids, brows, lips)stylized, low memory, mobilejaw + eyes as bones are almost always right
Hybridmost production game headsjaw/eye/tongue bones + blendshapes for everything soft
Rigify face (human metarig)film-style keyframe animation inside Blender100+ face bones, heavy for engines

Procedure (blendshapes)

  1. The head mesh needs clean loops around the eyes and mouth (blender-retopology-uv), with eyes, teeth and tongue as separate objects parented or weighted to bones.
  2. scripts/shapekeys.py -- --mesh Head --create arkit (or --create visemes for the 15 Oculus visemes) creates empty, correctly named keys.
  3. Sculpt each key (live: sculpt mode on the active key, use_shape_key_edit_mode). Symmetric expressions can be sculpted once, then --split eyeBlink gives eyeBlinkLeft/Right with a soft blend across X=0 (--falloff m).
  4. --mirror browDownLeft builds browDownRight (topology-independent mirror).
  5. --report lists unsculpted keys, the max offset per key, and missing ARKit names. A shape is done only when every key moves and nothing is left over.
  6. Optional: --drivers FaceCtrl adds a controller with 0–1 custom properties driving each key, for keyframing in Blender.
  7. Check the extremes and combinations (jawOpen + mouthSmile, eyeBlink + eyeSquint) with look. Fix them with corrective combination keys driven by the product of two keys.

Shape key rules

  • Shapes are deltas from Basis. Never change the Basis topology after creating keys (adding or removing verts destroys every key).
  • One action per key. No head or neck movement inside face keys (bones do that). Keep eyelids sliding over the eye surface, not through it (check with blender-asset-qa zfighting on lid/eye).
  • Range 0–1. slider_max can be raised for exaggeration, but engines clamp to 0–1.
  • Relative keys (use_relative=True, the default) are the only kind that exports.
  • Name exactly per spec (case-sensitive): eyeBlinkLeft, not EyeBlink_L. Engines map by name.
  • Keys on meshes with Subdivision: sculpt at level 0, and keep the subdivision modifier after the shape keys (they're evaluated first anyway).
  • Applying modifiers on a mesh with shape keys fails. Use modifier_apply_as_shapekey for deform modifiers, or apply them before creating keys.

Correctives and combination shapes

  • Corrective for a bone pose: sculpt in the posed state, then drive with a TRANSFORMS variable (ROT_X, LOCAL_SPACE, mapped to 0–1).
  • Combination: key jawOpen_mouthSmile with driver SCRIPTED expression a*b, from the two key values (SINGLE_PROP key_blocks["jawOpen"].value). Simple expressions don't need Python auto-run.

Engine notes

  • Unity: FBX blendshapes. In the Model importer, set Blend Shape Normals = Calculate (or Import if smoothing was exported). ARKit names map to the AR Foundation face-tracking samples.
  • Unreal: morph targets ("Import Morph Targets"). Live Link Face / MetaHuman Animator use ARKit names, and the Pose Asset maps the curves. No leaf bones.
  • Roblox dynamic heads: FACS-based poses with Roblox-specific names, authored as animation frames on a head rig (Creator Hub "Dynamic heads" spec). Build from the official Blender template. ARKit sculpts can be reused by renaming/mapping. Head ≤ 4,000 tris.
  • VRM / web (three-vrm, ReadyPlayerMe-style): ARKit 52 + visemes as glTF morph targets (export_morph=True). Keep the morph-normal export on only if shading needs it (it doubles the size).
  • Drop unused keys before export. Every key costs memory per vertex (glTF sparse accessors help).

Gotchas

  • ob.shape_key_add(from_mix=False) copies the Basis. from_mix=True bakes the current mix (useful for combos, dangerous by accident).
  • shape_key_mirror(use_topology=False) needs a mesh symmetric on X. Run it on the active key (the script handles this).
  • Driver variables on shape keys use the Key ID (ob.data.shape_keys), not the mesh: fc = kb.driver_add("value").
do mesmo repositório

Mais Skills

Todos os Skills
el4cteo
Comunidade

blender-environment-kits

Game environments in Blender 5.3 - terrain from noise or heightmaps (erosion, terraces, play areas, slope/height materials, 16-bit heightmaps + splat maps for UE/Unity), biome scatter by slope/height/mask with Poisson spacing, modular kit metrics and validation (grid, pivots, seams, texel density). Use for levels, landscapes, forests, modular buildings, dungeons.

Instalações / 1h
4
GitHub Stars
2,5 mil
Atualizado
17 de nov.
el4cteo
Comunidade

blender-geometry-nodes

Geometry Nodes in Blender 5.3 - fields, domains, attributes, instancing, zones (simulation/repeat/for-each), closures/bundles, lists, SDF grids, node tools, baking, plus a JSON-to-node-tree builder and socket inspector. Use for scattering, procedural assets/environments, parametric tools and modifier inputs.

Instalações / 1h
4
GitHub Stars
2,5 mil
Atualizado
17 de nov.
el4cteo
Comunidade

blender-lighting-lookdev

Lighting, cameras and look-dev in Blender 5.3 - studio 3-point and product lighting, HDRI environments, sun/sky exteriors, interiors, light linking, physically based light units, camera focal lengths/composition/DOF, cyclorama backdrops, looping turntables for asset presentation. Use when presenting assets, setting up scenes for rendering, or judging materials under consistent light.

Instalações / 1h
4
GitHub Stars
2,5 mil
Atualizado
17 de nov.
el4cteo
Comunidade

blender-rendering

Render with Blender 5.3 Cycles/EEVEE/Workbench - quality presets, GPU setup, adaptive sampling, denoising, light paths, color management (AgX, Khronos PBR Neutral, ACES), PNG/EXR/MP4 output, passes, the 5.0 compositor API, CLI and multi-camera batch rendering. Use for any still, animation or turntable render.

Instalações / 1h
4
GitHub Stars
2,5 mil
Atualizado
17 de nov.