README.md

Discord Tools

Discord Tools is a Visual Studio Code extension to code Discord bots more easily.

GitHub - VSC Marketplace - Open VSX

Supported Languages

• Javascript (Discord.js, Eris)
• Typescript (Harmony)
• Python (Discord.py, Pycord)
• Java (JDA)
• Soon...

Index

• Discord chat in VSCode
• Generate a template Discord bot
• Open the Discord bot Documentation with/without a research
• Javascript snippets
  • Discord.js
  • Eris
• Typescript snippets
  • Harmony
• Python snippets
  • Discord.py
  • Pycord
• Java snippets
  • JDA
• Themes
• Functionality table
• Contributing
• Release notes
• License

Features

[BETA] Discord chat in VSCode :

⚠️ This feature is currently in BETA, so it is possible that some features are not yet implemented and you may find bugs. If you find an error, thank you for reporting it here

⚠️ It seems that the way this extension works is not entirely within Discord's terms of service. See the Discord's terms for more. However, please note that this extension does not collect personal information and does not automatically respond to messages!

Installation

You must set up your personal Discord token with the command: Discord Chat: Set up your personal Discord token (Ctrl+Shift+P to open the Command palette) You can find your Discord token with the command: Discord Chat: Grab your personal Discord Token. However, if this does not work, you can follow this tutorial

Features

• Discord Chat
• Navigation tree through the servers (DM will be supported in the future)
• Parameters

Commands

• Discord Chat: Set up your personal Discord token
• Discord Chat: Start the Discord chat
• Discord Chat: Grab your personal Discord Token
• Discord Chat: Set up if the Discord chat should start when VSCode is opened
• Discord Chat: Open the Discord Chat (must be started before)
• Discord Chat: Reload the Discord Bot

Preview

To do (soon)

• Fix small chat glitches
• Refresh the Navigation tree when the chat is reload
• Embed support
• File support
• Private message support

Generate a template Discord bot :

• Open the command palette (Ctrl+Shift+P) and choose : Generate a <language> template bot (Discord.<language>) (not available for Harmony and Eris)

⚠️ A folder must be opened in VSCode to execute this command

⚠️ Maven must be installed to build the JDA tempate

Open the Discord bot Documentation with/without a research :

• Open the command palette (Ctrl+Shift+P) and choose : Open the Discord bot Documention
• Shortcut : Ctrl+Alt+D
• JDA, Harmony and Eris documentions do not allow to make a research
• You can change the wrapper in the extension settings if it is not the right documentation that opens by default

⚠️ A folder must be opened in VSCode to execute this command

Generate code easily :

Available Snippets

Javascript (Discord.js) :

• djs.index : Create a basic Discord bot index.js file.
• djs.cmd : Create a basic Discord command.
• djs.cmd+ : Create a complex Discord command.
• djs.embed : Create a basic Discord embed.
• djs.embed+ : Create a complex Discord embed.
• djs.message : Create a default Discord bot message event.
• djs.guildmemberadd : Create a default Discord bot guildMemberAdd event.
• djs.guildmemberremove : Create a default Discord bot guildMemberRemove event.
• djs.guildcreate : Create a default Discord bot guildCreate event.
• djs.guilddelete : Create a default Discord bot guildDelete event.
• and 47 other snippets...

Javascript (Eris) :

• eris.index : Create a basic Discord bot index.js file.
• eris.cmd : Create a basic Discord command.
• eris.cmd+ : Create a complex Discord command.
• eris.embed : Create a basic Discord embed.
• eris.embed+ : Create a complex Discord embed.
• eris.message : Create a default Discord bot message event.

Javascript Preview :

Typescript (Harmony) :

• hy.index : Create a basic Discord bot index.ts file.
• hy.cmd : Create a basic Discord command.
• hy.cmd+ : Create a complex Discord command.
• hy.embed : Create a basic Discord embed.
• hy.embed+ : Create a complex Discord embed.
• hy.message : Create a default Discord bot message event.

Python (Discord.py) :

