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

blender-game-optimization — скилл для Claude Code: оптимизация моделей

Скилл blender-game-optimization работает в Claude Code, Codex, Cursor и других платформах для оптимизации трехмерных моделей под лимиты игровых движков.

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

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

Что делает blender-game-optimization

Скилл рассчитывает бюджеты полигонов, костей, материалов и памяти текстур для мобильных устройств, консолей, ПК, Web и VR. Измерение геометрии запускается через встроенный скрипт, после чего агент выполняет очистку сетки, создание цепочек LOD и объединение материалов для снижения draw call.

Перед началом работы требуется установленный Blender и выполнение базовой модели в связке с blender-core. Правила учитывают особенности движков вроде ограничений на UV-швы, разделение вершин и подготовку простых физических коллайдеров.

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

  • рассчитать лимиты полигонов и материалов под конкретную платформу
  • создать LOD-цепочки для игровых объектов
  • уменьшить количество вызовов отрисовки через слияние материалов
  • очистить ненужную геометрию и внутренние грани сетки
  • настроить простые прокси-коллайдеры для физики

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

  • Оптимизируй модель hero.blend под лимиты мобильных устройств
  • Запусти скрипт измерения статистики сетки для объекта character
  • Создай LOD-цепочку для меша с уменьшением полигонов вдвое

Как установить blender-game-optimization

1Через Skills CLI (Vercel)

npx skills add EL4CTEO/blender-skills --skill blender-game-optimization -a claude-code

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

~/.claude/skills/blender-game-optimization/SKILL.md

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

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

Вопросы о blender-game-optimization

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

Выполните команду npx skills add EL4CTEO/blender-skills --skill blender-game-optimization -a claude-code, а затем обратитесь к файлу ~/.claude/skills/blender-game-optimization/SKILL.md.

Что делает blender-game-optimization?

Скилл автоматизирует подготовку трехмерных ассетов к экспорту в игры, контролируя бюджеты вершин, текстурную память и количество материалов под целевую платформу.

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

Для работы требуется окружение Blender и предварительно настроенный модуль blender-core в репозитории.

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

SKILL.md · MIT
---
name: blender-game-optimization
description: Optimize Blender assets for real-time engines - triangle/material/texture/bone budgets per platform (mobile, Roblox, web, VR, console, PC), LOD chains, decimation modes, mesh cleanup, draw-call reduction (material merging, atlases, trim sheets), instancing, vertex-split costs, collision proxies, texture memory. Use when an asset is too heavy, before export, or when targeting a platform budget.
license: MIT
metadata:
  author: blender-agent-skills
  version: "1.2.0"
---

# Game Optimization

The execution model is in `blender-core`. Always re-run `blender-asset-qa` after optimizing.

## Procedure
1. **Measure**: `scripts/mesh_stats.py -- --objects ... --budget mobile|roblox|web|vr|console|pc`. It returns tris, estimated draw calls, materials, texture VRAM, bones, and the over-budget items.
2. **Clean**: `make_lods.py --cleanup` (merge by distance 0.1 mm, dissolve degenerate, delete loose). Remove hidden faces: back-to-back faces and faces under other parts (`qa_check` → `back_to_back`, plus manual xray).
3. **Reduce in this order** (cheapest visual loss first): hidden/interior geometry → unnecessary edge loops on flat areas (Limited Dissolve 1–5°) → over-segmented cylinders → Decimate → bake detail to normals (`blender-texture-baking`).
4. **Materials**: merge to 1–2 per asset (atlas / trim sheet / shared tiling material). Each material slot per mesh is roughly one draw call.
5. **LODs**: `scripts/make_lods.py -- --objects SM_X --rename` creates `_LOD1.._LOD3` at 50/25/12.5%. Check every LOD silhouette with `look`/`review_shots`.
6. **Re-measure**, then QA, then export (`blender-export-pipelines`).

## Budgets (guidance per asset, 2026)
| Platform | Hero char tris | Prop tris | Mats/asset | Max texture | Bones |
|---|---|---|---|---|---|
| Mobile | 5–15k | 0.3–3k | 1–2 | 1024 | ≤75 |
| Roblox | body ≤10,742 (head 4k, torso 1.75k, limb 1,248); accessory/clothing 4k | ≤20k per MeshPart | 1 (SurfaceAppearance) | 1024 (PBR), 4k max | R15 + optional |
| Web (three.js/Babylon) | 10–30k | 1–10k | 1–2 | 2048 | ≤100 |
| Standalone VR (Quest) | 10–40k | 1–10k | 1–3 | 2048 | ≤100 |
| Console / PC | 50–150k | 5–50k | 2–6 | 4096 | 150–300 |
| UE5 Nanite (static) | — | millions OK | few | 4096+ | n/a |
Whole-scene limits matter more than single assets: mobile ≈ 100–300k tris visible and < 100–200 draw calls; PC ≈ millions of tris and < 2–5k draw calls.

## Decimate modes
| Mode | Use | Notes |
|---|---|---|
| `COLLAPSE` (ratio) | organic, scans, LODs | `use_symmetry`, vertex group factor to protect faces/hands; triangulates |
| `UNSUBDIV` (iterations) | meshes made by subdividing quads | restores the quad grid cleanly |
| `DISSOLVE` (planar, angle) | hard-surface / CAD | delimit `{"SEAM","SHARP","MATERIAL","UV"}`; keeps the silhouette, makes n-gons → triangulate on export |
Protect UV seams and silhouette: decimate a copy, then compare. If UVs tear at LOD1, the ratio is too aggressive for that topology, so re-unwrap or use a manual LOD.

