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

tsl-material-slots — правило для Claude Code: как установить

tsl-material-slots — правило для Claude Code со справочником слотов TSL в Three.js. Помогает настраивать шейдерную логику через узлы без ошибок в типах и именах свойств.

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

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

Что делает tsl-material-slots

Правило содержит справочник слотов для сборки нодовых материалов в Three.js Shading Language (TSL). В нём собраны базовые узлы вроде .vertexNode и .fragmentNode, а также каналы цвета и позиций вершин. Отдельные таблицы описывают слоты освещения, теней и вывод MRT.

Документ приводит шестнадцать параметров для MeshPhysicalNodeMaterial, включая лаковое покрытие .clearcoatNode и светопропускание .transmissionNode. В TSL тип каждого слота строго фиксирован. Присвоение обычного числа вместо float() приведёт к ошибке сборки шейдера.

Готовые примеры показывают анимацию цвета через функцию time и смещение геометрии по нормалям.

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

  • связать узлы смещения вершин в .positionNode
  • настроить маску прозрачности и отсечение через .alphaTestNode
  • сконфигурировать свойства преломления и лака в MeshPhysicalNodeMaterial
  • переопределить логику фрагментного шейдера через .fragmentNode

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

  • Напиши смещение вершин через positionNode и sin(time) с импортом из three/tsl
  • Настрой MeshPhysicalNodeMaterial, добавив прозрачность через transmissionNode и показатель iorNode
  • Сделай альфа-вырез на материале с помощью opacityNode и alphaTestNode

Как установить tsl-material-slots

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

.claude/rules/tsl-material-slots.md

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

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

Вопросы о tsl-material-slots

Как установить tsl-material-slots в Claude Code?

Создайте файл правила по пути .claude/rules/tsl-material-slots.md в корне вашего проекта и добавьте в него содержимое справочника.

Что делает правило tsl-material-slots?

Оно даёт модели актуальную таблицу слотов материалов TSL в Three.js с их типами данных и примерами связывания нод.

Какие слоты настраивают физические свойства в MeshPhysicalNodeMaterial?

В правиле перечислены шестнадцать слотов, включая .clearcoatNode, .transmissionNode, .iorNode, .thicknessNode, .sheenNode и .iridescenceNode.

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

tsl-material-slots.md · MIT
# TSL Material Node Slots

Complete reference for all material node slots available in TSL.

## Core Slots

| Slot | Description | Type |
|------|-------------|------|
| `.fragmentNode` | Replace fragment shader logic | `vec4` |
| `.vertexNode` | Replace vertex shader logic | `vec4` |
| `.geometryNode` | Execute geometry operations | `Fn()` |

## Basic Slots

| Slot | Description | Reference | Type |
|------|-------------|-----------|------|
| `.colorNode` | Base color x map | `materialColor` | `vec4` |
| `.depthNode` | Depth output | `depth` | `float` |
| `.opacityNode` | Opacity x alphaMap | `materialOpacity` | `float` |
| `.alphaTestNode` | Alpha threshold | `materialAlphaTest` | `float` |
| `.positionNode` | Vertex position + displacement | `positionLocal` | `vec3` |

## Lighting Slots

| Slot | Type |
|------|------|
| `.emissiveNode` | `color` |
| `.normalNode` | `vec3` |
| `.lightsNode` | Lighting model |
| `.envNode` | `color` |

## Shadow Slots

| Slot | Description | Type |
|------|-------------|------|
| `.castShadowNode` | Shadow color/opacity | `vec4` |
| `.maskShadowNode` | Shadow mask | `bool` |
| `.receivedShadowNode` | Shadow reception | `Fn()` |
| `.receivedShadowPositionNode` | Shadow projection position | `vec3` |
| `.aoNode` | Ambient occlusion | `float` |

## Output Slots

| Slot | Description | Type |
|------|-------------|------|
| `.maskNode` | Fragment mask | `bool` |
| `.mrtNode` | Custom MRT config | `mrt()` |
| `.outputNode` | Final output | `vec4` |

## MeshPhysicalNodeMaterial Specific

