LlamaMarket Icon

Buying Runs & Purchase Decisions

LlamaMarket Guide

LlamaMarket features an automated shopping system that visits the market board, travels to other worlds in your Data Center, and purchases items you need for crafting, gearing, or reselling. Here's how a buying run works, how it picks listings, and why you might end up with more items than you requested.

Triggering a Buying Run

How a buying run starts depends on how you run LlamaMarket.

Direct execution via the "MB Buy" botbase

If you select and start the MB Buy botbase (or 骆驼市场买入物品 on Chinese clients) directly from RebornBuddy's botbase dropdown, the buying run is triggered immediately and unconditionally. It clears the price/inventory caches, moves straight to the travel loops, fulfills your purchase list, and stops as soon as it's done — ignoring background timers, wait times, and global checks.

Automated integration (Orderbot & Lisbeth hooks)

When LlamaMarket runs in the background as a hook inside other plugins or profiles (Orderbot tasks, Lisbeth crafting/gathering pipelines), it periodically runs a background check — ShouldBuyingRun() — to decide if it's time to shop. In this mode it only triggers a run if all of these are true:

  • Buying is enabled: the global Buy Items setting is on.
  • The timer has elapsed: time since the last run is ≥ the configured Wait Time (e.g. 60 minutes).
  • You have outstanding orders: it checks both your character-specific and Data Center-wide buy lists for any enabled item whose stock is below its requested Buy Amount.

How the bot counts your stock

When calculating how many of an item you already own, the bot counts your character's main inventory plus other storage based on your settings:

  • Include Saddlebags: if enabled, items in your Chocobo Saddlebag count toward the total.
  • Include Retainers: if enabled, items stored across all active retainers count toward the total.

If your total stock already meets or exceeds the Buy Amount, the order is marked complete and ignored.

The Cross-World Travel Loop

Once a buying run starts, LlamaMarket follows a travel schedule to find the best deals:

  1. Home world first: the bot opens the market board on your home world and searches for your items.
  2. Cross-world shopping: if items are still missing and travel isn't restricted, it queues up and visits every other world in your Data Center, one by one.
  3. Limsa Lominsa default: when traveling to another world, it teleports to Limsa Lominsa and walks to the market board near the main Aetheryte to search.
  4. Returning home: after visiting all worlds or buying everything requested, it automatically returns to your home world.

Travel restriction settings

  • Stay Home: if enabled, the bot never travels to other worlds and buys only from your home world's board.
  • Stay Home Start/End Hour: define a time window (24-hour clock, local system time) where cross-world travel is disabled. For example, Start 18 and End 22 keeps the bot home between 6:00 PM and 10:00 PM — handy for avoiding congested login queues during peak hours.

How LlamaMarket Selects Listings to Buy

When the bot opens the board for an item, it scans the active listings from cheapest to most expensive. A listing is valid and will be purchased if:

  • Price limit: the price per unit is at or below your configured Max Price.
  • Quality match: an HQ listing requires the HQ box checked; an NQ listing requires NQ checked. If both are checked, the bot buys whichever valid listing is cheapest.
  • Not your listing: the bot never buys listings posted by your own characters.
  • Crystal caps: when buying crystals, it skips any listing that would push your inventory past the game's hard cap of 9,999.
  • Class warnings: if you're buying gear your current class can't equip, the game shows a confirmation popup. LlamaMarket detects it and clicks "Yes" to proceed anyway.

Why LlamaMarket May "Over-Buy"

⚠ Important

LlamaMarket cannot purchase partial stacks. On the FFXIV market board you must buy a seller's entire stack — you cannot choose to buy only part of it.

Because the bot must buy entire stacks, it will purchase whatever listing is available as long as you still "need" the item — even if that stack contains more than your remaining target.

The over-buying scenario

  1. You set an item's Buy Amount to 100.
  2. You currently own 90. You only need 10 more.
  3. The cheapest valid listing under your Max Price is a stack of 50.
  4. Because your count (90) is below the target (100), the bot decides it still needs to buy.
  5. It purchases the stack of 50.
  6. Your new count is 140. The bot sees 140 > 100, marks the order complete, and stops.

How to avoid unwanted excess

If you're buying expensive items commonly sold in large stacks (ingredients, crafting sub-materials), you may spend more Gil than expected. To minimize it:

  • Set your Max Price carefully so the bot doesn't buy overpriced bulk stacks.
  • Set your Buy Amount slightly lower than what you actually need if you expect standard stack listings to push you over.