Banner Image

Commands

Locale

language set
$language set <locale>

<locale> - The locale code of the language you want to use; full list can be found in $language

Changes the language the bot replies for you.

language
$[locale|lang|language] 

View all available languages' locale codes. You can check if your language is available by comparing against this list

Some of these languages, like xtreme-owo or unplayable are no real languages but serve as a way to spice up the english text.
If something is not yet translated, the english original text is used.

Gambling

bet
$bet [maximum=6] [tip=6] [money=0]
Checks: has_character

[maximum] - The amount of sides the dice will have, must be greater than 1; defaults to 6
[tip] - The number to bet on, must be greater than 0 and lower than, or equal to [maximum]; defaults to 6
[money] - The amount of money to bet, must be between 0 and 100,000; defaults to 0

Bet on the outcome of an n-sided dice.

You will win [maximum - 1] * [money] money if you are right and lose [money] if you are wrong.
For example:
$bet 10 4 100
- Rolls a 10 sided dice
- If the dice lands on 4, you will receive $900
- If the dice lands on any other number, you will lose $100

(This command has a cooldown of 5 seconds.)

blackjack
$[bj|blackjack] [amount=0]
Checks: has_character

[amount] - The amount of money you bet, must be between 0 and 1000; defaults to 0

Play a round of blackjack against the bot, controlled by reactions.
The objective is to have a card value as close to 21 as possible, without exceeding it (known as bust).
Having a card value of exactly 21 is known as a blackjack.

⤴ Hit: Pick up another card
⤵ Stand: stay at your current card value
↔ Split (if dealt two cards with the same value): Split your two cards into separate hands
🔁 Switch (if split): Change the focussed hand
⏬ Double down: double the amount you bet in exchange for only one more card

If a player wins, they will get the amount in cash. If they lose, they will lose that amount.
If they win with a natural blackjack (first two dealt card get to a value of 21), the player wins 1.5 times the amount.

(This command has a cooldown of 5 seconds.)

roulette table
$roulette table 

Sends a picture of a French Roulette table.

flip
$[coin|flip] [side=heads] [amount=0]
Checks: has_character

[side] - The coin side to bet on, can be heads or tails; defaults to heads
[amount] - A whole number from 1 to 100,000; defaults to 0

Bet money on a coinflip.

If the coin lands on the side you bet on, you will receive the amount in cash. If it's the other side, you lose that amount.
(This command has a cooldown of 5 seconds.)

roulette
$[rou|roulette] <money> <bid>
Checks: has_character

<money> - A whole number from 0 to 100
<bid> - What to bid on, see below for details

Play a game of French Roulette.

Possible simple bets:
- noir (all black numbers) (1:1 payout)
- rouge (all red numbers) (1:1 payout)
- pair (all even numbers) (1:1 payout)
- impair (all odd numbers) (1:1 payout)
- manque (1-18) (1:1 payout)
- passe (19-36) (1:1 payout)
- premier (1-12) (2:1 payout)
- milieu (13-24) (2:1 payout)
- dernier (25-36) (2:1 payout)

Complicated bets:
- colonne (34/35/36) (all numbers in a row on the betting table, either 1, 4, ..., 34 or 2, 5, ..., 35 or 3, 6, ... 36) (2:1 payout)
- transversale (vertical low)-(vertical high) This includes simple and pleine (a vertical row on the betting table, e.g. 19-21. can also be two rows, e.g. 4-9) (11:1 payout for pleine, 5:1 for simple)
- les trois premiers (numbers 0, 1, 2) (11:1 payout)
- carre (low)-(high) (a section of four numbers in a square on the betting table, e.g. 23-27) (8:1 payout)
- les quatre premiers (numbers 0, 1, 2, 3) (8:1 payout)
- cheval (number 1) (number 2) (a simple bet on two numbers) (17:1 payout)
- plein (number) (a simple bet on one number) (35:1 payout)

To visualize the rows and columns, use the command: roulette table

This command is in an alpha-stage, which means bugs are likely to happen. Play at your own risk.
(This command has a cooldown of 15 seconds.)

dos
$[doubleorsteal|dos] [user]
Checks: has_character

[user] - A discord user with a character; defaults to anyone

Play a round of double-or-steal against a player.

Each round, a player can double the bet played for, or steal, removing the bet from the other player and giving it to the first.

draw
$[card|draw] [enemy] [money=0]

[enemy] - A user who has a profile; defaults to None
[money] - The bet money. A whole number that can be 0 or greater; defaults to 0

Draws a random card from the 52 French playing cards. Playing Draw with someone for money is also available if the enemy is mentioned. The player with higher value of the drawn cards will win the bet money.

This command has no effect on your balance if done with no enemy mentioned.
(This command has a cooldown of 15 seconds.)

Adventure

cancel
$cancel 
Checks: has_adventure, has_character

Cancels your ongoing adventure and allows you to start a new one right away. You will not receive any rewards if you cancel your adventure.

deaths
$deaths 
Checks: has_character

Shows your overall adventure death and completed count, including your success rate.

status
$[s|status] 
Checks: has_adventure, has_character

Checks the remaining time of your adventures, or if you survived or died. Your chance is checked here, not in $adventure.
Your chances are determined by your equipped items, race and class bonuses, your level, God-given luck and active luck boosters.

If you are in an alliance which owns a city with an adventure building, your chance will be increased by 1% per building level.

If you survive on your adventure, you will receive gold up to the adventure number times 60, XP up to 500 times the adventure number and either a loot or gear item.
The chance of loot is dependent on the adventure number and whether you use the Ritualist class, check our wiki for the exact chances.

God given luck affects the amount of gold and the gear items' damage/defense and value.

If you are in a guild, its guild bank will receive 10% of the amount of gold extra.
If you are married, your partner will receive a portion of your gold extra as well, check the wiki for the exact portion.

adventure
$[mission|a|adventure] <adventure_number>
Checks: has_no_adventure, has_character

<adventure_number> - a whole number from 1 to 30

Send your character on an adventure with the difficulty <adventure_number>.
The adventure will take <adventure_number> hours if no time booster is used, and half as long if a time booster is used.

If you are in an alliance which owns a city with adventure buildings, your adventure time will be reduced by the adventure building level in %.
Donators' time will also be reduced:
- 5% reduction for Silver Donators
- 10% reduction for Gold Donators
- 25% reduction for Emerald Donators and above

Be sure to check $status to check how much time is left, or to check if you survived or died.

adventures
$[missions|dungeons|adventures] 
Checks: has_character

Shows all adventures, their names, descriptions, and your chances to beat them in picture form.
Your chances are determined by your equipped items, race and class bonuses, your level and your God-given luck.

activeadventure
$[aa|activeadventure] 
Checks: cooldown, has_no_adventure, has_character

Active adventures will put you into a 15x15 randomly generated maze. You will begin in the top left corner (0,0) and your goal is to find the exit in the bottom right corner (14,14)
You control your character with the arrow reactions below the message.

You have 1000HP. The adventure ends when you find the exit or your HP drop to zero.
You can lose HP by getting damaged by traps or enemies.

The maze contains safe spaces and treasures but also traps and enemies.
Each space has a 10% chance of being a trap. If a space does not have a trap, it has a 10% chance of having an enemy.
Each maze has 5 treasure chests.

Traps can damage you from 30 to 120 HP.
Enemy damage is based on your own damage. During enemy fights, you can attack (⚔️), defend (🛡️) or recover HP (❤️)
Treasure chests can have gold up to 25 times your attack + defense.

If you reach the end, you will receive a special treasure with gold up to 100 times your attack + defense.

(It is recommended to draw a map of the maze)
(This command has a cooldown of 30 minutes)

Ranks

lovers
$lovers 

The top 10 lovers sorted by their spouse's lovescore.

pvpstats
$[pvp|battles|pvpstats] 

Shows you the top 10 players by the amount of wins in PvP matches.

richest
$richest 

The 10 most richest players in IdleRPG.

highscore
$[best|high|top|highscore] 

Shows you the top 10 players by XP and displays the corresponding level.

Trading

sell
$sell <itemid> <price>
Checks: has_character

<itemid> - The ID of the item to sell
<price> - The price to sell the item for, can be 0 or above

Puts your item into the market. Tax for selling items is 5% of the price.

You may not sell modified items, items with a price lower than their value, or items below 4 stat.
If you are in an alliance with owns a city with a trade building, you do not have to pay the tax.

Please note that you won't get the money right away, another player has to buy the item first.
With that being said, please choose a reasonable price.

If your item has not been bought for 14 days, it will be removed from the market and put back into your inventory.

shop
$[market|m|shop] [itemtype=All] [minstat=0.0] [highestprice=1000000]
Checks: has_character

[itemtype] - The type of item to filter; defaults to all item types
[minstat] - The minimum damage/defense an item has to have to show up; defaults to 0
[highestprice] - The highest price an item can have to show up; defaults to $1,000,000

