Skip to content

MMOLib🔗

Minimal required version: 1.7.1-SNAPSHOT

Actions🔗

MmoStat🔗

Context:
Syntax: mmostat [stat] [value] [key] [type] [slot] [source] [add] [remove] [clear]
Description: Modifies a stat of a player.

Modify values that combine all sorts of stats from MMOCore and MMOItems. The functional flags add, remove and clear can be used to modify the stat and may even be combined. They follow a strict order of priority in their execution:

  1. clear
  2. remove
  3. add
Parameter Syntax Default Value Explanation
stat Name The stat to modify.
value Number 0 The value to add the stat. Only used if add is set to true.
key Name default The key to modify.
type ModifierType FLAT The type of the modification.
slot EquipmentSlot OTHER The slot of the modification.
source ModifierSource OTHER The source of the modification.
add Boolean Flag false Whether to add a new modifier for the stat with the given value.
remove Boolean Flag false Whether to remove a modifier for the given key and stat.
clear Boolean Flag false Whether to clear all modifiers for the key.
ModifierType values
  • FLAT
  • ADDITIVE_MULTIPLIER
  • RELATIVE
EquipmentSlot values
  • ARMOR
  • HEAD
  • CHEST
  • LEGS
  • FEET
  • ACCESSORY
  • INVENTORY
  • OFF_HAND
  • MAIN_HAND
  • OTHER
ModifierSource values
  • MELEE_WEAPON
  • RANGED_WEAPON
  • OFFHAND_ITEM
  • MAINHAND_ITEM
  • HAND_ITEM
  • ARMOR
  • ACCESSORY
  • ORNAMENT
  • OTHER
  • VOID
Example
actions:
  damageReduction3: "mmostat add stat:DAMAGE_REDUCTION value:3"
  damageReductionRemove: "mmostat remove stat:DAMAGE_REDUCTION"
  armorToughnessReplace: "mmostat add remove stat:ARMOR_TOUGHNESS value:5 key:default type:ADDITIVE_MULTIPLIER slot:CHEST source:ACCESSORY"
  statClear: "mmostat clear"

Objectives🔗

MmoSkill🔗

Context:
Syntax: mmoskill <skill> [trigger]
Description: Requires the player to activate a MythicLib skill (e.g. with MMOItems or MMOCore).

Parameter Syntax Default Value Explanation
skill SKILL_ID The ID of the skill.
trigger name:level All trigger types. The types of triggers that can be used to activate the skill. If not specified, all triggers are allowed.
Example
objectives:
  triggerSkill: "mmoskill LIFE_ENDER actions:updateStatistics"
  castSkillWithMMOCore: "mmoskill DEEP_WOUND trigger:CAST actions:completeTutorial"
  itemSkill: "mmoskill DEEP_WOUND trigger:RIGHT_CLICK,LEFT_CLICK actions:giveReward"

Conditions🔗

MmoStat🔗

Context:
Syntax: mmostat <stat> <value> [equal]
Description: Whether the player has a certain stat.

Checks stats that combine all sorts of stats from MMOCore and MMOItems. You can disable this behaviour by adding the equal argument.

Example
conditions:
  damageReduction3: "mmostat DAMAGE_REDUCTION 3"