Whispers are used to influence untrained Villagers (Villagers that have a profession, but never traded before). If a Whsiper was Imprinted, it can force Librarians to trade certain enchanted Books.

If you hold an (Imprinted-)Whisper in your hand while trading with a fresh Villager of any Profession, you will be able to re-roll it's first set of trades in the Trading Menu. Simply click the villager as usual to open the Trading Menu. If you hold a Whisper, and the villager is a Novice without any trading experience the re-roll button will appear.

Clicking the re-roll button will consume durability from the Whisper and re-roll the villagers trades. The re-roll behaves the same as destroying and rebuilding the workstation.

Using a Game Rule you can unlock re-rolls without the need for a Whisperer.

Imprinters are used to imprint an enchantment onto a blank Whisperer. When you use the Imprinter workstation, the above screen should open. If you have the required material, you can click an item from the left (hover over the Image of the Whisperer to see what enchantment it will imprint) to bring it to the build area on the right.

You can pick up the imprinted Whisperer from the right-most slot.

Wunderreich automatically generates an Imprinter recipe for every Enchantment that can be traded by Villagers, so Enchantments added by other mods are picked up automatically. On top of this, a Data Pack can patch or disable individual auto-generated Imprinters, without needing to write a full custom recipe.

File location

Override files are normal Data Pack data, one file per Enchantment, keyed by the Enchantment's own namespace:

• data/<enchantment_namespace>/wunderreich/imprinter_overrides/<enchantment_path>.json

Examples:

• minecraft:sharpness → data/minecraft/wunderreich/imprinter_overrides/sharpness.json
• minecraft:mending → data/minecraft/wunderreich/imprinter_overrides/mending.json
• somemod:frost → data/somemod/wunderreich/imprinter_overrides/frost.json

Because each Enchantment maps to exactly one file, two Data Packs overriding the same Enchantment resolve using the normal Data Pack load order (the last loaded Pack wins) - there is no special merge priority to worry about.

Overrides are (re-)applied automatically whenever a world loads and whenever /reload is run.

Setting up the Data Pack

If you don't already have a Data Pack, create one at <world>/datapacks/<your_pack>/ with a pack.mcmeta using the Data Pack format for Minecraft 26.1:

• pack_format: 101

After adding or editing an override file, run /reload (or re-enter the world). On success, the server log shows a line like Loaded N imprinter override(s).

JSON format

Every field is optional. A field that is present replaces the auto-generated value; a field that is missing keeps the auto-generated value (a partial override):

• input (ItemStack) - the item (and count) the player has to supply. This is the Imprint / trade cost.
• output (ItemStack) - the trained Whisperer produced by the Imprinter.
• baseXP (number) - base XP granted for the resulting trade.
• icon (ItemStack) - the icon shown in the Imprinter UI and in recipe viewers such as REI.
• enabled (true/false) - set to false to remove this auto-generated Imprinter entirely.
• disabled (true/false) - alternative way to write "enabled": false.

ItemStack values use the vanilla item-stack JSON form - { "id": "<item id>", "count": <n> } (count defaults to 1; Data Components may be added under "components" as usual).

Example - change the cost, XP and icon of Sharpness

data/minecraft/wunderreich/imprinter_overrides/sharpness.json:

• input: 5× Diamond
• baseXP: 99
• icon: Netherite Hoe

All other fields (the actual output whisperer) stay as auto-generated.

Example - disable the Mending Imprinter

data/minecraft/wunderreich/imprinter_overrides/mending.json:

• enabled: false

This removes the auto-generated Mending Imprinter entirely - it no longer appears in the Imprinter, in recipe viewers, or in network sync to clients. All other Enchantments are unaffected.

There are different configuration options for Whisperers and Imprinters. Some are global (for the entire Minecraft instance), somea are defined per world (for example as game rules).

Game Rules

• /gamerule wunderreich:wunderreich_allow_trades_cycling [true|false]
  Enable Trade-Cycling. If disabled, you basically disable the Whisperer mechanic.
• /gamerule wunderreich:wunderreich_cycling_needs_whisperer [true|false]
  Villagers will only cycle trades when player holds a Whisperer. When disabled, you can re-roll trades of unexperienced Novice Villagers without any Whisperer.
• /gamerule wunderreich:wunderreich_allow_librarian_selection [true|false]
  Librarians hear imprinted Whispers and present matching trades when cycled. When disabled, imprinted Whisperers behave like blank Whisperers and have no special effect on Librarians.
• /gamerule wunderreich:whispers_durability [number]
  The base Durability of a blank Whisperer.
• /gamerule wunderreich:whispers_trained_durability [number]
  The base Durability of an imprinted Whisperer.
• Imprinting a Whisperer generates a small amount of XP for the Player. The static base XP depends on the rarity of the imprinted Enchantment (or the Imprinter's override, if set) and is then multiplied with a random (percentage-)value in a user definable range.
  • /gamerule wunderreich:whispers_min_xpmultiplier [number]: Minimum percentage of base XP that will get dropped.
  • /gamerule wunderreich:whispers_max_xpmultiplier [number]: Maximum percentage of base XP that will get dropped.

Configuration (in Main.json)

• features.enableWhispers
  Will add (Imprinted-)Whisperers as Items to the game. When disabled, no Whisperer-Items will be available in your worlds.

  Dependant Settings (only available when true):

  • features.addBlankWhisperer
    Generate blank Whisperers.
  • features.addImprintedWhispers
    Generate imprinted Whisperers based on all enchanted Books that can be traded with Villagers.