meshy-dev/meshy-dcc-adapters/3dsmax-materials

3ds Max Material Tools

Inspect, create, edit, and assign 3ds Max materials in the current scene. All tools touch the live scene through pymxs, so they declare affinity: main.

Tool contracts live in tools.yaml. apply_material uses current selection when node_names is omitted.

Verified writes

Every write in this skill is verified by readback and reported per attribute or per node, so a caller can always tell "written" from "not written":

• create_standard_material, create_physical_material, and

create_pbr_material return applied / applied_count / errors and fail when a requested attribute did not land.

• apply_material reports skipped (node names that could not be resolved)

and errors (nodes whose assignment the host did not keep) and fails when either is non-empty; applied_count counts only verified assignments.

• reset_material verifies each reset and fails when a node still reports its

previous material.

Renderer-aware parameters and slots

create_material_from_textures, assign_bitmap_texture, and set_material_attributes resolve canonical PBR controls onto the renderer-native property and verify every write by readback:

A parameter or slot the material class does not expose fails the tool call and rolls the created material back; it is never reported as a silent success. Generic attribute names that fall outside the renderer tables go through the same readback check: a host that refuses every candidate, or silently accepts one it never persists, is reported as an error rather than a success.

assign_bitmap_texture reports the resulting connections through the same renderer-native slot names, so a write to texmap_roughness shows up in connections instead of returning an empty list.

Texture-set files are matched on filename tokens (basecolor, albedo, diffuse, roughness, metalness, normal, bump, displacement, height, opacity, alpha, specular, emission, reflection, ao).