Lists the buyable items on the market. You can cleverly filter out items you don't want to see with these parameters.

To quickly buy an item, you can use the 💰 emoji.

remove
$remove <itemid>
Checks: has_character

<itemid> - The item to remove from the shop

Takes an item off the shop. You may only remove your own items from the shop.

You can check your items on the shop with $pending. Paid tax money will not be returned.

trader
$trader 
Checks: cooldown, has_character

Buys items at the trader. These items can range from 1 stat to 15 stat, with their price being 50 times their stat.
Useful for the early game.

(This command has a cooldown of 1 hour.)

merchall
$merchall [maxstat=100] [minstat=0]
Checks: cooldown, has_character

[maxstat] - The highest damage/defense to include; defaults to 100
[minstat] - The lowest damage/defense to include; defaults to 0

Sells all your non-equipped items for their value. A convenient way to sell a large amount of items at once.
If you are in an alliance which owns a trade building, your earnings will be increased by 50% for each level.

(This command has a cooldown of 30 minutes.)

pending
$pending 

View your pending shop offers. This is a convenient way to find IDs of items that you put on the market.

shophistory
$[mh|markethistory|shophistory] [itemtype=All] [minstat=0.0] [after_date=2018-03-17]

[itemtype] - The type of item to filter; defaults to all item types
[minstat] - The minimum damage/defense an item has to have to show up; defaults to 0
[after_date] - Show sales only after this date, defaults to bot creation date, which means all

Lists the past successful sales on the market by criteria and shows average, minimum and highest prices by category.

merchant
$[merch|merchant] [itemids...]
Checks: cooldown, has_character

<itemids> - The IDs of the items to sell, seperated by space

Sells items for their value. Items that you don't own will be filtered out.

If you are in an alliance which owns a trade building, your winnings will be multiplied by 1.5 for each level.

(This command has a cooldown of 10 minutes.)

buy
$buy <itemid>
Checks: has_character

<itemid> - The ID of the item to buy

Buy an item from the global market. Tax for buying is 5%.

Buying your own items is impossible. You can find the item's ID in $shop.

offer
$offer <itemid> <price> <user>
Checks: cooldown, has_character

<itemid> - The ID of the item to offer
<price> - The price the other has to pay, can be a number from 0 to 100,000,000
<user> - The user to offer the item to

Offer an item to a specific user. You may not offer modified items.
Once the other user accepts, the item belongs to them.

Miscellaneous

choose
$choose [results...]

<results...> - The options to choose from

Chooses a random option of supplied possiblies. For an option with multiple words, put it in "double quotes".

garfield
$garfield [date=2020-12-15]

[date] - The date on which the comic strip was released, see below for more info

Sends today's garfield comic if no date info is given.
Otherwise, the format is YYYY MM DD or DD MM YYYY, depending on where the year is, with the date parts being seperated with spaces.
For example: 2013 12 25 is the same as 25 12 2013, both meaning December 25th 2013.

invite
$invite 

Invite the bot to your server.

Use this backup link in case the above does not work.

idlewiki
$[wiki|idlewiki] [query]

[query] - The idlewiki query to search for

Searches Idle's wiki for an entry.

dog
$[woof|dog] 

Sends cute dog pics from The Dog API.

cat
$[meow|cat] 

Sends cute cat pics from The Cat API.

web
$[pages|about|web] 

About the bot and our websites.

meme
$meme 

Sends a random meme from Some Random API.

userfriendly
$[uf|userfriendly] [date=2020-12-15]

[date] - The date on which the comic strip was released, see below for more info

Sends today's userfriendly comic if no date info is given.
Otherwise, the format is YYYY MM DD or DD MM YYYY, depending on where the year is, with the date parts being seperated with spaces.
For example: 2013 12 25 is the same as 25 12 2013, both meaning December 25th 2013.

fancy
$fancy <text>

<text> - The text to enlarge

Replaces text and numbers with emoji.

imgur
$[shorten|imgur] [given_url]

[given_url] - The URL to shorten; if not given, this command will look for image attachments

Get a short URL from a long one or an image attachment.

If both a URL and an attachment is given, the attachment is preferred. GIFs are not supported, only JPG and PNG.
In case this command fails, you can manually upload your image to Imgur.

guess
$guess 
Checks: guild_only

