Table of Contents


1.12 Support

1.12 Support


NEW: Illusioner

NEW: Parrot

  • Summons a parrot mob
  • Options.Color: [BLUE/CYAN/GRAY/GREEN/RED]


NEW: SetUseGravity

Turns the target's gravity on/off.

  1. setUseGravity{gravity=true/false}

NEW: SummonPassenger

Summons a mob riding the casting mob. Will boot a rider off if the mob already has a passenger.

  1. consumeHeldItem{amount=1} @trigger

BlockMask Effect

  • Added onlyAir=true option


Added options to command mechanic:

  • sudo=true / asCaster=true
  • asOP=true


NEW: @Passenger


NEW: HasOwner

NEW: OwnerIsOnline


  • Added missing 1.11 and 1.12 disguise support

Bug Fixes / Other

  • Using /mm s resettimers with no argument will now reset all spawners
  • Added better error reporting for skills with bad configs
  • Verify mobs removed on world unload
  • Use bukkit ChatColor instead of spigot ChatColor for backwards compat
  • Removed some error messages
  • Fixed example files not generating on 1.12
  • Fixed mob eggs being usable in offhand
  • Fixed NPE in drop tables
  • Fixed NPE with boss bar
  • Fixed server crashes caused by NaN velocity values
  • Fixed skills attempting to run in worlds that are unloaded
  • Fixed bug with command mechanic
  • Fixed NPE thrown by forced targeting
  • Fixed spawner name not being reusable after removal
  • Fixed default color for Llamas not being set if color not specified
  • Fixed Profession option for baby zombie villagers


NEW Feature: HealthBars

Now MythicMobs supports adding hologram healthbars that appear under your mob's name! Using this feature is simple.

  Type: SPIDER
  Display: 'HealthBar Spider'
    Enabled: true

This feature requires the Holograms plugin:

NEW Feature: Nameplates

Nameplates allow you to extend the nameplates of Player-disguise mobs, which are normally limited to 16 characters. To use this, simply have Holograms installed and then leave out the “Player” field in your disguise (skin is still required!). If you don't specify the player field, it will use the Display field instead using a custom nameplate.

  Type: skeleton
  Display: "this display name is too long for players normally"
    Type: player
    Skin: Kurdie

This feature requires LibsDisguises and the Holograms plugin:


  • Added Mobs.DespawnByDefault option to config.yml
  • Added Mobs.PreventOtherDropsByDefault option to config.yml



  • Fixed the custom EnderDragon's AI on 1.9+


NEW: ConsumeHeldItem

Consumes # of the item the player is holding in their hand. Can be used to make consumable items in the Artifacts add-on.

  1. consumeHeldItem{amount=1} @trigger

NEW: Decapitate

Drops the target player's head. Only works on players (for now).

NEW: GiveCurrency

