set_material_property

What set_material_property does on Sbox

AI agents use set_material_property to create or update resources in Sbox, usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your Sbox environment.

Why set_material_property is rated Medium

This tool modifies material properties on game objects, which is a Write operation. It alters visual/rendering attributes of game assets in a reversible manner (properties can be changed again). The severity is medium because misuse could degrade game aesthetics or corrupt material definitions, but changes are not destructive and the blast radius is limited to visual presentation within the game engine.

From the tool's definition Tool description states 'Change a property on the material assigned to a GameObject — color, roughness, metallic, texture, etc.' The verb 'change' combined with modifiable properties (color, roughness, metallic, texture) indicates reversible data modification.

The rule that runs set_material_property safely

PolicyLayer is an MCP gateway: it sits between your AI agents and Sbox, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For set_material_property, this is the rule to start with:

{
  "version": "1",
  "default": "deny",
  "tools": {
    "set_material_property": {
      "limits": [
        {
          "counter": "set_material_property_rate",
          "window": "minute",
          "max": 30,
          "scope": "grant"
        }
      ]
    }
  }
}

Questions about set_material_property