Modifiers

hide_obvious

This modifier is used by default, it aims to be fast and efficient. It hides most ores except ores that are exposed to the view of normal people.

The minimum configuration to activate it:

{
	Preset="overworld_stone"
	Type="mirage:hide_obvious"
}

The configuration generated by default:

{
	Options {
		# Blocks that will be hidden by the modifier
		Blocks=[
			"minecraft:coal_ore",
			"minecraft:diamond_ore",
			"minecraft:emerald_ore",
			"minecraft:gold_ore",
			"minecraft:iron_ore",
			"minecraft:lapis_ore",
			"minecraft:redstone_ore",
			"minecraft:copper_ore",
			"minecraft:deepslate_coal_ore",
			"minecraft:deepslate_diamond_ore",
			"minecraft:deepslate_emerald_ore",
			"minecraft:deepslate_gold_ore",
			"minecraft:deepslate_iron_ore",
			"minecraft:deepslate_lapis_ore",
			"minecraft:deepslate_redstone_ore",
			"minecraft:deepslate_copper_ore",
			"minecraft:chest",
			"minecraft:end_portal",
			"minecraft:end_portal_frame",
			"minecraft:mossy_cobblestone",
			"minecraft:nether_portal",
			"minecraft:spawner",
			"minecraft:trapped_chest"
		]
		# The dynamic obfuscation distance, between 0 and 10
		Dynamism=4
		# The maximum Y of the section to obfuscate
		MaxY=319
		# The minimum Y of the section to obfuscate
		MinY=1
		# The block used to replace hidden blocks
		Replacement="minecraft:stone"
	}
	Preset="overworld_stone"
	Type="mirage:hide_obvious"
}

random_block

This modifier is the most efficient against malicious users. It behaves the same way as hide_obvious but in addition it generates random fake ores to hide caves, bases and remaining ores. This one can be a bit slower when first obfuscating because it’s generating thousands of fake ores but will be negligible the remaining of the time thanks to the caching system.

The minimum configuration to activate it:

{
	Preset="overworld_stone"
	Type="mirage:random_block"
}

The configuration generated by default:

{
	Options {
		# Blocks that will be hidden by the modifier
		Blocks=[
			"minecraft:stone",
			"minecraft:granite",
			"minecraft:polished_granite",
			"minecraft:diorite",
			"minecraft:polished_diorite",
			"minecraft:andesite",
			"minecraft:polished_andesite",
			"minecraft:coal_ore",
			"minecraft:diamond_ore",
			"minecraft:emerald_ore",
			"minecraft:gold_ore",
			"minecraft:iron_ore",
			"minecraft:lapis_ore",
			"minecraft:redstone_ore",
			"minecraft:copper_ore",
			"minecraft:deepslate_coal_ore",
			"minecraft:deepslate_diamond_ore",
			"minecraft:deepslate_emerald_ore",
			"minecraft:deepslate_gold_ore",
			"minecraft:deepslate_iron_ore",
			"minecraft:deepslate_lapis_ore",
			"minecraft:deepslate_redstone_ore",
			"minecraft:deepslate_copper_ore",
			"minecraft:chest",
			"minecraft:end_portal",
			"minecraft:end_portal_frame",
			"minecraft:mossy_cobblestone",
			"minecraft:nether_portal",
			"minecraft:spawner",
			"minecraft:trapped_chest"
		]
		# The maximum Y of the section to obfuscate
		MaxY=319
		# The minimum Y of the section to obfuscate
		MinY=-64
		# Blocks and their weight used to randomly replace hidden blocks
		Replacements {
			"minecraft:coal_ore"=1.0
			"minecraft:copper_ore"=1.0
			"minecraft:diamond_ore"=1.0
			"minecraft:emerald_ore"=1.0
			"minecraft:gold_ore"=1.0
			"minecraft:iron_ore"=1.0
			"minecraft:lapis_ore"=1.0
			"minecraft:redstone_ore"=1.0
			"minecraft:stone"=8.0
		}
	}
	Preset="overworld_stone"
	Type="mirage:random_block"
}

random_bedrock

Some malicious mods use the patterns of bedrock generated in your world to calculate your seed and then use this seed to know where ores have been generated. This modifier alters the bedrock to prevents them from calculating your seed using the it.

The minimum configuration to activate it:

{
        Type="random_bedrock"
}

The configuration generated by default:

{
	Options {
		# The ground type used to hide real bedrock
		Ground="minecraft:deepslate"
		# The maximum layer where bedrock can be generated
		Height=5
	}
	Type="mirage:random_bedrock"
}

hide_all

This modifier is really fast but a bit extreme since all ores will be hidden. This modifier exists primarily for debugging purposes. In production, you should prefer the hide_obvious modifier.

The minimum configuration to activate it:

{
	Preset="overworld_stone"
	Type="mirage:hide_all"
}

The configuration generated by default:

{
	Options {
		# Blocks that will be hidden by the modifier
		Blocks=[
			"minecraft:coal_ore",
			"minecraft:diamond_ore",
			"minecraft:emerald_ore",
			"minecraft:gold_ore",
			"minecraft:iron_ore",
			"minecraft:lapis_ore",
			"minecraft:redstone_ore",
			"minecraft:copper_ore",
			"minecraft:deepslate_coal_ore",
			"minecraft:deepslate_diamond_ore",
			"minecraft:deepslate_emerald_ore",
			"minecraft:deepslate_gold_ore",
			"minecraft:deepslate_iron_ore",
			"minecraft:deepslate_lapis_ore",
			"minecraft:deepslate_redstone_ore",
			"minecraft:deepslate_copper_ore",
			"minecraft:chest",
			"minecraft:end_portal",
			"minecraft:end_portal_frame",
			"minecraft:mossy_cobblestone",
			"minecraft:nether_portal",
			"minecraft:spawner",
			"minecraft:trapped_chest"
		]
		# The maximum Y of the section to obfuscate
		MaxY=319
		# The minimum Y of the section to obfuscate
		MinY=1
		# The block used to replace hidden blocks
		Replacement="minecraft:stone"
	}
	Preset="overworld_stone"
	Type="mirage:hide_all"
}

The default configuration of each modifier can vary depending on the chosen preset. See Presets.