| Slot | Type |
|------|------|
| `.clearcoatNode` | `float` |
| `.clearcoatRoughnessNode` | `float` |
| `.clearcoatNormalNode` | `vec3` |
| `.sheenNode` | `color` |
| `.iridescenceNode` | `float` |
| `.iridescenceIORNode` | `float` |
| `.iridescenceThicknessNode` | `float` |
| `.specularIntensityNode` | `float` |
| `.specularColorNode` | `color` |
| `.iorNode` | `float` |
| `.transmissionNode` | `color` |
| `.thicknessNode` | `float` |
| `.attenuationDistanceNode` | `float` |
| `.attenuationColorNode` | `color` |
| `.dispersionNode` | `float` |
| `.anisotropyNode` | `vec2` |

## Usage Examples

### Color with Time Animation

```javascript
import { color, time, sin } from 'three/tsl';

const material = new MeshStandardNodeMaterial();
material.colorNode = color(0xff0000).mul(sin(time).mul(0.5).add(0.5));
```

### Custom Normal Mapping

```javascript
import { normalMap, texture, normalLocal } from 'three/tsl';

material.normalNode = normalMap(texture(normalTexture));
```

### Vertex Displacement

```javascript
import { positionLocal, normalLocal, sin, time } from 'three/tsl';

material.positionNode = positionLocal.add(
  normalLocal.mul(sin(time.add(positionLocal.y)).mul(0.1))
);
```

### Alpha Cutout

```javascript
import { texture, float } from 'three/tsl';

material.opacityNode = texture(alphaMap).r;
material.alphaTestNode = float(0.5);
```

### PBR Properties

```javascript
import { float, color } from 'three/tsl';

const material = new MeshPhysicalNodeMaterial();
material.clearcoatNode = float(1.0);
material.clearcoatRoughnessNode = float(0.1);
material.transmissionNode = float(0.9);
material.iorNode = float(1.5);
material.thicknessNode = float(0.5);
```

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

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

Все правила IDE по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
webgpu-threejs-tsl dgreenheck Скилл webgpu-threejs-tsl помогает писать Three.js-приложения с WebGPU, TSL-материалами, вычислительными шейдерами и постобработкой. CX Codex +1 1 800установок 3d-four-seasons MengTo Скилл 3d-four-seasons добавляет смену четырёх времён года в 3D-сцену через шейдерные uniform-переменные. Помогает переключать листву, свет и снег без пересборки геометрии мира. CX Codex +1 841установок 3d-metal-material MengTo Скилл 3d-metal-material настраивает реалистичные PBR-металлы в Three.js: физика проводника без альбедо, линейные значения F0, студия из ярких плашек с PMREM и слои шероховатости. CX Codex +1 ★ 7 995звёзд репо webgpu-claude-skill podo Учит агента рендерить Three.js через WebGPU: материалы на TSL, compute-шейдеры, постобработка и WGSL. Решает задачи GPU compute и авторских материалов. CX Codex +1 202установок threejs-fundamentals CloudAI-X Скилл threejs-fundamentals помогает настроить базовую сцену Three.js r186: рендерер, камеры, цикл анимации с THREE.Timer и import map для WebGL или WebGPU с TSL. CX Codex +1 24 100установок threejs-materials CloudAI-X Скилл threejs-materials для Claude Code, Codex, Cursor и других платформ: подбор и настройка материалов three.js — от базовых до PBR, тун-шейдинга и точечных облаков. CX Codex +1 21 100установок

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

Весь набор →
drei-use-gltf Правило drei-use-gltf для Claude Code задаёт загрузку GLTF-моделей через useGLTF с кэшированием и предварительной загрузкой. Используется в сценах на React Three Fiber. CX Codex +1 ★ 4 719звёзд репо perf-zustand-selectors Правило perf-zustand-selectors для ИИ-агента: подписка в компоненте идёт на отдельный срез Zustand-стора, поэтому перерисовка случается только при изменении нужных данных. CX Codex +1 ★ 4 719звёзд репо geometry-instanced-mesh Правило geometry-instanced-mesh задаёт использование THREE.InstancedMesh вместо отдельных мешей для рендеринга множества одинаковых 3D-объектов. CX Codex +1 ★ 4 719звёзд репо webgpu-renderer Правило webgpu-renderer для Claude Code описывает подключение WebGPU-рендерера Three.js и запасной путь через WebGL 2. Показывает настройку 3D-сцен с вычислениями на GPU. CX Codex +1 ★ 4 719звёзд репо 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звёзд репо

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

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