Everything you can change, and how it looks

Options per server Manager

Every server has its own options. You pick them on the server setup page, which gives you a code, and apply them with /setup code:. Anything you do not change keeps its default.

/setup with no options shows the current settings and their code, so you can load it on the page and change it.

Language per server Manager

Every server picks its language: English or Português. It changes the names of the commands, the bot's messages and images, and the dictionary that checks the words. A new server starts in the language Discord has for it, and a manager changes it on the server setup page.

Command names

Switching language renames the server's commands and redraws the cards already posted, little by little. Words stay as they are.

Card style Manager

The /style command (or the setup page) changes all of the server's cards at once, the existing ones and the next ones. Votes stay as they are. There are four styles; the default is C.

Curse

n. · A wish that harm will come to someone.

8.4 · Blessed

▰▰▰▰▰▰▰▰▱▱ · 11 votes

12345 678910

How voting works in each

On images only one reaction per person counts: if you react with another number, the previous one goes away by itself. Whoever posted the word cannot vote; their reaction is removed.

How the card changes Code

The same card looks different depending on the votes. It is redrawn on every vote.

Labels and colours Code

The label only appears with 2 or more votes. With no votes the card is grey.

Colour is never the only signal: the rating is always also a number and a label. Portuguese servers see Sagrada, Abençoada, Mundana, Pecado, Heresia and Unânime.

How points are earned Code

Two rules. A word with fewer than 2 votes gives no points and does not enter the word rankings.

Titles and roles Manager

Six titles, worked out on the spot. Each has a role in the server, which the bot creates and passes to the new holder by itself. The role is named with just the emoji and grants no permissions. A manager can turn the roles off; the titles still exist.

The emojis show next to the name in /ranking and /profile. You can change a role's colour by hand in the server, but do not rename it: that is how the bot recognises it.

Rankings and profile Everyone

/ranking has a menu with four views of 10 places each: Points, Best words, Worst words and Judges.

Weekly recap Manager

It posts by itself once a week, by default on Sunday at 21:00 (Lisbon time), if there was activity in the last 7 days. The day, hour and time zone are chosen per server, and the recap can be turned off. If the bot is down at that hour, that week's recap is skipped. /recap posts it right away, by hand (Manager).

Word photos Manager

When a free photo exists for the word, it shows in the corner of the card. If not, the card has none. The photo arrives after the card, which is then redrawn.

Rules

• They come from Wikimedia (Portuguese Wikipedia and Commons).
• Only licences that allow use with credit: CC BY, CC BY-SA, CC0 and public domain.
• The file name must contain the whole word. Words under 4 letters get no photo.
• No sexual content, no photos of people, and a list of words that never get a photo.
• A manager can turn photos off for the server. When off, the word is also no longer sent to Wikimedia.
• /nophoto palavra (Owner) removes a word's photo and does not look again.

What counts as a word Code

The bot looks at each message in the game channel (when reading is on) and decides in this order. Anything that does not pass is just chat: nobody is told.

What the dictionary decides

For an English server, with the Wiktionary:

A word that is also a real noun or adjective counts even if it looks like a form: "cursed" and "running" do. Portuguese servers use the Priberam Dictionary, where missing accents are fixed by themselves and typos are suggested.

• Repeats: each word enters only once per server. Case, accents and hyphens are ignored, and singular and plural count as the same.
• Word already there: your message is deleted and a notice with a link to the original card shows for 12 seconds.
• Definition: the first sense in the dictionary (Wiktionary for English servers, Priberam for Portuguese ones), cut with "…" on images from 220 characters.

Commands and who can use them

The Manager commands show up for whoever has the Manage Server permission.

Example: /pending

Bot configuration Owner

Two values, in a .env file next to the bot. Each server's channel is no longer here: it is picked with /setup. After changing the file the bot must be restarted. The values below are invented.

# The bot's token. Never share it.
DISCORD_TOKEN=the_bot_token


# Who can /reset, /stats, /nophoto and delete any word.
OWNER_ID=123456789012345678

For the bot to read words typed in the channel (the read_channel option of /setup), turn on Message Content Intent in the Developer Portal, under Bot. Without it the bot works with /word and the menu.

Fixed values Code

These values are in the code. They change by editing the bot, not by command.

What /help shows