Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/darkempire78/discord-tools

VSCode extension allowing the integration of a Discord chat, bot templates, snippets, themes and more!
https://github.com/darkempire78/discord-tools

discord discord-bot discord-java discord-js discord-py discordbot discordjs eris eris-discord eris-discord-bot hacktoberfest jda jda-bot jda-discord jda-discord-bot pycord template-bot typescript visual-studio-code visual-studio-code-extension

Last synced: about 1 month ago
JSON representation

VSCode extension allowing the integration of a Discord chat, bot templates, snippets, themes and more!

Host: GitHub
URL: https://github.com/darkempire78/discord-tools
Owner: Darkempire78
License: gpl-3.0
Created: 2020-12-21T18:13:59.000Z (almost 4 years ago)
Default Branch: master
Last Pushed: 2023-11-14T23:28:49.000Z (about 1 year ago)
Last Synced: 2024-10-12T02:41:35.573Z (about 1 month ago)
Topics: discord, discord-bot, discord-java, discord-js, discord-py, discordbot, discordjs, eris, eris-discord, eris-discord-bot, hacktoberfest, jda, jda-bot, jda-discord, jda-discord-bot, pycord, template-bot, typescript, visual-studio-code, visual-studio-code-extension
Language: JavaScript
Homepage: https://marketplace.visualstudio.com/items?itemName=Darkempire78.discord-tools
Size: 9.08 MB
Stars: 146
Watchers: 5
Forks: 22
Open Issues: 9
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

README

        ![CodeFactor](https://img.shields.io/codefactor/grade/github/Darkempire78/Discord-Tools?style=for-the-badge) ![Visual Studio Marketplace](https://img.shields.io/visual-studio-marketplace/v/Darkempire78.discord-tools?style=for-the-badge)  

# Discord Tools

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

[**GitHub**](https://github.com/Darkempire78/Discord-Tools) - [**VSC Marketplace**](https://marketplace.visualstudio.com/items?itemName=Darkempire78.discord-tools) - [**Open VSX**](https://open-vsx.org/extension/Darkempire78/discord-tools/1.4.3)

## Supported Languages

- [x] Javascript ([**Discord.js**](https://discord.js.org/#/), [**Eris**](https://abal.moe/Eris/))

- [x] Typescript ([**Harmony**](https://harmony.mod.land/))

- [x] Python ([**Discord.py**](https://discordpy.readthedocs.io/en/latest/), [**Pycord**](https://docs.pycord.dev/en/master/))

- [x] Java ([**JDA**](https://github.com/DV8FromTheWorld/JDA))

- [ ] Soon...

## Index

- [**Discord chat in VSCode**](##beta-discord-chat-in-vscode-)

- [**Generate a template Discord bot**](#generate-a-template-discord-bot-)

- [**Open the Discord bot Documentation with/without a research**](#open-the-discord-bot-documentation-withwithout-a-research-)

- [**Javascript snippets**](#available-snippets)

  - [Discord.js](#javascript-discordjs-)

  - [Eris](#javascript-eris-)

- [**Typescript snippets**](#typescript-harmony-)

  - [Harmony](#typescript-harmony-)

-  [**Python snippets**](#python-discordpy-)

    - [Discord.py](#python-discordpy-)

    - [Pycord](#python-pycord-)

-  [**Java snippets**](#java-jda-)

    - [JDA](#java-jda-)

- [**Themes**](#discord-theme-dark-version)

- [**Functionality table**](#functionality-table)

- [**Contributing**](#contributing)

- [**Release notes**](#release-notes)

- [**License**](#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](https://github.com/Darkempire78/Discord-Tools/issues/new)**

⚠️ It seems that the way this extension works is not entirely within Discord's terms of service. See the [Discord's terms](https://discord.com/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](https://www.youtube.com/watch?v=YEgFvgg7ZPI)

#### 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  template bot (Discord.)` (not available for Harmony and Eris)

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

⚠️ [Maven](https://maven.apache.org/) 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](https://discord.js.org/#/)) :

- `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](https://abal.moe/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](https://harmony.mod.land/)) :

- `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](https://discordpy.readthedocs.io/en/latest/)) :

- `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](https://docs.pycord.dev/en/master/)) :

- `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](https://github.com/DV8FromTheWorld/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!

[![](https://i.imgur.com/UfyvtOL.png)](https://discord.gg/sPvJmY7mcV)

## 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](https://github.com/Darkempire78/Raid-Protect-Discord-Bot/blob/master/LICENSE).