Skip to content

anbeime/skill / skills/img2threejs/img2threejs

img2threejs

Verified

Turn an object or character reference image into a quality-gated, animation-ready procedural Three.js model built in code. Use for image-to-3D reconstruction, detail-accurate object rebuilds, stylized/likeness-maximized human characters, sculpt specs, and staged code generation.

FileKindSize
.github/FUNDING.ymlconfig94 B
.github/ISSUE_TEMPLATE/bug_report.ymlconfig2.3 KB
.github/ISSUE_TEMPLATE/contribution_intent.ymlconfig1.8 KB
.github/ISSUE_TEMPLATE/feature_request.ymlconfig1.4 KB
.github/pull_request_template.mdmarkdown1.1 KB
.github/release.ymlconfig471 B
.github/workflows/beta-release.ymlconfig1.9 KB
.github/workflows/ci.ymlconfig349 B
.github/workflows/issue-triage.ymlconfig783 B
.github/workflows/pr-issue-close-policy.ymlconfig279 B
.github/workflows/release.ymlconfig625 B
.gitignoreother2.4 KB
CHANGELOG.mdmarkdown33.1 KB
CLAUDE.mdmarkdown2.8 KB
CONTRIBUTING.mdmarkdown4.7 KB
LAB-FINDINGS.mdmarkdown5.7 KB
LICENSEother11.1 KB
README.mdmarkdown38.9 KB
ROADMAP.mdmarkdown16.3 KB
SKILL.mdskill md30.8 KB
assets/logo.svgother2.0 KB
assets/sponsors/atlas-cloud-logomark-black.svgother595 B
assets/sponsors/atlas-cloud-logomark-white.svgother595 B
assets/sponsors/hyper3d-logomark-black.pngbinary1.1 KB
assets/sponsors/hyper3d-logomark-white.pngbinary1.2 KB
assets/sponsors/tripo-logomark-black.svgother1002 B
assets/sponsors/tripo-logomark-white.svgother1002 B
docs/ARCHITECTURE.mdmarkdown14.0 KB
docs/GLB_ANIMATED_CHARACTER_PROMPT.mdmarkdown13.1 KB
docs/GLB_CHARACTER_ANIMATION_PROMPT.mdmarkdown14.6 KB
docs/GLB_CHARACTER_POLISH_PROMPT.mdmarkdown10.6 KB
docs/GLB_CHARACTER_PROMPT.mdmarkdown19.1 KB
docs/HAIR_PIPELINE.mdmarkdown10.5 KB
docs/RESEARCH_TRELLIS2_TO_IMG2THREEJS.mdmarkdown35.4 KB
docs/STAGE_R_BACKLOG.mdmarkdown18.0 KB
docs/STAGE_R_TEST_PLAN.mdmarkdown14.0 KB
docs/TOKEN_COST.mdmarkdown2.5 KB
docs/UPGRADE_PLAN.mdmarkdown30.4 KB
docs/cs2-anatomy/gloves.mdmarkdown11.6 KB
docs/cs2-anatomy/heavy.mdmarkdown13.8 KB
docs/cs2-anatomy/knives.mdmarkdown18.2 KB
docs/cs2-anatomy/pistols.mdmarkdown12.0 KB
docs/cs2-anatomy/rifles.mdmarkdown13.1 KB
docs/cs2-anatomy/smgs.mdmarkdown13.4 KB
docs/cs2-anatomy/snipers.mdmarkdown13.8 KB
docs/cs2/3D_Technical_Mapping.jsonconfig10.6 KB
docs/cs2/3D_Technical_Reference.mdmarkdown22.2 KB
docs/cs2/3D_Vocabulary_CS2.jsonconfig10.0 KB
docs/cs2/3D_Vocabulary_CS2_Dictionary.mdmarkdown26.6 KB
docs/cs2/distill.mdmarkdown9.9 KB
docs/cs2/review-gates.mdmarkdown2.5 KB
docs/integrations/reference_fidelity_tooling.mdmarkdown6.2 KB
docs/issue-triage.mdmarkdown1.8 KB
docs/materials/IMAGE_MATERIAL_ANALYSIS.mdmarkdown5.0 KB
docs/materials/README.mdmarkdown5.2 KB
docs/materials/THREEJS_MATERIAL_REFERENCE.mdmarkdown11.4 KB
docs/materials/material-reference.jsonconfig55.0 KB
docs/pipelines/character-rigging-animation-1.5.2.mdmarkdown22.3 KB
docs/raw/.keepother0 B
docs/raw/img2threejs-skill-dataset.jsonconfig107.3 KB
docs/specs/render-profile.v2.example.jsonconfig2.6 KB
docs/specs/render-profile.v2.schema.jsonconfig3.8 KB
docs/specs/vocabulary/README.mdmarkdown4.4 KB
docs/specs/vocabulary/core_3d.jsonlother13.2 KB
docs/specs/vocabulary/core_3d_reconstruction.jsonlother56.1 KB
docs/specs/vocabulary/cs2.jsonlother7.1 KB
docs/specs/vocabulary/cs2_reconstruction.jsonlother85.7 KB
docs/standard-prompts/README.mdmarkdown2.2 KB
docs/standard-prompts/build.mdmarkdown5.2 KB
docs/standard-prompts/glb-force-measured.mdmarkdown8.6 KB
docs/standard-prompts/polish.mdmarkdown2.7 KB
docs/standard-prompts/vfx.mdmarkdown5.7 KB
forge/_shared/artifact_cache.pyscript1.7 KB
forge/_shared/chirality.pyscript12.1 KB
forge/_shared/color_metrics.pyscript3.6 KB
forge/_shared/feature_acceptance_policy.pyscript4.2 KB
forge/_shared/image_hash.pyscript4.0 KB
forge/_shared/jpeg.pyscript16.0 KB
forge/_shared/material_physics.pyscript12.2 KB
forge/_shared/pipeline_routing.pyscript7.0 KB
forge/_shared/scalp_field.pyscript14.3 KB
forge/_shared/sdf_primitives.pyscript8.3 KB
forge/_shared/spec_search.pyscript61.9 KB
forge/_shared/spec_search_profiles.jsonconfig1.4 KB
forge/_shared/status_banner.pyscript1.4 KB
forge/_shared/subdivision.pyscript10.5 KB
forge/_shared/vertex_paint.pyscript10.8 KB
forge/_shared/workflow_state.pyscript20.5 KB
forge/materials/__init__.pyscript355 B
forge/materials/compatibility.pyscript5.1 KB
forge/materials/reference.pyscript10.2 KB
forge/next.pyscript4.4 KB
forge/report.pyscript1.5 KB
forge/requirements.txtmanifest335 B
forge/stage1_intake/analyze_texture.pyscript12.1 KB
forge/stage1_intake/bind_detail_properties.pyscript4.6 KB
forge/stage1_intake/build_detail_inventory.pyscript13.0 KB
forge/stage1_intake/camera_fitting_math.pyscript5.5 KB
forge/stage1_intake/camera_fitting_solver.pyscript8.2 KB
forge/stage1_intake/camera_fitting_types.pyscript8.2 KB
forge/stage1_intake/camera_image_helpers.pyscript6.0 KB
forge/stage1_intake/check_intake_correctness.pyscript4.8 KB
forge/stage1_intake/check_reference_admission.pyscript7.6 KB
forge/stage1_intake/cs2_foundation.pyscript7.9 KB
forge/stage1_intake/cs2_manifest.pyscript10.5 KB
forge/stage1_intake/cs2_review_contract.pyscript1.7 KB
forge/stage1_intake/delight_albedo.pyscript14.2 KB
forge/stage1_intake/detect_cs2.pyscript9.7 KB
forge/stage1_intake/detect_reference_effects.pyscript8.9 KB
forge/stage1_intake/extract_cs2_textures.pyscript5.6 KB
forge/stage1_intake/extract_gradient_stops.pyscript5.8 KB
forge/stage1_intake/extract_hair_evidence.pyscript18.6 KB
forge/stage1_intake/extract_landmarks.pyscript16.0 KB
forge/stage1_intake/extract_part_color_recipe.pyscript20.8 KB
forge/stage1_intake/extract_pbr_evidence.pyscript32.5 KB
forge/stage1_intake/fetch_cs2_metadata.pyscript6.4 KB
forge/stage1_intake/label_glb_nodes.pyscript13.0 KB
forge/stage1_intake/locate_cs2_vpk.pyscript2.6 KB
forge/stage1_intake/material_region_analysis.pyscript9.8 KB
forge/stage1_intake/probe_glb.pyscript15.0 KB
forge/stage1_intake/probe_image.pyscript5.4 KB
forge/stage1_intake/run_vision_adapter.pyscript1.6 KB
forge/stage1_intake/search_specs.pyscript7.5 KB
forge/stage1_intake/semantic_decomposition.pyscript4.5 KB
forge/stage1_intake/solve_camera_pose.pyscript10.7 KB
forge/stage2_spec/apply_material_analysis.pyscript8.6 KB
forge/stage2_spec/cs2_adapters.pyscript3.0 KB
forge/stage2_spec/derive_geometry.pyscript4.3 KB
forge/stage2_spec/hair_profile.pyscript14.5 KB
forge/stage2_spec/humanoid_proportions.pyscript9.0 KB
forge/stage2_spec/new_pre_spec_assessment.pyscript12.1 KB
forge/stage2_spec/new_sculpt_spec.pyscript127.4 KB
forge/stage2_spec/validate_sculpt_spec.pyscript144.5 KB
forge/stage3_build/bake_projected_texture.pyscript8.8 KB
forge/stage3_build/decimate.pyscript10.4 KB
forge/stage3_build/generate_threejs_factory.pyscript207.6 KB
forge/stage3_build/module_cache.pyscript5.6 KB
forge/stage3_build/morph_targets.pyscript7.3 KB
forge/stage3_build/orchestrate_passes.pyscript27.6 KB
forge/stage3_build/uv_unwrap.pyscript24.7 KB
forge/stage3_build/visual_hull.pyscript16.4 KB
forge/stage4_review/_fit_divine_eye.pyscript2.6 KB
forge/stage4_review/append_review.pyscript20.4 KB
forge/stage4_review/attachment_anchor.pyscript16.2 KB
forge/stage4_review/calibrate_eye.pyscript5.4 KB
forge/stage4_review/check_part_coverage.pyscript13.1 KB
forge/stage4_review/compare_region_passes.pyscript7.6 KB
forge/stage4_review/correction_loop.pyscript10.2 KB
forge/stage4_review/cs2_review.pyscript8.7 KB
forge/stage4_review/diagnose_render.pyscript15.5 KB
forge/stage4_review/diagnose_render_multi_angle.pyscript5.6 KB
forge/stage4_review/divine_eye.pyscript21.0 KB
forge/stage4_review/fit_params.pyscript16.6 KB
forge/stage4_review/geometry_integrity.pyscript15.1 KB
forge/stage4_review/hair_gate.pyscript9.5 KB
forge/stage4_review/interior_difference.pyscript7.8 KB
forge/stage4_review/joint_loops.pyscript8.2 KB
forge/stage4_review/make_comparison_sheet.pyscript10.9 KB
forge/stage4_review/material_comparator.pyscript7.9 KB
forge/stage4_review/material_feedback.pyscript6.7 KB
forge/stage4_review/material_gate.pyscript5.8 KB
forge/stage4_review/material_views.pyscript7.5 KB
forge/stage4_review/mesh_reference_compare.pyscript16.2 KB
forge/stage4_review/multi_pass.pyscript3.1 KB
forge/stage4_review/objectness.pyscript5.4 KB
forge/stage4_review/pairwise_penetration.pyscript16.2 KB
forge/stage4_review/per_feature.pyscript6.8 KB
forge/stage4_review/render_bridge.pyscript24.1 KB
forge/stage4_review/scalp_exposure.pyscript11.5 KB
forge/stage4_review/self_intersection.pyscript26.3 KB
forge/stage4_review/swept_arc_gate.pyscript14.3 KB
forge/stage4_review/turntable_gate.pyscript17.6 KB
forge/stage4_review/validate_render_profile.pyscript8.9 KB
forge/stage4_review/vertex_region_gate.pyscript20.3 KB
forge/stage4_review/vlm_gate.pyscript8.8 KB
forge/stage5_rig/CONTRACT_1.5.2.mdmarkdown3.6 KB
forge/stage5_rig/NOTES.mdmarkdown8.5 KB
forge/stage5_rig/__init__.pyscript302 B
forge/stage5_rig/action_design.pyscript88.2 KB
forge/stage5_rig/clip_features.pyscript33.2 KB
forge/stage5_rig/emit_animation_runtime.pyscript17.7 KB
forge/stage5_rig/emit_rig.pyscript17.6 KB
forge/stage5_rig/geodesic_skinning.pyscript23.0 KB
forge/stage5_rig/glb_rig_reference.pyscript58.8 KB
forge/stage5_rig/mesh_parity.pyscript36.7 KB
forge/stage5_rig/rig_gates.pyscript78.7 KB
forge/stage5_rig/rig_spec.pyscript6.4 KB
forge/stage5_rig/skin_conditioning.pyscript25.9 KB
forge/stage5_rig/validate_rig_payload.pyscript8.8 KB
forge/state.pyscript3.5 KB
forge/tests/fixtures/implicit_character_torso_limb.jsonconfig1.4 KB
forge/tests/fixtures/knife_review_scene.jsonconfig1.3 KB
forge/tests/fixtures/stand_proud_hair_on_head.jsonconfig3.0 KB
forge/tests/fixtures/subdivision_cage.jsonconfig812 B
forge/tests/fixtures/visual_hull_two_views.jsonconfig2.6 KB
forge/tests/showcase_test_support.pyscript698 B
forge/tests/test_action_design.pyscript37.3 KB
forge/tests/test_albedo_color_space.pyscript4.6 KB
forge/tests/test_analyze_texture.pyscript6.0 KB
forge/tests/test_attachment_anchor.pyscript8.2 KB

