원클릭으로 Manus에서 모든 스킬 실행

minemap-material-system-and-shading

스타3

포크0

업데이트2026년 7월 15일 07:28

MineMap 材质与着色规范。覆盖 `StandardMaterial`、`PhongMaterial`、`PhysicalMaterial`、`LambertMaterial`、`PolylineMaterial` 等主流材质的选型与调参。

설치

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

Manus에서 실행

출처

ming1zhou88

ming1zhou88/minemap-skills

GitHub 저장소 열기 Creator 저장소 보기

다운로드

Manus에서 실행

MineMap Material System and Shading

Quick Start

const material = minemap.StandardMaterial.fromType("Color", {
	color: "green",
	opacity: 1,
	doubleSided: false
});

const primitive = new minemap.Primitive({
	geometry,
	material
});

map.addPrimitive(primitive);

Core Concepts

1) 材质先按用途分，不要先按类名分

当前最常用的几类是：

StandardMaterial
- 通用入口
- 颜色、贴图、扫描、扩散环等都可走它
PhongMaterial
- 经典高光模型
- 参数直观，适合普通演示材质
PhysicalMaterial
- PBR 路线
- 金属度、粗糙度、环境贴图更完整
LambertMaterial
- 更简单的漫反射思路
PolylineMaterial
- 线材专用
WaterMaterial
- 水面专用，已单独拆 skill

2) `StandardMaterial` 是最常用起点

源码和 demo 都说明，StandardMaterial 不只是“普通材质”，而是一个多模式入口。

常见类型包括：

Color
Texture
RadarScan
DiffusingRing

因此当你还不确定选哪种材质时，先看 StandardMaterial.fromType(...)。

3) 材质是否受光照影响，要和场景光照一起看

材质表达并不是孤立的。至少要联动考虑：

map.enableLight()
具体光源
材质自己的 useLight
是否有法线 / 法线贴图
是否参与水面反射折射

4) 贴图与环境贴图要当资源系统处理

高频贴图入口：

TextureLoader.load(...)
HDR / envMap 资源
normal / alpha / roughness / metallic 等贴图

不要把它们写成每次交互都重复创建的临时对象。

Demo-backed Patterns

模式 1：`StandardMaterial` 做通用表达

对应 demo：demo/html/StandardMaterial.html

它证明了：

普通颜色/贴图材质可走 StandardMaterial
扫描、扩散环这类业务特效也可走 StandardMaterial.fromType(...)
且可与 adaptTerrain 结合

模式 2：`PhongMaterial` 做经典高光材质

对应 demo：demo/html/PhongMaterial.html

高频参数：

baseColor
specularColor
emissive
shininess
baseColorMap
emissiveIntensity

模式 3：`PhysicalMaterial` 做 PBR

对应 demo：demo/html/PBRMaterial.html

高频参数：

baseColor
metallic
roughness
envMap
normalMap
alphaMap
emissive
clearcoat
ior

这条路径适合更强调材质真实感的对象。

模式 4：线材不要硬套面材

对应 demo：demo/html/PolylineMaterial.html

线流动、箭头、重复纹理，应优先 PolylineMaterial，不要勉强拿面材来模拟。

Material Selection Guide

用 `StandardMaterial`，如果你要：

普通 primitive 颜色/贴图
快速业务特效原型
扫描、扩散环等内置风格

用 `PhongMaterial`，如果你要：

经典镜面高光
参数相对简单直观

用 `PhysicalMaterial`，如果你要：

PBR 表现
环境贴图
metallic / roughness 工作流

用 `PolylineMaterial`，如果你要：

流动线
箭头线
线纹理重复

Strict Constraints

1. 不要先上最复杂材质

默认先 StandardMaterial，只有确实需要 PBR 或经典高光时再切换。

2. 材质调不对，先查光照

很多“材质不生效”的根因其实是：

没开光照
光源方向不对
没有法线/法线贴图

3. 贴图要复用

尤其是：

baseColorMap
normalMap
envMap

不要在鼠标事件里重复装载。

