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

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.)

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.

roulette table
$roulette table 

Sends a picture of a French Roulette table.

draw
$[card|draw] 

Draws a random card of the 52 french playing cards.

This command has no effect on your balance.
(This command has a cooldown of 15 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
$[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.)

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.)

Adventure

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.

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 5% 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.

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.

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.

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

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.

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.

Trading

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

[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.

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.)

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.

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.

pending
$pending 

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

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 higher 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.

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.

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

[maxstat] - The highest damage/defense to include; defaults to 75
[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 winnings will be multiplied by 1.5 for each level.

⚠ This command is currently disabled.

(This command has a cooldown of 30 minutes.)

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.

prefix
$prefix 
Checks: guild_only

View the bot prefix for the server

serverinfo
$[server|serverinfo] 
Checks: guild_only

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

settings reset
$settings reset 
Checks: has_permissions

Resets the server settings.

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

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.

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.

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.

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

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.

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.

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.

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 partner and children

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.)

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.)

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.)

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

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.

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

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.

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.

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.

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.)

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.)

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)

Help

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.

tutorial
$[faq|tutorial] 

Link to the bot tutorial and FAQ.

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.

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.

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.

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.

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.

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

tradecrate
$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.

open
$open [rarity=common]
Checks: has_character

[rarity] - the crate's rarity to open, can be common, uncommon, rare, magic or legendary; defaults to common

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.

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.

Patreon

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.

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.

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.

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.)

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.

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.

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.

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.

Store

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

<booster> - The booster type to buy, can be time, luck, money or all
[amount] - Thw 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.

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.

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.

Marriage

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.

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.

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.)

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.)

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.

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.

family
$family 
Checks: has_character

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

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.)

divorce
$divorce 
Checks: has_character

Divorce your partner, effectively un-marrying them.

When divorcing, any kids you have with your partner will be deleted.
You can marry another person right away, if you so choose. Divorcing has no negative consequences on gameplay.

Only married players can use this command.

Guild

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.

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 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 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 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 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 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 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 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 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 upgrade
$guild upgrade 
Checks: is_guild_leader

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

Guilds can be upgraded 4 times which sets them to a maximum of $1,000,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 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 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
$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 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 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 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 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 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 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!

Only guild leaders can use this command.

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 channel
$guild channel 
Checks: is_guild_leader, has_permissions

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 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 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 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

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!

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)

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 the target'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 target cannot be anyone with less than $10, yourself, or one of the Game Masters.

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

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.)

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.

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.

tree
$tree 

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

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 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
$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.

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)

myclass
$myclass 
Checks: has_character

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

Images

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.)

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.)

Raid

increase defense
$increase defense 
Checks: has_character, cooldown

Increase your raid defense.

increase
$increase 

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

increase damage
$increase damage 
Checks: has_character, cooldown

Increase your raid damage.

raid
$raid 

Informs you about joining raids.

raidstats
$raidstats 
Checks: has_character

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

Gods

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.

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.)

sacrifice
$sacrifice [loot_ids...]
Checks: 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.

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.

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.

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 a game of the hunger games (starts a hunger game?)

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.

Alliance

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 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 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.)

cities
$cities 

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

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 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 $alliance 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 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 10%
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 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 attack
$alliance attack <city>
Checks: is_guild_leader, cooldown

<city> - The name of a city. You can check the city names with $alliance 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 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 build
$alliance build 

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

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)

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.

Sharding

clusters
$[botstatus|shards|clusters] 

Lists all clusters and their current status.

timers
$[cooldowns|t|cds|timers] 

Lists all your cooldowns, including your adventure timer.

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.

Werewolf

role
$role 

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
$[ww|werewolf] [mode=Classic]

[mode] - The mode to play, see below for more info; defaults to Classic

Starts a game of Werewolf.
Game modes:
Classic - Play the classic werewolf game. (This is the default)
Blitz - In Blitz mode, all action timers are limited to 30 seconds and number of days to play is dependent on the number of players plus 3 days. This means not killing anyone every night or every election will likely end the game with no winners.

Chess

