К основному содержанию
скилл CX Codex

blender-hardsurface-modeling — скилл для Claude Code: установка

Скилл blender-hardsurface-modeling для Claude Code задаёт пайплайн hard-surface моделирования в Blender 5.3: от блокаута до сборки стека модификаторов. Помогает моделировать технику, оружие и пропсы.

MIT 621 установок ★ 2 624 обновлён 2026-11-13

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add EL4CTEO/blender-skills --skill blender-hardsurface-modeling -a claude-code
Открыть на GitHub

Что делает blender-hardsurface-modeling

Скилл выстраивает пайплайны mid-poly, high-to-low и subdivision для техники, оружия и механических деталей в Blender 5.3. Он задаёт правила перехода от базового блокаута к вторичным формам, булевым вырезам и фаскам.

Внутри описан неразрушающий стек модификаторов: Mirror, булевы операции с солверами EXACT или MANIFOLD, Bevel, Weighted Normal и триангуляция для экспорта. Развёртку базовой сетки скилл требует делать до фасок, потому что после скругления рёбер автоматические швы ломаются. Скрипт scripts/apply_stack.py собирает пресеты стека через Python, а атрибуты bevel_weight_edge и sharp_edge назначаются кодом прямо в ob.data.attributes.

Без сброса масштаба через transform_apply(scale=True) фаски и булевы операции ломаются, так как дистанции модификаторов рассчитываются в объектных координатах. Завершается работа проверкой геометрии в blender-asset-qa.

Какие задачи решает

  • собрать неразрушающий стек модификаторов Mirror, Boolean и Bevel
  • устранить градиенты на плоских поверхностях с помощью Weighted Normal
  • выбрать между пайплайнами mid-poly, subdivision и high-to-low
  • назначить веса фасок и рёбер через атрибуты Python в Blender

Примеры запросов агенту

  • Собери стек модификаторов для mid-poly корпуса с булевыми вырезами
  • Рассчитай бюджет сегментов цилиндров для болтов и стволов оружия
  • Назначь атрибуты bevel_weight_edge и sharp_edge через Python для выбранных рёбер

Как установить blender-hardsurface-modeling

1Через Skills CLI (Vercel)

npx skills add EL4CTEO/blender-skills --skill blender-hardsurface-modeling -a claude-code

2Вручную: положить файлы

~/.claude/skills/blender-hardsurface-modeling/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/blender-hardsurface-modeling/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о blender-hardsurface-modeling

Как установить blender-hardsurface-modeling в Claude Code?

Выполните команду npx skills add EL4CTEO/blender-skills --skill blender-hardsurface-modeling -a claude-code.

Что делает blender-hardsurface-modeling?

Задаёт правила моделирования твёрдотельных объектов в Blender: топологию, плотность цилиндров, булевы операции и порядок применения модификаторов.

Что нужно для работы blender-hardsurface-modeling?

Нужен Blender 5.3, базовая модель выполнения blender-core и утилита проверки blender-asset-qa.

Исходный текст

SKILL.md · MIT
---
name: blender-hardsurface-modeling
description: Hard-surface and prop modeling in Blender 5.3 - blockout-to-detail flow, non-destructive modifier stacks (Mirror, Boolean Exact/Manifold, Bevel, Weighted Normal, Smooth by Angle), mid-poly vs subdivision vs high-to-low workflows, shading/custom normals, cylinder segment budgets, edge attributes from Python. Use for weapons, vehicles, props, architecture, mechanical parts.
license: MIT
metadata:
  author: blender-agent-skills
  version: "1.2.0"
---

# Hard-Surface Modeling

The execution model is in `blender-core`. Run `blender-asset-qa` after every modeling pass.

## Pick the workflow first
| Workflow | When | Output |
|---|---|---|
| **Mid-poly** (bevel + weighted normals, no bake) | modern games, props seen up close, fast iteration | game mesh directly; tiling materials/trim sheets |
| **High → low** (high via booleans+bevel or subd, low baked) | hero assets, unique textures, tight tri budgets | `_high` + `_low` → `blender-texture-baking` |
| **Subdivision** (support loops/creases + Subsurf) | renders, product viz, film | smooth surfaces, edges held by loops/creases |