4. `WaterMaterial` 不再塞进通用材质 skill 里展开

它已经有独立 skill，应通过互链使用。

Common Failure Cases

用 PhysicalMaterial 做简单单色物体，徒增复杂度
忽略 envMap 却追求高质量 PBR 观感
把线材需求写成面材需求
材质参数改了很多，但场景根本没开光照
高频交互里反复 TextureLoader.load(...)

Performance Discipline

材质从简到繁：Standard → Phong → Physical
贴图和环境图尽量复用
高质量材质、阴影、SSR 联动时要一起测预算

Demo References

demo/html/StandardMaterial.html
demo/html/PhongMaterial.html
demo/html/PBRMaterial.html
demo/html/PolylineMaterial.html

MineMap Material System and Shading

Quick Start

const material = minemap.StandardMaterial.fromType("Color", {
	color: "green",
	opacity: 1,
	doubleSided: false
});

const primitive = new minemap.Primitive({
	geometry,
	material
});

map.addPrimitive(primitive);

Core Concepts

1) 材质先按用途分，不要先按类名分

当前最常用的几类是：

StandardMaterial
- 通用入口
- 颜色、贴图、扫描、扩散环等都可走它
PhongMaterial
- 经典高光模型
- 参数直观，适合普通演示材质
PhysicalMaterial
- PBR 路线
- 金属度、粗糙度、环境贴图更完整
LambertMaterial
- 更简单的漫反射思路
PolylineMaterial
- 线材专用
WaterMaterial
- 水面专用，已单独拆 skill

2) `StandardMaterial` 是最常用起点

源码和 demo 都说明，StandardMaterial 不只是“普通材质”，而是一个多模式入口。

常见类型包括：

Color
Texture
RadarScan
DiffusingRing

因此当你还不确定选哪种材质时，先看 StandardMaterial.fromType(...)。

3) 材质是否受光照影响，要和场景光照一起看

材质表达并不是孤立的。至少要联动考虑：

map.enableLight()
具体光源
材质自己的 useLight
是否有法线 / 法线贴图
是否参与水面反射折射

4) 贴图与环境贴图要当资源系统处理

高频贴图入口：

TextureLoader.load(...)
HDR / envMap 资源
normal / alpha / roughness / metallic 等贴图

不要把它们写成每次交互都重复创建的临时对象。

Demo-backed Patterns

模式 1：`StandardMaterial` 做通用表达

对应 demo：demo/html/StandardMaterial.html

它证明了：

普通颜色/贴图材质可走 StandardMaterial
扫描、扩散环这类业务特效也可走 StandardMaterial.fromType(...)
且可与 adaptTerrain 结合

模式 2：`PhongMaterial` 做经典高光材质

对应 demo：demo/html/PhongMaterial.html

高频参数：

baseColor
specularColor
emissive
shininess
baseColorMap
emissiveIntensity

模式 3：`PhysicalMaterial` 做 PBR

对应 demo：demo/html/PBRMaterial.html

高频参数：

baseColor
metallic
roughness
envMap
normalMap
alphaMap
emissive
clearcoat
ior

这条路径适合更强调材质真实感的对象。

模式 4：线材不要硬套面材

对应 demo：demo/html/PolylineMaterial.html

线流动、箭头、重复纹理，应优先 PolylineMaterial，不要勉强拿面材来模拟。

Material Selection Guide

用 `StandardMaterial`，如果你要：

普通 primitive 颜色/贴图
快速业务特效原型
扫描、扩散环等内置风格

用 `PhongMaterial`，如果你要：

经典镜面高光
参数相对简单直观

用 `PhysicalMaterial`，如果你要：

PBR 表现
环境贴图
metallic / roughness 工作流

用 `PolylineMaterial`，如果你要：

流动线
箭头线
线纹理重复

Strict Constraints

1. 不要先上最复杂材质

默认先 StandardMaterial，只有确实需要 PBR 或经典高光时再切换。

2. 材质调不对，先查光照

很多“材质不生效”的根因其实是：

没开光照
光源方向不对
没有法线/法线贴图