chess
$chess 

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

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 elo
$chess elo 

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

chess match moves
$chess match moves 

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

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.

Music

chooseplay
$[cp|chooseplay] <query>
Checks: is_in_vc, get_player, is_not_locked

<query> - The query to search a song by

Query for a track and play or add any result to the playlist, you can choose from a multitude of tracks.

stop
$[leave|stop] 
Checks: is_playing, get_player, is_not_locked, vote

Stops the music and leaves voice chat.

If there are more than one person in the session and a non-DJ uses this command, a vote has to pass first.

loop
$[repeat|loop] 
Checks: is_playing, get_player, is_not_locked, vote

Toggle repeat of the currently playing song. Queue loop is not supported.

If there are more than one person in the session and a non-DJ uses this command, a vote has to pass first.

now_playing
$[np|now_playing] 
Checks: is_playing, get_player

Displays some information about the currently playing song.

play
$play <query>
Checks: is_in_vc, get_player, is_not_locked

<query> - The query to search a song by

Query for a track and play or add the first result to the playlist.
If this is not the song you were looking for, try $chooseplay.

volume
$[vol|volume] <volume>
Checks: is_playing, get_player, is_not_locked, vote

Changes the playback's volume.

If there are more than one person in the session and a non-DJ uses this command, a vote has to pass first.

lyrics
$lyrics [query]

<query> - The query to search the song by; defaults to the currently playing song

Retrieves song lyrics. If no song specified, will check the current playing song.

skip
$skip 
Checks: is_playing, get_player, is_not_locked, vote

Skip the currently playing song.

If there are more than one person in the session and a non-DJ uses this command, a vote has to pass first.

queue
$[q|que|cue|queue] 
Checks: is_playing, get_player

Show the next (maximum 5) tracks in the queue.

pause
$[resume|pause] 
Checks: is_playing, get_player, is_not_locked, vote

Toggles the music playback's paused state.

If there are more than one person in the session and a non-DJ uses this command, a vote has to pass first.

equalizer
$[equaliser|eq|equalizer] <eq>
Checks: is_playing, get_player, is_not_locked, vote

<eq> - The equalizer to use

Sets the equalizer. May be flat, piano, metal or boost.
Flat is the standard, piano is quiet, metal boosts high frequencies and boost boosts low frequencies.

If there are more than one person in the session and a non-DJ uses this command, a vote has to pass first.

lock
$[unlock|lock] 
Checks: is_playing, get_player, is_dj

Lock/Unlock the player. This allows nobody else to control the music.

Only the session's DJ can use this command.

Miscellaneous

cat
$cat 

Sends cute cat pics from The Cat API.

partners
$partners 

Awesome bots by other coffee-drinking individuals.

dab
$dab 

Let's dab together.

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

idlewiki
$[wiki|idlewiki] [query]

[query] - The idlewiki query to search for

Searches Idle's wiki for an entry.

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).

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.

userfriendly
$[uf|userfriendly] [date=2020-06-17]

[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.

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.)

yesno
$[yn|yesno] <question>

<question> - The question to answer

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

changelog
$changelog 

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

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.

dog
$dog 

Sends cute dog pics from The Dog API.

wikipedia
$wikipedia <query>

<query> - The wikipedia query to search for

Searches Wikipedia for an entry.

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.

echo
$[say|echo] <phrase>

<phrase> - The text to repeat

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

rules
$rules 

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

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".

invite
$invite 

Invite the bot to your server.

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

roll
$roll <maximum>

<maximum> - A whole number greater than 0

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

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.

randomname
$randomname 

Sends you my nickname from a random server.

⚠ Caution: may contain NSFW.

fancy
$fancy <text>

<text> - The text to enlarge

Replaces text and numbers with emoji.

meme
$meme 

Sends a random meme from Some Random API.

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!

stats
$stats 

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

uptime
$uptime 

Shows how long the bot has been connected to Discord.

garfield
$garfield [date=2020-06-17]

[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.

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.

web
$[pages|about|web] 

About the bot and our websites.

support
$support 

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

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

8ball
$8ball <question>

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

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.

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

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

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.)