Gives the target player X Vault currency. Requires Vault and an economy plugin.

  1. giveCurrency{amount=#} @target

NEW: Glow Effect

Causes the target to get the Glow effect with a certain color for # of ticks. Requires GlowAPI.

  1. effect:glow{color=RED;duration=1000}

NEW: PercentDamage

Deals damage equal to a percent of the player's max health, where 1 is 100%. Has the same options as the Damage mechanic.

  1. percentDamage{percent=0.5}

Particle Effects

  • Added directional and directionReversed options to Particles
  • Causes certain particles to move at # speed
  • Direction is based on the origin's location to the target's location.


  • Now grants wolf ownership to target if caster is a wolf

Fixed Mechanics

  • Made ShootFireball,ShootPotion,ShootSkull usable w/Location targeters
  • Fixed Fixed forwardOffset on Projectiles


NEW: Mounted

NEW: MythicMobType

NEW: HasCurrency

Returns true if the player has X vault currency. Requires Vault and an economy plugin.

  1. hascurrency <amount>

NEW: HasInventorySpace

NEW: HasPermission

Returns true if the player has X permission.

  1. haspermission <permission>

NEW: TCBiome

Returns true if the location matches the specified TerrainControl biome. Can be matched loosely or strictly (loosely by default).

  1. tcbiome Forest (Matches any TerrainControl biome whose name contains FOREST)
  2. tcbiome{biome=TropicalDesert;strict=true} Would match only TropicalDesert, not TropicalDesertBorder

Fixed Conditions

Fixed conditions that did not port over properly in 4.0, including:

  • PlayerWithin
  • PlayerNotWithin
  • TargetWithin
  • TargetNotWithin

Random Spawning

Random Spawns now use the new condition system, which should result in a significant performance increase for lower-end servers.



  • Required for the new HealthBar and Nameplate features

Libs' Disguises

Added missing Disguises:

  • Llama with options:
    • Disguise.HasSaddle: true/false
    • Disguise.CarryingChest: true/false
    • Disguise.Grazing: true/false
  • PolarBear
  • Shulker
  • Shulker_Bullet
  • Vex


  • Required for the TCBiome condition, documented above.


  • Required for new Currency-based mechanics and conditions.

Bugs / Other

  • Fixed mythicmobs.admin not granting access to all perms
  • Fixed mythicmobs.command.* not working for command perms
  • Fixed BossBar not going away when a mob despawns naturally
  • Fixed item amounts not working correctly
  • Fixed several errors with commands
  • Fixed chance not working properly in Drop Tables
  • Fixed NPE in threat tables
  • Fixed egg get command not accepting amounts
  • Fixed mobs refusing to die if killed immediately after spawning
  • Fixed NPEs with entity manager related to multi-world support
  • Fixed server crashes related to high velocities with velocity skills
  • Fixed various skill mechanic NPEs
  • Removed spammy debugging messages with repeating skills




  • Added accuracy, horizontalnoise, verticalnoise to projectile mechanic


NEW: ItemRecharging Condition

  • Evaluates if the player's item is on recharge from attacking

Bug Fixes / Other

  • Fixed some issues with spawner behavior
  • Fixed several commands not working in the console
  • Fixed several other issues with commands
  • Fixed ItemSpray effect not working with vanilla items
  • Fixed variables and random numbers not parsing in item lore
  • Fixed @TargetLocation not working as expected for players


4.0 Condition-System Revamp

The condition system of MythicMobs has undertaken some pretty nifty changes and we hope you guys will find it as fascinating and useful as we do! We have been putting quite some effort into quasi “remaking” it and are very happy with the newly found powers which it provides.

None of the conditions you were previously able to use with MythicMobs are gone - they are in-fact all still there and we even added a bunch of new ones. The most important part about this change is how the system now works and the new possibilities it offers.

Old conditions were very basic and only executed on the mob and/or the mob's target. The new system now works according to one of three ways: on the skill's caster, on the skill's target, or on the entity that triggered the skill. Conditions are now also divided into Entity conditions and Location conditions, similar to skill mechanics.

NOTE: You can still use old conditions by instead using “LegacyConditions:” For example: The new version of targetlineinsight would be:

  - lineofsight true
The old version can still be used like this:
  - targetlineofsight true

Read on for further details on how to use each type of condition.


Conditions now have an updated format. Most old conditions should work the way they did, but conditions can now optionally include multiple options and actions.

The new format(s) work like so:

- condition [variable]
- condition [variable] [action]
- condition [variable] [action] [action_variable]
- condition{variable1=value;variable2=value} [action] [action_variable]

The old format will still work in most cases and the majority of skills should not break. However, this also allows for more advanced conditions that can evaluate multiple variables.

All of these are valid examples of the new format:

- day required
- stance defensive power 0.5
- stance{stance=defensive} power 0.5
- score{objective=test;value=>20} cancel
- haspotioneffect{type=POISON;level=>0;duration=0 to 100} true


The “Conditions” field on skills now specifically always evaluates the condition against the caster. The condition failing means that the skill will not trigger.


The “TargetConditions” field on skills lets you run a skill only on targets that meet the conditions. Any targets inherited by the skill will be filtered according to the conditions, and targets that do not meet them will be removed from the skill's target list.


# Mob
  Type: ZOMBIE
  - skill{s=Flare} @PlayersInRadius{r=20}
# Skill
  - lineofsight true
  - ignite{d=10}

The skill in this example would only ignite targets that were in the mob's line of sight.


The “TriggerConditions” field on skills specifically always evaluates the condition against the entity that triggered the skill. The condition failing means that the skill will not trigger.

  - entitytype ZOMBIE true

This example skill would not cast unless the triggering entity was a zombie.

Condition Actions

Condition Actions are a new feature that allow you to do additional things based off of conditions. Before conditions were always a “requirement”, but now you can specify other meanings for them.

Here is a list of actions being added:

  • required (or true) (default) - The condition is required for the skill to run.
  • cancel (or false) - The skill will not run if this condition is met.
  • power [power multiplier] - Modifies the skill's power (e.i. power 2.0 would double the skill's power)
  • cast [skill] - NOT YET IMPLEMENTED Casts an additional skill if the condition is met.
  • castinstead [skill] - NOT YET IMPLEMENTED Casts a different skill instead if the condition is met.