3. 贴图要复用

尤其是：

baseColorMap
normalMap
envMap

不要在鼠标事件里重复装载。

4. `WaterMaterial` 不再塞进通用材质 skill 里展开

它已经有独立 skill，应通过互链使用。

Common Failure Cases

用 PhysicalMaterial 做简单单色物体，徒增复杂度
忽略 envMap 却追求高质量 PBR 观感
把线材需求写成面材需求
材质参数改了很多，但场景根本没开光照
高频交互里反复 TextureLoader.load(...)

Performance Discipline

材质从简到繁：Standard → Phong → Physical
贴图和环境图尽量复用
高质量材质、阴影、SSR 联动时要一起测预算

Demo References

demo/html/StandardMaterial.html
demo/html/PhongMaterial.html
demo/html/PBRMaterial.html
demo/html/PolylineMaterial.html

name	minemap-material-system-and-shading
description	MineMap 材质与着色规范。覆盖 `StandardMaterial`、`PhongMaterial`、`PhysicalMaterial`、`LambertMaterial`、`PolylineMaterial` 等主流材质的选型与调参。

minemap-material-system-and-shading

MineMap Material System and Shading

Quick Start

Core Concepts

1) 材质先按用途分，不要先按类名分

2) StandardMaterial 是最常用起点

3) 材质是否受光照影响，要和场景光照一起看

4) 贴图与环境贴图要当资源系统处理

Demo-backed Patterns

模式 1：StandardMaterial 做通用表达

模式 2：PhongMaterial 做经典高光材质

模式 3：PhysicalMaterial 做 PBR

模式 4：线材不要硬套面材

Material Selection Guide

用 StandardMaterial，如果你要：

用 PhongMaterial，如果你要：

用 PhysicalMaterial，如果你要：

用 PolylineMaterial，如果你要：

Strict Constraints

1. 不要先上最复杂材质

2. 材质调不对，先查光照

3. 贴图要复用

4. WaterMaterial 不再塞进通用材质 skill 里展开

Common Failure Cases

Performance Discipline

Demo References

See Also

이 저장소의 다른 Skills

MineMap Material System and Shading

Quick Start

Core Concepts

1) 材质先按用途分，不要先按类名分

2) StandardMaterial 是最常用起点

3) 材质是否受光照影响，要和场景光照一起看

4) 贴图与环境贴图要当资源系统处理

Demo-backed Patterns

模式 1：StandardMaterial 做通用表达

模式 2：PhongMaterial 做经典高光材质

模式 3：PhysicalMaterial 做 PBR

模式 4：线材不要硬套面材

Material Selection Guide

用 StandardMaterial，如果你要：

用 PhongMaterial，如果你要：

用 PhysicalMaterial，如果你要：

用 PolylineMaterial，如果你要：

Strict Constraints

1. 不要先上最复杂材质

2. 材质调不对，先查光照

3. 贴图要复用

4. WaterMaterial 不再塞进通用材质 skill 里展开

Common Failure Cases

Performance Discipline

Demo References

See Also

이 저장소의 다른 Skills

2) `StandardMaterial` 是最常用起点

模式 1：`StandardMaterial` 做通用表达

模式 2：`PhongMaterial` 做经典高光材质

模式 3：`PhysicalMaterial` 做 PBR

用 `StandardMaterial`，如果你要：

用 `PhongMaterial`，如果你要：

用 `PhysicalMaterial`，如果你要：

用 `PolylineMaterial`，如果你要：

4. `WaterMaterial` 不再塞进通用材质 skill 里展开

2) `StandardMaterial` 是最常用起点

模式 1：`StandardMaterial` 做通用表达

模式 2：`PhongMaterial` 做经典高光材质

模式 3：`PhysicalMaterial` 做 PBR

用 `StandardMaterial`，如果你要：

用 `PhongMaterial`，如果你要：

用 `PhysicalMaterial`，如果你要：

用 `PolylineMaterial`，如果你要：

4. `WaterMaterial` 不再塞进通用材质 skill 里展开