mirror of
https://github.com/discordeno/discordeno.git
synced 2026-05-30 15:30:07 +00:00
75 lines
2.6 KiB
Markdown
75 lines
2.6 KiB
Markdown
---
|
|
sidebar_position: 3
|
|
---
|
|
|
|
# Getting Started
|
|
|
|
Discordeno aims for a simple, easy and stress-free interaction with the Discord API. Always supporting the latest
|
|
version to ensure stability, consistency and the best developer experience. This guide serves as the purpose for
|
|
introducing Discordeno to developers.
|
|
|
|
## Requirements
|
|
|
|
- **Deno 1.0** or higher
|
|
|
|
## Creating your First Discord Bot Application
|
|
|
|
Plenty of guides are available on how to create a Discord Bot Application.
|
|
|
|
1. [Creating an Application](https://discord.com/developers/applications) on the Developer Portal, name something cool
|
|
and pick a sweet icon!
|
|
2. After creating an application. Save the **Client ID.** Thats the unique identifier for a Discord Bot.
|
|
3. Now, go and create a bot by clicking the **Bot** tab. You will see a **Token** section and thats the Discord Bot's
|
|
token. **Make sure you don't share that token with anyone!!!**
|
|
4. Invite the bot to the server, you can use the
|
|
**[Discord Permissions Calculator](https://discordapi.com/permissions.html#0)** for creating the invite link with
|
|
custom permissions. By default, `0` means no permissions and `8` means Administrator.
|
|
|
|
Now you've created an Application but it will need some code in order for it to be online. Thats when Discordeno comes
|
|
in handy!
|
|
|
|
> Make sure you store your tokens in a file that is NOT deployed by adding it to the .gitignore file. **Don't share your
|
|
> bot token with anybody.**
|
|
|
|
## Installation
|
|
|
|
You can install Discordeno by importing:
|
|
|
|
```ts
|
|
import { startBot } from "https://deno.land/x/discordeno@16.0.0/mod.ts";
|
|
```
|
|
|
|
## Example Usage
|
|
|
|
Starting with Discordeno is very simple, you can start from scratch without any templates/frameworks: Add this snippet
|
|
of code into a new TypeScript file:
|
|
|
|
```ts
|
|
import { createBot, Intents, startBot } from "https://deno.land/x/discordeno/mod.ts";
|
|
|
|
startBot(
|
|
createBot({
|
|
token: "BOT TOKEN",
|
|
intents: Intents.Guilds | Intents.GuildMessages,
|
|
events: {
|
|
ready() {
|
|
console.log("Successfully connected to gateway");
|
|
},
|
|
messageCreate(bot, message) {
|
|
if (message.content === "!ping") {
|
|
bot.helpers.sendMessage(message.channelId, { content: "Pong using Discordeno!" });
|
|
}
|
|
},
|
|
},
|
|
}),
|
|
);
|
|
```
|
|
|
|
## Tutorials
|
|
|
|
Below you will find youtube playlists that display channels using Discordeno for their tutorials.
|
|
|
|
- [Making a Discord bot with Deno and Discordeno](https://web-mystery.com/articles/making-discord-bot-deno-and-discordeno)
|
|
- [Running a Discord bot written using Deno in Docker](https://web-mystery.com/articles/running-discord-bot-written-deno-docker)
|
|
- [Discordeno Bot Tutorials (YouTube)](https://youtu.be/rIph9-BGsuQ)
|