Installation Guide

This is an old version of this page. You can view the most recent version or browse the history.

You may download the plugin on SpigotMC. The file you download is a ZIP which contains the actual plugin build, plus extra addons that you don't need to install the first time you run MMOItems.

If you are using WorldGuard, make sure you are running the very latest WG build available for your server version. You need WorldGuard 6.2 or higher. You also need MMOItems LegacyWG if you are running WorldGuard 6.2.

Installing MMOItems Premium on Legacy (<1.13)

Since 4.7.6, MMOItems Premium supports Spigot 1.12 however it is not the native versions and the default config files are made for 1.13+, therefore you need to follow these instructions in order to load an older version of the config files. Install MMOItems Premium and start your server, then shut it down once MMOItems has been enabled and generated default config files. You should see many loading errors on the console. When your server is shut down, delete all the config files inside the /plugins/MMOItems folder, open the MMOItems downloaded zip, which contains another zip called legacy-configs.zip. Extract all its content inside the /MMOItems folder and restart your server. The errors should be gone.

If you're running WorldGuard on Legacy, you MUST install MMOItems LegacyWG otherwise MMOItems will spit out an error when loading and it will not enable.

Additional Addons

The other files are addons. If you are new to MMOItems, you might not need them right away. Install them in the /plugins folder (not in the /MMOItems/addon folder).

MMOItems WorldDrops

MMOItems WorldDrops allows you to have per-world drop tables for blocks and monsters. This allows monsters/blocks to drop different items depending on the world they are killed/mined in. If you want to use this addon, simply drag & drop it in your plugins folder just like you did with MMOItems. A /drops folder should appear in the /MMOItems plugin folder after rebooting your server. In that folder, each .yml file corresponds to a world drop tables. In order to know how to configurate these YAML config files, please refer to this wiki page.

MMOItems Mana & Stamina

MMOItems Mana & Stamina is a simple addon which adds default mana & stamina resources for players. These resources can be consumed to use abilities or weapons. PlaceholderAPI placeholders:

%mana_mana%
%mana_stamina%
%mana_mana_regen%
%mana_stamina_regen%
%mana_mana_bar%
%mana_stamina_bar%
%mana_max_mana%
%mana_max_stamina%

This addon also adds three new item stats to MMOItems: Max Stamina, Stamina Regeneration and Mana Regeneration. If you would like to utilize these item stats, you must add the following lines to your stats.yml, otherwise MMOItems will spit out an error in the console every time you try to apply it onto an item.

max-stamina: '&7■ Max Stamina: &f<plus>#'
mana-regen: '&7■ Mana Regeneration: &f<plus>#'
stamina-regen: '&7■ Stamina Regeneration: &f<plus>#'

Add these lines somwhere in your lore-format.yml setup as well, otherwise these stats will not display in any of your items lore.

- '#max-stamina#'
- '#mana-regen#'
- '#stamina-regen#'

MMOItems Mana & Stamina is NOT compatible with other RPG core plugins which already handle mana and stamina/power like SkillAPI, Heroes or RPGPlayerLeveling. This addon will NOT let you utilize the player level from your RPG plugin when installed.