docs/materials/material-reference.json

View on GitHub
{
  "schemaVersion": 1,
  "libraryId": "img2threejs.threejs-material-reference",
  "renderer": {
    "engine": "three.js",
    "workflow": "metallic-roughness",
    "defaultMaterial": "MeshPhysicalMaterial",
    "workingColorSpace": "LinearSRGBColorSpace",
    "displayColorSpace": "SRGBColorSpace"
  },
  "research": {
    "provider": "NotebookLM",
    "notebookTitle": "ThreeJS Materials Textures PBR",
    "notebookId": "34554cd6-c897-4077-9561-308876bf2716",
    "researchTaskIds": [
      "5ab630a8-a49a-438f-8b01-284ec879b1d6",
      "434f776e-3947-4182-bef8-9dbb0ef7585f"
    ],
    "deepResearchRuns": [
      {
        "taskId": "5ab630a8-a49a-438f-8b01-284ec879b1d6",
        "focus": "PBR foundations, specialist material models and image-based material recognition",
        "sourcesFound": 101,
        "citedSourcesImported": 73
      },
      {
        "taskId": "434f776e-3947-4182-bef8-9dbb0ef7585f",
        "focus": "Official Three.js and Khronos material property contracts and production recipes",
        "sourcesFound": 100,
        "citedSourcesImported": 52
      }
    ],
    "sourceHierarchy": [
      "Three.js official documentation and source contracts",
      "Khronos glTF specifications and extension specifications",
      "primary rendering research and reference implementations",
      "widely used industry PBR guides"
    ],
    "policy": "Direct Three.js and glTF facts define property contracts. Per-material numbers are bounded starting priors and must be fitted against admitted image evidence and controlled renders."
  },
  "textureContract": {
    "colorMaps": [
      "map",
      "emissiveMap",
      "sheenColorMap",
      "specularColorMap"
    ],
    "colorMapColorSpace": "SRGBColorSpace",
    "dataMaps": [
      "roughnessMap",
      "metalnessMap",
      "normalMap",
      "aoMap",
      "bumpMap",
      "displacementMap",
      "clearcoatMap",
      "clearcoatRoughnessMap",
      "clearcoatNormalMap",
      "sheenRoughnessMap",
      "transmissionMap",
      "thicknessMap",
      "anisotropyMap",
      "iridescenceMap",
      "iridescenceThicknessMap"
    ],
    "dataMapColorSpace": "NoColorSpace",
    "channelPacking": {
      "roughnessMap": "green",
      "metalnessMap": "blue",
      "aoMap": "red; requires UV channel 1",
      "clearcoatMap": "red",
      "clearcoatRoughnessMap": "green",
      "transmissionMap": "red",
      "thicknessMap": "green",
      "sheenRoughnessMap": "alpha",
      "anisotropyMap": "red-green direction, blue strength"
    },
    "environment": {
      "requiredForPbrValidation": true,
      "prefilter": "PMREMGenerator",
      "hdrColorSpace": "LinearSRGBColorSpace"
    }
  },
  "legalRanges": {
    "metalness": [
      0.0,
      1.0
    ],
    "roughness": [
      0.0,
      1.0
    ],
    "clearcoat": [
      0.0,
      1.0
    ],
    "clearcoatRoughness": [
      0.0,
      1.0
    ],
    "sheen": [
      0.0,
      1.0
    ],
    "sheenRoughness": [
      0.0,
      1.0
    ],
    "transmission": [
      0.0,
      1.0
    ],
    "ior": [
      1.0,
      2.333
    ],
    "anisotropy": [
      0.0,
      1.0
    ],
    "iridescence": [
      0.0,
      1.0
    ],
    "dispersion": [
      0.0,
      1.0
    ]
  },
  "sources": [
    {
      "id": "three.mesh-physical",
      "title": "MeshPhysicalMaterial - three.js docs",
      "url": "https://threejs.org/docs/pages/MeshPhysicalMaterial.html",
      "notebookSourceId": "5ded9c1b-a798-4f3c-a5f6-83e6bd0ae6de",
      "authority": "official"
    },
    {
      "id": "three.mesh-standard",
      "title": "MeshStandardMaterial - three.js docs",
      "url": "https://threejs.org/docs/pages/MeshStandardMaterial.html",
      "notebookSourceId": "47ee0b29-95c6-4516-92e7-436332922bca",
      "authority": "official"
    },
    {
      "id": "three.texture",
      "title": "Texture - three.js docs",
      "url": "https://threejs.org/docs/pages/Texture.html",
      "notebookSourceId": "55236b6a-c1a3-45e2-b3b7-4dc635ea5784",
      "authority": "official"
    },
    {
      "id": "three.renderer",
      "title": "WebGLRenderer - three.js docs",
      "url": "https://threejs.org/docs/pages/WebGLRenderer.html",
      "notebookSourceId": "99eb283c-adfe-4a5b-bd6d-584bdb82af2a",
      "authority": "official"
    },
    {
      "id": "three.pmrem",
      "title": "PMREMGenerator - three.js docs",
      "url": "https://threejs.org/docs/pages/PMREMGenerator.html",
      "notebookSourceId": "e7ae92f6-1b92-497a-8ff4-5abe0311741c",
      "authority": "official"
    },
    {
      "id": "three.materials-manual",
      "title": "Materials - three.js manual",
      "url": "https://threejs.org/manual/en/materials.html",
      "notebookSourceId": "54042985-ed61-4074-baf9-4d5b82262e72",
      "authority": "official"
    },
    {
      "id": "three.color-management",
      "title": "Color Management - three.js manual",
      "url": "https://threejs.org/manual/en/color-management.html",
      "notebookSourceId": "eb0350a4-e0d7-48e9-9259-9cd3723d8f5b",
      "authority": "official"
    },
    {
      "id": "gltf.2",
      "title": "glTF 2.0 specification - Khronos Group",
      "url": "https://github.com/KhronosGroup/glTF/tree/main/specification/2.0",
      "notebookSourceId": "fef339d2-4fcd-4663-a423-bb8ad19195bd",
      "authority": "official"
    },
    {
      "id": "khronos.gltf-pbr",
      "title": "glTF 2.0: PBR Materials - Khronos Group",
      "url": "https://www.khronos.org/assets/uploads/developers/library/2017-gtc/glTF-2.0-and-PBR-GTC_May17.pdf",
      "notebookSourceId": "265ebc28-1d0d-4cd5-9d50-108172875c1a",
      "authority": "official"
    },
    {
      "id": "khronos.sheen",
      "title": "KHR_materials_sheen - Khronos Group",
      "url": "https://github.com/KhronosGroup/glTF/blob/main/extensions/2.0/Khronos/KHR_materials_sheen/README.md",
      "notebookSourceId": "a46c7f93-f19e-4a0b-b273-03ffb90018d8",
      "authority": "official"
    },
    {
      "id": "khronos.transmission",
      "title": "KHR_materials_transmission - Khronos Group",
      "url": "https://github.com/KhronosGroup/glTF/blob/main/extensions/2.0/Khronos/KHR_materials_transmission/README.md",
      "notebookSourceId": "8a316973-8bb0-44a7-a8e3-ccfc23074c65",
      "authority": "official"
    },
    {
      "id": "khronos.volume",
      "title": "KHR_materials_volume - Khronos Group",
      "url": "https://github.com/KhronosGroup/glTF/blob/main/extensions/2.0/Khronos/KHR_materials_volume/README.md",
      "notebookSourceId": "5a4ce5ed-1ace-4707-a562-1df5577f5ab3",
      "authority": "official"
    },
    {
      "id": "adobe.pbr-guide-1",
      "title": "The PBR Guide, Part 1 - Adobe Substance 3D",
      "url": "https://www.adobe.com/learn/substance-3d-designer/web/the-pbr-guide-part-1",
      "notebookSourceId": "c09727e9-d489-40bc-82e8-73daa4927d4a",
      "authority": "industry-reference"
    },
    {
      "id": "adobe.pbr-guide-2",
      "title": "The PBR Guide, Part 2 - Adobe Substance 3D",
      "url": "https://www.adobe.com/learn/substance-3d-designer/web/the-pbr-guide-part-2",
      "notebookSourceId": "47bfa258-b6c4-488a-907d-0277286a9da0",
      "authority": "industry-reference"
    },
    {
      "id": "google.filament-pbr",
      "title": "Physically Based Rendering in Filament - Google",
      "url": "https://google.github.io/filament/Filament.md.html",
      "notebookSourceId": "e8f97cd1-9b73-497d-9e55-4de545310d6d",
      "authority": "reference-implementation"
    },
    {
      "id": "mit.material-recognition",
      "title": "Recognizing Materials Using Perceptually Inspired Features - MIT CSAIL",
      "url": "https://people.csail.mit.edu/celiu/pdfs/IJCV13-MaterialRecognition.pdf",
      "notebookSourceId": "f84b37f9-71cb-4830-bb58-ca2f140a88ef",
      "authority": "primary-research"
    },
    {
      "id": "nvidia.faceworks",
      "title": "FaceWorks skin and eye rendering - NVIDIA GameWorks",
      "url": "https://github.com/NVIDIAGameWorks/FaceWorks",
      "notebookSourceId": "dc940b82-dfaf-4857-925e-0b1828df3a64",
      "authority": "reference-implementation"
    },
    {
      "id": "activision.separable-sss",
      "title": "Separable Subsurface Scattering - Activision",
      "url": "https://www.activision.com/cdn/research/Separable_Subsurface_Scattering_Expanded_Technical_Report_NEW.pdf",
      "notebookSourceId": "6f8a4c71-47f3-4b55-93a3-f294ed47b36f",
      "authority": "primary-research"
    },
    {
      "id": "pbrt.hair",
      "title": "Scattering from Hair - Physically Based Rendering",
      "url": "https://pbr-book.org/4ed/Reflection_Models/Scattering_from_Hair",
      "notebookSourceId": "4c538546-148e-4d29-b59f-acce911cd5bc",
      "authority": "reference-text"
    }
  ],
  "materials": [
    {
      "id": "skin.human",
      "aliases": [
        "skin",
        "human skin"
      ],
      "family": "skin",
      "subtype": "human",
      "finish": "natural",
      "model": "dielectric-approximation",
      "recipeBasis": "inferred-starting-prior",
      "renderPrior": {
        "metalness": {
          "default": 0.0,
          "range": [
            0.0,
            0.0
          ]
        },
        "roughness": {
          "default": 0.52,
          "range": [
            0.35,
            0.7
          ]
        },
        "clearcoat": {
          "default": 0.12,
          "range": [
            0.0,
            0.25
          ]
        },
        "clearcoatRoughness": {
          "default": 0.35,
          "range": [
            0.2,
            0.6
          ]
        },
        "ior": {
          "default": 1.4,
          "range": [
            1.33,
            1.5
          ]
        }
      },
      "requiredMaps": [
        "map",
        "roughnessMap",
        "normalMap"
      ],
      "optionalMaps": [
        "aoMap"
      ],
      "visualCues": [
        "warm dielectric diffuse response",
        "broad soft highlights",
        "pores and wrinkles at micro scale"
      ],
      "confusableWith": [
        "plastic.matte",
        "rubber.matte",
        "coating.paint-matte"
      ],
      "validationViews": [
        "albedo-unlit",
        "neutral-studio",
        "grazing",
        "reference-beauty"
      ],
      "limitations": [
        "MeshPhysicalMaterial has no true multilayer skin subsurface scattering"
      ],
      "sourceRefs": [
        "three.mesh-physical",
        "three.mesh-standard",
        "nvidia.faceworks",
        "activision.separable-sss",
        "mit.material-recognition"
      ]
    },
    {
      "id": "hair.human",
      "aliases": [
        "hair",
        "human hair"
      ],
      "family": "hair",
      "subtype": "human",
      "finish": "strand-directional",
      "model": "anisotropic-dielectric-approximation",
      "recipeBasis": "inferred-starting-prior",
      "renderPrior": {
        "metalness": {
          "default": 0.0,
          "range": [
            0.0,
            0.0
          ]
        },
        "roughness": {
          "default": 0.45,
          "range": [
            0.3,
            0.7
          ]
        },
        "anisotropy": {
          "default": 0.65,
          "range": [
            0.4,
            1.0
          ]
        },
        "sheen": {
          "default": 0.45,
          "range": [
            0.2,
            0.8
          ]
        },
        "sheenRoughness": {
          "default": 0.35,
          "range": [
            0.2,
            0.6
          ]
        },
        "ior": {
          "default": 1.5,
          "range": [
            1.4,
            1.6
          ]
        }
      },
      "requiredMaps": [
        "map",
        "roughnessMap",
        "normalMap",
        "anisotropyMap"
      ],
      "optionalMaps": [
        "aoMap"
      ],
      "visualCues": [
        "elongated highlights follow strand or clump direction",
        "silhouette breakup",
        "dark masses retain directional specular"
      ],
      "confusableWith": [
        "fabric.velvet",
        "plastic.glossy",
        "rubber.matte"
      ],
      "validationViews": [
        "neutral-studio",
        "grazing",
        "environment-reflection",
        "reference-beauty"
      ],
      "limitations": [
        "Use geometry clumps or cards for silhouette; a normal map cannot replace hair volume"
      ],
      "sourceRefs": [
        "three.mesh-physical",
        "pbrt.hair",
        "mit.material-recognition"
      ]
    },
    {
      "id": "hair.human.code-only",
      "aliases": [
        "hair code only",
        "procedural hair",
        "untextured hair"
      ],
      "family": "hair",
      "subtype": "human-code-only",
      "finish": "strand-directional",
      "model": "anisotropic-dielectric-approximation",
      "recipeBasis": "inferred-starting-prior",
      "renderPrior": {
        "metalness": {
          "default": 0.0,
          "range": [
            0.0,
            0.0
          ]
        },
        "roughness": {
          "default": 0.38,
          "range": [
            0.25,
            0.6
          ]
        },
        "anisotropy": {
          "default": 0.8,
          "range": [
            0.5,
            1.0
          ]
        },
        "sheen": {
          "default": 0.6,
          "range": [
            0.35,
            0.9
          ]
        },
        "sheenRoughness": {
          "default": 0.3,
          "range": [
            0.15,
            0.5
          ]
        },
        "ior": {
          "default": 1.55,
          "range": [
            1.45,
            1.6
          ]
        }
      },
      "requiredMaps": [],
      "optionalMaps": [],
      "visualCues": [
        "one broad highlight band running across the mass, not per-strand speculars",
        "root darker than tip",
        "facet edges read as clump boundaries"
      ],
      "confusableWith": [
        "hair.human",
        "fabric.velvet",
        "plastic.glossy"
      ],
      "validationViews": [
        "neutral-studio",
        "grazing",
        "reference-beauty"
      ],
      "limitations": [
        "No maps by construction: this pipeline emits code, so anisotropyMap and normalMap are unavailable and every value here has to carry the whole strand impression on its own.",
        "Priors are pushed above hair.human deliberately: on the reference scan the hair surface is smooth (radial roughness 0.00338 against a torso control of 0.00312) and its entire strand appearance lives in the diffuse and normal textures. Without those textures, sheen and anisotropy are the only remaining carriers.",
        "Not calibrated against a reference render. No multipart GLB with separated hair geometry exists to fit these against, so they are a documented starting point and not a measurement."
      ],
      "sourceRefs": [
        "three.mesh-physical",
        "pbrt.hair"
      ],
      "colorPrior": {
        "sheenColor": {
          "default": "#fff6e8",
          "note": "REQUIRED whenever sheen > 0: three's default sheenColor is 0x000000 and the sheen term is a multiply by that colour, so sheen alone contributes exactly zero (WebGLMaterials.js:408). Warm off-white because a hair highlight carries the light's tint, not the hair's."
        }
      }
    },
    {
      "id": "skin.human.code-only",
      "aliases": [
        "skin code only",
        "procedural skin",
        "untextured skin"
      ],
      "family": "skin",
      "subtype": "human-code-only",
      "finish": "natural",
      "model": "clearcoat-over-warm-dielectric",
      "recipeBasis": "inferred-starting-prior",
      "renderPrior": {
        "metalness": {
          "default": 0.0,
          "range": [
            0.0,
            0.0
          ]
        },
        "roughness": {
          "default": 0.55,
          "range": [
            0.4,
            0.75
          ]
        },
        "clearcoat": {
          "default": 0.18,
          "range": [
            0.08,
            0.32
          ]
        },
        "clearcoatRoughness": {
          "default": 0.38,
          "range": [
            0.0525,
            0.6
          ],
          "note": "The low bound is three's own floor: max(clearcoatRoughness, 0.0525) at lights_physical_fragment.glsl.js:72. A smaller number renders as exactly 0.0525."
        },
        "ior": {
          "default": 1.4,
          "range": [
            1.33,
            1.5
          ]
        }
      },
      "requiredMaps": [],
      "optionalMaps": [],
      "forbiddenProperties": [
        "transmission",
        "thickness",
        "attenuationDistance"
      ],
      "visualCues": [
        "broad soft highlight that moves with the light, not a tight specular dot",
        "warm diffuse base",
        "tone varies by region: forehead lighter, cheek warmer, jaw cooler"
      ],
      "confusableWith": [
        "plastic.matte",
        "rubber.matte",
        "skin.human"
      ],
      "validationViews": [
        "albedo-unlit",
        "neutral-studio",
        "grazing",
        "reference-beauty"
      ],
      "limitations": [
        "No maps by construction: this pipeline emits code, so map/roughnessMap/normalMap are unavailable and the whole skin impression rests on base colour, clearcoat and per-region tone.",
        "MeshPhysicalMaterial has no true multilayer subsurface scattering, and transmission is NOT a substitute -- it is a screen-space refraction (glass) model that on a closed body mesh renders a glassy figure and costs an extra render target. transmission/thickness are therefore forbidden on this family.",
        "clearcoatRoughness has geometryRoughness ADDED at shade time (lights_physical_fragment.glsl.js:73), so a value tuned on smooth geometry reads blurrier flat-shaded. Author it on the final tessellation.",
        "Not calibrated against a reference render. These are a documented starting point, not a measurement."
      ],
      "sourceRefs": [
        "three.mesh-physical",
        "nvidia.faceworks"
      ]
    },
    {
      "id": "fabric.woven-matte.code-only",
      "aliases": [
        "fabric code only",
        "procedural cloth",
        "untextured cloth"
      ],
      "family": "fabric",
      "subtype": "woven-code-only",
      "finish": "matte",
      "model": "sheen-dielectric",
      "recipeBasis": "inferred-starting-prior",
      "renderPrior": {
        "metalness": {
          "default": 0.0,
          "range": [
            0.0,
            0.0
          ]
        },
        "roughness": {
          "default": 0.9,
          "range": [
            0.75,
            1.0
          ]
        },
        "sheen": {
          "default": 0.7,
          "range": [
            0.4,
            1.0
          ]
        },
        "sheenRoughness": {
          "default": 0.85,
          "range": [
            0.6,
            1.0
          ],
          "note": "High for cotton/linen/wool: a broad soft rim. Drop toward 0.2 only for a visible satin rim, and never on sparse geometry where a tight rim lands on a few facets and reads as plastic."
        },
        "ior": {
          "default": 1.5,
          "range": [
            1.45,
            1.55
          ]
        }
      },
      "requiredMaps": [],
      "optionalMaps": [],
      "visualCues": [
        "diffuse body with a grazing-angle rim",
        "soft broad highlights",
        "folds and hems read as geometry, never as texture"
      ],
      "confusableWith": [
        "leather.matte",
        "rubber.matte",
        "plastic.matte",
        "fabric.woven-matte"
      ],
      "validationViews": [
        "albedo-unlit",
        "neutral-studio",
        "grazing",
        "reference-beauty"
      ],
      "limitations": [
        "No maps by construction, so sheen is the entire woven cue available.",
        "Enabling sheen DARKENS this material's own diffuse base by 0.157 x effective sheen strength (sheenEnergyComp, meshphysical.glsl.js:205). Author the base colour brighter by 1/(1-darkening) or the render lands darker than the reference at every non-grazing angle.",
        "Large folds and hems belong in geometry, per fabric.woven-matte. A code-only profile cannot fake them with a normal map.",
        "A garment shell with an open hem, cuff or collar must set side to DoubleSide; three defaults to FrontSide and culls the backfaces, so the opening renders as a hole.",
        "Not calibrated against a reference render."
      ],
      "sourceRefs": [
        "three.mesh-physical",
        "khronos.sheen"
      ],
      "colorPrior": {
        "sheenColor": {
          "default": "#f2ece2",
          "note": "REQUIRED whenever sheen > 0. sheen and sheenColor are multiplied into ONE uniform before upload (WebGLMaterials.js:408), so they are a single degree of freedom -- extract the tint, keep sheen as an authored strength."
        }
      }
    },
    {
      "id": "fur.stylized",
      "aliases": [
        "fur",
        "animal fur"
      ],
      "family": "fur",
      "subtype": "stylized",
      "finish": "fibre-matte",
      "model": "sheen-dielectric-approximation",
      "recipeBasis": "inferred-starting-prior",
      "renderPrior": {
        "metalness": {
          "default": 0.0,
          "range": [
            0.0,
            0.0
          ]
        },
        "roughness": {
          "default": 0.78,
          "range": [
            0.55,
            1.0
          ]
        },
        "sheen": {
          "default": 0.45,
          "range": [
            0.2,
            0.8
          ]
        },
        "sheenRoughness": {
          "default": 0.75,
          "range": [
            0.5,
            1.0
          ]
        }
      },
      "requiredMaps": [
        "map",
        "roughnessMap",
        "normalMap"
      ],
      "optionalMaps": [
        "sheenColorMap",
        "sheenRoughnessMap",
        "aoMap"
      ],
      "visualCues": [
        "soft grazing response",
        "directional fibres",
        "broken outer silhouette"
      ],
      "confusableWith": [
        "fabric.velvet",
        "hair.human"
      ],
      "validationViews": [
        "neutral-studio",
        "grazing",
        "reference-beauty"
      ],
      "limitations": [
        "Geometry shells, tufts or cards are required for identity-scale fur"
      ],
      "sourceRefs": [
        "three.mesh-physical",
        "pbrt.hair",
        "khronos.sheen"
      ]
    },
    {
      "id": "fabric.woven-matte",
      "aliases": [
        "fabric",
        "cloth",
        "cotton",
        "linen"
      ],
      "family": "fabric",
      "subtype": "woven",
      "finish": "matte",
      "model": "sheen-dielectric",
      "recipeBasis": "inferred-starting-prior",
      "renderPrior": {
        "metalness": {
          "default": 0.0,
          "range": [
            0.0,
            0.0
          ]
        },
        "roughness": {
          "default": 0.85,
          "range": [
            0.7,
            1.0
          ]
        },
        "sheen": {
          "default": 0.65,
          "range": [
            0.3,
            1.0
          ]
        },
        "sheenRoughness": {
          "default": 0.75,
          "range": [
            0.5,
            1.0
          ]
        }
      },
      "requiredMaps": [
        "map",
        "roughnessMap",
        "normalMap"
      ],
      "optionalMaps": [
        "sheenColorMap",
        "sheenRoughnessMap",
        "aoMap"
      ],
      "visualCues": [
        "diffuse body with grazing-angle sheen",
        "woven directional microstructure",
        "soft broad highlights"
      ],
      "confusableWith": [
        "leather.matte",
        "rubber.matte",
        "plastic.matte"
      ],
      "validationViews": [
        "albedo-unlit",
        "neutral-studio",
        "grazing",
        "reference-beauty"
      ],
      "limitations": [
        "Large folds and hems belong in geometry"
      ],
      "sourceRefs": [
        "three.mesh-physical",
        "three.texture",
        "khronos.sheen",
        "mit.material-recognition"
      ]
    },
    {
      "id": "fabric.silk-satin",
      "aliases": [
        "silk",
        "satin"
      ],
      "family": "fabric",
      "subtype": "silk-satin",
      "finish": "smooth-directional",
      "model": "sheen-anisotropic-dielectric",
      "recipeBasis": "inferred-starting-prior",
      "renderPrior": {
        "metalness": {
          "default": 0.0,
          "range": [
            0.0,
            0.0
          ]
        },
        "roughness": {
          "default": 0.32,
          "range": [
            0.18,
            0.55
          ]
        },
        "sheen": {
          "default": 0.85,
          "range": [
            0.5,
            1.0
          ]
        },
        "sheenRoughness": {
          "default": 0.4,
          "range": [
            0.2,
            0.65
          ]
        },
        "anisotropy": {
          "default": 0.45,
          "range": [
            0.2,
            0.8
          ]
        }
      },
      "requiredMaps": [
        "map",
        "roughnessMap",
        "normalMap",
        "anisotropyMap"
      ],
      "optionalMaps": [
        "sheenColorMap",
        "sheenRoughnessMap"
      ],
      "visualCues": [
        "bright moving grazing highlight",
        "directional weave response",
        "smooth drape"
      ],
      "confusableWith": [
        "plastic.glossy",
        "coating.paint-gloss",
        "fabric.woven-matte"
      ],
      "validationViews": [
        "neutral-studio",
        "grazing",
        "environment-reflection",
        "reference-beauty"
      ],
      "limitations": [
        "Highlight direction must follow the authored fibre tangent"
      ],
      "sourceRefs": [
        "three.mesh-physical",
        "khronos.sheen",
        "google.filament-pbr"
      ]
    },
    {
      "id": "fabric.velvet",
      "aliases": [
        "velvet",
        "nhung"
      ],
      "family": "fabric",
      "subtype": "velvet",
      "finish": "pile-sheen",
      "model": "sheen-dielectric",
      "recipeBasis": "inferred-starting-prior",
      "renderPrior": {
        "metalness": {
          "default": 0.0,
          "range": [
            0.0,
            0.0
          ]
        },
        "roughness": {
          "default": 0.72,
          "range": [
            0.55,
            0.95
          ]
        },
        "sheen": {
          "default": 1.0,
          "range": [
            0.75,
            1.0
          ]
        },
        "sheenRoughness": {
          "default": 0.65,
          "range": [
            0.4,
            0.9
          ]
        }
      },
      "requiredMaps": [
        "map",
        "roughnessMap",
        "normalMap",
        "sheenColorMap"
      ],
      "optionalMaps": [
        "sheenRoughnessMap",
        "aoMap"
      ],
      "visualCues": [
        "dark frontal body",
        "strong soft rim or grazing sheen",
        "pile direction changes tone"
      ],
      "confusableWith": [
        "fur.stylized",
        "hair.human",
        "fabric.woven-matte"
      ],
      "validationViews": [
        "neutral-studio",
        "grazing",
        "reference-beauty"
      ],
      "limitations": [
        "Short pile is an approximation without a fibre shader"
      ],
      "sourceRefs": [
        "three.mesh-physical",
        "khronos.sheen",
        "google.filament-pbr"
      ]
    },
    {
      "id": "leather.matte",
      "aliases": [
        "leather",
        "matte leather"
      ],
      "family": "leather",
      "subtype": "natural-or-synthetic",
      "finish": "matte-worn",
      "model": "dielectric",
      "recipeBasis": "inferred-starting-prior",
      "renderPrior": {
        "metalness": {
          "default": 0.0,
          "range": [
            0.0,
            0.0
          ]
        },
        "roughness": {
          "default": 0.62,
          "range": [
            0.35,
            0.85
          ]
        },
        "clearcoat": {
          "default": 0.08,
          "range": [
            0.0,
            0.3
          ]
        },
        "clearcoatRoughness": {
          "default": 0.45,
          "range": [
            0.2,
            0.8
          ]
        }
      },
      "requiredMaps": [
        "map",
        "roughnessMap",
        "normalMap"
      ],
      "optionalMaps": [
        "aoMap",
        "clearcoatMap"
      ],
      "visualCues": [
        "irregular grain",
        "worn edges become smoother",
        "creases darken without becoming metallic"
      ],
      "confusableWith": [
        "fabric.woven-matte",
        "rubber.matte",
        "plastic.matte"
      ],
      "validationViews": [
        "albedo-unlit",
        "neutral-studio",
        "grazing",
        "reference-beauty"
      ],
      "limitations": [
        "Single images rarely prove natural versus synthetic leather"
      ],
      "sourceRefs": [
        "three.mesh-physical",
        "three.mesh-standard",
        "adobe.pbr-guide-2",
        "mit.material-recognition"
      ]
    },
    {
      "id": "metal.steel-polished",
      "aliases": [
        "polished steel",
        "chrome",
        "stainless steel"
      ],
      "family": "metal",
      "subtype": "steel",
      "finish": "polished",
      "model": "conductor",
      "recipeBasis": "inferred-starting-prior",
      "renderPrior": {
        "metalness": {
          "default": 1.0,
          "range": [
            1.0,
            1.0
          ]
        },
        "roughness": {
          "default": 0.12,
          "range": [
            0.03,
            0.25
          ]
        },
        "anisotropy": {
          "default": 0.0,
          "range": [
            0.0,
            0.15
          ]
        }
      },
      "requiredMaps": [
        "map",
        "roughnessMap"
      ],
      "optionalMaps": [
        "normalMap",
        "metalnessMap"
      ],
      "visualCues": [
        "neutral tinted environment reflection",
        "sharp high-contrast highlights",
        "little diffuse body colour"
      ],
      "confusableWith": [
        "metal.aluminum",
        "coating.metallic-paint",
        "plastic.glossy"
      ],
      "validationViews": [
        "neutral-studio",
        "environment-reflection",
        "grazing",
        "reference-beauty"
      ],
      "limitations": [
        "A meaningful environment map is mandatory; flat lighting cannot validate polished metal"
      ],
      "sourceRefs": [
        "three.mesh-standard",
        "three.pmrem",
        "gltf.2",
        "khronos.gltf-pbr",
        "adobe.pbr-guide-2",
        "google.filament-pbr"
      ]
    },
    {
      "id": "metal.steel-brushed",
      "aliases": [
        "brushed steel",
        "machined steel"
      ],
      "family": "metal",
      "subtype": "steel",
      "finish": "brushed",
      "model": "anisotropic-conductor",
      "recipeBasis": "inferred-starting-prior",
      "renderPrior": {
        "metalness": {
          "default": 1.0,
          "range": [
            1.0,
            1.0
          ]
        },
        "roughness": {
          "default": 0.35,
          "range": [
            0.2,
            0.55
          ]
        },
        "anisotropy": {
          "default": 0.85,
          "range": [
            0.5,
            1.0
          ]
        }
      },
      "requiredMaps": [
        "map",
        "roughnessMap",
        "normalMap",
        "anisotropyMap"
      ],
      "optionalMaps": [
        "metalnessMap"
      ],
      "visualCues": [
        "elongated highlight aligned to brushing",
        "neutral conductor reflection",
        "parallel micro-scratches"
      ],
      "confusableWith": [
        "metal.aluminum",
        "plastic.glossy"
      ],
      "validationViews": [
        "neutral-studio",
        "grazing",
        "environment-reflection",
        "reference-beauty"
      ],
      "limitations": [
        "Anisotropy direction must agree with geometry tangent and visible brushing"
      ],
      "sourceRefs": [
        "three.mesh-physical",
        "three.pmrem",
        "gltf.2",
        "khronos.gltf-pbr",
        "adobe.pbr-guide-2",
        "google.filament-pbr"
      ]
    },
    {
      "id": "metal.aluminum",
      "aliases": [
        "aluminum",
        "aluminium"
      ],
      "family": "metal",
      "subtype": "aluminum",
      "finish": "satin",
      "model": "conductor",
      "recipeBasis": "inferred-starting-prior",
      "renderPrior": {
        "metalness": {
          "default": 1.0,
          "range": [
            1.0,
            1.0
          ]
        },
        "roughness": {
          "default": 0.3,
          "range": [
            0.15,
            0.55
          ]
        },
        "anisotropy": {
          "default": 0.2,
          "range": [
            0.0,
            0.8
          ]
        }
      },
      "requiredMaps": [
        "map",
        "roughnessMap"
      ],
      "optionalMaps": [
        "normalMap",
        "anisotropyMap"
      ],
      "visualCues": [
        "bright neutral conductor",
        "soft satin highlight unless polished",
        "often fine machining direction"
      ],
      "confusableWith": [
        "metal.steel-polished",
        "coating.metallic-paint"
      ],
      "validationViews": [
        "neutral-studio",
        "environment-reflection",
        "grazing"
      ],
      "limitations": [
        "Steel versus aluminium may require context or metadata"
      ],
      "sourceRefs": [
        "three.mesh-standard",
        "three.pmrem",
        "gltf.2",
        "khronos.gltf-pbr",
        "adobe.pbr-guide-2",
        "google.filament-pbr"
      ]
    },
    {
      "id": "metal.copper",
      "aliases": [
        "copper"
      ],
      "family": "metal",
      "subtype": "copper",
      "finish": "polished-or-aged",
      "model": "coloured-conductor",
      "recipeBasis": "inferred-starting-prior",
      "renderPrior": {
        "metalness": {
          "default": 1.0,
          "range": [
            1.0,
            1.0
          ]
        },
        "roughness": {
          "default": 0.28,
          "range": [
            0.08,
            0.65
          ]
        }
      },
      "requiredMaps": [
        "map",
        "roughnessMap"
      ],
      "optionalMaps": [
        "normalMap",
        "metalnessMap",
        "aoMap"
      ],
      "visualCues": [
        "warm red-orange conductor reflection",
        "patina may create rough dielectric corrosion regions"
      ],
      "confusableWith": [
        "metal.brass",
        "coating.metallic-paint"
      ],
      "validationViews": [
        "albedo-unlit",
        "environment-reflection",
        "grazing",
        "reference-beauty"
      ],
      "limitations": [
        "Patina and oxidation require region masks rather than one uniform metal recipe"
      ],
      "sourceRefs": [
        "three.mesh-standard",
        "gltf.2",
        "khronos.gltf-pbr",
        "adobe.pbr-guide-2",
        "google.filament-pbr"
      ]
    },
    {
      "id": "metal.brass",
      "aliases": [
        "brass",
        "bronze"
      ],
      "family": "metal",
      "subtype": "brass-bronze",
      "finish": "polished-or-aged",
      "model": "coloured-conductor",
      "recipeBasis": "inferred-starting-prior",
      "renderPrior": {
        "metalness": {
          "default": 1.0,
          "range": [
            1.0,
            1.0
          ]
        },
        "roughness": {
          "default": 0.3,
          "range": [
            0.1,
            0.65
          ]
        }
      },
      "requiredMaps": [
        "map",
        "roughnessMap"
      ],
      "optionalMaps": [
        "normalMap",
        "aoMap",
        "metalnessMap"
      ],
      "visualCues": [
        "warm yellow-to-brown conductor reflection",
        "aged recesses darken and roughen"
      ],
      "confusableWith": [
        "metal.gold",
        "metal.copper",
        "coating.metallic-paint"
      ],
      "validationViews": [
        "albedo-unlit",
        "environment-reflection",
        "grazing",
        "reference-beauty"
      ],
      "limitations": [
        "Brass versus bronze versus gold may require context or metadata"
      ],
      "sourceRefs": [
        "three.mesh-standard",
        "gltf.2",
        "khronos.gltf-pbr",
        "adobe.pbr-guide-2",
        "google.filament-pbr"
      ]
    },
    {
      "id": "metal.gold",
      "aliases": [
        "gold"
      ],
      "family": "metal",
      "subtype": "gold",
      "finish": "polished",
      "model": "coloured-conductor",
      "recipeBasis": "inferred-starting-prior",
      "renderPrior": {
        "metalness": {
          "default": 1.0,
          "range": [
            1.0,
            1.0
          ]
        },
        "roughness": {
          "default": 0.22,
          "range": [
            0.08,
            0.45
          ]
        }
      },
      "requiredMaps": [
        "map",
        "roughnessMap"
      ],
      "optionalMaps": [
        "normalMap",
        "metalnessMap"
      ],
      "visualCues": [
        "yellow conductor reflection rather than yellow diffuse paint",
        "strong environment-dependent highlight"
      ],
      "confusableWith": [
        "metal.brass",
        "coating.metallic-paint"
      ],
      "validationViews": [
        "albedo-unlit",
        "environment-reflection",
        "grazing",
        "reference-beauty"
      ],
      "limitations": [
        "Gold identity should not be inferred from yellow albedo alone"
      ],
      "sourceRefs": [
        "three.mesh-standard",
        "three.pmrem",
        "gltf.2",
        "khronos.gltf-pbr",
        "adobe.pbr-guide-2",
        "google.filament-pbr"
      ]
    },
    {
      "id": "coating.painted-metal",
      "aliases": [
        "painted metal",
        "coated metal"
      ],
      "family": "coating",
      "subtype": "paint-over-metal",
      "finish": "gloss-or-satin",
      "model": "coated-dielectric",
      "recipeBasis": "inferred-starting-prior",
      "renderPrior": {
        "metalness": {
          "default": 0.0,
          "range": [
            0.0,
            0.1
          ]
        },
        "roughness": {
          "default": 0.45,
          "range": [
            0.2,
            0.7
          ]
        },
        "clearcoat": {
          "default": 0.75,
          "range": [
            0.0,
            1.0
          ]
        },
        "clearcoatRoughness": {
          "default": 0.12,
          "range": [
            0.02,
            0.35
          ]
        },
        "ior": {
          "default": 1.5,
          "range": [
            1.35,
            1.65
          ]
        }
      },
      "requiredMaps": [
        "map",
        "roughnessMap"
      ],
      "optionalMaps": [
        "normalMap",
        "clearcoatMap",
        "clearcoatRoughnessMap",
        "metalnessMap"
      ],
      "visualCues": [
        "diffuse paint colour under a separate glossy coat",
        "chips may expose metallic substrate"
      ],
      "confusableWith": [
        "plastic.glossy",
        "metal.gold",
        "metal.steel-polished"
      ],
      "validationViews": [
        "albedo-unlit",
        "neutral-studio",
        "grazing",
        "environment-reflection",
        "reference-beauty"
      ],
      "limitations": [
        "Intact paint is dielectric; exposed substrate needs a separate region or mask"
      ],
      "sourceRefs": [
        "three.mesh-physical",
        "gltf.2",
        "khronos.gltf-pbr",
        "adobe.pbr-guide-1",
        "adobe.pbr-guide-2"
      ]
    },
    {
      "id": "plastic.glossy",
      "aliases": [
        "glossy plastic",
        "acrylic"
      ],
      "family": "plastic",
      "subtype": "generic-polymer",
      "finish": "glossy",
      "model": "dielectric",
      "recipeBasis": "inferred-starting-prior",
      "renderPrior": {
        "metalness": {
          "default": 0.0,
          "range": [
            0.0,
            0.0
          ]
        },
        "roughness": {
          "default": 0.28,
          "range": [
            0.12,
            0.5
          ]
        },
        "clearcoat": {
          "default": 0.2,
          "range": [
            0.0,
            0.6
          ]
        },
        "clearcoatRoughness": {
          "default": 0.18,
          "range": [
            0.05,
            0.4
          ]
        },
        "ior": {
          "default": 1.5,
          "range": [
            1.4,
            1.65
          ]
        }
      },
      "requiredMaps": [
        "map",
        "roughnessMap"
      ],
      "optionalMaps": [
        "normalMap",
        "clearcoatMap"
      ],
      "visualCues": [
        "untinted or light-coloured specular over coloured diffuse body",
        "smooth molded surface"
      ],
      "confusableWith": [
        "coating.painted-metal",
        "ceramic.glazed",
        "metal.steel-polished"
      ],
      "validationViews": [
        "neutral-studio",
        "grazing",
        "environment-reflection",
        "reference-beauty"
      ],
      "limitations": [
        "Do not set metalness from highlight sharpness alone"
      ],
      "sourceRefs": [
        "three.mesh-physical",
        "three.mesh-standard",
        "adobe.pbr-guide-1",
        "google.filament-pbr",
        "mit.material-recognition"
      ]
    },
    {
      "id": "plastic.matte",
      "aliases": [
        "matte plastic",
        "polymer"
      ],
      "family": "plastic",
      "subtype": "generic-polymer",
      "finish": "matte",
      "model": "dielectric",
      "recipeBasis": "inferred-starting-prior",
      "renderPrior": {
        "metalness": {
          "default": 0.0,
          "range": [
            0.0,
            0.0
          ]
        },
        "roughness": {
          "default": 0.68,
          "range": [
            0.48,
            0.88
          ]
        },
        "ior": {
          "default": 1.5,
          "range": [
            1.4,
            1.65
          ]
        }
      },
      "requiredMaps": [
        "map",
        "roughnessMap"
      ],
      "optionalMaps": [
        "normalMap",
        "aoMap"
      ],
      "visualCues": [
        "coloured diffuse body",
        "broad neutral highlight",
        "mold seams or fine stipple"
      ],
      "confusableWith": [
        "rubber.matte",
        "leather.matte",
        "skin.human"
      ],
      "validationViews": [
        "albedo-unlit",
        "neutral-studio",
        "grazing"
      ],
      "limitations": [
        "Context and texture frequency often distinguish matte plastics from rubber"
      ],
      "sourceRefs": [
        "three.mesh-standard",
        "adobe.pbr-guide-1",
        "google.filament-pbr",
        "mit.material-recognition"
      ]
    },
    {
      "id": "rubber.matte",
      "aliases": [
        "rubber",
        "matte rubber",
        "cao su"
      ],
      "family": "rubber",
      "subtype": "generic-elastomer",
      "finish": "matte",
      "model": "dielectric",
      "recipeBasis": "inferred-starting-prior",
      "renderPrior": {
        "metalness": {
          "default": 0.0,
          "range": [
            0.0,
            0.0
          ]
        },
        "roughness": {
          "default": 0.88,
          "range": [
            0.68,
            1.0
          ]
        },
        "ior": {
          "default": 1.48,
          "range": [
            1.4,
            1.55
          ]
        }
      },
      "requiredMaps": [
        "map",
        "roughnessMap",
        "normalMap"
      ],
      "optionalMaps": [
        "aoMap"
      ],
      "visualCues": [
        "dark diffuse body",
        "weak broad highlight",
        "molded or grippy microtexture"
      ],
      "confusableWith": [
        "plastic.matte",
        "leather.matte",
        "fabric.woven-matte"
      ],
      "validationViews": [
        "albedo-unlit",
        "neutral-studio",
        "grazing",
        "reference-beauty"
      ],
      "limitations": [
        "Wet or polished rubber needs a separate finish record"
      ],
      "sourceRefs": [
        "three.mesh-standard",
        "adobe.pbr-guide-1",
        "google.filament-pbr",
        "mit.material-recognition"
      ]
    },
    {
      "id": "wood.unfinished",
      "aliases": [
        "wood",
        "raw wood"
      ],
      "family": "wood",
      "subtype": "generic",
      "finish": "unfinished",
      "model": "directional-dielectric",
      "recipeBasis": "inferred-starting-prior",
      "renderPrior": {
        "metalness": {
          "default": 0.0,
          "range": [
            0.0,
            0.0
          ]
        },
        "roughness": {
          "default": 0.72,
          "range": [
            0.5,
            0.95
          ]
        },
        "anisotropy": {
          "default": 0.12,
          "range": [
            0.0,
            0.4
          ]
        }
      },
      "requiredMaps": [
        "map",
        "roughnessMap",
        "normalMap"
      ],
      "optionalMaps": [
        "aoMap",
        "anisotropyMap"
      ],
      "visualCues": [
        "directional grain",
        "pores and growth rings",
        "roughness follows grain and wear"
      ],
      "confusableWith": [
        "plastic.matte",
        "leather.matte"
      ],
      "validationViews": [
        "albedo-unlit",
        "neutral-studio",
        "grazing"
      ],
      "limitations": [
        "Species identity cannot usually be established from a small crop"
      ],
      "sourceRefs": [
        "three.mesh-standard",
        "three.texture",
        "adobe.pbr-guide-1",
        "mit.material-recognition"
      ]
    },
    {
      "id": "wood.varnished",
      "aliases": [
        "varnished wood",
        "lacquered wood"
      ],
      "family": "wood",
      "subtype": "generic",
      "finish": "varnished",
      "model": "coated-dielectric",
      "recipeBasis": "inferred-starting-prior",
      "renderPrior": {
        "metalness": {
          "default": 0.0,
          "range": [
            0.0,
            0.0
          ]
        },
        "roughness": {
          "default": 0.42,
          "range": [
            0.25,
            0.65
          ]
        },
        "clearcoat": {
          "default": 0.75,
          "range": [
            0.35,
            1.0
          ]
        },
        "clearcoatRoughness": {
          "default": 0.16,
          "range": [
            0.04,
            0.35
          ]
        },
        "ior": {
          "default": 1.5,
          "range": [
            1.4,
            1.6
          ]
        }
      },
      "requiredMaps": [
        "map",
        "roughnessMap",
        "normalMap"
      ],
      "optionalMaps": [
        "clearcoatMap",
        "clearcoatRoughnessMap",
        "aoMap"
      ],
      "visualCues": [
        "wood grain under a separate glossy layer",
        "coating scratches differ from grain"
      ],
      "confusableWith": [
        "plastic.glossy",
        "coating.painted-metal"
      ],
      "validationViews": [
        "albedo-unlit",
        "neutral-studio",
        "grazing",
        "environment-reflection"
      ],
      "limitations": [
        "Do not bake the coating highlight into the grain albedo"
      ],
      "sourceRefs": [
        "three.mesh-physical",
        "three.texture",
        "adobe.pbr-guide-1",
        "google.filament-pbr"
      ]
    },
    {
      "id": "stone.natural",
      "aliases": [
        "stone",
        "rock",
        "granite",
        "marble"
      ],
      "family": "stone",
      "subtype": "natural",
      "finish": "rough-or-polished",
      "model": "dielectric",
      "recipeBasis": "inferred-starting-prior",
      "renderPrior": {
        "metalness": {
          "default": 0.0,
          "range": [
            0.0,
            0.0
          ]
        },
        "roughness": {
          "default": 0.78,
          "range": [
            0.25,
            1.0
          ]
        },
        "clearcoat": {
          "default": 0.0,
          "range": [
            0.0,
            0.35
          ]
        }
      },
      "requiredMaps": [
        "map",
        "roughnessMap",
        "normalMap"
      ],
      "optionalMaps": [
        "aoMap",
        "displacementMap",
        "clearcoatMap"
      ],
      "visualCues": [
        "multi-scale mineral pattern",
        "fracture or pore relief",
        "polished stone retains dielectric reflection"
      ],
      "confusableWith": [
        "ceramic.glazed",
        "plastic.matte",
        "coating.paint-matte"
      ],
      "validationViews": [
        "albedo-unlit",
        "neutral-studio",
        "grazing",
        "reference-beauty"
      ],
      "limitations": [
        "Marble and polished stone may need transmission or subsurface approximation beyond this base record"
      ],
      "sourceRefs": [
        "three.mesh-standard",
        "three.mesh-physical",
        "adobe.pbr-guide-1",
        "mit.material-recognition"
      ]
    },
    {
      "id": "ceramic.glazed",
      "aliases": [
        "ceramic",
        "porcelain",
        "glazed ceramic"
      ],
      "family": "ceramic",
      "subtype": "glazed",
      "finish": "glossy",
      "model": "coated-dielectric",
      "recipeBasis": "inferred-starting-prior",
      "renderPrior": {
        "metalness": {
          "default": 0.0,
          "range": [
            0.0,
            0.0
          ]
        },
        "roughness": {
          "default": 0.26,
          "range": [
            0.1,
            0.5
          ]
        },
        "clearcoat": {
          "default": 0.7,
          "range": [
            0.4,
            1.0
          ]
        },
        "clearcoatRoughness": {
          "default": 0.12,
          "range": [
            0.02,
            0.3
          ]
        },
        "ior": {
          "default": 1.5,
          "range": [
            1.4,
            1.65
          ]
        }
      },
      "requiredMaps": [
        "map",
        "roughnessMap"
      ],
      "optionalMaps": [
        "normalMap",
        "clearcoatMap",
        "clearcoatRoughnessMap"
      ],
      "visualCues": [
        "hard dielectric body",
        "smooth glaze reflection",
        "small chips reveal matte body"
      ],
      "confusableWith": [
        "plastic.glossy",
        "stone.natural",
        "coating.painted-metal"
      ],
      "validationViews": [
        "neutral-studio",
        "grazing",
        "environment-reflection",
        "reference-beauty"
      ],
      "limitations": [
        "Unglazed ceramic needs a separate matte finish"
      ],
      "sourceRefs": [
        "three.mesh-physical",
        "adobe.pbr-guide-1",
        "google.filament-pbr"
      ]
    },
    {
      "id": "glass.clear",
      "aliases": [
        "glass",
        "clear glass"
      ],
      "family": "glass",
      "subtype": "clear",
      "finish": "polished",
      "model": "transmissive-dielectric-volume",
      "recipeBasis": "inferred-starting-prior",
      "renderPrior": {
        "metalness": {
          "default": 0.0,
          "range": [
            0.0,
            0.0
          ]
        },
        "roughness": {
          "default": 0.05,
          "range": [
            0.0,
            0.18
          ]
        },
        "transmission": {
          "default": 1.0,
          "range": [
            0.85,
            1.0
          ]
        },
        "ior": {
          "default": 1.5,
          "range": [
            1.45,
            1.55
          ]
        }
      },
      "requiredMaps": [
        "roughnessMap",
        "thicknessMap"
      ],
      "optionalMaps": [
        "map",
        "normalMap",
        "transmissionMap"
      ],
      "visualCues": [
        "background distortion",
        "bright interface reflection",
        "visible thickness or absorption"
      ],
      "confusableWith": [
        "plastic.glossy",
        "gemstone.quartz",
        "alpha-transparent material"
      ],
      "validationViews": [
        "neutral-studio",
        "environment-reflection",
        "backlight-transmission",
        "reference-beauty"
      ],
      "limitations": [
        "Use opacity 1 with transmission; thickness must be derived from geometry scale"
      ],
      "sourceRefs": [
        "three.mesh-physical",
        "three.pmrem",
        "gltf.2",
        "khronos.transmission",
        "khronos.volume",
        "google.filament-pbr"
      ]
    },
    {
      "id": "glass.frosted",
      "aliases": [
        "frosted glass",
        "etched glass"
      ],
      "family": "glass",
      "subtype": "frosted",
      "finish": "rough-transmissive",
      "model": "transmissive-dielectric-volume",
      "recipeBasis": "inferred-starting-prior",
      "renderPrior": {
        "metalness": {
          "default": 0.0,
          "range": [
            0.0,
            0.0
          ]
        },
        "roughness": {
          "default": 0.52,
          "range": [
            0.3,
            0.8
          ]
        },
        "transmission": {
          "default": 0.85,
          "range": [
            0.6,
            1.0
          ]
        },
        "ior": {
          "default": 1.5,
          "range": [
            1.45,
            1.55
          ]
        }
      },
      "requiredMaps": [
        "roughnessMap",
        "normalMap",
        "thicknessMap"
      ],
      "optionalMaps": [
        "transmissionMap",
        "map"
      ],
      "visualCues": [
        "blurred transmitted background",
        "broad interface highlight",
        "fine etched normal structure"
      ],
      "confusableWith": [
        "plastic.matte",
        "glass.clear"
      ],
      "validationViews": [
        "neutral-studio",
        "grazing",
        "backlight-transmission",
        "reference-beauty"
      ],
      "limitations": [
        "Transmission quality and cost depend on renderer and scene configuration"
      ],
      "sourceRefs": [
        "three.mesh-physical",
        "three.pmrem",
        "khronos.transmission",
        "khronos.volume",
        "google.filament-pbr"
      ]
    },
    {
      "id": "gemstone.quartz",
      "aliases": [
        "quartz",
        "crystal",
        "gemstone"
      ],
      "family": "gemstone",
      "subtype": "quartz-like",
      "finish": "polished",
      "model": "transmissive-dielectric-volume",
      "recipeBasis": "inferred-starting-prior",
      "renderPrior": {
        "metalness": {
          "default": 0.0,
          "range": [
            0.0,
            0.0
          ]
        },
        "roughness": {
          "default": 0.06,
          "range": [
            0.01,
            0.2
          ]
        },
        "transmission": {
          "default": 0.9,
          "range": [
            0.5,
            1.0
          ]
        },
        "ior": {
          "default": 1.54,
          "range": [
            1.45,
            1.7
          ]
        },
        "dispersion": {
          "default": 0.0,
          "range": [
            0.0,
            0.3
          ]
        }
      },
      "requiredMaps": [
        "roughnessMap",
        "thicknessMap"
      ],
      "optionalMaps": [
        "map",
        "normalMap",
        "transmissionMap"
      ],
      "visualCues": [
        "faceted interface reflections",
        "transmitted or internally varied colour",
        "thickness-dependent appearance"
      ],
      "confusableWith": [
        "glass.clear",
        "plastic.glossy",
        "coating.candy"
      ],
      "validationViews": [
        "neutral-studio",
        "environment-reflection",
        "backlight-transmission",
        "reference-beauty"
      ],
      "limitations": [
        "A painted opaque gem-like surface is not a transmissive gemstone and needs a coating record"
      ],
      "sourceRefs": [
        "three.mesh-physical",
        "three.pmrem",
        "gltf.2",
        "khronos.transmission",
        "khronos.volume",
        "google.filament-pbr"
      ]
    }
  ]
}
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 321kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 321kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 321kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 321kUpdated Claude CodeCodexVerifiedInstall