AI Merchant

Trade vanilla and mod items using natural-language requests, calculated barter offers, and negotiation without an external AI API.

AIMerchant

AIMerchant is an API-free barter trading mod for Minecraft Forge 1.20.1.

Describe the item you want in natural language, and AIMerchant will search through vanilla and installed mod items, calculate their value, and propose a suitable payment item and quantity. You can negotiate the offer or request a different payment item.

No OpenAI API key or external AI service is required.

Features

  • No API key or external service required
  • English and Korean natural-language item search
  • Supports vanilla and installed mod items
  • Accurate item identification through Forge Registry IDs
  • Recipe and rarity-based value calculation
  • Item-for-item barter trading
  • Player-specific negotiation history
  • Price negotiation and alternative payment offers
  • Displays how many payment items you currently own
  • Server-side validation of every trade
  • Inventory rollback if an exchange fails
  • Configurable cooldown, session timeout, and maximum quantities

How to Trade

  1. Craft an AIMerchant Caller.
  2. Hold it and right-click to open the trading screen.
  3. Describe the item and quantity you want.
  4. AIMerchant will propose a payment item and amount.
  5. Negotiate or request a different payment item if necessary.
  6. Review the offer and select Confirm Trade.

Example requests:

  • I want 2 diamond swords
  • Give me 3 netherite ingots
  • I need a diamond pickaxe
  • That is too expensive. Can you do better?
  • Suggest a different payment item

AIMerchant Caller

Each caller can start up to four trade sessions.

Reopening an active session does not consume another use.

Hiding and Reopening the Trading Screen

If the required payment items are stored in a chest, press Hide or ESC.

Move the items from the chest into your player inventory, then press G to reopen the existing trading screen. AIMerchant will recalculate the number of payment items you currently own.

The current offer, negotiation history, and entered text are preserved while the screen is hidden.

A trade session is automatically canceled after five minutes without a request, negotiation, reopening action, or confirmation.

Obtainability Checks

AIMerchant checks whether an item has a verified survival acquisition method, including:

  • Crafting and processing recipes
  • Mob loot
  • Chest loot
  • Block drops
  • Data pack loot tables
  • Loot tables added by installed mods

Items without a verified acquisition method cannot be offered.

Some modded items granted exclusively through Java events, without recipes or JSON loot tables, may not be detected.

Trade Safety

Every exchange is validated by the server.

  • Registry ID validation
  • Payment item and quantity checks
  • Reward inventory-space simulation
  • Obtainability revalidation
  • Unique offer ID validation
  • Inventory rollback on failure
  • Protection against duplicate or modified trade packets

AI Merchant Team

profile avatar
Owner
  • 1
    Projects
  • 10
    Downloads