tsl-material-slots — правило для Claude Code: как установить
tsl-material-slots — правило для Claude Code со справочником слотов TSL в Three.js. Помогает настраивать шейдерную логику через узлы без ошибок в типах и именах свойств.
MIT ★ 4 719 обновлён 2026-10-24
.claude/rules/tsl-material-slots.mdЧто делает 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
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/tsl-material-slots.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/tsl-material-slots.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/tsl-material-slots.mdВручную: положить файлы
.clinerules/tsl-material-slots.mdПо шагам, с командами для каждой платформы: 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