## Procedure
1. **Blockout** at real scale (`ob.dimensions`) from primitives. Settle the silhouette and proportions before any detail. Check against references.
2. **Apply scale** (`transform_apply(scale=True)`) before bevels, booleans or solidify, because modifier distances use object space.
3. **Primary → secondary → tertiary** forms. Booleans for cuts and panels, then bevels. Small tertiary details go in normal maps/decals, or into the high-poly as "floaters" for baking.
4. **UV the base mesh now** (mid-poly). Bevel/Boolean modifiers propagate UVs, but after bevels no edge is sharp enough to auto-seam. Then **build the stack** with `scripts/apply_stack.py -- --objects Body --preset midpoly --cutters Cut1 Cut2`. Order: Mirror → Booleans → Bevel → Weighted Normal → (Triangulate at export).
5. **Shading check**: smooth shading + Weighted Normal (keep sharp). There must be no gradients across flat faces. View with a matcap or `look` in `solid` shading.
6. **QA** with `blender-asset-qa`, then apply the stack only on an export copy (`--apply`), keeping the editable source.

## Stack rules
- **Booleans**: put cutters in a `Cutters` collection with display `WIRE` and `hide_render=True`. Solver: `EXACT` (robust default), `MANIFOLD` (much faster, but inputs must be closed manifold), `FLOAT` (legacy fast, fragile with coplanar faces). With many cutters, use `operand_type="COLLECTION"`.
- Avoid coplanar boolean faces: extend cutters slightly past the surface. They also cause z-fighting.
- **Bevel**: `limit_method="ANGLE"` (30°), or `"WEIGHT"` with a `bevel_weight_edge` attribute for hand-picked edges. Turn on `use_clamp_overlap`, `harden_normals=True`, `miter_outer="MITER_ARC"`. Width ≈ 0.5–2% of the part's size, kept consistent across the asset.
- **Weighted Normal** after Bevel: `mode="FACE_AREA"`, `keep_sharp=True`, weight 50. Needs smooth faces (remove the `sharp_face` attribute or call `shade_smooth`).
- **Smooth by Angle** (4.1+, replaces auto smooth): `bpy.ops.object.shade_auto_smooth(angle=rad)` adds a GN modifier, or `shade_smooth_by_angle` sets `sharp_edge` destructively.
- **Mirror**: `use_clip=True`, `use_mirror_merge=True`. Model one half only at x ≥ 0.
- **Subdivision**: hold edges with support loops (a loop 1–5% of the face width from the edge) or `crease_edge` (0–1). Turn on `use_limit_surface`. Don't use creases if the asset goes to an engine.
- **Triangulate** only for export/baking (`keep_custom_normals=True`, `BEAUTY`). Triangulating the bake mesh and the export mesh identically keeps normal maps synced.

## Topology rules
- **N-gons**: fine on flat, non-deforming faces in mid-poly/game meshes. Never use them on curved surfaces or anything that subdivides or deforms.
- **Poles** (5+ edges) should sit on flat areas, never on a curvature peak or bevel.
- **Cylinder segments by on-screen size**: small (bolts) 6–8, medium (handles) 12–16, large (barrels) 24–32, hero/close-up 48+. Use multiples of 4 or 8 so booleans/mirrors line up with existing loops.
- **No long, thin triangles** across visible curved areas (shading and LOD artifacts).
- **Panel lines**: inset + extrude in (mid-poly) or a boolean groove on the high-poly, then bake.
- Spend density where the silhouette needs it, not on flat faces.

## Edge/face attributes from Python (4.0+ names)
```python
me = ob.data
bw = me.attributes.get("bevel_weight_edge") or me.attributes.new("bevel_weight_edge", "FLOAT", "EDGE")
cr = me.attributes.get("crease_edge") or me.attributes.new("crease_edge", "FLOAT", "EDGE")
sh = me.attributes.get("sharp_edge") or me.attributes.new("sharp_edge", "BOOLEAN", "EDGE")
bw.data[edge_index].value = 1.0; sh.data[edge_index].value = True
me.edges[edge_index].use_seam = True          # seams are still an edge property
```
Select sharp edges by angle in bmesh: `e.calc_face_angle(0) > math.radians(30)`.

