LlamaMarket Icon

Selling Runs & Decision Making

LlamaMarket Guide

To behave like a real human player, LlamaMarket doesn't constantly click the summoning bell. Instead it runs a background check — ShouldSellingRun() — to decide whether it is actually worth visiting your retainers.

The Decision Workflow

The chart below shows the exact logic LlamaMarket follows. Each check is evaluated in order — a Trigger Run or Stay Idle outcome ends the evaluation; otherwise it falls through to the next check.

Check: Should Selling Run?
1. Are the game offsets OK?
No Abort & log an error
Yes Continue to the next check ↓
2. Is Refresh Ventures enabled, a venture finished, and you have venture tokens?
Yes Trigger Run  —  venture resend needed
No Continue to the next check ↓
3. Is the internal cache empty and are retainers selling items?
Yes Trigger Run  —  cache initialization
No Continue to the next check ↓
4. Has the Wait Time elapsed?
No Stay Idle  —  keep waiting
Yes Continue to the next check ↓
5. Is Min Old Prices OR Min Free Slots set to 0?
Yes Trigger Run  —  elapsed wait time
No Simulate pricing for all active listings ↓
6. Does the count of mispriced items exceed Min Old Prices to Update?
Yes Trigger Run  —  price adjustment needed
No Continue to the next check ↓
7. Do empty listing slots exceed Min Free Slots to Update AND are there items ready to post?
Yes Trigger Run  —  new item posting
No Stay Idle  —  not enough changes needed
Trigger Run Stay Idle Abort / Error Yes path

How Settings Affect the Decision

Each setting in the LlamaMarket configuration panel plays a specific role in deciding when the bot runs. Adjust these to make the bot more aggressive (checking prices constantly) or more conservative (visiting retainers less often to look more human).

Wait Time SellingTimeWait

Category: Timing  •  Default: 60.0 minutes

The primary gatekeeper. It sets the minimum time that must pass between selling runs before the bot is allowed to look at prices or post new items.

  • Set to 0: time-based checks are disabled entirely — the bot only visits retainers when ventures need refreshing.
  • Set to 30: the bot waits at least 30 minutes since its last run before running price checks.

Refresh Ventures DoVentures

Category: Retainer Tasks  •  Default: True

Tells the bot to automatically manage and resend your retainers on ventures.

This check bypasses the Wait Time timer. If a venture is finished and you have at least 2 venture tokens in your inventory, the bot immediately starts a run to renew it — even if the Wait Time has not elapsed.

Minimum Old Prices to Update MinOldPricesToUpdate

Category: Selling Items  •  Default: 0

The threshold for how many of your items must be undercut or mispriced before it's worth visiting the summoning bell to fix them.

  • 0: the bot skips the price-check simulation and runs a retainer check as soon as the Wait Time expires.
  • Higher (e.g. 5): once Wait Time expires, the bot simulates current listings against your selected deciders, counts how many are priced incorrectly, and only summons retainers if more than 5 need adjusting — saving you a trip just to change one item's price by 1 Gil.

Minimum Retainer Slots to Update MinFreeSlotsToUpdate

Category: Selling Items  •  Default: 0

The threshold for how many open market slots you must have across your retainers before the bot visits them to post new items.

  • 0: the bot runs a retainer visit to list items as soon as the Wait Time expires.
  • Higher (e.g. 3): the bot counts empty selling slots across all retainers. If empty slots exceed this setting and you have items configured for sale in your bags, it triggers a run. Empty slots with nothing to sell — or lots to sell but only 1 empty slot — keep it idle.