!!! - Enjoying the plugin? Consider a donation! It's a great help and will contribute to the maintaining/development of the plugin!
Introduction:
MIReplacer is an addon for MMOItems which automatically converts vanilla items into configured MMOItem items. Everything is handled automatically when a player crafts, smelts or picks up an item, etc.
Current events where an item gets converted:
- When crafted.
- When smelted.
- When picked up.
- When a chest is opened.
- When moving items around in the inventory.
All of these are configurable and can be enabled/disabled to your liking.
Configuration:
The default configuration is an example using the default MMOItem items and some vanilla items:
Code (YAML):
Options
:
# When enabled, stores the whole config into memory for performance.
# Is highly recommended, but may take up some RAM if using a VERY large config.
# NOTE: Some features will not work as intended and may be entirely disabled if
# this is set to false. ONLY do this as a last resort if MIReplacer is lagging!
cacheConfig : true
# List of worlds that uses MIReplacer. Leave empty to use it server-wide.
# worldList: ["world", "world_nether", "world_the_end"]
worldList : [ ]
# Whether converted items should keep old enchantments once converted.
keepEnchantments : true
# Whether custom names carry over from old items once converted.
keepCustomNames : true
# The item name of the random item displayed when using weights in crafting.
previewItemName : "&1Random Item"
# {itemname} will be replaced by the name of the possible item.
previewItemIndex : "&f- &9Possible Item: &f{itemname}"
# The lore to display when previewing items to be crafted.
# set to 'craftingLorePreview: []' to disable this feature.
craftingLorePreview :
- "&7This is a placeholder item."
- "&7Stats will remain hidden until crafted!"
Convert-On :
# Convert items when picked up from the ground
pickup : true
# Convert items when crafted in the crafting table
craft : true
# Convert items when smelted in a furnace. (Blast & Smokers on 1.14+)
# !!! IMPORTANT: Servers must be restarted when changing the config
# !!! for smelted recipes to work correctly when replacing!
smelt : true
# Convert when chests are being opened. This only applied once per
# individual chest/minecart (resets on server restarts)
chest : true
# Convert when item is moved around in the inventory.
# This one will call A LOT of events and therefore may not
# be suited for larger servers. Most of the time there won't
# even be the need for it, so best to leave it off.
inventory-change : false
ConversionItems :
# This will turn any brick into an MMOItems Steel Ingot
BRICK : MATERIAL.STEEL_INGOT
# Iron Swords into MMOItems Cutlass...
IRON_SWORD : SWORD.CUTLASS
# Diamond Sword = Falcon Blade
DIAMOND_SWORD : SWORD.FALCON_BLADE
# This Gold Nugget will turn into a gold coin, but
# enchantments won't carry over, regardless of the global option.
# This also works the other way around so if global is false and
# the individual item is true, then enchantments will only carry
# over for the individual item and not for other replacements.
GOLD_NUGGET:
item : MISCELLANEOUS.GOLD_COIN
keepEnchantments : false
# [!] This setting also works here:
# keepCustomNames: false
# This is a weighted list, making replacements random.
# Each entry requires an item and a weight. Higher
# weight means more likely. This is an example where
# an Iron Axe will commonly turn into a Butcher's Axe
# or a Bone Cracker and in rare cases a Skull Breaker.
IRON_AXE :
# the numbers don't have to be numbers, they
# can be anything. Be like the numbers. Be anything.
1:
item : AXE.BUTCHER_AXE
# The total weight is summed and then a random numbers
# between 0 and summed weight is generated. The random
# number is then subtracted by each choices weight and once
# it hits 0 or less the candidate will be found.
# (That was a horrible explanation, sorry I'm writing this at 3 AM)
weight : 5
2:
item : AXE.BONE_CRACKER
# Weights can be anything from 1 to 2147483647
weight : 5
3:
item : AXE.SKULL_BREAKER
weight : 2
# When chichen is cooked. It will turn into
# an MMOItems Sandwich instead of cooked chicken.
COOKED_CHICKEN : CONSUMABLE.SANDWITCH
# When enabled, stores the whole config into memory for performance.
# Is highly recommended, but may take up some RAM if using a VERY large config.
# NOTE: Some features will not work as intended and may be entirely disabled if
# this is set to false. ONLY do this as a last resort if MIReplacer is lagging!
cacheConfig : true
# List of worlds that uses MIReplacer. Leave empty to use it server-wide.
# worldList: ["world", "world_nether", "world_the_end"]
worldList : [ ]
# Whether converted items should keep old enchantments once converted.
keepEnchantments : true
# Whether custom names carry over from old items once converted.
keepCustomNames : true
# The item name of the random item displayed when using weights in crafting.
previewItemName : "&1Random Item"
# {itemname} will be replaced by the name of the possible item.
previewItemIndex : "&f- &9Possible Item: &f{itemname}"
# The lore to display when previewing items to be crafted.
# set to 'craftingLorePreview: []' to disable this feature.
craftingLorePreview :
- "&7This is a placeholder item."
- "&7Stats will remain hidden until crafted!"
Convert-On :
# Convert items when picked up from the ground
pickup : true
# Convert items when crafted in the crafting table
craft : true
# Convert items when smelted in a furnace. (Blast & Smokers on 1.14+)
# !!! IMPORTANT: Servers must be restarted when changing the config
# !!! for smelted recipes to work correctly when replacing!
smelt : true
# Convert when chests are being opened. This only applied once per
# individual chest/minecart (resets on server restarts)
chest : true
# Convert when item is moved around in the inventory.
# This one will call A LOT of events and therefore may not
# be suited for larger servers. Most of the time there won't
# even be the need for it, so best to leave it off.
inventory-change : false
ConversionItems :
# This will turn any brick into an MMOItems Steel Ingot
BRICK : MATERIAL.STEEL_INGOT
# Iron Swords into MMOItems Cutlass...
IRON_SWORD : SWORD.CUTLASS
# Diamond Sword = Falcon Blade
DIAMOND_SWORD : SWORD.FALCON_BLADE
# This Gold Nugget will turn into a gold coin, but
# enchantments won't carry over, regardless of the global option.
# This also works the other way around so if global is false and
# the individual item is true, then enchantments will only carry
# over for the individual item and not for other replacements.
GOLD_NUGGET:
item : MISCELLANEOUS.GOLD_COIN
keepEnchantments : false
# [!] This setting also works here:
# keepCustomNames: false
# This is a weighted list, making replacements random.
# Each entry requires an item and a weight. Higher
# weight means more likely. This is an example where
# an Iron Axe will commonly turn into a Butcher's Axe
# or a Bone Cracker and in rare cases a Skull Breaker.
IRON_AXE :
# the numbers don't have to be numbers, they
# can be anything. Be like the numbers. Be anything.
1:
item : AXE.BUTCHER_AXE
# The total weight is summed and then a random numbers
# between 0 and summed weight is generated. The random
# number is then subtracted by each choices weight and once
# it hits 0 or less the candidate will be found.
# (That was a horrible explanation, sorry I'm writing this at 3 AM)
weight : 5
2:
item : AXE.BONE_CRACKER
# Weights can be anything from 1 to 2147483647
weight : 5
3:
item : AXE.SKULL_BREAKER
weight : 2
# When chichen is cooked. It will turn into
# an MMOItems Sandwich instead of cooked chicken.
COOKED_CHICKEN : CONSUMABLE.SANDWITCH
all Iron Swords will become Sharp Cutlasses, Diamond Swords will become Falcon Blades, Gold Nuggets will become Gold Coins and Cooked Chicken will become Sandwiches. The Iron Axe will randomly select between the Butcher's Axe, Bone Cracker and Skull Breaker, with the first two having a higher chance of appearing.
Examples:
Code (YAML):
ConversionItems:
TORCH : MATERIAL.RARE_DIAMOND
BRICK : MATERIAL.STEEL_INGOT
TORCH : MATERIAL.RARE_DIAMOND
BRICK : MATERIAL.STEEL_INGOT
Code (YAML):
ConversionItems:
BRICK : MATERIAL.STEEL_INGOT
IRON_SWORD : SWORD.SHARP_CUTLASS
DIAMOND_SWORD : SWORD.SOULSTEALER
FURNACE : MATERIAL.RARE_DIAMOND
BRICK : MATERIAL.STEEL_INGOT
IRON_SWORD : SWORD.SHARP_CUTLASS
DIAMOND_SWORD : SWORD.SOULSTEALER
FURNACE : MATERIAL.RARE_DIAMOND
- NEW IN 2.0!:
You can now set options for individual conversion items.
Example:
Code (YAML):
ConversionItems:
NETHERITE_SWORD:
item : SWORD.BIG_BAD_BOY
keepEnchantments : false
keepCustomNames : false
NETHERITE_SWORD:
item : SWORD.BIG_BAD_BOY
keepEnchantments : false
keepCustomNames : false
- - - - - - - - - - - - - -
My Other Plugins
Support Discord
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.12, 1.13, 1.14
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
MIReplacer - (Requires MMOItems) is a free Minecraft Java mod. Compatible with Minecraft 1.12, 1.13, 1.14, 1.15 and newer. Downloaded 14,593 times (via Spigot). Download it and open it directly in the game.