Source Code | Documentation | Legacy Version | Issue Tracker | Metrics | Crowdin | Website


Make sure you download MythicLib first!
Join our Discord server to get dev builds.


Unique Item Types (wiki)
MMOItems introduces new original item types, such as slashing weapons (swords, daggers... ), piercing weapons (lances, spears), and blunt weapons (hammers, great staffs). Item types apply unique on-hit attack effects, like slashing weapons which redirect some percentage of the attack damage in a cone behind the initial target. Piercing weapons feature a smaller attack cone balanced by a higher damage rate. Blunt weapons deal area-of-effect damage just like vanilla sweep attacks.

MMOItems also introduces staffs, crossbows, muskets & lutes, which all have unique attack effects. Item types have more specific options: you may change the particle effects displayed by staffs or lutes or even define a fully custom skill run when arrows hit your target.

  Attack Effects

90+ Item Options (wiki)
MMOItems comes with about 90 item options, including item stats, display options, item attributes, abilities, recipe options, and many more. A brief overview of the available options can be found below, although you'll find a more exhaustive list on the wiki.

70+ Item Abilities (wiki)
Item abilities are fantastic skills you can bind to your items to make them even more unique. You can bind up to seven abilities on each item. While some abilities help you defeat enemies by summoning powerful projectiles, others may temporarily buff you or your allies.

There are many ways of casting an ability: right/left clicks, sneaking, landing an arrow on a block, being damaged by an entity, damaging an entity... They are the same casting modes as in MMOCore skills. You can also create abilities with a specific timer.

If you feel like MMOItems abilities are duplicates, you can add your abilities to MMOItems using scripting languages from MythicLib, MythicMobs, SkillAPI, or ProSkillAPI.

  Some Abilities

Item Sets & Full Set Bonuses (wiki)
Item sets can grant extra stats to the player when he wears multiple items from the same item set. This is an extremely powerful RPG feature you can use to link different items, as it incites players to use items from the same set.
Item sets may give extra damage, damage reduction, maximum mana, and critical strike chance... They may also grant the holder permanent potion effects or even more abilities. Item sets can also give different stat bonuses depending on the number of items from the same set the player is wearing. The possibilities are limitless!


Item Generator (wiki)
MMOItems features a powerful rule-based item generator. The basic principle is to have item templates with basic item data, like material and default attack damage, and a list of item modifiers that the item can have.

  1. The rarer the item, the more modifiers it can carry and the better the stats are. A modifier can give extra stats, an ability, an extra enchant, additional elemental stats, or any other stat.
  2. Every modifier has a prefix or a suffix to let the player know what special features the item has!
  3. Numeric stats like attack damage, move speed, and crit strike chance all feature powerful formulas so the item stats can scale on the item level: the higher the level, the better the stats.
  4. This system lets you have simple items for beginners with less special features, as well as rarer items with more item modifiers for higher levels using the very same "item template." The item generator is bound to the tier system: the tier determines how many modifiers an item may carry.
  5. To reduce time spent in the configs, you can define global modifiers that you can use in different item templates.
  6. Last but not least, the /mmoitems generate config lets you generate a random item with either a specific type, a specific tier, or a specific level or all at the same time. This command also features an extra parameter so that the item generated matches the player's level or class to improve loot chest tables.


  Item Examples

Custom Blocks (without Armor Stands!) (wiki)
MMOItems adds custom blocks with configurable textures (using a resource pack). Configure item break levels and create custom ores or use them as decorative blocks. Custom blocks don't use armor stands. They are entirely physical blocks and function much like vanilla ones!

  Custom Blocks in Action

Item Upgrading (wiki)
Players can upgrade their items using specific crafting station recipes or consumables, granting better stats. Items display their current level on the display name and may have maximum upgrades and an upgrading chance. Using upgrading references, you can have weapons that only a specific set of consumables can upgrade. Using upgrading templates, you can have items gain the same extra stats when upgraded for a faster plugin setup.


Crafting Stations & Custom Recipes (wiki)
A crafting station is a GUI that grants players access to custom recipes. There are two types of recipes: crafting recipes that players can use to create new items and upgrading recipes that players can use to boost their weapons/armor.
These custom recipes require specific ingredients (vanilla or items from MI) and conditions, including level, class, and permission conditions. Crafting recipes may also have a crafting time, which delays players' need to wait before claiming the crafted item. These items are sent to the crafting queue and can be claimed later by the player when opening the crafting station.
These stations can be opened using a command; therefore, they can be easily bound to any NPC from Citizens. For example, you could have a Blacksmith NPC which lets you create advanced gear like steel stuff.


Soulbound (wiki)
Players can bind items to themselves using specific consumables. Once their item is bound, other players can't use it and will take damage when trying to... unless they use another consumable to break that soulbound!
Soulbounds are displayed on the item lore, but the info of an item can also be accessed using /soulbound while holding that particular item. Soulbounds also have levels. A consumable item stat determines the level of a soulbound and sets how strong the binding is, i.e., how much damage it deals. To break a soulbound, the level of the consumable breaking the soulbound must be higher than the binding level.
Creating or breaking a soulbound item might sometimes fail depending on the consumables' soul-binding chance/soulbound break chance.


Gem Stones (wiki)
Gem Stones are a great way for players to improve the items they obtain. Gem Stones can be bound to items to give them extra statistics like extra attack damage, damage reduction, and movement speed... Items need empty gem sockets to receive gem stones. Applying gem stones might sometimes fail, and the player will lose the gem. However, the gem socket will not be used.
You can also configure item type restrictions to make your gem stones only available to specific items. This way, gem stones that give extra armor and max health can't be applied to weapons.
Gem Stones and item gem sockets have colors. You can only apply a gem onto an item with at least one socket with the same gem color. Uncolored gems can be applied to any socket. Any gem can be applied to an uncolored socket.

  Gem Stones



