- 1. Resumé
- 2. Authors
- 3. Dependencies
- 4. Quick Setup
- 5. General Overview
- 6. Changelog
- 7. Motivation
- 8. Acknowledgements
- 9. License
Instead of opening the web browser to search about an item, why don't just type-and-search directly from Discord? As the name suggests, the bot created using Discord's Python API intend to be a Discord built-in information wiki for every Terraria player. Its content is based on general item/NPC information and its respective crafting recipes, grab bag drops, enemy drops and selling offers from NPCs, as well as having some extra commands about rarity tiers and Angler quests, supposing to have everything a Terraria player would like to know while playing.
All the bot's source code were made by me and Andrei Alisson as a personal project.
Discord Terraria Bot uses some specific Python libraries to work. In order to proceed with the setup to host in your own machine (if you want to), you may need to install some of them. Otherwise, just go directly to 4. Quick Setup section.
From the beggining, you may also need to install a Python package manager in order to proceed with the libraries installation if you don't have one already. Here we'll be using the awesomeness of pip, which can be installed via
sudo apt install python3-pip
in any Ubuntu-based distribution.
All the libraries can be installed using pip running the following command from any Linux-based shell
pip install discord.py levenshtein colorthief colormap
Similar to Linux, Python needs a package manager in order to install each one of the libraries and we'll be using pip as well. In Windows, save get-pip.py in any directory and run the script using python get-pip.py (assuming that you already have Python installed) on the Windows Powershell, from the directory that the file has been saved.
The next one will be simple: We can use
pip install discord.py levenshtein colorthief colormap
into the Windows Powershell to install the remaining dependencies.
The bot's main instance is already hosted 24/7 and can be added to any Discord server with this invite link.
Everything that the bot uses to work can be found here. The main bot token was obviously taken away to prevent
further problems with the main bot instance (and the old token was refreshed of course). If you wish to host
the bot in your personal machine for any reason, take a look inside main_bot.py.
The entire list of possible commands and flags can be shown with t.help. Some of them can be pointed here, such as:
t.item: Shows every possible information of an item, such as its gerenal stats, crafting recipes and drop sources.t.list: Points every possible item/NPC in data base starting with the command argument.t.rarity: Shows a description list about each item rarity tier in Terraria (it can also be specified by passing the rarity tier as argument!).t.npc: Shows every information about some specific in-game NPC, such as its conditions to spawn, its inventory and its drops.t.craft: Points each crafting recipe for the item given in the command argument.
And so on.
Changes and updates can be tracked from the Changelog file!
It was such a great experience working on this project aside with Andrei, from the data scrap to the bot development. As they say, practice makes perfect and I think we both are going further with our main goal as developers: being able to solve problems and work with creativity.
It's also important to point how this project reflects my first footsteps inside the development of a bigger project. If you think knowledge is never a waste, so do I. :)
- Official Terraria Gamepedia Wiki, where all those data files come from.
- Andrei Alisson, my code mate.
- Noas with his gorgeous drawing skills.
- Heroku, the web hoster we're using to keep it up 24/7.
MIT.