Skip to content

Parameters for adding a request

Jump to bottom
theBowja edited this page Sep 3, 2022 · 50 revisions

This page describes the options you can add to refine your request. Once a popular snap that fits your criteria appears, it'll ping you in the channel you requested it in. /snaprequest is the command used for making a snap request.

The following are some examples you can learn from:
/snaprequest itemname:eye of dullahan refine:12
/snaprequest itemname:static shield enchant:tenacity enchantlevel:3,4
/snaprequestfor role assign:@archsnapping itemname:malang snow crab enchant:arch enchantlevel:4 alias:true
/snaprequest itemname:andre* card
/snaprequest itemname:monocle refine:3,4 broken:true enchant:none
/snaprequest itemname:rune boots refine:1-4 broken:true enchant:none slotted:false
/snaprequest itemname:boss card alias:true pricelower:100,000,000
/snaprequest itemname:delicious bamboo shoots

Everything is case-insensitive. The values for each option is whitespace-insensitive.

itemname

Exact string match. Asterisk * substitutes for ★. Punctuation like apostrophes don't matter. If the name does not exactly match the name from poring.world, then it will not find what you are looking for.

  • MVP Card matches for all regular MVP cards only.
  • Mini Card matches for all regular Mini cards only.
  • MVP★ Card matches for all starred MVP cards only.
  • Mini★ Card matches for all starred Mini cards only.
  • MVP/Mini Card matches for all regular MVP and Mini cards only.
  • MVP/Mini★ Card matches for all starred MVP and Mini cards only.
  • Undead Card, Dead Card, Revenant Card matches for all Revenant cards only.
  • Boss Card matches for all MVP, Mini, MVP★, Mini★, and Revenant Cards.
  • Ancient Tier 1, Ancient Tier 2, Ancient Tier 3, Ancient Tier 4, Ancient Tier 5, Ancient Voucher - please see this wiki page..

Default exclude behavior: matches any snap
Examples:
itemname:s t A u N c H R i N g :)
itemname:Anubis * card
itemname:Lernaean Hydra
itemname:Mini *card alias:true

enchant

Autocompleted string for one of following values: none, sharp, sharp blade, arch, zeal, morale, blasphemy, tenacity, divine blessing, armor breaking, anti mage, arcane, armor, magic, insight
Warning: sharp will not match against sharp blade
Default exclude behavior: matches both enchant and non-enchanted snaps
Example:
enchant:morale
enchant:sb -> enchant:sharp blade

enchantlevel

Comma-separated list of numbers or ranges between 0 and 4
Default exclude behavior: matches snaps at any enchant level
Examples:
enchantlevel:4
enchantlevel:3,4
enchantlevel:2-6 -> enchantlevel:2-4

refine

Comma-separated list of numbers or ranges between 0 and 15
Default exclude behavior: matches snaps at any refine level
Examples:
refine:15
refine:3,4
refine:10,11,12,13,14,15 -> refine:10-15
refine:4,5-8,7-11 -> refine:4-11

slotted

True or false.
Default exclude behavior: matches both slotted and non-slotted snaps
Example:
excluded: matches both slotted and non-slotted equipments
slotted:true matches only slotted equipments
slotted:false matches only non-slotted equipments

broken

True or false.
Default exclude behavior: matches both broken and non-broken snaps
Example:
broken:true broken:false

alias

Does not need a value provided.
Including this parameter will allow you to get pinged for snaps across equipment upgrades.
For example if you do -name Strength Ring -alias, then you'll also get pinged for Powerful Ring and Ring of Contract.
TODO: refine drop will also be accounted for you.
TODO: For example doing -name Rune Boots -refine 12 -alias will get you pings for +14 Rune Shoes.
You can check the list of aliases here. Make a github issue or message me in discord secretlyrice#5536 if a certain alias is not there.
Default exclude behavior: doesn't match you against aliased equipments
Example:
alias:true

category

Exact string match
One of the following:

  • Weapon, OffHand, Armor, Garment, Footgear, Accessory,
  • Head, Face, Mouth, Back, Tail,
  • Card Weapon, Card OffHand, Card Armor, Card Garment, Card Shoe, Card Accessory, Card Headwear,
  • Item Potion/Effect, Item Refine, Item Scroll/Album, Item Material, Item Holiday Material, Item Pet Material,
  • Card, Blueprint, Mount, Costume, Premium

Default exclude behavior: any category is matched
Examples:
category:accessory
category:headweartail

pricehigher

Enter an integer or a decimal number followed by an optional modifier\

  • t - multiplies the number by 1000
  • m - multiplies the number by 1000000
  • b - multiplies the number by 1000000000

Notifies when price matches this number or higher; commas will be automatically stripped
Default excluded behavior: matches a snap at any price
Examples:
pricehigher:1200000
pricehigher:1,200,000
pricehigher:1.2m

pricelower

Enter an integer or a decimal number followed by an optional modifier\

  • t - multiplies the number by 1000
  • m - multiplies the number by 1000000
  • b - multiplies the number by 1000000000

Notifies when price matches this number or lower; commas will be automatically stripped
Default behavior: matches a snap at any price
Examples:
pricelower:2440000
pricelower:2,440,000
pricelower:2.44m

stock

Notifies when number of stock matches this number or higher
Default behavior: 1
Example:
stock:2

buyer

DOES NOT WORK Notifies when number of buyers matches this number or higher; allows commas
Warning: the bot only checks buyers once when the snap first appears on poring.world. It will not check again later. I probably won't get around to fixing this anytime soon
default behavior: 0
Example:
-bu 100

assign

Tag a user or a role in discord and assign this request to them
Cannot assign to someone who's internal permission level is equal to or higher than yours
I recommend tagging roles over special mentions but in case you really need to... put 'everyone' and 'here' without the '@'
Default excluded behavior: request will be assigned to you
Examples:
assign:@Lovyrn
assign:@Arch-snapping-squad
assign:@everyone

Clone this wiki locally