AGENT SKILL

uv-workflow

Production UV unwrapping for seam placement, UV packing, texel density, UDIM, lightmap UVs, and modular UV layouts. Use when preparing meshes for texturing and engine export in Blender via MCP.

License 许可
MIT
最近更新
2026-11-14
Stars
★ 3
Forks
0

01 前言 Front Matter

name
uv-workflow
license
MIT
metadata
{ "role": "specialist", "author": "https://github.com/arjun988", "domain": "blender", "version": "1.0.0", "triggers": "UV, unwrap, seam, texel density, UV pack, UDIM, lightmap UV, UV layout", "related-skills": "texture-workflow, materials, export-pipeline" }
description
Production UV unwrapping for seam placement, UV packing, texel density, UDIM, lightmap UVs, and modular UV layouts. Use when preparing meshes for texturing and engine export in Blender via MCP.

02 资源文件 2

03 SKILL.md 正文

UV Workflow

Efficient UV layouts with consistent texel density. Seams at hidden edges. Engine-ready.

When to Use

  • After topology locked, before texturing
  • Modular kit UV atlas planning
  • Lightmap UV channel setup
  • UDIM workflows for hero assets

Workflow

UV Planning → Seam Marking → Unwrap → Texel Density Check
    → Pack → Mirror/Overlap Decision → Lightmap UV (if needed) → Validation

Seam Placement Rules

Place seams at:

  • Back of head, spine centerline
  • Inner arms, inner legs
  • Bottom of chin, underside of objects
  • Panel edges on hard surface (construction seams)
  • Hidden areas under clothing/overlaps

Never place seams on:

  • Face (front)
  • Primary gameplay-visible surfaces
  • Deforming joint centers (relocate to nearby hidden area)

Texel Density

Formula: Texel Density = Texture Resolution / UV Island Size in UV space

Target consistency across visible surfaces:

Asset Tier Target TD (px/m)
Hero 512–1024 px/m
Standard 256–512 px/m
Background 128–256 px/m

Use same density for modular kit pieces sharing atlas.

Unwrap Methods

Method Use When
Smart UV Project Quick blockout UVs only
Follow Active Quads Strip UVs (roads, limbs)
Cube Project Boxy hard surface
Lightmap Pack Lightmap channel
Manual seam + Unwrap Production default

UV Packing

  • Margin: 0.002–0.01 UV units (engine dependent)
  • Rotate islands for maximum packing efficiency
  • Group islands by material ID
  • Keep related islands near each other in UV space
  • Use UVPackmaster or native pack for production

Mirrored UVs

  • Mirror UVs for symmetrical characters (save texture space)
  • Offset mirrored islands slightly if engine requires unique bakes
  • Mark mirrored halves in object naming: _L / _R meshes if separate

UDIM Workflow

For hero assets exceeding single 4K texture:

  • Tile 1001: head
  • Tile 1002: torso
  • Tile 1003: limbs
  • Document tile assignment in production brief

Lightmap UVs

Second UV channel requirements:

  • No overlapping islands
  • Consistent texel density less critical
  • Larger margin (0.02+) for light bleed prevention
  • Pack separately from texture UVs

Modular UV Atlas

1. Plan shared atlas resolution (2048/4096)
2. Assign UV islands per module to atlas regions
3. Trim sheet regions for repeating detail
4. Vertex color variation for module differentiation
5. Document atlas layout for texture artist

MCP Integration

  1. Mark seams via MCP if supported
  2. Execute unwrap via MCP
  3. Query UV island count and pack efficiency
  4. Assign UV channels via MCP
  5. Validate no overlapping UVs (except intentional mirror)

Validation Checklist

  • [ ] No unintended overlapping UVs
  • [ ] Consistent texel density on visible surfaces
  • [ ] Seams hidden at gameplay angles
  • [ ] UV islands within 0–1 (or UDIM tiles assigned)
  • [ ] Lightmap channel separate if required
  • [ ] Pack efficiency > 75%

Constraints

MUST DO

  • Plan UVs before final modeling (topology informed by UV needs)
  • Maintain texel density consistency
  • Hide seams at logical construction edges
  • Create lightmap UVs for baked lighting pipelines
  • Document atlas layout for modular kits

MUST NOT DO

  • Smart UV Project as final production UVs
  • Overlapping UVs on unique surface detail (unless mirrored)
  • Inconsistent texel density on same asset tier
  • Seams across faces or primary visible surfaces
  • Skip packing margins

Reference Guide

Topic Reference Load When
Texel density calc references/texel-density.md Hero assets
Trim sheets references/trim-sheets.md Modular kits

04 同仓库更多 Skills

yhyu13
yhyu13/AgentSkillsVault

feishu-kdocs-cli

Office cloud CLIs for agents: install, authenticate, verify and troubleshoot Feishu `lark-cli` and Kingsoft/WPS Docs `kdocs-cli`, plus the three China office MCP endpoints (Feishu, WPS SkillHub, Tencent Docs). Use when setting up or re-logging-in 飞书 CLI / 金山文档 CLI, when a command fails with missing scope / PATH / token / device-code errors, when a kdocs or lark command returns 400001 or unknown action, or when wiring 飞书 / 金山文档 / 腾讯文档 MCP into Cindy, Claude or another host. Not a per-command reference: domain commands live in the lark-* Skills and the kdocs Skill.

★ 3
yhyu13
yhyu13/AgentSkillsVault

vfx-fx

Cinematic and game VFX in Blender including smoke, fire, particles, trails, and Geometry Nodes FX setups via MCP.

★ 3
yhyu13
yhyu13/AgentSkillsVault

texture-workflow

Production texture workflow for atlases, baking AO/curvature/normal/roughness maps, decals, and texture memory optimization. Use for game-ready texture pipelines in Blender via MCP.

★ 3
yhyu13
yhyu13/AgentSkillsVault

sculpting

Blender sculpting for organic and hard surface detail using Dyntopo, multiresolution, brushes, alpha workflow, wrinkles, and damage. Use when high-frequency surface detail is needed before retopology in Blender via MCP.

★ 3
yhyu13
yhyu13/AgentSkillsVault

scene-assembly

Large scene layout in Blender with collections, linking, overrides, streaming-friendly organization, and set assembly via MCP.

★ 3
yhyu13
yhyu13/AgentSkillsVault

rigging

Production rigging in Blender with armatures, IK/FK, constraints, weight painting, mechanical rigs, facial rigs, and drivers. Use before animation on deforming assets via MCP.

★ 3