Easy Trades

Changes since 1.0.0

Version 2.0.0 is a major reliability and feature update for Easy Trades. It fixes the dedicated-server crash reported in 1.0.0 and expands the mod into a server-authoritative, configurable trade rerolling system.

Critical fixes

• Fixed the dedicated-server startup crash caused by loading the client-only Screen class on the server.
• Separated client-only UI and input code from common and server code.
• Added safe client/server networking instead of performing trade changes directly from the client.
• Added server-side validation for the active merchant menu, villager, player, and trading session.
• Added request rate limiting to prevent duplicate or spammed refresh requests.
• Made trade replacement transactional: the original offers and payment inventory are restored if applying the refresh fails.
• Reapplied vanilla special prices and Hero of the Village discounts after generating new offers.

Automatic rerolling

• Added automatic rerolling that stops when a selected target trade is found.
• Automatic rerolls are sent one request at a time and wait for the server result before continuing.
• Added client-side attempt and total-cost safety limits.
• Added server-side permission and maximum-attempt controls.
• Added optional per-attempt automatic cost increases and a maximum cost cap.
• Added clear feedback for success, cancellation, exhausted limits, insufficient payment, and target detection.

Trade targets and profiles

• Added a searchable target selection screen.
• Targets can be searched by display name, registry ID, mod namespace, item tag, or enchantment ID.
• Added four matching modes:
  • same item;
  • exact item components;
  • enchantment at or above the selected level;
  • exact enchantment level.
• Added multiple named target profiles with profile creation, selection, and deletion.
• Target profiles are saved atomically to config/easy_trades/target_profiles.nbt to reduce the risk of corrupted data.
• Existing 1.0.0 target data is migrated automatically.

Villager trade handling

• Refreshing now regenerates every currently unlocked villager trade tier when leveled-villager support is enabled.
• Added support for both vanilla trades and the experimental trade-rebalance tables.
• Added a server option to allow or reject villagers that have already gained levels or XP.
• Added an optional persistent per-villager daily refresh limit.
• Preserved the villager's level, XP, progress display, and restock state when synchronizing new offers.

Server economy and configuration

• Split client preferences and authoritative server rules into separate configuration files.
• Added free or paid refreshes.
• Added configurable payment items and item tags, with emeralds as the default.
• Added an optional creative-mode payment bypass.
• Added configurable manual and automatic refresh limits.
• Added server-controlled cooldown and speed multiplier settings.
• Reduced the default effective delay to one server tick, approximately 50 ms, for both manual and automatic rerolling.
• Added a one-time migration from the previous default speed multiplier of 3 to 9; custom multiplier values are preserved.

Interface and accessibility

• Added configurable button position and X/Y offsets.
• Added a dedicated settings screen.
• Added an optional sound when a selected target is found.
• Improved button tooltips, status messages, and screen narration.
• Added complete English and Japanese localization for the new features.

Quality and maintenance

• Added unit tests for refresh policies, rate limiting, economy rules, automatic sessions, daily quotas, protocol values, timing migration, and localization parity.
• Added NeoForge GameTests for real villager trade generation, leveled trades, discounts, target matching, payment tags, daily quotas, and server timing.
• Added automated GitHub Actions builds using Java 21.
• Verified startup on a NeoForge 21.1.218 dedicated server without loading client-only classes.

Requirements and upgrade notes

• Minecraft 1.21.1
• NeoForge 21.1.218 or newer in the 1.21.1 series
• Java 21
• Install Easy Trades on both the client and server for multiplayer use.
• Existing target data and the old default timing value are migrated automatically on first launch.