MMOItem Converter

I mentioned that 'no stats from the VANILLA MMOItem will be passed on to converted vanilla items. Well thats not entirely true.

There is exactly one stat that is passed on:

Random Tiers:

The first step is to choose which category, that is, SWORD? TOOL? ARMOR? And also choose where, OnCraft (when the item is crafted), or OnPickup (when picked up). Write the possible tiers in GooP List Placeholder's format (Allows you to specify a tier and a weight):

plugins/Gunging_Ootilities_Plugin/mmoitems-converter.yml

SWORD:

OnCraft:

Tier:

# Total: 100, of which 70% will be common.

- COMMON 70

- UNCOMMON 22

- RARE 6

- EPIC 2

OnPickup:

Tier:

# Total 5, of which 20% will be epic.

- RARE 4

- EPIC 1

Furthermore, you may give any bonus (numeric/text/text list/boolean) stats based on tier:

plugins/Gunging_Ootilities_Plugin/mmoitems-converter.yml

SWORD:

OnCraft:

Tier:

- COMMON 7

- UNCOMMON 4

- RARE 2

- EPIC 1

UNCOMMON:

# Better attack damage

attack-damage: '110%'

RARE:

# Even better attack damage

attack-damage: '130%'

EPIC:

# Best attack damage, and even crit chance!

attack-damage: '150%'

critical-strike-chance: '5'

OnPickup:

Tier:

- RARE 5

- EPIC 1

RARE:

disable-enchanting: true

attack-damage: '120%'

gem-sockets:

- 'Uncolored'

- 'Red'

EPIC:

attack-damage: '140%'

critical-strike-chance: '4'

set: 'EPIC_SET_BONUS'

String Lists require MMOItems 6.3+

When are the Random Tiers applied?

The item a player crafts, is not the same one they see in the crafting table as a preview. The preview is exactly that, a preview, and the tier it will be has not been chosen yet. The tier is chosen the moment the player crafts the item.

This will cause the preview to not display a tier, but the final item will always have a tier (because its based on weights). To fix this:

SWORD:

OnCraft:

# Lowercase t, the tier the preview will display.

tier: 'COMMON'

# Capital T, the weighted list of random tiers.

Tier:

- COMMON 7

- UNCOMMON 4

- RARE 2

- EPIC 1

When the item is crafted, and a random tier picked, it will take precedence and overwrite the standard one.

Advanced Settings

The default behaviour of the GooP Converter is fitting vanilla items into MMOItem Types (swords go to SWORD, pickaxes go to TOOL...), and giving them all the same MMOItems ID 'VANILLA'. This behavior generalizes things, and though its simple, its not very powerful.

The first step in making a more powerful system, is fitting vanilla items to other types. Suppose you do

plugins/Gunging_Ootilities_Plugin/mmoitems-converter.yml

MMOItems_Type_Prefix: "VANILLA_"

With that, swords will be sent to MMOItem Type VANILLA_SWORD, while armor will go to VANILLA_ARMOR, and crossbows to VANILLA_BOW. Make sure the types exist by configuring them all, you may follow this example:

plugins/MMOItems/item-types.yml

VANILLA_SWORD:

# This is the parent MMOItem Type, basically, what kind of

# stats these items can have. For example, setting the parent

# to GEM_STONE will allow this type VANILLA_SWORD to be inserted

# into items... we dont want that. Lets just use the SWORD type.

parent: 'SWORD'

# What it will display like in /mmoitems browse

display: 'WOODEN_SWORD'

name: 'Makeshift Sword'

unident-item:

name: '<#cb94ff>&l¿ <#b363ff>Unidentified<#f7e57e>&l Sword <#cb94ff>&l?'

material: 'CLAY_BALL'

model: '2'

lore:

- ''

- '<#bee89b>This item is unidentified. Will have to'

- '<#bee89b>purchase a <#e099f0>Scroll of Identification'

- '<#bee89b>for &a$10<#bee89b> at the &b/warp market<#bee89b>.'

These are the types you must make a configuration of: SWORD, AXE, TOOL, ARMOR, SPEAR, WHIP, BOW, and SHIELD.

Finally, editing their IDs individually.

plugins/Gunging_Ootilities_Plugin/mmoitems-converter.yml

Differentiate_Items: true

Activating this will give every vanilla piece a different id, the three things considered are the Equipment, Material, and Tier, where Tier will only show up if there are tiers involved, and is thus optional. The format is simple:

GENERIC_{Equipment}_{Material}_{Tier}

For example, a diamond sword (with no tier): GENERIC_SWORD_DIAMOND

A goldwn helmet with EPIC tier: GENERIC_HELMET_GOLDEN_EPIC

A turtle helmet with rare tier: GENERIC_HELMET_RARE

You can now redirect a diamond axe from m AXE VANILLA into a very specific m VANILLA_AXE GENERIC_AXE_DIAMOND_UNCOMMON, and the coolest part is, that if you do create an axe with that type and id (/mmoitems create VANILLA_AXE GENERIC_AXE_DIAMOND_UNCOMMON), the MMOItems Converter will spit it out as the result of the crafting (or picking up) operation.

Prevent MythicItems from being Converted

If the items you made with MythicMobs should not be converted, do not allow them to enter the converter by adding this to the file:

Allow_MythicItems: false

Use Defense instead of Armor to Convert Items

Some people use Defense stat from MMOItems, to toggle this you must put in the plugin config the following value:

plugins/Gunging_Ootilities_Plugin/config.yml

ConverterUsesDefense: true