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

lighting-shadows-advanced — правило для Claude Code

Правило lighting-shadows-advanced для Claude Code настраивает освещение и тени в Three.js с учётом стоимости рендеринга. Оптимизирует тени при множестве источников света.

MIT ★ 4 719 обновлён 2026-10-24

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/lighting-shadows-advanced.md
Открыть на GitHub

Что делает lighting-shadows-advanced

Правило собирает рекомендации по свету и теням в Three.js: ограничивать число активных источников, подбирать размер карты теней и сужать область камеры теней до границ сцены. Для больших сцен описаны каскадные карты CSM, а для статических — запекание света и отключение автоматического обновления теней.

Отдельно разбираются карты окружения, Light Probe и контактные тени из полупрозрачной плоскости. У PointLight тени требуют шесть проходов рендеринга на каждый источник, поэтому для теней правило советует рассмотреть DirectionalLight или SpotLight. Добавьте файл .claude/rules/lighting-shadows-advanced.md в проект Claude Code.

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

  • сократить число активных источников света
  • подобрать размер карты теней для целевой платформы
  • ограничить область камеры теней размерами сцены
  • выбрать способ освещения для статической сцены
  • заменить тени PointLight на менее затратный вариант

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

  • Посмотри на освещение в этой сцене Three.js и предложи, как снизить стоимость теней.
  • Настрой карту теней DirectionalLight под размеры сцены.
  • Подскажи, чем заменить тени PointLight в статической сцене.

Как установить lighting-shadows-advanced

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

.claude/rules/lighting-shadows-advanced.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать

Вопросы о lighting-shadows-advanced

Как установить lighting-shadows-advanced в Claude Code?

Добавьте файл .claude/rules/lighting-shadows-advanced.md в проект.

Что делает lighting-shadows-advanced?

Правило описывает настройку освещения и теней в Three.js: от числа источников и параметров карт теней до CSM и запекания света.

Почему правило советует избегать теней PointLight?

PointLight требует шесть проходов рендеринга карты теней на каждый источник. Для теней предлагается рассмотреть DirectionalLight или SpotLight.

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

lighting-shadows-advanced.md · MIT
# Lighting & Shadows Advanced