## Gotchas
- A bevel that looks blobby or flips usually means unapplied/non-uniform scale or overlapping geometry (turn on clamp).
- A Boolean that returns nothing or garbage: the cutter isn't closed/manifold (Exact copes, Manifold fails), or its normals are inverted.
- Weighted Normal has no effect: faces are flat-shaded, or an earlier modifier destroyed the custom normals.
- 5.2: the GN `Mesh Bevel` node exists for procedural bevels inside node trees (`blender-geometry-nodes`).
- 5.3: LoopTools is built in (`mesh.relax_edge_loops`, `curve_edge_loops_between_selected`, `fit_edge_loops_to_annotation`, `space_edge_loops_evenly`). `mesh.primitive_quad_sphere_add(segments=4)` gives an all-quad cube-sphere: no pinched poles, so it subdivides and bevels cleanly.
- Trim-sheet/mid-poly assets: UVs go to the trim strips (`blender-retopology-uv`) and materials tile (`blender-pbr-materials`).

© blender-agent-skills · MIT · EL4CTEO/blender-skills

Похожие скиллы

Все скиллы по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
roblox-blender-modeling LihFolk Скилл roblox-blender-modeling для Claude Code помогает создавать и проверять модели Blender для Roblox. Включается при моделировании, исправлении и экспорте предметов, зданий и существ. CX Codex +1 ★ 98звёзд репо blender-modeling RobLe3 Скилл blender-modeling для ИИ-агента: создаёт и правит 3D-меши в Blender по текстовому запросу — примитивы, модификаторы, bmesh-правки. CX Codex +1 4 100установок scenario-blender-hard-surface scenario-labs Скилл scenario-blender-hard-surface для моделирования твёрдых поверхностей в Blender: булевы вырезы, фаски, weighted normals и subdivision. Помогает, когда шейдинг ломается или фаска исчезает после булевой операции. CX Codex +1 1 000установок blender-lighting RobLe3 Скилл blender-lighting настраивает студийный, кинематографичный или уличный свет в сценах Blender через готовые Python-сценарии и MCP-сервер. CX Codex +1 2 300установок scenario-blender-grease-pencil scenario-labs Скилл scenario-blender-grease-pencil управляет Grease Pencil v3 в Blender 5.x через Python: создаёт 2D-риги, настраивает заливки и покадровую анимацию. Пригодится при сбоях старых скриптов GPENCIL. CX Codex +1 885установок blender-motion-state-inspection affaan-m Скилл blender-motion-state-inspection для Claude Code извлекает параметры скелета, костей и контактов в Blender. Проверяет скольжение ног, проваливание в пол и инверсию осей ретаргетинга. CX Codex +1 7 000установок

Из того же набора28

Весь набор →
blender-animation Скилл blender-animation для Claude Code, автоматизирующий анимацию в Blender 5.3 через Python-скрипты. Управляет ключевыми кадрами, ретаргетингом mocap и запеканием ригов для игровых движков. CX Codex +1 757установок blender-export-pipelines Скилл blender-export-pipelines для Claude Code настраивает экспорт ассетов из Blender под игровые движки и другие форматы. Включается, когда ассет нужно выгрузить из Blender и проверить результат. CX Codex +1 681установок blender-game-optimization Скилл blender-game-optimization работает в Claude Code, Codex, Cursor и других платформах для оптимизации трехмерных моделей под лимиты игровых движков. CX Codex +1 657установок blender-pbr-materials Скилл blender-pbr-materials для Claude Code настраивает PBR-материалы и текстурные карты для Blender 5.3 по правилам игровых движков. CX Codex +1 644установок blender-lighting-lookdev Скилл blender-lighting-lookdev для Claude Code настраивает свет, камеры и вид материалов в Blender 5.3. Подключается при подготовке сцены к рендеру или презентации ассета. CX Codex +1 606установок blender-retopology-uv Скилл blender-retopology-uv для Claude Code помогает переделать скульпт или скан в игровую сетку и подготовить UV для текстурирования и запекания. Включается при работе с ретопологией и развёрткой в Blender 5.3. CX Codex +1 603установок blender-texture-baking Скилл blender-texture-baking для Claude Code автоматизирует запекание карт нормалей, AO и PBR-текстур в Blender 5.3 через движок Cycles. Включается при переносе деталей со скульптов или конвертации процедурных материалов. CX Codex +1 587установок blender-rendering Скилл blender-rendering для Claude Code настраивает рендеринг в Blender 5.3 для кадров, анимаций и turntable. Включается для рендера кадра, анимации или turntable. CX Codex +1 582установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой