Trading and Traders 1.21.1 - Herbertofury/Advent-of-Ascension GitHub Wiki

Trading and Traders · 1.21.1

Minecraft 1.21.1 / AoA 3.7.16.1. This handbook catalogs 55 base offer definitions: seventeen fixed AoA trader offers, 22 dimension-conditional Herald offers and 16 additions to villager profession pools. It is not a promise that one trader offers all of them, that every retained dimension is playable, or that final displayed prices match the base input.

Where modern traders spawn, including Precasian hovels

Open the searchable Trading Desk · Historical 1.16.5 traders

Before you spend your coins

  • Base prices can change. Reputation, demand and other runtime/modpack changes are not evaluated here. Inspect the price in the actual trade screen.
  • Max uses means transactions before restocking, not total output items. A three-item output used 16 times represents 48 items before other changes.
  • Merchant XP is profession progression, not the number of player experience orbs. The AoA trader class calculates player XP separately.
  • Profession rows are candidates added to their level pools. A particular villager may not select every listed offer.
  • Bring the listed coin denomination. This extraction does not establish a universal coin-conversion recipe. Find Copper Coin loot references and Silver Coin references.

Lottoman

The released level-one pool contains four offers, and the Lottoman requests four level-one unlocks. The source trade map does not define additional higher-level pools. Boxes and totems have their own item behavior; buying one is not a guaranteed particular reward.

Lottoman bestiary entry · Rendered model views

Level Base input Output Max uses Merchant XP
Novice Copper Coin 31 × Copper Coin Weapons Case 1 × Weapons Case 16 12
Novice Copper Coin 14 × Copper Coin Rune Box 1 × Rune Box 16 8
Novice Copper Coin 41 × Copper Coin Treasure Box 1 × Treasure Box 16 20
Novice Silver Coin 3 × Silver Coin Lotto Totem 1 × Lotto Totem 16 25

Skill Master

Ten level-one definitions exchange Archaic Tokens for four crystal sizes or six Skill Helmets. The released class requests up to 50 unlocks from this ten-offer pool. See the Skill Master and Archaic Tokens walkthrough for the utility lobby, reward routes and limitations.

Level Base input Output Max uses Merchant XP
Novice Archaic Token 11 × Archaic Token Small Skill Crystal 1 × Small Skill Crystal 32 20
Novice Archaic Token 13 × Archaic Token Medium Skill Crystal 1 × Medium Skill Crystal 24 50
Novice Archaic Token 18 × Archaic Token Large Skill Crystal 1 × Large Skill Crystal 16 75
Novice Archaic Token 32 × Archaic Token Giant Skill Crystal 1 × Giant Skill Crystal 12 125
Novice Archaic Token 64 × Archaic Token Helm of the Dextrous 1 × Helm of the Dextrous 2147483647 200
Novice Archaic Token 64 × Archaic Token Helm of the Dryad 1 × Helm of the Dryad 2147483647 200
Novice Archaic Token 64 × Archaic Token Helm of the Ritualist 1 × Helm of the Ritualist 2147483647 200
Novice Archaic Token 64 × Archaic Token Helm of the Trawler 1 × Helm of the Trawler 2147483647 200
Novice Archaic Token 64 × Archaic Token Helm of the Treasurer 1 × Helm of the Treasurer 2147483647 200
Novice Archaic Token 64 × Archaic Token Helm of the Warrior 1 × Helm of the Warrior 2147483647 200

Undead Herald

The base level-one pool supplies Energy, Spirit and Rage banners. Extra offers are selected by the Herald’s current dimension key, not by which dimension the player has visited before.

Undead Herald entry

Level Base input Output Max uses Merchant XP
Novice Silver Coin 4 × Silver Coin Energy Banner 1 × Energy Banner 729 20
Novice Silver Coin 4 × Silver Coin Spirit Banner 1 × Spirit Banner 729 20
Novice Silver Coin 4 × Silver Coin Rage Banner 1 × Rage Banner 729 20
All 22 built-in dimension-conditional banner definitions

These are retained predicate definitions. A dimension key and a banner resource do not establish a working realm, reachable portal or completed Enderloom port. Other mods can register additional Herald trades.

Dimension predicate Base input Output Max uses Merchant XP
aoa3:vox_ponds Silver Coin 4 × Silver Coin Vox Banner 1 × Vox Banner 729 20
aoa3:shyrelands Silver Coin 4 × Silver Coin Shyre Banner 1 × Shyre Banner 729 20
aoa3:runandor Silver Coin 4 × Silver Coin Runic Banner 1 × Runic Banner 729 20
aoa3:precasia Silver Coin 4 × Silver Coin Ancient Banner 1 × Ancient Banner 729 20
minecraft:overworld Silver Coin 4 × Silver Coin Void Banner 1 × Void Banner 729 20
minecraft:the_nether Silver Coin 4 × Silver Coin Nether Banner 1 × Nether Banner 729 20
aoa3:mysterium Silver Coin 4 × Silver Coin Fungal Banner 1 × Fungal Banner 729 20
aoa3:lunalus Silver Coin 4 × Silver Coin Lunar Banner 1 × Lunar Banner 729 20
aoa3:lelyetia Silver Coin 4 × Silver Coin Lelyetian Banner 1 × Lelyetian Banner 729 20
aoa3:lborean Silver Coin 4 × Silver Coin Boreic Banner 1 × Boreic Banner 729 20
aoa3:iromine Silver Coin 4 × Silver Coin Mecha Banner 1 × Mecha Banner 729 20
aoa3:haven Silver Coin 4 × Silver Coin Utopian Banner 1 × Utopian Banner 729 20
aoa3:greckon Silver Coin 4 × Silver Coin Haunted Banner 1 × Haunted Banner 729 20
aoa3:gardencia Silver Coin 4 × Silver Coin Rosidian Banner 1 × Rosidian Banner 729 20
aoa3:dustopia Silver Coin 4 × Silver Coin Dustopian Banner 1 × Dustopian Banner 729 20
aoa3:deeplands Silver Coin 4 × Silver Coin Deep Banner 1 × Deep Banner 729 20
aoa3:crystevia Silver Coin 4 × Silver Coin Crystal Banner 1 × Crystal Banner 729 20
aoa3:creeponia Silver Coin 4 × Silver Coin Creepy Banner 1 × Creepy Banner 729 20
aoa3:celeve Silver Coin 4 × Silver Coin Clown Banner 1 × Clown Banner 729 20
aoa3:candyland Silver Coin 4 × Silver Coin Candy Banner 1 × Candy Banner 729 20
aoa3:barathos Silver Coin 4 × Silver Coin Baron Banner 1 × Baron Banner 729 20
aoa3:abyss Silver Coin 4 × Silver Coin Shadow Banner 1 × Shadow Banner 729 20

Villager professions

AoA adds these candidates to villager profession pools. Their profession/job behavior is distinct from the custom AoA trader AI.

Cartographer

The novice map listing costs 4 Emeralds plus 1 Compass at its base definition. The Compass is added by the vanilla TreasureMapForEmeralds implementation, so it is easy to miss when looking only at AoA’s constructor call. The map factory searches for a matching structure and can fail to produce an offer if none is found. The map icon below is only a neutral item illustration, not a map of your world.

Level Base input Output Max uses Merchant XP
Novice Emerald 4 × Emerald + Compass 1 × Compass Map 1 × Ruined Teleporter Frame explorer map 3 7

Butcher

Level Base input Output Max uses Merchant XP
Expert Raw Charger Shank 5 × Raw Charger Shank Emerald 1 × Emerald 16 25

Cleric

These trades provide an alternative source of Ancient Rock, Runium Chunks and carved portal runes. Candidate selection and the villager’s profession level still matter.

Level Base input Output Max uses Merchant XP
Novice Copper Coin 1 × Copper Coin Ancient Rock 3 × Ancient Rock 16 1
Apprentice Copper Coin 5 × Copper Coin Runium Chunk 1 × Runium Chunk 8 9
Journeyman Copper Coin 20 × Copper Coin Carved Rune of Travel 1 × Carved Rune of Travel 4 20
Journeyman Copper Coin 20 × Copper Coin Carved Rune of Space 1 × Carved Rune of Space 4 20
Journeyman Copper Coin 20 × Copper Coin Carved Rune of Reality 1 × Carved Rune of Reality 4 20
Journeyman Copper Coin 20 × Copper Coin Carved Rune of Direction 1 × Carved Rune of Direction 4 20
Master Silver Coin 2 × Silver Coin Carved Rune of Power 1 × Carved Rune of Power 1 50

Assassin

The Assassin profession is bound to the Frame Bench POI in the source registration. Normal villager eligibility, job assignment and POI behavior still apply; this is not a guarantee that placing one block instantly changes every nearby villager. Frame Bench reference.

Level Base input Output Max uses Merchant XP
Novice Copper Coin 2 × Copper Coin Goo Ball 3 × Goo Ball 16 2
Novice Copper Coin 2 × Copper Coin Slice Star 2 × Slice Star 16 2
Apprentice Copper Coin 3 × Copper Coin Chakram 2 × Chakram 16 3
Apprentice Copper Coin 3 × Copper Coin Vulkram 2 × Vulkram 16 3
Journeyman Copper Coin 2 × Copper Coin Metal Slug 2 × Metal Slug 16 2
Journeyman Copper Coin 2 × Copper Coin Limonite Bullet 5 × Limonite Bullet 16 2
Expert Copper Coin 2 × Copper Coin Hellfire 1 × Hellfire 16 2

Why a Lottoman or Herald may not restock

The custom TraderRestockGoal requires all of the following before its start logic can attempt a restock:

  1. The trader is alive and is not currently trading.
  2. The inherited canRestock() and allowedToRestock() checks pass.
  3. The world finds no nearby alive player within the 24-block radius used by the goal.
  4. The start step still checks shouldRestock() before calling restock().

Practical troubleshooting: close the trade screen and step more than 24 blocks away; another nearby player may still prevent the goal from running. This is a necessary condition, not a fixed restock timer. The rule belongs to the custom AoA trader goal and should not be applied wholesale to ordinary Clerics, Butchers, Cartographers or Assassin-profession villagers.

Merchant XP versus player XP

The offer’s XP value contributes to merchant progression. For the custom AoA trader class, the player-orb calculation starts with 3–6, may add five on a level-up path, then divides by maxUses / 16f with integer assignment. For a 729-use Herald offer, those branches compute zero player-orb XP even though the offer has 20 merchant XP. This is a source calculation, not an in-game XP measurement; other hooks may change behavior.

The Corrupted Traveller uses a different screen

The Corrupted Traveller is not a normal MerchantOffer trader in this build. It opens its own menu when alive and interacted with without sneaking, after its Name Tag handling. Its food/book exchange is documented in the beginner walkthrough and released exchange evidence. Do not look for it in the ordinary coin-offer tables above.

Evidence and limits

The symbolic reader records literal trade-builder inputs and defaults without executing Java/game code. Registry field names are joined to the pinned source registrations. Default item-instance outputs are displayed as one; runtime replacements and component-sensitive overrides are not evaluated. The map’s secondary Compass input is checked against the official vanilla class and its one-item cost constructor.

No live trading, restocking, discount or save-persistence test is claimed. Static definitions should guide testing and restoration, not replace target-build validation.

Item/block artwork: Tslat and contributors; vanilla item references: Mojang. Pinned trader source · Villager trade registration.

⚠️ **GitHub.com Fallback** ⚠️