Skip to main content

Engagement Features

Tools that make bot auction activity feel dynamic, exciting, and worth paying attention to.

Flash Sales​

A flash sale is a randomly triggered event where bot listings for that run are generated at a discounted price for a shorter listing duration.

SettingDescription
engagement.flash-sale.chanceProbability (0–1) that a flash sale triggers during a generation run
engagement.flash-sale.discountDiscount percentage applied to all listing prices during the sale
engagement.flash-sale.durationHow long flash sale listings stay active (minutes) — shorter than normal
engagement.flash-sale.announceWhen true, a server-wide broadcast fires at the start of the flash sale

How It Works​

On each generation run, a random roll is made against flash-sale.chance. If it triggers:

  1. All listings for that run are priced with the discount applied
  2. Listing durations are set to the flash sale duration (shorter urgency window)
  3. If announce is true, all players receive a broadcast notification

Flash sales create urgency and encourage players to check the auction house regularly.

Any bot listing has a configurable chance of being marked as "featured" in the auction house GUI, making it stand out from regular listings.

SettingDescription
engagement.featured-chanceProbability (0–1) that any generated listing is marked featured

Featured listings appear with a visual distinction in the auction GUI, drawing player attention to specific bot items.

Rare Item Announcements​

When the bot generates a listing from a pool designated as "rare," a server-wide broadcast is sent to alert all players.

SettingDescription
engagement.announce-rareEnable/disable rare item announcements
engagement.rare-poolsList of pool names that trigger announcements (e.g. rare, enchanted)

This creates excitement and gives players a reason to check the auction house when rare items appear.

Named Market Events​

Market events are named, scheduled time windows that temporarily change how the bot behaves — increasing listing volume, adjusting prices, and optionally broadcasting an announcement.

SettingDescription
event-schedule.<name>.daysDays of the week the event runs (e.g. SATURDAY, SUNDAY)
event-schedule.<name>.startStart time in HH:MM format
event-schedule.<name>.endEnd time in HH:MM format
event-schedule.<name>.bonus-multiplierPrice multiplier applied to all listings during the event
event-schedule.<name>.extra-listingsAdditional listings generated per run during the event
event-schedule.<name>.announceBroadcast a server-wide message when the event begins

Example Events​

engagement:
  event-schedule:
    IronRush:
      days: [MONDAY, WEDNESDAY]
      start: "17:00"
      end: "19:00"
      bonus-multiplier: 1.3
      extra-listings: 5
      announce: true
    DiamondFrenzy:
      days: [SATURDAY, SUNDAY]
      start: "14:00"
      end: "20:00"
      bonus-multiplier: 1.5
      extra-listings: 10
      announce: true

Behavior During an Event​

  • The bonus-multiplier is applied on top of normal rarity and time-based pricing
  • extra-listings adds to the player-count-scaled listing count for each run during the event window
  • If announce is true, the broadcast fires once when the event window begins

Multiple events can be configured and can overlap. When two events overlap, their multipliers and extra listings stack.

Bot Identity​

The bot's name can be configured to match any persona the server chooses.

ModeSettingBehaviour
staticsystem-player-nameAll listings appear under one fixed player name
randomrandom-names listA name is randomly selected from the list for each generation run

In random mode, different generation runs can appear to come from different "traders," giving the auction house a more populated, player-like feel.

See Also​