Skip to content

Change Statistic

Change Statistic

Adjusts a statistic on a character by a specified amount, as either a flat value or percentage scale.

Properties

System

Name Explanation Type
Amount The amount to adjust the statistic by. Variable or Value
Is Value When enabled, the amount is treated as a flat value. When disabled, the amount is treated as a percentage scale. Toggle
Scale When enabled, the amount is treated as a percentage multiplier against the current statistic value. Toggle
Statistic The formula name of the statistic to change. Statistic
Target The character to apply the operation to. Character
Use As Delta Value When enabled, the amount is added to the current statistic value. When disabled, the statistic is set to the specified amount. Toggle

Examples

Add Health Points to Party Member 0

This increases the health points of the first active party member by 100.

change_statistic(party(0), "hp", 100);

{"Data":{"Amount":{"IsGlobalVariable":false,"IsLocalVariable":false,"IsValue":true,"Value":"100","VariableIndex":0,"Metadata":null},"FormulaName":{"IsGlobalVariable":false,"IsLocalVariable":false,"IsValue":true,"Value":"hp","VariableIndex":0,"Metadata":null},"IsDeltaOperation":true,"IsScaleModifier":false,"Target":{"Identifier":{"IsGlobalVariable":false,"IsLocalVariable":false,"IsValue":true,"Value":"0","VariableIndex":0,"Metadata":null},"IsInstanceIndex":true,"IsReferenceIndex":false,"IsUniqueID":false,"Metadata":null},"Metadata":null},"TypeName":"MAR.Game.RPGCore.Models.Scripts.Commands.Character.ChangeStatisticCommand"}

Set a Statistic to an Absolute Value

This sets the health points of the first active party member to exactly 100.

change_statistic(party(0), "hp", 100, set);

{"Data":{"Amount":{"IsGlobalVariable":false,"IsLocalVariable":false,"IsValue":true,"Value":"100","VariableIndex":0,"Metadata":null},"FormulaName":{"IsGlobalVariable":false,"IsLocalVariable":false,"IsValue":true,"Value":"hp","VariableIndex":0,"Metadata":null},"IsDeltaOperation":false,"IsScaleModifier":false,"Target":{"Identifier":{"IsGlobalVariable":false,"IsLocalVariable":false,"IsValue":true,"Value":"0","VariableIndex":0,"Metadata":null},"IsInstanceIndex":true,"IsReferenceIndex":false,"IsUniqueID":false,"Metadata":null},"Metadata":null},"TypeName":"MAR.Game.RPGCore.Models.Scripts.Commands.Character.ChangeStatisticCommand"}

Scale a Statistic by a Percentage

This scales the health points of hero 0 by 50 percent of the current value.

change_statistic(hero(0), "hp", 0.5, scale);

{"Data":{"Amount":{"IsGlobalVariable":false,"IsLocalVariable":false,"IsValue":true,"Value":"0.5","VariableIndex":0,"Metadata":null},"FormulaName":{"IsGlobalVariable":false,"IsLocalVariable":false,"IsValue":true,"Value":"hp","VariableIndex":0,"Metadata":null},"IsDeltaOperation":true,"IsScaleModifier":true,"Target":{"Identifier":{"IsGlobalVariable":false,"IsLocalVariable":false,"IsValue":true,"Value":"0","VariableIndex":0,"Metadata":null},"IsInstanceIndex":false,"IsReferenceIndex":true,"IsUniqueID":false,"Metadata":null},"Metadata":null},"TypeName":"MAR.Game.RPGCore.Models.Scripts.Commands.Character.ChangeStatisticCommand"}