Item Glow and Hints
Rare items may glow when dropped. The glowing colors depend on the item tier. Rare items also display their name above the item entity.


Item Deconstruction (wiki)
Players can deconstruct an item into another item using a special consumable. The deconstruction output gets better with the initial item level tier. Deconstructing an item can also drop materials players can use with the advanced workbench to craft other unique items!
As seen on the screenshot, deconstructing the same item may drop different items, some being rarer than others. This new system brings utility (apart from selling) to all the unusable RPG loot.

  Item Deconstruction

Consumables are custom food players that can eat to regen their health, food bar, and saturation level & to gain potion effects for a specific amount of time. Consumables can also send commands and cast abilities just like normal weapons. They can also be used to repair, identify or deconstruct other items.




Unidentified Items (wiki)
Unidentified items are a cool way of adding some suspense & extra randomness to mob loot. When monsters drop unidentified loot, the only way to reveal its stats and use it is to identify it using a consumable item.

  Item Identification

Items with custom textures
MMOItems features 1.14 custom model data support, which can be used to create items with custom textures or animated models. Texture by durability is no longer supported since Legacy builds were discontinued.


Custom Durability System (wiki)
If a vanilla tool has not had enough uses, you can use the custom durability system, similar to the vanilla durability feature; coupled with 1.14+ custom model data, new item possibilities are endless.
Any item can have a set amount of use before it breaks. Items can be repaired using consumables to get some uses back, and this system also supports the Unbreaking, and Mending vanilla enchants. Custom durability displays on the item vanilla durability bar like usual!
Items may break or become unusable if their durability points reach 0, depending on how the item is configured.
Suppose you want to let your players know exactly how broken the item is. In that case, you can use placeholders from PlaceholderAPI to display the exact number of uses left for your item. The remaining durability points also show in the item lore directly.

Item Edition GUI
You can edit any item using /mi edit <type> <id>. This menu makes editing much easier: you can configure anything about your item. Every step of editing is detailed, and the only stats displayed here are the stats that your current item supports.

  Item Edition Menu

Item Particle Effects
Every item can display a particle effect around the player when worn/held. There are currently seven types of particle effects, and you can choose what particular to use each time. You can also give colors to the particles you are using, e.g., green and Redstone particles.

  Item Particle Effects

Elemental Damage (wiki)
Elemental Damage defines the percent of your weapon damage dealt as elemental damage. Elemental Defense decreases a specific type of elemental damage. Particles display when hitting an enemy for every element on your item—available elements: Fire, Ice, Wind, Earth, Thunder, and Water.
Weapons with elemental damage can perform elemental critical strikes, increasing damage dealt by elements and applying different attack effects (Fire burns your target, Earth knocks up nearby enemies...).

Monster & Block Drop Tables (wiki)
You can set up complex drop tables for monsters and blocks. You can also drop unidentified items which will need to be identified to be used by players. Items from MI are also recognized in MythicMobs drop tables, which means you can make MM mobs drop or equip items from MMOItems.

Endless Possibilities
MMOItems comes with more than 60 pre-configured items. As new features are implemented, more sample items will be added to the default config to make the plugin more accessible. You can use /mi browse to open the item browser, which allows you to explore the items you created, sorted by their item type.
You can also make your items have random stat values this way. There might be better & more valuable versions of any item around your server.

  Item Browser



Damage & Regen Indicators
These indicators display damage dealt by players to monsters as well as health gained by players from natural regeneration, magic regen, and saturation... They can be fully edited in the main config file. These indicators require Holograms, HolographicDisplays, or CMI to work.


Fully translatable & customizable
You can translate any message, ability, stat name, or potion effect name... The item lore format can also be fully edited.

Vanilla Crafting Recipes
Shaped, shapeless & furnace editable crafting recipes.

Automatic Item Updates
If you want to nerf an item that is becoming overpowered, you can use the auto-updater to force the item to update for everyone on the server. The new "revision ID" system will ensure that everyone's items are updated.

Easy to use & fully documented
MMOItems is natively compatible with many leveling plugins like Heroes, SkillAPI, RPGPlayerLeveling, BattleLevels, and mcMMO... It also features commands with full tab completion support. You can find the entire command and permission list on the wiki.

  More Items

  1. Highly compatible with MMOCore
  2. Compatible with MMOInventory and RPGInventory
  3. Levels, classes, mana & stamina from Heroes
  4. Levels, classes & mana from SkillAPI
  5. Levels, mana & power from RPGPlayerLeveling
  6. Levels, classes & energy from Skills
  7. Levels & mana from AureliumSkills
  8. Useful WorldGuard flags
  9. Drop tables and custom skills for MythicMobs
  10. Adds PlaceholderAPI placeholders
  11. Indicators using HolographicDisplays, Holograms or CMI
  12. Levels from BattleLevels
  13. Item glow using GlowAPI and PacketListenerAPI
  14. Power level from mcMMO and McRPG
  15. New reward type for BossShopPro
  16. Fully supports RealDualWield and DualWield
  17. Support for Vault economy and permissions






By purchasing this plugin, you agree to the following:

  1. You cannot redistribute, resell, or give this plugin to anyone else.
  2. We don't give support to servers involved with piracy in any way, shape, or form.
  3. You cannot modify or decompile the plugin.
  4. You can only use it on one network/server at a time.
  5. You are only allowed to download this plugin from an official source (PhoenixDevt or Spigot).
  6. Bugs must be reported on Gitlab.
  7. PhoenixDevt reserves the right to change the terms at any time; therefore, you must agree to the most recent version.
  8. There will be no refunds.
  9. An installation guide is available on the wiki.