Overview
The set_relative_property tool allows you to modify properties based on their current values using mathematical operations. Instead of setting absolute values, you can add, multiply, subtract, divide, or raise properties to powers.
Parameters
Array of instance paths to modify. Each path uses dot notation (e.g., game.Workspace.Part1)
Name of the property to modify (e.g., Position, Transparency, Size)
Mathematical operation to perform on the current value:
add - Add value to current valuesubtract - Subtract value from current valuemultiply - Multiply current value by valuedivide - Divide current value by valuepower - Raise current value to the power of value
Value to use in the operation. Must be a number.
For Vector3 or UDim2 properties, specify which component to modify:
X - Modify only X componentY - Modify only Y componentZ - Modify only Z component (Vector3 only)
If omitted, the operation applies to all components. Vector3 Component Operations
When working with Vector3 properties (Position, Size, Velocity), you can:
-
Modify all components: Omit the
component parameter
{"operation": "multiply", "value": 2}
-
Modify specific component: Use
component parameter
{"operation": "add", "value": 5, "component": "Y"}
Examples
Moving parts up (Y axis)
{
"paths": [
"game.Workspace.Platform1",
"game.Workspace.Platform2",
"game.Workspace.Platform3"
],
"propertyName": "Position",
"operation": "add",
"value": 10,
"component": "Y"
}
Doubling part sizes
{
"paths": [
"game.Workspace.Cube1",
"game.Workspace.Cube2"
],
"propertyName": "Size",
"operation": "multiply",
"value": 2
}
Increasing transparency
{
"paths": [
"game.Workspace.Window1",
"game.Workspace.Window2"
],
"propertyName": "Transparency",
"operation": "add",
"value": 0.3
}
Shifting along Z axis
{
"paths": [
"game.Workspace.Step1",
"game.Workspace.Step2",
"game.Workspace.Step3"
],
"propertyName": "Position",
"operation": "subtract",
"value": 50,
"component": "Z"
}
Scaling only width
{
"paths": [
"game.Workspace.Bridge1",
"game.Workspace.Bridge2"
],
"propertyName": "Size",
"operation": "multiply",
"value": 1.5,
"component": "X"
}
Halving a numeric property
{
"paths": [
"game.Workspace.Light1",
"game.Workspace.Light2"
],
"propertyName": "Brightness",
"operation": "divide",
"value": 2
}
Moving back along path (negative Z)
{
"paths": [
"game.Workspace.Obstacle1",
"game.Workspace.Obstacle2",
"game.Workspace.Obstacle3"
],
"propertyName": "Position",
"operation": "add",
"value": -20,
"component": "Z"
}
Operation Reference
Add
newValue = currentValue + value
Subtract
newValue = currentValue - value
Multiply
newValue = currentValue * value
Divide
newValue = currentValue / value
Power
newValue = currentValue ^ value
Use Cases
- Batch position adjustments (moving multiple objects)
- Uniform scaling of multiple parts
- Incremental transparency changes
- Adjusting physics properties (friction, density)
- Offsetting UI elements
- Fine-tuning placement after duplication
Relative property operations are efficient because:
- Single MCP round-trip for multiple instances
- No need to retrieve current values manually
- Automatic handling of Vector3 component math
- Batch processing on the Roblox Studio side
Common Patterns
{"propertyName": "Position", "operation": "add", "value": 5, "component": "Y"}
{"propertyName": "Position", "operation": "subtract", "value": 5, "component": "Y"}
Doubling all sizes
{"propertyName": "Size", "operation": "multiply", "value": 2}
Making more transparent
{"propertyName": "Transparency", "operation": "add", "value": 0.2}
Making less transparent
{"propertyName": "Transparency", "operation": "subtract", "value": 0.2}
Warnings
Be careful with operations that can produce invalid values:
- Transparency must stay between 0 and 1
- Division by zero will cause errors
- Very large multiplications may produce extreme values
- Always validate ranges before batch operations
