Skip to main content

Discord bot

The bot has three slash commands: /check, /top and /offers. It registers them only on the server set in baseSettings.botGuild. It also sends your price alerts as direct messages.

Your home world​

Every command works from your home world. Your home world is part of your offer filter, which the bot and the web app share. Set it in one of these places:

  • in the web app, on the Settings page or in the filter of the Offers page,
  • with /offers filter world:<your world>.

Without a home world, /check shows no listings, /offers get shows "No match" and /top shows "No items match".

/check​

Shows the current listings of one item on every world of your home data center. The answer is only visible to you.

There is one subcommand per language of the item name:

SubcommandItem name in
/check deGerman
/check enEnglish
/check frFrench
/check jpJapanese
OptionRequiredMeaning
nameyesThe item name. It suggests names while you type.
hqnoTrue for high quality only, False for normal quality only. Leave it out for both.

For each world you see a table with price per unit, amount and total, and when the listings were last updated. The title links to the item on Universalis.

/top​

Lists the top items on your home world or your home data center, one item per page. Everyone in the channel sees the answer. Each page shows the item's market volume, interest, popularity, sales, views, minimum and average price, sold amounts and number of listings.

OptionMeaning
scopeWORLD (default) or DATACENTER.
orderWhat to sort by: SALES, MARKET_VOLUME (default), INTEREST, POPULARITY, MIN_PRICE or AVG_PRICE.
hqTrue for high quality only, False for normal quality only.
min_salesMinimum number of sales.
min_popularityMinimum popularity.
min_interestMinimum interest.
min_market_volumeMinimum market volume.
min_priceMinimum price.
min_avg_priceMinimum average price.

scope and order suggest their values while you type. Any other value gets a reply with the allowed ones. All options are optional.

/offers​

Finds items that are cheaper on another world than they sell for on your home world. /offers has two subcommands.

/offers filter​

Changes your saved offer filter and shows it. Every option is optional. Options you leave out keep their current value. The filter is the same one the web app uses.

OptionRangeDefaultMeaning
worldnoneYour home world. It suggests worlds while you type.
limit1 to 100001000How many offers to fetch.
unit_price1 or more1000Minimum price of a single unit.
factor1 or more2.0Minimum profit factor between buy price and sell price.
profit1 to 1000000100Minimum profit.
effective_profit1 to 100000010000Minimum effective profit.
popularity0 to 1000Minimum popularity.
refresh_hours1 to 1201Maximum age of a listing in hours.
market_volume0 to 1000Minimum market volume of the item on your world.
interest0 to 1000Minimum interest in the item on your world.
sales0 or more0Minimum number of sales in the last 7 days.
views0 or more0Minimum number of views in the last 7 days.
targetDATA_CENTERWhere to look for offers: DATA_CENTER or REGION.

The defaults apply until you change a value. You can reset the whole filter in the web app under Settings.

/offers get​

Shows the best offers for your saved filter, one item per page. The answer is only visible to you. Each page shows the item's statistics on your home world, a recommendation with how many to buy, what to sell for and the expected profit range, and a table per source world with price, amount, total, factor and profit.

Alert messages​

You create alert rules in the web app on the Alerts page. When a rule fires, the bot sends you a direct message. It has the item name in the title and one of these lines:

TriggerMessage
Price dropsCheapest listing on world dropped to price gil.
Price risesCheapest listing on world climbed to price gil.
Sales spikeSales on world in the last 24 h are at percent of the usual daily volume.
Listings dropOnly count listing(s) left on world.

The message also shows the threshold, the quality (high, normal or either) and the rule id. For a rule on a whole data center, world is the name of the data center.

tip

The bot can only send you a DM if your privacy settings allow direct messages from members of the server. Use the Test button on the Alerts page to check.