Guess a user by their avatar and discriminator (the four numbers after the # in a discord tag).

Both their tag and nickname are accepted as answers. You have 20 seconds to guess.

(This command has a channel cooldown of 20 seconds.)

source
$[license|source] 

Shows our GitLab page and license.
If you want to contribute, feel free to create an account and submit issues and merge requests.

clear
$clear <num> [target]
Checks: has_permissions

<num> - A whole number from 1 to 1000
[target] - The user whose messages to delete; defaults to everyone

Deletes an amount of messages in the channel, optionally only by one member.
If no target is given, all messages are cleared.

Note that this will scan <num> messages and will only delete them, if they are from the target, if one is given.
If the target sent 30 messages, other people sent 70 messages and you cleared 100 messages by the target, only those 30 will be deleted.

Only users with the Manage Messages permission can use this command.

ping
$ping 

Shows you the bot's current websocket latency in milliseconds.

dab
$dab 

Let's dab together.

support
$support 

Sends you the link to join the official IdleRPG Support server.

Use this backup link in case the above does not work.

randomname
$randomname 

Sends you my nickname from a random server.

⚠ Caution: may contain NSFW.

uptime
$uptime 

Shows how long the bot has been connected to Discord.

cookie
$cookie <user>
Checks: guild_only

<user> - the discord user to give the cookie to

Gives a cookie to a user. Sadly, this cookie does not have an effect on gameplay.

changelog
$changelog 

Shows you the bots current version along with its major updates.

chucknorris
$[chuck|cn|norris|theman|chucknorris] 

Sends a random Chuck Norris joke fact from The Chuck Norris API

partners
$partners 

Awesome bots by other coffee-drinking individuals.

ice
$[ice-cream|ice] <other>
Checks: guild_only

<other> - the discord user to give the icecream to

Gives icecream to a user. Sadly, this ice does not have an effect on gameplay.

stats
$stats 

Show some stats about the bot, ranging from hard- and software statistics, over performance to ingame stats.

patreon
$[donate|patreon] 

View the Patreon page of the bot. The different tiers will grant different rewards.
View $help module Patreon to find the different commands.

Thank you for supporting IdleRPG!

dice
$dice <dice_type>

<dice_type> - The dice to roll, uses the ndx format

Rolls n dice with x sides (3d20 rolls 3 20-sided dice).

yesno
$[yn|yesno] <question>

<question> - The question to answer

An alternative to $8ball with some more blunt answers.

love
$love <first> <second>
Checks: guild_only

<first> - A discord User
<second> - Also a discord User

Calculates the love between two people. Don't be disappointed when the result is low, you'll find your Romeo/Juliet someday.

rules
$rules 

Shows the rules you consent to when creating a character. Don't forget them!

talk
$[cb|chat|talk] <text>

<text> - The text to say, must be between 3 and 60 characters.

Talk to me! This uses a chatbot AI backend.

8ball
$8ball <question>

Provides a variety of answers to all of your questions. If in doubt, ask the magic 8ball.

roll
$roll <maximum>

<maximum> - A whole number greater than 0

Roll a dice with <maximum> sides and let the bot display the outcome.

daily
$daily 
Checks: cooldown, has_character

Get your daily reward. Depending on your streak, you will gain better rewards.

After ten days, your rewards will reset. Day 11 and day 1 have the same rewards.
The rewards will either be money (2/3 chance) or crates (1/3 chance).

The possible rewards are:

Day 1
$50 or 1-6 common crates

Day 2
$100 or 1-5 common crates

Day 3
$200 or 1-4 common (99%) or uncommon (1%) crates

Day 4
$400 or 1-4 common (99%) or uncommon (1%) crates

Day 5
$800 or 1-4 common (99%) or uncommon (1%) crates

Day 6
$1,600 or 1-3 common (80%), uncommon (19%) or rare (1%) crates

Day 7
$3,200 or 1-2 uncommon (80%), rare (19%) or magic (1%) crates

Day 8
$6,400 or 1-2 uncommon (80%), rare (19%) or magic (1%) crates

Day 9
$12,800 or 1-2 uncommon (80%), rare (19%) or magic (1%) crates

Day 10
$25,600 or 1 rare (80%), magic (19%) or legendary (1%) crate

If you don't use this command up to 48 hours after the first use, you will lose your streak.

(This command has a cooldown until 12am UTC.)

streak
$streak 
Checks: has_character

Want to flex your streak on someone or just check how many days in a row you've claimed your daily reward? This command is for you

wikipedia
$wikipedia <query>

<query> - The wikipedia query to search for

Searches Wikipedia for an entry.

echo
$[say|echo] <phrase>

<phrase> - The text to repeat

Repeats what you said. This will delete the command message if possible.

Server

settings reset
$settings reset 
Checks: has_permissions

Resets the server settings.

prefix
$prefix 
Checks: guild_only

View the bot prefix for the server

settings prefix
$settings prefix <prefix>
Checks: has_permissions

<prefix> - The new prefix to use. Use "" quotes to surround it if you want multiple words or trailing spaces.

Change the bot prefix, it cannot exceed 10 characters.

Only users with the Manage Server permission can use this command.

settings
$settings 
Checks: guild_only

Change the server settings for the bot.

serverinfo
$[server|serverinfo] 
Checks: guild_only

Shows information about your server, from its region and membercount to its creation date and roles.

avatar
$avatar [target=Author]

<target> - The user whose avatar to show; defaults to oneself

Shows someone's avatar, also known as their icon or profile picture.

Profile

create
$[new|c|start|create] [name]
Checks: cooldown, has_no_char

[name] - The name to give your character; will be interactive if not given

Create a new character and start playing IdleRPG.

By creating a character, you agree to the bot rules.
No idea where to go from here? Check out our tutorial.
If you still have questions afterward, feel free to ask us on the official support server.

(This command has a cooldown of 1 hour.)

profile2
$[p2|pp|profile2] [target=Author]

[target] - The person whose profile to view

View someone's profile. This will send an embed rather than an image and is usually faster.

colour
$[color|colour] <colour>
Checks: has_character

<color> - The color to use, see below for allowed format

Sets your profile text colour. The format may be #RGB, #RRGGBB, CSS3 defaults like "cyan", a rgb(r, g, b) tuple or a rgba(r, g, b, a) tuple

A tuple is a data type consisting of multiple parts. To make a tuple for this command, seperate your values with a comma, and surround them with parantheses.
Here is an example of a tuple with four values: (128,256,0,0.5)

This will change the text color in $profile and the embed color in $profile2.

exchange
$[ex|exchange] [loot_ids...]
Checks: cooldown, has_character

[loot_ids...] - The loot IDs to exchange; defaults to all loot

Exchange your loot for money or XP, the bot will let you choose.

If you choose money, you will get the loots' combined value in cash. For XP, you will get 1/4th of the combined value in XP.

rename
$rename [name]
Checks: has_character

[name] - The name to use; if not given, this will be interactive

Renames your character. The name must be from 3 to 20 characters long.

items
$[loot|items] 
Checks: has_character

Show your loot items.

Loot items can be exchanged for money or XP, or sacrificed to your God to gain favor points.

You can gain loot items by completing adventures. The higher the difficulty, the higher the chance to get loot.
If you are a Ritualist, your loot chances are doubled. Check our wiki for the exact chances.

equip
$[use|equip] <itemid>
Checks: has_character, cooldown

<itemid> - The ID of the item to equip

Equip an item by its ID, you can find the item IDs in your inventory.

Each item has an assigned hand slot,
"any" meaning that the item can go in either hand,
"both" meaning it takes both hands,
"left" and "right" should be clear.

You cannot equip two items that use the same hand, or a second item if the one your have equipped is two-handed.

luck
$luck 
Checks: has_character

Shows your current luck value.

Luck updates once a week for everyone, usually on Monday. It depends on your God.
Luck influences your adventure survival chances as well as the rewards.

Luck is decided randomly within the Gods' luck boundaries. You can find your God's boundaries here.

If you have enough favor to place in the top 25 followers, you will gain additional luck:
- The top 25 to 21 will gain +0.1 luck
- The top 20 to 16 will gain +0.2 luck
- The top 15 to 11 will gain +0.3 luck
- The top 10 to 6 will gain +0.4 luck
- The top 5 to 1 will gain +0.5 luck

If you follow a new God (or become Godless), your luck will not update instantly, it will update with everyone else's luck on Monday.

unequip
$unequip <itemid>
Checks: has_character

<itemid> - The ID of the item to unequip

Unequip one of your equipped items. This has no benefit whatsoever.

give
$give <money> <other>
Checks: has_character

<money> - The amount of money to give to the other person, cannot exceed 100,000,000
[other] - The person to give the money to

Gift money! It will be removed from you and added to the other person.

economy
$[money|e|balance|bal|economy] 
Checks: has_character

Shows the amount of money you currently have.

Among other ways, you can get more money by:
- Playing adventures
- Selling unused equipment
- Gambling

upgradeweapon
$[upgrade|upgradeweapon] <itemid>
Checks: cooldown, has_character

<itemid> - The ID of the item to upgrade

Upgrades an item's stat by 1.
The price to upgrade an item is 250 times its current stat. For example, upgrading a 15 damage sword will cost $3,750.

One handed weapons can be upgraded up to 41, two handed items up to 82.

(This command has a cooldown of 1 hour.)

merge
$merge <firstitemid> <seconditemid>
Checks: cooldown, has_character

<firstitemid> - The ID of the first item
<seconditemid> - The ID of the second item

Merges two items to a better one.

⚠ The first item will be upgraded by +1, the second item will be destroyed.

The two items must be of the same item type and within a 5 stat range of each other.
For example, if the first item is a 23 damage Scythe, the second item must be a Scythe with damage 18 to 28.

One handed weapons can be merged up to 41, two handed items up to 82

(This command has a cooldown of 1 hour.)

delete
$[rm|del|delete] 
Checks: has_character

Deletes your character. There is no way to get your character data back after deletion.

Deleting your character also removes:
- Your guild if you own one
- Your alliance's city ownership
- Your marriage and children

xp
$xp [user=Author]
Checks: has_character

[user] - The player whose XP and level to show; defaults to oneself

Show a player's XP and level.

You can gain more XP by:
- Completing adventures
- Exchanging loot items for XP

profile
$[me|p|profile] [person=Author]

[person] - The person whose profile to view; defaults to oneself

View someone's profile. This will send an image.
For an explanation what all the fields mean, see this picture

inventory
$[inv|i|inventory] [itemtype=All] [lowest=0] [highest=101]
Checks: has_character

[itemtype] - The type of item to show; defaults to all items
[lowest] - The lower boundary of items to show; defaults to 0
[highest] - The upper boundary of items to show; defaults to 101

Show your gear items. Items that are in the market will not be shown.

Gear items can be equipped, sold and given away, or upgraded and merged to make them stronger.
You can gain gear items by completing adventures, opening crates, or having your pet hunt for them, if you are a ranger.

To sell unused items for their value, use $merch. To put them up on the global player market, use $sell.

Battles

activebattle
$activebattle [money=0] [enemy]
Checks: cooldown, has_character

[money] - A whole number that can be 0 or greater; defaults to 0
[enemy] - A user who has a profile; defaults to anyone

Fight against another player while betting money.
To decide players' stats, their items, race and class bonuses are evaluated.

The money is removed from both players at the start of the battle. Once a winner has been decided, they will receive their money, plus the enemy's money.
The battle takes place in rounds. Each round, both players have to choose their move using the reactions.
Players can attack (⚔️), defend (🛡️) or recover HP (❤️).

The battle ends if one player's HP drops to 0 (winner decided), or a player does not move (forfeit).
In case of a forfeit, neither of the players will get their money back.

The battle's winner will receive a PvP win, which shows on their profile.
(This command has a cooldown of 10 minutes.)

raidbattle
$raidbattle [money=0] [enemy]
Checks: cooldown, has_character

[money] - A whole number that can be 0 or greater; defaults to 0
[enemy] - A user who has a profile; defaults to anyone

Fight against another player while betting money.
To decide the players' stats, their items, race and class bonuses and raidstats are evaluated.

The money is removed from both players at the start of the battle. Once a winner has been decided, they will receive their money, plus the enemy's money.
The battle is divided into rounds, in which a player attacks. The first round's attacker is chosen randomly, all other rounds the attacker is the last round's defender.

The battle ends if one player's HP drops to 0 (winner decided), or if 5 minutes after the battle started pass (tie).
In case of a tie, both players will get their money back.

The battle's winner will receive a PvP win, which shows on their profile.
(This command has a cooldown of 5 minutes)

battle
$battle [money=0] [enemy]
Checks: cooldown, has_character

[money] - A whole number that can be 0 or greater; defaults to 0
[enemy] - A user who has a profile; defaults to anyone

Fight against another player while betting money.
To decide the fight, the players' items, race and class bonuses and an additional number from 1 to 7 are evaluated, this serves as a way to give players with lower stats a chance at winning.

The money is removed from both players at the start of the battle. Once a winner has been decided, they will receive their money, plus the enemy's money.
The battle lasts 30 seconds, after which the winner and loser will be mentioned.

If both players' stats + random number are the same, the winner is decided at random.
The battle's winner will receive a PvP win, which shows on their profile.
(This command has a cooldown of 90 seconds.)

Help

tutorial
$[faq|tutorial] 

Link to the bot tutorial and FAQ.

unbanfromhelpme
$unbanfromhelpme <thing_to_unban>
Checks: is_supporter

<thing_to_unban> - A discord User, their User ID, or a server ID

Unbans a previously banned user/server from using the $helpme command.

Only Support Team Members can use this command.

banfromhelpme
$banfromhelpme <thing_to_ban>
Checks: is_supporter

<thing_to_ban> - A discord User, their User ID, or a server ID

Bans a user/server from using the $helpme command.

Only Support Team Members can use this command.

helpme edit
$helpme [correct|edit] <new_text>
Checks: has_open_help_request

<new_text> - The new text to use in your helpme request

Edit the text on your open helpme request. Our Support Team will see the new text right away.

You can only use this command if your server has an open helpme request.

helpme
$helpme <text>
Checks: guild_only

<text> - The text to describe the question or the issue you are having

Ask our support team for help, allowing them to join your server and help you personally.
If they do not join within 48 hours, you may use the helpme command again.

Make sure the bot has permissions to create instant invites.
English is preferred.

help
$help [command]

Views the help on a topic.

The topic may either be a command name or a module name.
Command names are always preferred, so for example, $help adventure
will show the help on the command, not the module.

To view the help on a module explicitely, use $help module [name]

documentation
$[commands|cmds|documentation] 

Sends a link to the official documentation.

helpme view
$helpme view 
Checks: has_open_help_request

View how your server's current helpme request looks like to our Support Team.

You can only use this command if your server has an open helpme request.

helpme delete
$helpme [revoke|remove|delete] 
Checks: has_open_help_request

Cancel your ongoing helpme request. Our Support Team will not join your server.

You can only use this command if your server has an open helpme request.

Vote

vote
$vote 

Vote me up to get a random crate!

You may receive a common crate (89%), an uncommon crate (6%), a rare crate (4%), a magic crate (0.9%) or a legendary crate (0.1%)

If your vote was not registered, make sure you are logged into the right account on https://discord.com/login and try again.

Crates

offercrate
$[offercrates|oc|offercrate] <quantity> <rarity> <price> <buyer>
Checks: cooldown, has_character

<quantity> - The quantity of crates to offer
<rarity> - The rarity of crate to offer. First letter of the rarity is also accepted.
<price> - The price to be paid by the buyer, can be a number from 0 to 100000000
<buyer> - Another IdleRPG player to offer the crates to

Offer crates to another player. Once the other player accepts, they will receive the crates and you will receive their payment.
Example:
$offercrate 5 common 75000 @buyer#1234
$oc 5 c 75000 @buyer#1234

crates
$[boxes|crates] 
Checks: has_character

Shows all the crates you can have.

Common crates contain items ranging from stats 1 to 30
Uncommon crates contain items ranging from stats 10 to 35
Rare crates contain items ranging from stats 20 to 40
Magic crates contain items ranging from stats 30 to 45
Legendary crates contain items ranging from stats 41 to 50

You can receive crates by voting for the bot using $vote, using $daily and with a small chance from $familyevent, if you have children.

open
$open [rarity=common] [amount=1]
Checks: has_character

[rarity] - the crate's rarity to open, can be common, uncommon, rare, magic or legendary; defaults to common
[amount] - the amount of crates to open, may be in range from 1 to 100 at once

Open one of your crates to receive a weapon. To check which crates contain which items, check $help crates.
This command takes up a lot of space, so choose a spammy channel to open crates.

tradecrate
$[tc|tradecrate] <other> [amount=1] [rarity=common]
Checks: has_character

<other> - A user with a character
[amount] - A whole number greater than 0; defaults to 1
[rarity] - The crate's rarity to trade, can be common, uncommon, rare, magic or legendary; defaults to common

Give your crates to another person.

Players must combine this command with $give for a complete trade.

Patreon

weapontype
$weapontype <itemid> <new_type>
Checks: has_character, is_patron

<itemid> - The ID of the item to change type
<new_type> - The type to transform the item into

Change an item's type. Once the type changed, the item becomes unsellable.

You may not change a two-handed item into a one-handed one, or vice versa.
This proves useful for merging items.

Only bronze (or above) tier patrons can use this command.

resetitem
$resetitem <itemid>
Checks: has_character

<itemid> - The ID of the item to reset

Reset an item's type and name, if modified. Once an item is reset, it can be sold again.

weaponname
$weaponname <itemid> <newname>
Checks: has_character, is_patron

<itemid> - The ID of the item to rename
<newname> - The name to give the item, must be shorter than 40 characters

Change an item's name. Once an item is renamed, it can no longer be sold.

Only basic (or above) tier patrons can use this command.

donatordaily
$donatordaily 
Checks: cooldown, has_character, is_patron

Receive a daily booster. The booster can be a time, money or luck booster.

(This command has a cooldown of 24 hours.)

makebackground
$makebackground <url>
Checks: is_patron

<url> - The image URL to format

Generate a profile background for you. This will stretch/compress your image to 800x650 pixels and layer on an overlay.
This will return a link you can then use for $background.

Only basic (or above) tier patrons can use this command.

eventbackground
$eventbackground <number>
Checks: has_character

<number> - The number of the eventbackground to use

Update your background to one from the events. You can get event backgrounds from special events, for example easter or christmas.

updateguild
$updateguild 
Checks: is_guild_leader, is_patron

Update your guild member limit and bank size according to your donation tier.

Gold (and above) Donators have their bank space quintupled (x5), Silver Donators have theirs doubled.
The member limit is set to 100 regardless of donation tier.

⚠ To use this, you have to be the leader of a guild, not just a member.

Only basic (or above) tier patrons can use this command.

background
$background <url>
Checks: has_character

<url> - The image URL to use as the background, may not exceed 60 characters.

Change your profile's background image. $background reset sets it to the default one again.

This image should be formatted by the $makebackground command, however if you want to get creative and not use an overlay, or create your own, the image dimensions are 800x650.
Having trouble finding a short URL? Try following this tutorial!

Only basic (or above) tier patrons can use this command.

Store

store
$store 

Show the booster store. For a detailed explanation what the boosters do, check $help boosters.

activate
$activate <boostertype>
Checks: has_character

<boostertype> - The booster type to activate, can be time, luck, money or all

Activate a booster. For a detailed explanation what the boosters do, check $help boosters.

boosters
$[b|boosters] 
Checks: has_character

View your boosters and the active ones' status. Each one has a different effect.

- Time boosters halve the adventures' times (must be active before starting an adventure)
- Luck boosters increase your adventure chances by 25%
- Money boosters increase the amount of gold gained from adventures by 25%

Each booster lasts 24 hours after activation.

purchase
$purchase <booster> [amount=1]
Checks: has_character

<booster> - The booster type to buy, can be time, luck, money or all
[amount] - The amount of boosters to buy; defaults to 1

Buy one or more booster from the store. For a detailed explanation what the boosters do, check $help boosters.

Marriage

date
$date 
Checks: has_character, cooldown

Take your partner on a date to increase their lovescore. To increase your own lovescore, your partner should go on a date with you.

The lovescore gained from dates can range from 10 to 150 in steps of 10.

Only players who are married can use this command.
(This command has a cooldown of 12 hours.)

family
$family 
Checks: has_character

View your children. This will display their name, age and gender.

familyevent
$[fe|familyevent] 
Checks: cooldown, has_character

Allow your children to do something, this includes a multitude of events.

Every time you or your partner uses this command, your children:
- have an 8/23 chance to grow older by one year
- have a 4/23 chance to be renamed
- have a 4/23 chance to take up to 1/64th of your money
- have a 4/23 chance to give you up to 1/64th of your current money extra
- have a 2/23 chance to find a random crate for you:
+ 500/761 (65%) chance for a common crate
+ 200/761 (26%) chance for an uncommon crate
+ 50/761 (6%) chance for a rare crate
+ 10/761 (1%) chance for a magic crate
+ 1/761 (0.1%) chance for a legendary crate
- have a 1/23 chance to die

In each event you will know what happened.

Only players who are married and have children can use this command.
(This command has a cooldown of 30 minutes.)

lovescore
$lovescore [user=Author]
Checks: has_character

[user] - The user whose lovescore to show; defaults to oneself

Show the lovescore a player has. Lovescore can be increased by their partner spoiling them or going on dates.

Lovescore affects the adventure bonus and the amount of children you can have.

divorce
$divorce 
Checks: has_character

Divorce your partner, effectively un-marrying them.

When divorcing, any kids you have will be split between you and your partner. Each partner will get the children born with their $child commands.
You can marry another person right away, if you so choose. Divorcing has no negative consequences on gameplay.

Both players' lovescore will be reset.

Only married players can use this command.

child
$[fuck|sex|breed|child] 
Checks: cooldown, guild_only, has_character

Have a child with your partner.

Children on their own don't do much, but $familyevent can effect your money and crates.
To have a child, your partner has to be on the server to accept the checkbox.

There is a 50% chance that you will have a child, and a 50% chance to just have fun (if you know what I'm saying) and gain between 10 and 50 lovescore.
When you have a child, there is a 50% chance for it to be a boy and a 50% chance to be a girl.

Your partner and you can enter a name for your child once the bot prompts you to. (Do not include $)
If you fail to choose a name in time, the bot will choose one for you from about 500 pre-picked ones.

For identification purposes, you cannot have two children with the same name in your family, so make sure to pick a unique one.

Only players who are married can use this command.
(This command has a cooldown of 1 hour.)

propose
$[marry|propose] <partner>
Checks: guild_only, has_character

<partner> - A discord User with a character who is not yet married

Propose to a player for marriage. Once they accept, you are married.

When married, your partner will get bonuses from your adventures, you can have children, which can do different things (see $help familyevent) and increase your lovescore, which has an effect on the adventure bonus.
If any of you has children, they will be brought together to one family.

Only players who are not already married can use this command.

relationship
$relationship 
Checks: has_character

Show your partner's Discord Tag. This works fine across server.

Only married players can use this command.

spoil
$spoil [item]
Checks: has_character

[item] - The item to buy, a whole number from 1 to 40; if not given, displays the list of items

Buy something for your partner to increase their lovescore. To increase your own lovescore, your partner should spoil you.

Please note that these items are not usable and do not have an effect on gameplay, beside increasing lovescore.

Only players who are married can use this command.

Guild

guild create
$guild create 
Checks: cooldown, has_no_guild, has_character

Create a guild for $10,000.

Creating a guild has no level requirements, as long as you have $10,000, you can create a guild.
To create a guild, you will need the following:
- A name with 20 characters or less
- An image URL with 60 characters or less to your guild's icon
- $10,000

Having trouble finding a short image URL? Check this tutorial

The bot will ask for these separately. When you enter the guild's name or URL, don't include $.

Only players who are not already in a guild can use this command.
(This command has a cooldown of 10 minuets.)

guild description
$guild description <text>
Checks: is_guild_leader

<text> - The text to use as the description. Cannot exceed 200 characters.

Change the description of your guild.
⚠ This can be seen by everyone, do not use NSFW/inappropriate text.

Only guild leaders can use this command.

guild timers
$guild [cooldowns|t|cds|timers] 
Checks: has_guild

Lists guild-specific cooldowns, meaning all guild members have these cooldowns and cannot use the commands.

guild info
$guild info <by>

<by> - The guild's name (format guild:name, i.e. guild:Adrian's Refuge), its ID (format id:number, i.e. id:5003), or a person in the guild.

Show a specific guild's info. You can look up guilds by its name, its ID, or a player in that guild.

guild invite
$guild invite <newmember>
Checks: is_guild_officer

<member> - A discord user with a character who is not yet in a guild.

Invites a new member to your guild.
If your guild is in an alliance which owns a city, the new member will have its bonuses applied immediately.

Only guild leaders and officers can use this command.

guild leave
$guild leave 
Checks: is_no_guild_leader, has_guild

Leave your current guild

If your guild was in an alliance which owned a city, you will have its bonuses removed immediately.

Only players who are in a guild, beside guild leaders, can use this command.

guild richest
$guild richest 
Checks: has_guild

Displays the top 10 richest guild members of your guild.

Only players in a guild can use this command.

guild channel
$guild channel [channel]
Checks: is_guild_leader, has_permissions

[channel] - The channel to send guild logs to, defaults to the channel the command is used in

Set or update the guild update channel. Relevant guild events will be sent here.
The channel the command is used in will become the guild log channel, $guild channel #channel-name will not work.

The following will be logged:
- Guild badge updated
- Guild transferred
- Guild promotions
- Guild demotions
- New member joins
- Members leaving the guild
- Member kicks
- Guild deletion
- Guild icon changes
- Guild description changes
- Money invests
- Money payouts
- Money distributions
- Guild bank upgrades
- Guild adventures (start and end)

Only guild leaders can use this command.

guild transfer
$guild transfer <member>
Checks: is_guild_leader

<member> - A discord User with a character, must be a member of your guild.

Transfer your guild to someone else. This person will be the new guild leader, while you will become a regular member.

If the user you transfer the guild to is a patron, the guild's member limit will be set to 100, otherwise it will be set to 50.

Only guild leaders can use this command.

guild pay
$guild pay <amount> <member>
Checks: is_guild_officer

<amount> - The amount of money to take out of the bank, must be greater than 0 and smaller or equal the amount your guild has
<member> - A discord User with a character.

Take money out of the guild bank and give it to a user. The user does not have to be a member of your guild.

Only guild leaders and officers can use this command.

guild
$guild 
Checks: has_character

Interact with your guild. If no subcommand is given, this will show your guild.

Guilds are groups of players, they have a guild bank where money can be kept safe from thieves and the guild's members can go on adventures to earn extra rewards.
Players cannot join guilds by themselves, they must be invited by the guild leader or one of its officers.

guild battle
$guild battle <enemy> <amount> <fightercount>
Checks: cooldown, is_guild_officer

<enemy> - A guild officer or leader
<amount> - The amount of money to battle for, must be 0 or above
<fightercount> - The amount of fighters to take into the battle

Fight against another guild, the winning guild will be awarded one GvG win.

While the battle is preparing, both players, you and the other player, will be asked to nominate guild members for the battle.
You can do this by writing battle nominate @person (not including $) until you hit the fightercount.

After the preparation is over, battles will be randomly matched between the two guilds.
These battles function exactly the same as regular battles, see $help battle for more details.

Each fight will give the guild who the winner is from one point. The guild with the most points in the end will win the guild battle.
In case of a tie, nobody gets the money or guild win. The money will be taken from the guild bank.

Only guild leaders and officers can use this command.
(This command has a guild cooldown of 30 minutes.)

guild demote
$guild demote <member>
Checks: is_guild_leader

<member> - A discord User with a character, must be an officer of your guild

Demotes an officer of your guild to member rank. The user will lose their guild officer permissions immediately.

Only guild leaders can use this command.

guild invest
$guild invest <amount>
Checks: has_guild

<amount> - A whole number greater than 0

Invest money into your guild bank, keeping it safe from thieves.

Only guild officers can take money out of the guild bank.

The money in the guild bank can be used to upgrade the bank or upgrade buildings/build defenses in your alliance, if it owns a city.

guild upgrade
$guild upgrade 
Checks: is_guild_leader

Upgrade your guild's bank, adding space for $250,000 each time.

Guilds can be upgraded 9 times which sets them to a maximum of $2,500,000.
Patrons will be able to upgrade their guild further:
- Silver donors can double their maximum bank space
- Gold donors can quintuple (x5) their maximum bank space

The price to upgrade the guild bank is always half of the maximum.

Only guild leaders can use this command.

guild kick
$guild kick <member>
Checks: is_guild_officer

<member> - A discord User with a character, must be a member of your guild

Kicks a member from your guild. Officers cannot be kicked.
If your guild is in an alliance which owns a city, the member will have its bonuses removed immediately.

If the member shares no server with you, you may use their User ID as the member parameter.

Only guild leaders and officers can use this command.

guild status
$guild status 
Checks: has_guild

Check your guild adventure's status

This will either display the time left or the reward. The reward can range from 20 times the difficulty up to 50 times the difficulty.
Only guild leaders and officers can finish adventures, the status can be seen by every guild member.

guild adventure
$guild adventure 
Checks: cooldown, is_guild_officer

Start a guild adventure. Guild adventures can happen alongside regular adventures.

On guild adventures, you can gain additional gold for your guild bank.
When using this command, the bot will send a link used to join the adventure. Each member of the guild can join, at least 3 are required.
Ten minutes after the link was sent, the users who joined will be gathered.

The guild adventure's difficulty will depend solely on the users' levels, their equipped items and race/class bonuses are not considered.
The adventure's lentgh depends on the difficulty, +1 difficulty means +30 minutes time.

Only guild leaders and officers can use this command.
(This command has a guild cooldown of 1 hour.)

guild best
$guild [high|top|best] 
Checks: has_guild

Displays the top 10 best guild members of your guild ordered by XP.

Only players in a guild can use this command.

guild members
$guild members 
Checks: has_guild

Show a list of your guild members. If a user's name cannot be found for whatever reason, their user ID is displayed.

This command can take a minute to load, depending on the amount of members in your guild. Please be patient.

Only players who are part of a guild can use this command.

guild distribute
$guild [dis|distrib|distribute] <amount> [members...]
Checks: is_guild_officer

<amount> - The amount of money to take out all together, must be greater than 0
<members...> - The discord users to give money to, can be multiple, separated by space.

Distribute some money to multiple members. This will divide by the amount of players before distributing.
For example, distributing $500 to 5 members will give everyone of them $100.

Members that are mentioned multiple times will receive multiple payouts.

In case of a decimal result the bot will round down, i.e. $7 distributed to 3 members will give everyone $2.

Only guild leaders and officers can use this command.

guild promote
$guild promote <member>
Checks: is_guild_leader

<member> - A discord User with a character, must be a member of your guild

Promote a member of your guild to the officer rank. This allows them to use certain guild commands. Officers can:
- Invite new members
- Kick members from the guild (cannot kick officers)
- Take money out of the guild bank
- Distribute money from the guild bank
- Start battles with other guilds
- Start and finish guild adventures

Officers cannot be kicked from your guild and must be demoted first.
Only promote members you trust. You can demote officers using $guild demote.

Only guild leaders can use this command.

guild rename
$guild rename <new_name>
Checks: is_guild_leader

<new_name> - The new name for the guild.

This renames your guild to something else.

The name may not exceed 20 characters.

Only guild leaders can use this command.

guild badge
$guild badge <number>
Checks: is_guild_leader, has_character

<number> - The number of the guild badge to use, ranging from 1 to the amount of available badges

Change your guild's badge, it will display in $guild info.

Only guild leaders can use this command.

guild delete
$guild delete 
Checks: is_guild_leader

Delete your guild.

If you would just like to leave the guild, consider transferring it to someone, then leaving normally.

If your guild was in an alliance which owned a city, all members will lose its bonuses immediately.

Only guild leaders can use this command.

guild icon
$guild icon [url]
Checks: is_guild_leader

[url] - The image URL to use as the icon

Change your guild's icon. The URL cannot exceed 60 characters.
⚠ This can be seen by anyone, do not use NSFW/innapropriate images. GIFs are not supported.

Having trouble finding short image URLs? Follow this tutorial or just attach the image you want to use (png, jpg and gif are supported)!

Only guild leaders can use this command.

guild ladder
$guild ladder 

Shows the top 10 guilds ordered by Guild vs Guild wins.

To get more GvG wins, the guild leader or its officers can use $guild battle.

Tournament

raidtournament
$raidtournament [prize=0]
Checks: cooldown, has_character

[prize] - The amount of money the winner will get

Start a new raid tournament. Players have 30 seconds to join via the reaction.
Tournament entries are free, only the tournament host has to pay the price.

Only an exponent of 2 (2^n) users can join. If there are more than the nearest exponent, the last joined players will be disregarded.

The match-ups will be decided at random, the battles themselves will be decided like raid battles (see $help raidbattle for details).

The winner of a match moves onto the next round, the losers get eliminated, until there is only one player left.
Tournaments in IdleRPG follow the single-elimination principle.

(This command has a cooldown of 30 minutes.)

tournament
$tournament [prize=0]
Checks: cooldown, has_character

[prize] - The amount of money the winner will get

Start a new tournament. Players have 30 seconds to join via the reaction.
Tournament entries are free, only the tournament host has to pay the price.

Only an exponent of 2 (2^n) users can join. If there are more than the nearest exponent, the last joined players will be disregarded.

The match-ups will be decided at random, the battles themselves will be decided like regular battles (see $help battle for details).

The winner of a match moves onto the next round, the losers get eliminated, until there is only one player left.
Tournaments in IdleRPG follow the single-elimination principle.

(This command has a cooldown of 30 minutes.)

Classes

evolve
$evolve 
Checks: has_character

Evolve your class, bringing it to the next level and giving better class bonuses.

You can evolve every 5 levels, i.e. at level 5, level 10, level 15, level 20, level 25 and finally level 30.

- Warriors gain +1 defense per evolution
- Thieves gain +8% for their success chance per evolution
- Mages gain +1 damage per evolution
- Rangers' pets' hunted item get +3 minimum stat and +6 maximum stat per evolution
- This means level 1 pets can hunt items from stat 3 to stat 6; level 2 pets from stat 6 to stat 12
- Raiders gain +0.1 defense and damage raidstats
- Ritualists gain +5% extra favor when sacrificing per evolution
(- Paragons gain +1 damage and +1 defense per evolution)

tree
$tree 

Shows the evolution tree for each class.
This will only show the names, not the respective benefits.

pet play
$pet [fun|play] 
Checks: cooldown, has_character, is_class

Play with your pet to raise its joy points. Your pet can gain from 1 to 12 Joy points per play.

Only rangers can use this command.
(This command has a cooldown of 6 hours.)

pet rename
$pet [name|rename] <name>
Checks: has_character, is_class

Give your pet a new name. The name cannot be longer than 20 characters.

Only rangers can use this command.

class
$class 
Checks: cooldown, has_character

Change or select your primary or secondary class.

- Warriors gain added defense
- Thieves gain access to $steal
- Mages gain added damage
- Rangers gain access to a pet which can hunt for gear items
- Raiders gain additional raidstats, used in raidbattles and raids
- Ritualists gain additional favor from sacrificing items and are twice as likely to receive loot from adventures
(- Paragons gain added damage and defense; the class is only available to donators)

The second class unlocks at level 12. Selecting a class the first time is free (No Class -> Class), but changing it later will cost $5,000 (Class -> another Class)

(This command has a cooldown of 24 hours)

myclass
$myclass 
Checks: has_character

Show your class(es) and their added benefits, sent as images.

steal
$steal 
Checks: cooldown, has_character, is_class

Steal money from a random user.

Your steal chance is increased by evolving your class and your alliance's thief buildings, if you have an alliance that owns a city.
If you succeed in stealing, you will steal 10% of a random player's money.

You cannot choose your target, it is always a random player. If the bot can't find the player's name, it will be replaced with "a traveller passing by".
The random player cannot be anyone with money less than $10, yourself, or one of the bot owners.

Only thieves can use this command.
(This command has a cooldown of 1 hour.)

pet feed
$pet feed 
Checks: has_character, is_class

Feed your pet. This brings up an interactive menu where you can buy a food item.

Only rangers can use this command.

pet image
$pet image [url]
Checks: has_character, is_class

[url] - An image url for the pet's image, must be 60 characters or shorter

Updates the image that shows in $pet.

Having trouble finding a short image link? Follow this tutorial or just attach the image you want to use (png, jpg, webp and gif are supported)!

Only rangers can use this command.

pet
$pet 
Checks: is_class, has_character

Interact with your pet. Be sure to see $help pet.

Every two hours, your pet will lose 2 food points, 4 drink points, 1 joy point and 1 love point.

If food or drink drop below zero, your pet dies and the ranger class is removed from you.
If love sinks below 75, your pet has a chance to run away which increases the lower its love drops.

Your pet's joy influences the items it hunts, acting as a multiplier for the item's stat.

Only rangers can use this command.

pet drink
$pet drink 
Checks: has_character, is_class

Give your pet something to drink. This brings up an interactive menu where you can buy a drink item.

Only rangers can use this command.

pet hunt
$pet hunt 
Checks: cooldown, has_character, is_class

Make your pet hunt an item for you.

The items stat depends on your pet's level (determined by class evolution) as well as its joy score.
The lowest base stat your pet can find is three times its level, the highest is 6 times its level.
Your pet's joy score in percent is multiplied with these base stats.

For example:
- Your pet is on level 2, its joy score is 50.
- The item's base stats are (3x2) to (6x2), so 6 to 12.
- Its joy score in percent is multiplied: 50% x 6 to 50% x 12, so 3 to 6

In this example, your pet can hunt an item with stats 3 to 6. It has a hard cap at 30.
The item's value will be between 0 and 250.

Only rangers can use this command.
(This command has a cooldown until 12am UTC.)

pet cuddle
$pet [caress|hug|kiss|cuddle] 
Checks: cooldown, has_character, is_class

Cuddle with your pet to raise its love points. Your pet can gain from 1 to 12 Love points per cuddle.

Only rangers can use this command.
(This command has a cooldown of 6 hours.)

Images

edgy
$edgy [user=Author]

[user] - A discord User whose avatar to edit; defaults to oneself

Finds and exaggerates edges in a user's avatar, creating a cool image effect.

pixelfy
$pixelfy [user=Author] [size=2]

[user] - A discord User whose avatar to pixelfy; defaults to oneself
[size] - The pixelation rate to use, can be a number between 1 and 5; defaults to 2

Pixelfies a user's avatar. If the user has an animated icon, the first frame is used.

oil
$oil [member=Author]

[member] - A discord User whose avatar to oil-paint; defaults to oneself

Creates an oil-painting effect on someone's avatar.

(This command has a channel cooldown of 15 seconds.)

invert
$invert [member=Author]

[member] - A discord User whose avatar to invert; defaults to oneself

Invert the colors in someone's avatar.

(This command has a channel cooldown of 15 seconds.)

Raid

raid
$raid 

Informs you about joining raids.

raidstats
$raidstats 
Checks: has_character

View your raidstats. These will affect your performance in raids and raidbattles.

increase defense
$increase defense 
Checks: has_character, cooldown

Increase your raid defense.

increase damage
$increase damage 
Checks: has_character, cooldown

Increase your raid damage.

increase
$increase 

Upgrade your raid damage or defense multiplier. These will affect your performance in raids and raidbattles.

Gods

sacrifice
$sacrifice [loot_ids...]
Checks: cooldown, has_character, has_god

[loot_ids...] - The loot IDs to sacrifice, can be one or multiple IDs separated by space; defaults to all loot

Sacrifice loot to your God to gain favor points.

If no loot IDs are given with this command, all loot you own will be sacrificed.
You can see your current loot with $loot.

Only players, who follow a God can use this command.

favor
$[favour|favor] 
Checks: has_character, has_god

Shows your current God and how much favor you have with them at the time.

If you have enough favor to place in the top 25 of that God's followers, you will gain extra luck when the new luck is decided, this usually happens on Monday.
- The top 25 to 21 will gain +0.1 luck
- The top 20 to 16 will gain +0.2 luck
- The top 15 to 11 will gain +0.3 luck
- The top 10 to 6 will gain +0.4 luck
- The top 5 to 1 will gain +0.5 luck

These extra luck values are based off the decided luck value.
For example, if your God's luck value is decided to be 1.2 and you are the 13th best follower, you will have 1.5 luck for that week.
All favor is reset to 0 when the new luck is decided to make it fair for everyone.

followers
$followers <limit>
Checks: has_character

<limit> - A whole number from 0 to 25. If you are a God, the upper bound is lifted.

Display your God's (or your own, if you are a God) top followers, up to <limit>.

The format for this is as follows:
- Placement
- User ID
- Amount of favor
- current luck

The result is attached as a text file.

pray
$pray 
Checks: cooldown, has_character, has_god

Pray to your God in order to gain a random amont of favor points, ranging from 0 to 1000.

There is a 33% chance you will gain 0 favor, a 33% chance to gain anywhere from 0 to 500 favor and a 33% chance to gain anywhere from 500 to 1000 favor.

(This command has a cooldown until 12am UTC.)

follow
$follow 
Checks: cooldown, has_character

Choose a God or change your current God for a reset point.
Every player gets 2 reset points when they start playing, you cannot get any more.

Following a God allows your $luck to fluctuate, check $help luck to see the exact effects this will have on your gameplay.
If you don't have any reset points left, or became Godless, you cannot follow another God.

(This command has a cooldown of 3 minutes.)

unfollow
$unfollow 
Checks: has_god, has_character

Unfollow your current God and become Godless. This is permanent!

Looking to change your God instead? Simply use $follow again.

Once you become Godless, all your reset points and your God are removed.
Becoming Godless does not mean that your luck returns to 1.00 immediately, it changes along with everyone else's luck on Monday.

Transaction

trade add
$trade add 
Checks: has_transaction

Adds something to trade session.
You can specifiy what item you want to add to the trade by using one of the subcommands below.

You need to have an open trading session to use this command.

trade remove item
$trade remove item <itemid>
Checks: has_transaction

<itemid> - The ID of the item to remove

Remove an item from the trading session. The item needs to be in the trade to remove it.
To add an item, consider $trade add item.

You need to have an open trading session to use this command.

trade remove
$trade [del|rem|delete|remove] 
Checks: has_transaction

Removes something from a trade session.
You can remove something of your choice by using one of the subcommands below.

You need to have an open trading session to use this command.

trade set money
$trade set money <amount>
Checks: has_transaction

<amount> - The amount of money to set, must be greater than -1

Sets an amount of money in the trading session. You cannot set more money than you have.
To add or remove money, consider $trade add/remove money.

You need to have an open trading session to use this command.

trade remove money
$trade remove money <amount>
Checks: has_transaction

<amount> - The amount of money to remove, must be greater than 0

Removes money from the trading session. You cannot remove more money than you added.
To add money, consider $trade add money.

You need to have an open trading session to use this command.

trade set
$trade set 
Checks: has_transaction

Sets a sepcific value in the trade session.
You can specifiy what item you want to set in the trade by using one of the subcommands below.

You need to have an open trading session to use this command.

trade add crates
$trade add crates <amount> <rarity>
Checks: has_transaction

<amount> - The amount of crates to add, must be greater than 0
<rarity> - The crate rarity to add, can be common, uncommon, rare, magic or legendary

Adds crate to the trading session. You cannot add more crates than you have.
To remove crates, consider $trade remove crates.

You need to have an open trading session to use this command.

trade remove crates
$trade remove crates <amount> <rarity>
Checks: has_transaction

<amount> - The amount of crates to remove, must be greater than 0
<rarity> - The crate rarity to remove, can be common, uncommon, rare, magic or legendary

Removes crates from the trading session. You cannot remove more crates than you added.
To add crates, consider $trade add crates.

You need to have an open trading session to use this command.

trade remove items
$trade remove items [itemids...]
Checks: has_transaction

<itemids...> - The IDs of the item to remove, separated by space

Remove multiple items from the trading session. The items must be in the trading session already.
Items that are not in the trade will be automatically filtered out.
To remove an item, consider $trade remove item.

You need to have an open trading session to use this command.

trade add money
$trade add money <amount>
Checks: has_transaction

<amount> - The amount of money to add, must be greater than 0

Adds money to the trading session. You cannot add more money than you have.
To remove money, consider $trade remove money.

You need to have an open trading session to use this command.

trade
$trade <user>
Checks: has_no_transaction

Opens a trading session for you and another player.
Using $trade <user>, then the user accepting the checkbox will start the trading session.

While the trading session is open, you and the other player can add or remove items, money and crates as you choose.

Here are some examples to familiarize you with the concept:
- $trade add crates 10 common
- $trade set money 1000
- $trade remove item 13377331 (this only works if you added this item before)
- $trade add items 1234 2345 3456

To accept the trade, both players need to react with the ✅ emoji.
Accepting the trade will transfer all items in the trade session to the other player.

You cannot trade with yourself, or have more than one trade session open at once.
Giving away any items, crates or money during the trade will render it invalid and it will not complete.

trade add items
$trade add items [itemids...]
Checks: has_transaction

<itemids...> - The IDs of the item to add, separated by space

Adds multiple items to the trading session. The items cannot already be in the trading session.
Items that are not in your inventory will be automatically filtered out.
To remove an item, consider $trade remove item.

You need to have an open trading session to use this command.

trade add item
$trade add item <itemid>
Checks: has_transaction

<itemid> - The ID of the item to add

Add an item to the trading session. The item needs to be in your inevntory.
To remove an item, consider $trade remove item.

You need to have an open trading session to use this command.

trade set crates
$trade set crates <amount> <rarity>
Checks: has_transaction

<amount> - The amount of crates to set, must be greater than -1
<rarity> - The crate rarity to set, can be common, uncommon, rare, magic or legendary

Sets an amount of crates in the trading session. You cannot set more crates than you have.
To add or remove crates, consider $trade add/remove crates.

You need to have an open trading session to use this command.

Races

race
$race 
Checks: cooldown, has_character

Pick or change your race. This can be chosen as long as you have reset points left.

Each race has a different DMG/DEF distribution:
- Orc: +4 defense, +0 damage
- Dwarf: +3 defense, +1 damage
- Human: +2 defense, +2 damage
- Elf: +1 defense, +3 damage
- Jikill: +0 defense, +4 damage

By default, you are a human.

After picking the race, you will be asked a personal question, the answer may affect something.

HungerGames

hungergames
$[hg|hungergames] 

Starts the hunger games

Players will be able to join via the :shallow_pan_of_food: emoji.
The game is controlled via both random actions and possibly chosen actions.
Players may choose an action if they get a direct message from the bot. If no action is chosen by the player, the bot chooses one for them.

Not every player will get the opportunity to choose an action. Sometimes nobody gets to choose, so don't be discouraged.

Maths

calc
$[calculate|math|maths|calc] <expr>

<expr> - The mathematical expression to calculate

Calculates something. pi is pi, tau is tau and e is math.e
Supports round(), sin(), cos(), sqrt(), tan() and infinity (inf) and NaN (nan).
Works with variable assignment and multiline-statements.

Sharding

timers
$[cooldowns|t|cds|timers] 

Lists all your cooldowns, including your adventure timer.

clusters
$[botstatus|shards|clusters] 

Lists all clusters and their current status.

Alliance

alliance build defense
$alliance build defense <name>
Checks: has_character, is_alliance_leader, owns_city, cooldown

Build some defensive buildings or place troops in your cities. The following are available:

Cannons: 250HP, 60 defense for $200,000
Archers: 500HP, 50 defemse for $100,000
Outer Wall: 20,000HP, 0 defense for $500,000
Inner Wall: 10,000HP, 0 defense for $200,000
Moat: 5,000HP, 25 defense for $150,000
Tower: 1,000HP, 50 defense for $200,000
Ballista: 250HP, 30 defense for $100,000

Any city can have a maximum of 10 defenses. When attacked, the buildings with the most HP are targeted first.
You may not build defenses while your city is under attack. The price of the defense is removed from the leading guild's bank.

This command requires your alliance to own a city.
Only the alliance leader can use this command.
(This command has a cooldown of 1 minutes)

alliance build building
$alliance build building <name>
Checks: has_character, is_alliance_leader, owns_city, cooldown

<name> - The name of the building to upgrade.

Upgrade one of your city's buildings, granting better passive bonuses. The maximum level of any building is 10.
Depending on the city's available buildings, <name> is either Thief, Raid, Trade, or Adventure. Use $alliance buildings to see which are available.

The upgrade price depends on the building's next level and is calculated as next_level * $100,000.
The upgrade price will be removed from the Alliance Leader's guild bank.

This command requires your alliance to own a city.
Only the alliance leader can use this command.
(This command has a cooldown of 5 minutes)

cities
$cities 

Show all cities, their tiers, owners, available buildings and current defense.

alliance timers
$alliance [cooldowns|t|cds|timers] 
Checks: has_character

Lists alliance-specific cooldowns, meaning all alliance members have these cooldowns and cannot use the commands.

alliance occupy
$alliance occupy <city>
Checks: has_character, is_alliance_leader, owns_no_city

<city> - The name of a city. You can check the city names with $cities

Occupy a city. Your alliance will then own that city and will be able to build defenses and level up buildings.
You can only occupy a city of it has zero defenses left.

Occupying a city sets it on a cooldown of 10 minutes, during which time it cannot be occupied by another alliance.
Occupying a city also sets all of its buildings back to level 0.

You cannot occupy a city if your alliance already owns one.
Only the alliance leader can use this command.

alliance build
$alliance build 

Build buildings $alliance build building or defenses $alliance build defense.

alliance buildings
$alliance buildings 
Checks: has_character

Lists all buildings in your city, along with their level. These buildings give passive rewards to all alliance members:

Thief buildings increase your chance to steal money as a thief, for every level, this increases your chance by 5%
Raid buildings increase a user's raidstats by 0.1 per level
Trade buildings remove the need to pay the 5% tax when selling or buying items when it reached at least Level 1. It also increases the amount of money you get from $merch and $merchall increasing the reward by 50% for each level
Adventure buildings shorten the adventure time by 1% per level and increase your succes chances by 1% per level.

Your alliance must own a city to use this command.

alliance invite
$alliance invite <newleader>
Checks: has_character, is_alliance_leader, cooldown

<newleader> - A user with a character who leads a guild.

Invite a guild to your alliance. All allied guilds will benefit from your city's buildings. Once you’re allied with another guild, it will be shown in $alliance.
The other guild can't be allied with another alliance or own a city in order to be invited.

Only the alliance leader can use this command.
(This command has a cooldown of 5 minutes.)

alliance attack
$alliance attack <city>
Checks: is_guild_leader, cooldown

<city> - The name of a city. You can check the city names with $cities

Attack a city, reducing its defenses to potentially take it over.
Attacking a city will activate a grace period of 10 minutes, during which time it cannot be attacked again.

When using this command, the bot will send a link used to join the attack. Each member of the alliance can join.
Ten minutes after the link was sent, the users who joined will be gathered, their attack and defense depending on their equipped items, class and raid bonuses and their raidstats, and start the attack.

During the attack, the highest HP defenses will be attacked first. All attackers' damage will be summed up.
The defenses' damage sum up and damage either the attacker with the lowest HP or the attacker with the highest damage.

If a defense reaches zero HP, it will be removed from the city, it will not regenerate HP after the attack is over.
Attackers reaching zero HP will be removed from the attack as well.

If a city's defenses were destroyed, your alliance can take occupy the city right away ($alliance occupy)

Only the alliance leader can use this command.
(This command has a cooldown of 2 hours.)

alliance defenses
$alliance defenses 
Checks: has_character

Lists your city’s defenses and view the HP left for each.

Your alliance must own a city to use this command.

alliance
$alliance 
Checks: has_guild, has_character

Alliances are groups of guilds. Just like a guild requires at least one member, an alliance requires at least one guild and is considered a single-guild alliance.
Alliances can occupy cities for passive bonuses given by the buildings.

If this command is used without subcommand, it shows your allied guilds.
See $help alliance for a list of commands to interact with your alliance!

alliance kick
$alliance kick <guild_to_kick>
Checks: has_character, is_alliance_leader

<guild_to_kick> - A guild's name or ID

Remove a guild from your alliance. Once the guild was kicked, it will no longer benefit from an owned city's buildings.

Only the alliance leader can use this command.

alliance leave
$alliance leave 
Checks: is_guild_leader

Leave your alliance. Once you left your alliance, you will no longer benefit from an owned city's buildings.

If you lead an alliance, you cannot leave it (consider $alliance kick).
Only guild leaders can use this command.

alliance abandon
$alliance abandon 
Checks: has_character, is_alliance_leader, owns_city

Abandoning your city will immediately make all alliance members lose all passive bonuses offered by the city's buildings and the city ownership will be given back to the System Guild Alliance.

Your alliance must own a city to use this command.
Only the alliance leader can use this command.

Trivia

trivia
$[tr|trivia] [difficulty=easy]

[difficulty] - The difficulty of the question, may be easy, medium or hard

Answer a trivia question from OpenTDB. You select your answer with the emoji reactions.

Chess

chess elo
$chess elo 

Shows your ELO and the best chess players' ELO rating limited to IdleRPG's chess.

chess
$chess 

IdleRPG's Chess system. You can play against AI or other users and gain ELO.

chess match moves
$chess match moves 

Shows the moves of the current match in the channel that you and your opponent took.

chess match
$chess match [difficulty=3] [enemy]

[difficulty] - A whole number between 1 and 10; defaults to 3
[enemy] - A user; defaults to nobody

Starts a game of chess.
If a difficulty is given, you will play against the Stockfish chess AI with the given difficulty.
If an enemy is given, you will play against that enemy, no matter if you set a difficulty or not.

You are able to choose which side you want to play as at the beginning using the emojis.
If you play against an enemy and both of you are ELO-registered, you are given the choice to play ranked or not.

There can only be one chess game in one channel at a time.

Chess moves can be sent in several formats:
-g1f3
-Nf3
-0-0
-xe3

Keep in mind that these are case sensitive:
Pieces are upper case:
-King = K
-Queen = Q
-Bishop = B
-Knight = N
-Rook = R
-Pawn = no notation
Fields are lower case.

chess register
$chess register 

Register an ELO-rating eligible account for Idle's Chess.
The rating determines your relative skill and can be increased/decreased by winning/losing matches.

Werewolf

werewolf speeds
$werewolf speeds 

Used to see the list of available werewolf game speeds.

werewolf
$[ww|werewolf] [mode=Classic] [speed=Normal] [min_players]

[mode] - The mode to play, see below for available options. (optional and defaults to Classic)
[speed] - The game speed to play, see below available options. (optional and defaults to Normal)
[min_players] - The minimum players needed to play. (optional and defaults depending on the game mode: Classic: 5, Imbalanced: 5, Huntergame: 8, Villagergame: 5, Valentines: 8, IdleRPG: 5)

Starts a game of Werewolf. Find the werewolves, before they find you!
Your goal to win is indicated on the role you have.
Game modes: Classic (default), Imbalanced, Huntergame, Villagergame, Valentines, IdleRPG. Use $ww modes for detailed info.
Game speeds (in seconds): Normal: 60 (default), Extended: 90, Fast: 45, Blitz: 30. Use $ww speeds for detailed info.
Aliases:
ww
Examples:
$ww Blitz for Classic mode on Blitz speed
$ww Imbalanced for Imbalanced mode on Normal speed
$ww Valentines Extended for Valentines mode on Extended speed
$ww Huntergame Fast for Huntergame mode on Fast speed

werewolf myrole
$werewolf myrole 

Check your role in the Werewolf game and have the bot DM it to you.

You must be part of the ongoing game to get your role.

werewolf modes
$werewolf modes 

Used to see the list of available werewolf game modes.

werewolf roles
$werewolf roles [role]

View the descriptions of roles in the Werewolf game.
$roles to see all roles.
$roles <role name here> to view info about a role.

Scheduling

remind
$[r|reminder|remindme|remind] <when_and_what>

<when_and_what> - The reminder subject and time, see below for more info.

Remind yourself about something you should do in the future.

<when_and_what> can be you reminder and time, several formats are accepted:
- $remind 12h vote on top.gg
- $remind 12am use $daily
- $remind next monday check out the new God luck

Please keep it in order of $remind time subject to make sure this works properly

remind cancel
$remind [remove|rm|delete|del|cancel] [ids...]

[ids...] - A list of reminder IDs, separated by space

Cancels running reminders using their IDs.

To find a reminder's ID, use $reminder list.

remind list
$remind list 

Shows you a list of your currently running reminders

Reminders can be cancelled using $reminder cancel <id>.

reminders
$reminders 

Shows you a list of your currently running reminders

Reminders can be cancelled using $reminder cancel <id>.

(serves as an alias for $reminder list)