Trader Mirage

Trader Mirage

What is this datapack/mod?

This enables the illusioner (already present in the game and normally can only be summoned with the /summon command) to appear by making it so each wandering trader has a chance to be one in disguise!

How this works

Each wandering trader gets one secret roll when it first appears.
Chance = (ordinary traders since the last illusioner + 1) x difficulty value, capped at 100%.
So the base chance and the per-miss increase are the same number, set by difficulty:

Easy 5% Normal 10% Hard 15%

The difficulty is read fresh on every roll, so changing it mid-game is safe; the streak is kept.
Peaceful: no rolls happen, the streak is untouched, and disguised traders stay disguised
(an illusioner would be removed instantly there). Everything resumes when difficulty is raised.

A disguised trader turns into an illusioner when a player interacts with it or hurts it.
When a roll succeeds, the streak resets to zero.

Commands (permission level 2):

• /function trader_mirage:status
• /function trader_mirage:reset
• /function trader_mirage:set_easy {value:50} (FYI: 50 = 5%)
• /function trader_mirage:set_normal {value:100}
• /function trader_mirage:set_hard {value:150}
• /function trader_mirage:set_hint {value:0} (Also FYI: 1 shows the faint particle hint and 0 hides it)

For Minecraft Java 1.21 and above.