ed-george / tcgenius

TCGenius is a Pokémon Trading Card Discord bot written in Kotlin

---

---

Commands 📣

• !help - Display available commands

• !set

  • !set - Get list of all sets
  • !set SEARCHTERM - List of sets matching the search term

• !card

  • !card SEARCHTERM - Card matching search term
  • !card [CARD-ID] - Card matching ID (e.g. !card [xy1-1])

Add to Discord 🤖

Automatically

To add this bot to your Discord server click here and authorise the bot to post messages, embed links and read channel messages.

If you use and enjoy this bot on your server, please consider contributing a small donation to the upkeep.

Manual Build

TCGenius requires Java 1.8 to run.

To create and run your own version of TCGenius, follow the steps below.

• Fork this project
• Create a new application on Discord
• Create a server.properties file within /src/resources
• Add values for server.token and server.ownerid within the file. These values can be found from your newly Discord app's dashboard
• Within the project's root folder, run the following within a terminal window
  • Windows: gradlew shadowJar
  • Mac / Linux: ./gradlew shadowJar
• Copy the generated .jar file from build/libs and run it using java -jar FILENAME.jar
• 🎉 Enjoy!

Contributing 🛠

I welcome contributions and discussion for new features or bug fixes. It is recommended to file an issue first to prevent unnecessary efforts, but feel free to put in pull requests in the case of trivial changes. In any other case, please feel free to open discussion and I will get back to you when possible.

Thanks 💕

This project uses the Kotlin Pokemon TCG SDK for pokemontcg.io

Logo designed by Ray Cheung 🙌

tcgenius's Issues

Show Ability / Poke Power / Poke Body name

Please describe the feature/solution you would like to see
An Ability / Poke Power / Poke Body name should be displayed with the accompanying text

Describe how the solution should work
Example: For Shaymin EX's ability, the title should read "Ability - Set Up"

Describe any alternatives you've considered
N/A

Additional context
N/A

The bot encounters an error for Base Set Charizard cards

Describe the bug
Requesting certain cards, e.g. Base Set Charizard, causes an exception to be thrown by the bot

To Reproduce
Run the command !card [base1-4] or !card [base4-4]

Expected behavior
The requested card should be outputted correctly

Log Output:

java.lang.IllegalArgumentException: Parameter specified as non-null is null: method io.pokemontcg.model.Ability.<init>, parameter type
...
at uk.breedrapps.command.SearchCardCommand.searchForTerm(SearchCardCommand.kt:72)
at uk.breedrapps.command.base.BaseCommand.execute(BaseCommand.kt:31)

Screenshots
N/A

Additional context
N/A

Searching for a card should return a list of relevant cards

Please describe the feature/solution you would like to see
Searching for a card should return a list of relevant cards

Describe how the solution should work
!card CARDNAME should return a list of relevant cards, their sets, number and ids.

Describe any alternatives you've considered
N/A

Additional context
If the list is too long, it may be worth PM-ing to avoid spam

Use energy symbols within card text

Please describe the feature/solution to a problem you would like to see
References to energy within a Pokemon's text should use the energy emote

Describe a solution you'd like
When displaying a card with text that contains a reference to energy symbols, e.g. Shaymin [pl1-15], either in the attack, poke power, poke body, ability or other; The relevant energy emote should be displayed in place of the text

Describe any alternatives you've considered
N/A

Additional context
N/A

Weakness incorrectly displaying for multi-weakness cards

Describe the bug
Cards with multiple weaknesses are incorrectly showing multiple energy emotes, when they should display a single emote only.

To Reproduce
View any LEGEND card with multiple weakness, e.g. Kyogre & Groudon LEGEND !card [hgss3-88]

Expected behavior
The energy emote should only display once per weakness

Log Output:
Any log output produced that helps identify the problem.

Screenshots

Additional context
N/A

Show error message on unsuccessful/invalid command

Please describe the feature/solution you would like to see
When a user enters an invalid command or a command that returns no results, no acknowledgement of this is shown to the user

Describe how the solution should work
On entering a command that is invalid or returns no results, the bot should reply to the user with a message explaining the error

Describe any alternatives you've considered
Replying the user through a 'reaction' might save on spam

Additional context
N/A

Remove '1' from single attributes

Describe the bug
Cards that have only a single field for an attribute such as 'Text', 'Attack' and 'Weakness', currently display a '1' after the attribute name. e.g. 'Attack 1'

To Reproduce
Lopunny (Flashfire 85) displays this behaviour !card [xy2-85]

Expected behavior
If an attribute has multiple, use numbered convention "Attack 1, Attack 2..."; Remove otherwise.

Log Output:
N/A

Screenshots

Additional context
N/A