## The hidden cost: vertex splits
GPU vertex count = unique (position, normal, UV, color) combinations. Every UV seam and hard edge **duplicates** vertices, so engine vertex counts are often 1.5–3× Blender's. Minimize seams where they aren't needed, keep hard edges = seams (so the split happens once), and don't add vertex colors or extra UV sets you don't use.

## LOD rules
- Halve the tris per level. Switch at screen size ~0.5 / 0.25 / 0.125 (UE "Screen Size", Unity LOD Group %, Godot `lod_bias` auto).
- LODs keep the same materials (or fewer: merge them at LOD2+), same pivot, same bounds.
- Skeletal LODs: remove finger/face bones at LOD2+ (the engine bone-reduction tools handle this). Keep the skinning on the same skeleton.
- Far LOD / foliage: impostor/billboard. Unreal Nanite (static, opaque/masked) and Godot's auto mesh LOD can replace a hand-made chain.
- Roblox: no manual LODs. `RenderFidelity=Automatic` does it. Keep each MeshPart ≤ 20k tris and use a simple `CollisionFidelity` (Box/Hull) for non-walkable parts.

## Draw calls and batching
- **Merge** static meshes that share a material and are always seen together (join objects). **Don't merge** across large areas, because that defeats frustum/occlusion culling.
- **Instancing**: repeated objects as linked duplicates (Alt+D, shared mesh) or collection instances. They export as instances (glTF `EXT_mesh_gpu_instancing` with `export_gpu_instances`) or as one mesh + transforms in the engine.
- **Atlases/trim sheets**: put many props on one texture set. Trim sheets let walls, panels and pipes share one 2k material.
- **Texture memory** (upper bound, uncompressed RGBA8 + mips): 1k = 5.3 MB, 2k = 21 MB, 4k = 85 MB. Engines compress (BC7/ASTC ≈ 4–8×). Pack grayscale maps into ORM channels to cut it 3×.

## Collision
Keep collision separate and simple: boxes/convex hulls of ≤ 32–255 verts. UE `UCX_<Mesh>_##`, Godot `-colonly`/`-convcolonly` suffix, Unity MeshCollider on a simplified mesh, Roblox `CollisionFidelity`. Never use the render mesh as a physics mesh for anything that moves.

## Rig and animation cost
Limit to 4 influences per vertex (`vertex_group_limit_total(limit=4)` + normalize). Remove non-deforming bones from the export (`use_armature_deform_only`). Bake constraints and drivers to keys. Shape keys cost memory per vertex, so drop unused ones and keep only deltas (glTF sparse accessors handle this).

## Gotchas
- Decimate on meshes with unapplied modifiers: `make_lods.py` evaluates them first. Other paths need you to apply them.
- Join (`Ctrl+J`) merges materials and UV maps by **name**. Rename the UV maps identically first, or the UVs get lost.
- The `Weld` modifier is the non-destructive merge by distance. Use `mode="CONNECTED"` to avoid welding separate parts.
- Triangulate before measuring if the engine will. Quads already count as 2 tris in the stats.

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

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

Все скиллы по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
asset-optimization https://github.com/arjun988 Скилл asset-optimization для Claude Code проверяет и оптимизирует 3D-модели в Blender перед экспортом через MCP. Запускает аудит полигонов, чистит топологию, генерирует уровни детализации LOD и собирает отчёт. CX Codex +1 720установок scenario-blender-expert scenario-labs Скилл scenario-blender-expert для Claude Code помогает автоматизировать Blender через Python и MCP: моделировать, запекать, настраивать риг и проверять меши перед экспортом. CX Codex +1 1 700установок scenario-blender-rigging scenario-labs Скилл scenario-blender-rigging для риггинга персонажа, существа или пропа в Blender через Python: метариг Rigify, веса, IK/FK, лицевой риг. CX Codex +1 1 200установок blender-image-to-3d majidmanzarpour Скилл blender-image-to-3d для Claude Code собирает игровой 3D-ассет в Blender по референсам через контролируемые фазы с рендером и сравнением. Запускается при упоминании референс-изображения для создания модели. CX Codex +1 917установок blender MonumentalSystems Справочник по интерфейсу Blender, горячим клавишам, риггингу и пайплайну экспорта моделей в движки Unity и Unreal. CX Codex +1 563установок blender-modeling RobLe3 Скилл blender-modeling для ИИ-агента: создаёт и правит 3D-меши в Blender по текстовому запросу — примитивы, модификаторы, bmesh-правки. CX Codex +1 4 100установок

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

Весь набор →
blender-character-rigging Скилл blender-character-rigging для Claude Code автоматизирует риггинг персонажей в Blender 5.3 через Rigify. Подключается при задачах на создание скелета, скиннинг и развесовку. CX Codex +1 779установок blender-asset-qa Скилл blender-asset-qa для Claude Code автоматизирует проверку 3D-моделей и ассетов в Blender. Запускается перед экспортом или сдачей задачи. CX Codex +1 765установок 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-pbr-materials Скилл blender-pbr-materials для Claude Code настраивает PBR-материалы и текстурные карты для Blender 5.3 по правилам игровых движков. CX Codex +1 644установок blender-hardsurface-modeling Скилл blender-hardsurface-modeling для Claude Code задаёт пайплайн hard-surface моделирования в Blender 5.3: от блокаута до сборки стека модификаторов. Помогает моделировать технику, оружие и пропсы. CX Codex +1 621установок 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установок

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

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