About

Revelio for Discord

Revelio is a free Discord app that looks up Harry Potter Trading Card Game cards from this archive. Type a command, pick a card, and it posts a small picture of the card, plus the set, rarity, artist and card text, with a link to the full page.

Add to my account →Add to a server →

What a reply looks like in Discord.

Adding it

Add to my account lets you use Revelio in any DM or server you're in, without asking anyone. In a server, the server needs to allow external apps for you.
Add to a server puts it in one server where you have the Manage Server permission, so everyone there can use it.
Discord asks you to approve it. It only asks for the right to add its slash commands. Then type / and pick Revelio.

Commands

/revelio: Look up a card. Start typing a name, pick the card from the list and send it. To search instead, type a search like lesson:potions AND rarity:rare and send it.
/image: Just the scan of one card, large, with nothing else. Start typing a name and pick the card. Only the picture comes back, with a button to the card on this site.
/random: One card at random, with your name on the reply.
/today: Today's Card of the Day, the same one as the home page.
/artist: Pick an illustrator to see their cards and a short bio.
/syntax: Every key and value you can use in a search, with examples.

Searching

Searches use RevelioQL, the same small language as the search box on this site. A search is key:value pieces joined with AND, OR and NOT. Type the whole search into /revelio and send it; there is nothing to pick from the list for a search. Quotes round the whole search are optional:

lesson:potions AND rarity:rare
set:base,qc type:spell NOT finish:foil
(lesson:charms OR lesson:potions) AND artist:"Jon Foster"
name:dragon OR subtype:unique
text:"draw 2" AND type:spell
flavor:dragon

A few rules that make longer searches work the way you mean:

AND binds tighter than OR, so a OR b AND c means a OR (b AND c). Use brackets to group the other way, and brackets can sit inside brackets.
NOT, ! and - all mean not, and work on a group too: -(type:spell OR type:item). && and || work for AND and OR, in any case.
Two terms side by side with nothing between them mean AND. A comma means or inside one key: set:base,qc, and a space after the comma or the colon is fine.
Put a value with spaces in quotes, double or single, straight or curly: set:"chamber of secrets". Words that look like operators inside quotes stay words.
Short names work: lesson:comc, type:spells. If a search finds nothing because of a key or value that doesn't exist, Revelio says which one, and what it can be.

A few rules that make longer searches work the way you mean:

AND binds tighter than OR, so a OR b AND c means a OR (b AND c). Use brackets to group the other way, and brackets can sit inside brackets.
NOT, ! and - all mean not, and work on a group too: -(type:spell OR type:item). && and || work for AND and OR, in any case.
Two terms side by side with nothing between them mean AND. A comma means or inside one key: set:base,qc, and a space after the comma or the colon is fine.
Put a value with spaces in quotes, double or single, straight or curly: set:"chamber of secrets". Words that look like operators inside quotes stay words.
Short names work: lesson:comc, type:spells. If a search finds nothing because of a key or value that doesn't exist, Revelio says which one, and what it can be.

text: looks inside a card's printed rules text and flavor: inside its flavor text. Both match any part of the text, so text:draw also finds "drawn". Put a phrase in its own quotes, as in the text: example. A search that finds more than one card lists twelve at a time, with Back and More buttons to move through the rest and a button that opens the full results on the site.

Run /syntax in Discord for the full list of keys and values, or read the RevelioQL guide.

Questions

The commands aren't showing up.: A new install can take a few minutes. Reload Discord (Ctrl+R on a computer, or close and reopen the app on a phone) and type / again. Pick Revelio from the list on the left, because other apps can have commands with the same names. If you added it to your account rather than a server, the server has to allow external apps for you.
What can it see?: Only the commands you run and what you type into them. It can't read messages or see who is in a server, and it doesn't store anything about you or your server.
Is there a limit?: Each person gets three commands every ten seconds and ten a minute, and a server gets sixty a minute between everyone in it. Go past that and it replies with a note to slow down. Commands sent while you're blocked still count, so stop for a few seconds and it works again.
Is it official?: No. It's a fan project and isn't connected to Wizards of the Coast or Warner Bros. The card art belongs to its owners, the same as on the rest of this site.

Something not working? Get in touch.