Brick Parameters for Magic Actions

Owned by Matt Raykowski
Last updated: Jun 05, 2013

All magic action bricks must start with an MA parameter as Property 0 and the final property should be MA_END. A typical action will start with an MA parameter, have 1 more more MA action parameters (e.g. MA_HEAL), a SET_BEHAVIOR and finally MA_END.

It is important to note that some of this code is incomplete. The mtcb (or Cure) factory is declared but not fully implemented and the MA_CURE brick parameter has a definition but has no action code. Be aware of these relationships when looking at the raw definitions provided here.

MA

Description: The MA brick parameter signals the system to begin building a magic action. It has 7 possible parameters which all indicate the action factory type to be used to process the remaining brick parameters.

Factory Types:

  • mdal - Negative Effect (Defensive)
  • moal - Negative Effect (Offensive)
  • mdht - Healing
  • mlosmp - Affect Stat
  • moet - Attack
  • reload - Recharge Items

The following factory types are either not in common use or are incomplete in code:

  • mlc - Healing over Time
  • moel - Damage Over Time
  • mtcb - Cure

Use: MA: FactoryType
Example:

MA:mdht

MA_END

Description: The MA_END signals the end of the magic action builder.
Use: MA_END
Example:

MA_END

MA_HEAL

Description: Heals hit points, sap or stamina.
Supported Factory Types: mlc and mdht 
Use: MA_HEAL: HpValue : SapValue : StaminaValue
Example:

MA_HEAL:0:0:200

MA_EFFECT

Description: Applies a magic effect. See code/ryzom/common/src/game_share/effect_families.h for a thorough list of available effect types.
Supported Factory Types: mlosmp 
Use: MA_EFFECT: Effect
Example:

MA_EFFECT:SlowMove

MA_STAT

Description: Applies a debuff stat effect. If the stat type is "Skill" then the stat value should be set to the numeric value of the target skill, as defined by the ESkills enum. If the stat type is "Score" then the stat value should be set to the numeric value of the target score, as defined by the TScoresenum. If the stat type is "Speed" then the stat value is always 0. The Speed type is the only commonly used stat type.

Supported Stat Types:

  • Skill
  • Score
  • Speed

Note that negative modifiers imply a 'buff' effect but 'buffing' is not presently supported using this brick parameters.

Supported Factory Types: mlosmp
Use: MA_STAT: Stat : Type
Example:

MA_STAT:0:Speed

MA_EFFECT_MOD

Description: Sets the effect value for a magic action.
Supported Factory Types: mlosmp, mdal, moal 
Use: MA_EFFECT_MOD: EffectMod
Example:

MA_EFFECT_MOD: -49

MA_EFFECT_MULT

Description: Defines a multiplier for a magic action. This is converted into a decimal and used in the final determination of effect value. A value less than 1 is considered offensive. This is not currently in common use.
Supported Factory Types: mlosmp
Use: MA_EFFECT_MULT: Multiplier
Example:

MA_EFFECT_MULT: 2

MA_CASTING_TIME

Description: Defines a modifer for the casting time required, in seconds. The casting modifier may be a negative value.
Supported Factory Types: N/A
Use: MA_CASTING_TIME: CastingModifier
Example:

MA_CASTING_TIME: 3

Magic Actions Not In Use

  • MA_CURE

MA_CASTING_TIME,
MA_DMG_TYPE,
MA_DMG,
MA_RANGE,
MA_LINK_COST,
MA_LINK_PERIOD,
MA_LINK_POWER,
MA_BREAK_RES,
MA_ARMOR_COMP,
MA_VAMPIRISE,
MA_VAMPIRISE_RATIO,