---------- General Commands -----------------
p!start
Find out how to get your first pokémon!
p!daily
Get credit rewards every day for just clicking a button!
p!help
Display the help menu!





-------------- Pokemon Commands -----------------

p!info
Display your selected pokémon's information. - should look like https://i.imgur.com/5U1d3jM.png
p!select
Select a different pokémon.
p!pokeball here E.G pk!ultraball pikachu will attempt to catch a pikachu. This should check if a user has an ultra ball (purchased from shop) If not, return message. 'Sorry, you have insufficient Ultraballs to execute this command'
p!nickname id nickname
Give your pokémon a nickname.
p!duel @username
Battle another user.
p!accept duel
accepts the duel request
p!moves
Display your pokémon's moves and movepool. - Should look like this - https://i.imgur.com/JoL0A38.png
p!learn
Teach your pokémon a move.
p!mega
Mega evolve your pokémon.
p!release
Release pokémon back into the wild. (Confirmation Needed) (Once a user uses this command, they will have a prompt that says Are you sure you would like to release x y z. User will need to type pk!accept to release) This should support multiple ids E.G pk!release 84 94 749 would show

Would you like to release
Pikachu - level 18 - Number: 2
Pikachu - Level 12 - Number 3
Pikachu - Level 9 - Number 1:
p!pokemon (this should also have search parameters like the market commands e.g pk!pokemon --atkiv 30 --defiv 0 which will show all pokemon with an attack iv of 30 and a defence iv of 0
p!fav
Display a list of your favourite pokémon you own. - should look like this https://i.imgur.com/xcLsBDt.png
p!addfav idhere
Add a pokémon to your list of favourites.
p!removefav idhere
Remove a pokémon from your list of favourites.
p!dropitem idhere
Drop the item your pokémon is currently holding.
p!moveitem idhere
Give the item your pokémon is currently holding to another of your pokémon.
p!xp will return 'you have x amount of time left on your XP booster'
Display your active XP booster.
p!health
Display pokemon that require healing and show health next to them
p!use
Use an item on a pokemon
p!order
Change the order of your pokémon lists.

p!order alphabetical
p!order number
p!order level
p!order iv


------------------------ Shop Commands ---------------

p!shop
Display the shop menu. - should look like this https://i.imgur.com/Gn31Z9s.png
p!market
Access the global marketplace.
p!trade @username
Trade with another user.
p!add pokemonid
Add a pokemon to a trade - this should support multiple ids as well as coins. If a user types anything with coins after it e.g 10000 coins, it will add 10000 coins from their balance to their trade. If a user does not have the correct amount of coins, it will return an error message. E.G pk!trade 10000 coins or pk!trade 293 121 484 which will add three pokemon to the trade.
p!buy idofshopitem
Buy something from the shop.
p!balance
Display your credit balance

----------- Market Commands (Should be DM'd when user uses pk!market help) -------------------
p!market search <Page number> | Show the requested page of the market.
p!market search <Page number> <Search Options> <Order Option> | Search the market.
p!market view <Pokémon ID> | View detailed information for a pokémon on the market.
p!market info <Pokémon ID> | Alternative to view.
p!market list <Pokémon Number> <Price> | List a pokémon on the market.
p!market buy <Pokémon ID> | Buy a pokémon from the market.
p!market remove <Pokémon ID> | Remove one of your pokémon from the market.
p!market listings <Page number> | Display the pokémon you have listed on the market.
Search Options:
--name <name> | Search for pokémon by name (not nickname).
--shiny | Search for shiny pokémon.
--level <level> | Search for pokémon by level.
--type <type> | Search for pokémon by type.
--price <price> | Search for pokémon with a specific price.
--hpiv <IV> | Search for pokémon by their HP IV.
--atkiv <IV> | Search for pokémon by their Attack IV.
--defiv <IV> | Search for pokémon by their Defense IV.
--spatkiv <IV> | Search for pokémon by their Special Attack IV.
--spdefiv <IV> | Search for pokémon by their Special Defense IV.
--speediv <IV> | Search for pokémon by their Speed IV.
When searching by IVs, you can use the ">" or "<" symbols to look for a range of IVs, like this: --hpiv > 27
You can use multiple search options in a single command.
Order Options:
--order lvl ascending/descending | Order results by pokémon level.
--order price ascending/descending | Order results by price.
--order iv ascending/descending | Order by the sum of the pokémon's IVs.
--order name ascending/descending | Order results by name.(Alphabetical Order)
Tip: As long as you type the start of ascending/descending, the bot will understand. Example: lvl a
When using options in a command, don't include "<" and ">"!

-------------- Server Admin Commands ------------
p!prefix
Change the bot's prefix for your server.
p!config
Displays the server's current settings.

(Will show something like the below)
Spawn Redirect |
Spawns are not redirected in this server.
Disabled Channels
There are no disabled channels in this server.

p!redirect
Redirect all wild pokémon in this server to a chosen channel.
p!channel
Enable/Disable commands and pokémon spawns in a channel.

--------- Misc Commands ---------

p!invite
Get the link to add Pokécentral to a server.
p!redeem
Exchange your redeems for pokémon or credits. - a user can type pk!redeem meloetta to be given a meloetta or they can type pk!redeemcoins and they will be given 50000 coins for each redeem
p!botinfo
Display some information about the bot.
p!ping
Display the bot's ping to Discord.

--------- Bot Owner Commands --------
pk!give

pk!give coins userhere amount
pk!give pokemon pokemonname level hp atk def spatk spdef speed
pk!give redeem @user amount
pk!give itemname @user amount
pk!restart - restarts bot
pk!delete - deletes user from the bot using their discord id
pk!godheal- pk!godheal @username - heals all pokemon owned by that user
pk!set spawn id percentagehere
pk!set redeem id amount (this specifies how many redeem tokens a user should have to be able to redeem that pokemon)
pk!spawn pokemonname level - allows bot owner to spawn a pokemon in any channel
pk!blacklist - blacklist a server from using the bot
pk!removeblacklist - removes a server from the blacklist
pk! add pokemonname imgurl hp atk def spatk spdef speed spawnrate - allows a bot owner to add a custom pokemon
pk!shop disable itemname
pk!shop enable itemname
pk!shop price itemname newprice
pk!r comamnds - refreshes command list

-------------- Evolution Items -----------------

We will need to discuss that so remind me
Refer to https://prowiki.info/index.php?title=Evolutionary_Items for a full list of items that will need coding in

When a pokemon does evolve, it will retain the same IVS and level but the base stats may change to those of the evolved pokemon but i imagine this will come from the API

------------- Moves & Battles ------------------

Each pokemon will be able to learn a specific set of moves. Some pokemon may be able to learn the same move, some may not. This may be able to be pulled from the API. If not, we may need a command for me to add this.

If a command was to be added, it would need to be pk!move add/remove pokemonname movename power accuracy movetype.

The below four links will show how battle damage should be calculated.

https://m.bulbapedia.bulbagarden.net/wiki/Nature - Nature doesn't really show damage calcs, if anything it shows stat multipliers which will affect the damage.
https://m.bulbapedia.bulbagarden.net/wiki/Statistic
https://bulbapedia.bulbagarden.net/wiki/Critical_hit
https://bulbapedia.bulbagarden.net/wiki/Damage

Trainers should be able to earn the following amount of coins from a battle

1-100 - loser
300 - 500 - winner

Each battle should also provide a pokemon with some additional xp

1 - 50 - losing pokemon
300 - 600 - winning pokemon

------------- Natures ----------------

Would be useful to have for the battling element of the bot as this will modify their XP. This is NOT essential but if you can do it, please do

---------- Pokemon Friendships -----------

A feature that i would like to add after the bot is completed later on,

https://bulbapedia.bulbagarden.net/wiki/Friendship - You could just add an item to the shop called a 'friendship braclet' which evolves the pokemon when the item is being held.

------------ Levelling up and earning coins --------------

The bot should monitor chat within the channels it can read. Each message a user sends in a channel with the bot in, will earn the user 'Trainer XP' as well as 'Pokemon XP'. Each time the user levels up, they will earn a set amount of coins whether it be level or pokemon level. A trainer will earn 10 coins x the level, if a user levels up from 1 - 2 they will earn 20 coins. If the user levels up from 19 - 20 they will earn 200 coins and so on. This information should be predefined in a database.

If a a trainer levels up rather than a pokemon, they will earn 100 coins per level so if a user levelled up from 1 - 2 they will earn 200 coins. If a user levels up from 31- 32 they will earn 3200


--------- Spawns ---------------

Spawns should happen at random intervals, anywhere between 30 seconds to 3 minutes. They should timeout and self delete after 30 minutes. We need to make sure that after the message is deleted, they cannot still catch the pokemon. Whether a pokemon should spawn or not should be based on their spawn percentage configurable by pk!set spawn name percentage. If the percentage is 0, it will not spawn. Anything higher, it could. If this could be a bulk command so i could do pk!set spawn pikachu poliwag togepi diancie fennekin 50
and it sets all of those to 50% spawn chance, that would be great. if not possible, it's not urgent.


------ Starters ---------

https://uk.ign.com/articles/2013/01/11/battle-of-the-pokemon-starters - All of those should be available stater pokemon
When a starter is selected, it should not return any statistic information. It should merely show a picture of the pokemon and show a message that says 'Congratulations, you have successfully chosen pokemonhere as your Starter Pokemon. Type pk!info 1 to view your first pokemon.' At that point, the statistic information will show.



---------- Moderation ----------

It might be wise to have a simple kick/ban command which is able to be used by server moderators, not urgent as can use dyno or something but could be useful.

----- Catching Pokemon ---------

Catching pokemon should be subject to rarity. The balls I would like to use are as followed

Pokeball - 60% common, 40% uncommon, 16% rare, 9%, 1% legendary - Cannot catch ultra
Greatball - 80% common, 70% uncommon, 20% rare, 5% legendary - cannot catch ultra
Ultraball - 80% common, 70% uncommon, 40% rare, 10% legendary - cannnot catch ultra
Masterball - can catch any pokemon
Beastball - The only ball that can catch any pokemon with rarity of 'Ultra' as well as a masterball - these can only catch pokemon with ultra rarity. - 50% ultra chance, 0% legendary chance, 80% chance everything else


------- Shop Items -----------

Prices will need to be configured when we work out how quick/how the coin collection will work.

== Evolution Items ==

https://prowiki.info/index.php?title=Evolutionary_Items - Those

== Pokeballs ==

Pokeball - 60% common, 40% uncommon, 16% rare, 9%, 1% legendary - Cannot catch ultra
Greatball - 80% common, 70% uncommon, 20% rare, 5% legendary - cannot catch ultra
Ultraball - 80% common, 70% uncommon, 40% rare, 10% legendary - cannnot catch ultra
Masterball - can catch any pokemon
Beastball - The only ball that can catch any pokemon with rarity of 'Ultra' as well as a masterball - these can only catch pokemon with ultra rarity.

== XP Modifiers ==

2x XP Modifier - lasts an hour
2x XP Modifier - lasts three hours
4x hp modifier - lasts 1 hour

== Stat Items ==

Please note a pokemons HP must be higher than 0 to use a potion. A revive must be used if the pokemon is under 1 HP. A user can use a potion after to increase the rest of the health

Potion - heals pokemon by 10% of max health
Super potion - heals pokemon by 30% of max health
Hyper potion - heals pokemon by 60% of max health
Max Potion - heals pokemon by 100% of max health
Revive - heals a pokemon by 50%
Max Revive - heals a pokemon by 100%

== Megafiers ==

Mega Y
Mega X
Primal
Mega

== Items not in shop but bot owner can give ==

Redeem - allows them to redeem a pokemon
Rare Candy - Allows a user to level up a pokemon by one level
Pokeheal - Allows a user to heal all of their pokemon to the top

== Specifying Bot Owner ==

Bot owner should be able to be configured in a configuration file
Can i specify more than one bot owner? or perhaps specify a channel that will allow the commands to be used by anyone with access to the channel?