• dpy.main : Create a basic Discord bot main.py file.
• dpy.cog : Create a basic Discord cog.
• dpy.cmd : Create a basic Discord command.
• dpy.cmd+ : Create a complex Discord command.
• dpy.embed : Create a basic Discord embed.
• dpy.embed+ : Create a complex Discord embed.
• dpy.onmessage : Create a default Discord bot on_message event.
• dpy.onmemberjoin : Create a default Discord bot on_member_join event.
• dpy.onmemberremove : Create a default Discord bot on_member_remove event.
• dpy.onguildjoin : Create a default Discord bot on_guild_join event.
• dpy.onguildremove : Create a default Discord bot on_guild_remove event.
• and 59 other snippets...

Python (Pycord) :

• pyc.main : Create a basic Discord bot main.py file.
• pyc.slash : Create a basic Discord slash command.
• pyc.cmd : Create a basic Discord command.
• pyc.cmd+ : Create a complex Discord command.
• pyc.embed : Create a basic Discord embed.
• pyc.embed+ : Create a complex Discord embed.
• pyc.onmessage : Create a default Discord bot on_message event.
• pyc.onmemberjoin : Create a default Discord bot on_member_join event.
• pyc.onmemberremove : Create a default Discord bot on_member_remove event.
• pyc.onguildjoin : Create a default Discord bot on_guild_join event.
• pyc.onguildremove : Create a default Discord bot on_guild_remove event.
• and 60 other snippets...

Python Preview :

Java (JDA) :

• jda.main : Create a basic Discord bot main function.
• jda.cmd : Create a basic Discord command.
• jda.embed : Create a basic Discord embed.
• jda.embed+ : Create a complex Discord embed.
• jda.onmessagereceived : Create a default Discord bot on.

Java Preview :

Discord Theme (Dark version)

Works for Python and JavaScript Activate the theme : CTRL + K + CTRL + T and choose Discord Theme (Dark)

Preview :

Functionality table

	Template	Doc	Doc searcher	Snippets
Discord.js	✅	✅	✅	✅
Eris	❌	✅	❌	✅
Harmony	❌	✅	❌	✅
Discord.py	✅	✅	✅	✅
Pycord	❌	✅	✅	✅
JDA	✅	✅	❌	✅

Discord

Join the Discord server!

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

Release Notes

1.5.0 (Latest update)

• Add the Pycord support
• Fix Discord.js documentation searcher
• Improve the documentation system

1.4.3

• New JDA bot template
• Improve of the Discord.py template system
• Update of the Discord.py template

1.4.2

• The servers in the Discord chat navigation tree are collapsed by default
• Custom emojis support

1.4.1

• Small fix

1.4.0

• Discord chat [BETA]
• JSON Discord Theme fixed
• Log system

1.3.3

• New Discord Theme (Javascript, Python)

1.3.2

• Update of the Discord.js snippets
• Update of the Discord.js template
• Fix an issue with the discord-tools.openDiscordDoc command
• Several small corrections

1.3.1

• Update of the Discord.js template
• Update of the Discord.py template

1.3.0

• Add the Harmony support

1.2.2

• Fix the python template

1.2.1

• Fix workspace error
• Small corrections

1.2.0

• Add the Eris support
• Add the definition of python parameters
• Fix small python snippets

1.1.6

• Several python snippet corrections
• Correction of the python template

1.1.5

• New snippet aliases
• New snippet choices
• Several corrections

1.1.4

• New command : open the Discord bot Documentation with/without a research (works with Discord.py, Discord.js, JDA)

1.1.3

• New Discord.js bot template
• New bot template generator system
• New auto package downloader
• Few small updates

1.1.2

• 48 new Discord.js events added
• Addition of capital letters to Discord.py events
• Few small updates

1.1.1

• Change of snippet prefixes to dpy (Discord.py), djs (Discord.js) and jda (JDA)
• 59 new Discord.py events added

1.1.0

• New language supported : Java (JDA)

1.0.1

• Several corrections

1.0.0

• Initial release

License

This project is under GPLv3.