> Source: [100 Three.js Tips - Utsubo](https://www.utsubo.com/blog/threejs-best-practices-100-tips)

Lighting is computationally expensive. Optimize carefully.

## Limit Active Lights

**Target: 3 or fewer active lights**

Each additional light increases shader complexity. Beyond 3 lights, consider baking.

## PointLight Shadow Cost

PointLights require 6 shadow map renders (cube faces):

```
Draw calls = objects × 6 × point_lights
```

A scene with 100 objects and 2 PointLights = 1,200 shadow draw calls.

**Prefer DirectionalLight or SpotLight for shadows.**

## Shadow Map Sizing

| Platform | Recommended Size |
|----------|------------------|
| Mobile | 512-1024 |
| Desktop | 1024-2048 |
| Quality-critical | 4096 |

```javascript
directionalLight.shadow.mapSize.width = 2048;
directionalLight.shadow.mapSize.height = 2048;
```

## Tight Shadow Camera Frustum

```javascript
const light = new THREE.DirectionalLight(0xffffff, 1);

// Fit tightly to scene bounds
light.shadow.camera.left = -10;
light.shadow.camera.right = 10;
light.shadow.camera.top = 10;
light.shadow.camera.bottom = -10;
light.shadow.camera.near = 0.1;
light.shadow.camera.far = 50;

// Use helper to visualize
const helper = new THREE.CameraHelper(light.shadow.camera);
scene.add(helper);
```

## Disable Shadow Auto-Update for Static Scenes

```javascript
renderer.shadowMap.autoUpdate = false;

// Manually trigger when needed (e.g., after moving light)
renderer.shadowMap.needsUpdate = true;
```

## Cascaded Shadow Maps (CSM) for Large Scenes

```javascript
import { CSM } from 'three/addons/csm/CSM.js';

const csm = new CSM({
  maxFar: camera.far,
  cascades: 4, // Desktop: 4, Mobile: 2
  shadowMapSize: 2048,
  lightDirection: new THREE.Vector3(-1, -1, -1).normalize(),
  camera: camera,
  parent: scene
});

// Update in render loop
function animate() {
  csm.update();
  renderer.render(scene, camera);
}
```

## Bake Lightmaps for Static Scenes

Options:
1. **Blender** - Bake lighting in Blender, export to glTF
2. **@react-three/lightmap** - Runtime baking in R3F

```jsx
// React Three Fiber
import { Lightmap } from '@react-three/lightmap';

<Lightmap>
  <Scene />
</Lightmap>
```

## Environment Maps for Ambient Light

```javascript
import { RGBELoader } from 'three/addons/loaders/RGBELoader.js';

const pmremGenerator = new THREE.PMREMGenerator(renderer);

new RGBELoader().load('environment.hdr', (texture) => {
  const envMap = pmremGenerator.fromEquirectangular(texture).texture;
  scene.environment = envMap;
  texture.dispose();
  pmremGenerator.dispose();
});
```

## Fake Shadows for Simple Cases

Semi-transparent planes with radial gradients provide budget-friendly contact shadows:

```javascript
const shadowTexture = createRadialGradientTexture();
const shadowMaterial = new THREE.MeshBasicMaterial({
  map: shadowTexture,
  transparent: true,
  opacity: 0.5,
  depthWrite: false
});

const shadowPlane = new THREE.Mesh(
  new THREE.PlaneGeometry(2, 2),
  shadowMaterial
);
shadowPlane.rotation.x = -Math.PI / 2;
shadowPlane.position.y = 0.01; // Slightly above ground
```

## Light Probes

For static scenes with complex lighting:

```javascript
import { LightProbeGenerator } from 'three/addons/lights/LightProbeGenerator.js';

const lightProbe = new THREE.LightProbe();

// Generate from cube camera
const cubeRenderTarget = new THREE.WebGLCubeRenderTarget(256);
const cubeCamera = new THREE.CubeCamera(0.1, 1000, cubeRenderTarget);
cubeCamera.update(renderer, scene);

lightProbe.copy(LightProbeGenerator.fromCubeRenderTarget(renderer, cubeRenderTarget));
scene.add(lightProbe);
```

## Checklist

- [ ] Limit to 3 or fewer active lights
- [ ] Avoid PointLight shadows when possible
- [ ] Size shadow maps for target platform
- [ ] Fit shadow camera frustum tightly
- [ ] Disable shadow autoUpdate for static scenes
- [ ] Use CSM for large outdoor scenes
- [ ] Bake lighting for static geometry
- [ ] Use environment maps for ambient lighting
- [ ] Consider fake shadows for simple cases

© zebbern · MIT · zebbern/claude-code-guide

Похожие правила IDE

Все правила IDE по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
threejs-lighting CloudAI-X Скилл threejs-lighting для Claude Code помогает настроить освещение в Three.js. Он включается при добавлении источников света, настройке теней и работе с HDR-окружением. CX Codex +1 19 400установок r3f-lighting EnzeD Скилл r3f-lighting для Claude Code настраивает свет, окружение и тени в React Three Fiber. Разбирает артефакты теней и стоимость рендера. CX Codex +1 2 200установок threejs-materials-lighting gamedev-skills Скилл threejs-materials-lighting для Claude Code настраивает материалы, освещение и тени в сценах three.js. Запускается при чёрных или пересвеченных мешах, пропавших тенях и затемнении после EffectComposer. CX Codex +1 11 100установок 3d-wood-lighting-scorecard MengTo Скилл 3d-wood-lighting-scorecard настраивает свет, процедурные текстуры дерева и объёмные лучи в Three.js, затем оценивает результат по рубрике и доводит каждый пункт до целевого балла. CX Codex +1 ★ 7 995звёзд репо beautiful-shadows MengTo Скилл beautiful-shadows для Claude Code, Cursor, Codex и других агентов: добавляет три набора точных Tailwind-классов для нейтральных многослойных теней. CX Codex +1 2 600установок roblox-lighting TabooHarmony Скилл roblox-lighting для Claude Code и Codex. Настраивает освещение, атмосферу, цикл дня и ночи и пост-обработку в Roblox, решает проблемы с плоскими или пересвеченными сценами. CX Codex +1 3 900установок

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

Весь набор →
core-web-vitals Правило core-web-vitals для Claude Code: грузит модели и текстуры в 3D-сценах на Three.js так, чтобы LCP, FID и CLS не проседали. Не даёт тяжёлому 3D тормозить первую отрисовку. CX Codex +1 ★ 4 719звёзд репо postprocessing-optimization Правило postprocessing-optimization для Three.js и React Three Fiber. Помогает оптимизировать постобработку и объединять шейдерные проходы без просадок FPS. CX Codex +1 ★ 4 719звёзд репо timeline-builder Скилл timeline-builder для Claude Code превращает JSON-данные в интерактивную HTML-хронологию с вертикальной, горизонтальной или двусторонней раскладкой. Отображает этапы проекта, историю выпусков и резюме. CX Codex +1 ★ 4 719звёзд репо loading-suspense Правило loading-suspense требует оборачивать асинхронные компоненты React Three Fiber в Suspense с заглушкой: без границы сцена останется пустой, пока грузится модель или текстура. CX Codex +1 ★ 4 719звёзд репо migration-checklist Правило migration-checklist подсказывает агенту, как мигрировать код при обновлении Three.js. Перечисляет breaking changes с r125 и актуальные пути импортов. CX Codex +1 ★ 4 719звёзд репо audio-spatial Правило audio-spatial для Claude Code задаёт шаблоны настройки 3D-звука в Three.js: позиционирование источников, затухание и реакцию на действия пользователя. CX Codex +1 ★ 4 719звёзд репо debug-devtools Правило debug-devtools для Claude Code и Codex добавляет в Three.js-проект средства диагностики производительности, сцены и потери WebGL-контекста. Находит узкие места и проверяет параметры вживую. CX Codex +1 ★ 4 719звёзд репо tsl-post-processing Правило tsl-post-processing для Claude Code описывает постобработку Three.js на TSL: эффекты подключаются к postProcessing.outputNode без цепочки проходов EffectComposer. Агент обращается к нему при написании кода сцены. CX Codex +1 ★ 4 719звёзд репо

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

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