NEW: Altitude Condition

* Detects the targets height above the ground.
* Can be a single number, a range (20-40), or >10 <5, etc.

NEW: Crouching Condition

* Detects if the entity (must be a player) is crouching.

NEW: Distance Condition

* Checks the distance between the target and the casting entity.

NEW: EntityType Condition

* Detects if the target matches the entitytype.

  - entitytype PLAYER true

NEW: FallSpeed Condition

* Detects falling speed of the mob. Can be positive or negative. (For jumping.)
* Can be a single number, a range (20-40), or >10 <5, etc. Example:

- fallspeed{speed=>0.7845} true

NEW: Gliding Condition

* Checks target to see if it is gliding with elytra.

NEW: HasPotionEffect Condition

* Checks the target to see if it has the potion effect.
* You can specify a number of options, including the level of the effect, and the duration.

- haspotioneffect{type=POISON;level=>1;duration=0 to 100} true
This will only work if the target has the poison effect at a level of 2 or above, and a duration of 0 to 100 ticks.

NEW: HasTag Condition

* Checks target for scoreboard tags. Can be added using Add Tag mechanic.

  - hastag{tag=Test} true

NEW: LineOfSight Condition

* Checks if the entity can see its target/if there are no blocks in the way.

NEW: OnGround Condition

* Checks if the caster is on the ground. Pretty self-explanatory.

NEW: Score Condition

* Replaces the old targetscore and mobscore mechanics.
* Can be a single number, a range (20-40), or >10 <5, etc.

- score{objective=test;v=>20} true
Only will run when the objective “test” has a value of more than 20 for the target.



NEW: Interactable: [true/false]



NEW: AddTag

Adds a scoreboard tag to a target entity.

NEW: CancelEvent

CancelEvent will cancel whatever event triggered the skill.

This mechanic has several important requirements in order to execute properly:

  • The mechanic (or the first skill that leads to it) must be run with sync=true in the mob's skill list.
  • There can be no “delays” leading to its execution (no delay mechanics, and nothing else with delays such as projectiles)
  • It only works with specific triggers that make sense (works with onDamaged, onAttack, etc but not onDeath!)

NEW: Lunge

Accelerates the caster towards the target.

NEW: RemoveTag

Removes a scoreboard tag from a target entity.

NEW: SetHealth

NEW: SetMaxHealth

NEW: SetOwner

NEW: SudoSkill

The SudoSkill mechanic allows you to force the targeted entity to “cast” a MythicMobs skill. This skill will inherit the previous targets in the stack from a previous parent skill, and is even able to force players to use MythicMobs skills.


  • fromOrigin now defaults to false.


  • Added startYoffset attribute.


  • Added owner to targets.

Target filters

  • Added samefaction to target filters.

API Update

The API has been changed significantly in this update, and comes with many new improvements. Plugins that used MythicMobs prior to 4.0 will need to be recompiled using the new API, though.

Information about the new API will be expanded on in the future.


JavaDocs for the API can now be found at

Custom Mechanics

Developers can now add custom mechanics to MythicMobs at runtime using the MythicMechanicLoadEvent. Examples will be available on the manual and in the API forum.

Custom Conditions

Developers can now add custom mechanics to MythicMobs at runtime using the MythicConditionLoadEvent. Examples will be available on the manual and in the API forum.

New API Events

  • MythicConditionLoadEvent - Called on startup/reload for each custom condition referenced in the plugin.
  • MythicMechanicLoadEvent - Called on startup/reload for each custom condition referenced in the plugin.
  • MythicReloadedEvent - Called after MythicMobs finishes reloading



  • Fixed several issues with MPets compatibility

Bug Fixes / Other

  • Fixed issues with 1.11 support
  • Fixed mob eggs
  • Fixed various bugs with spawners
  • Many, many other bug fixes

Older Changelogs

changelog.txt · Last modified: 2017/07/24 05:15 by xikage
GNU Free Documentation License 1.3
Driven by DokuWiki Recent changes RSS feed Valid CSS Valid XHTML 1.0