https://github.com/loosedwhale/rcxpn-discord-bot
I'm simply following discords instructions on how to make a .js bot.
https://github.com/loosedwhale/rcxpn-discord-bot
discord discord-bot discord-js discordapp
Last synced: about 2 months ago
JSON representation
I'm simply following discords instructions on how to make a .js bot.
- Host: GitHub
- URL: https://github.com/loosedwhale/rcxpn-discord-bot
- Owner: LoosedWhale
- License: mit
- Created: 2023-02-11T16:47:12.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-02-11T16:59:09.000Z (over 2 years ago)
- Last Synced: 2025-02-13T23:45:06.559Z (4 months ago)
- Topics: discord, discord-bot, discord-js, discordapp
- Language: JavaScript
- Homepage:
- Size: 1.09 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# RCXPN
Discord bot for learning discord.js and bot development. \
Used Discord.py for bots in the past but wanted to try this. \
Note that I'm following discords instructions
# Getting Started app for Discord
This project contains a basic rock-paper-scissors-style Discord app written in JavaScript, built for the [getting started guide](https://discord.com/developers/docs/getting-started).
> ✨ A version of this code is also hosted **[on Glitch 🎏](https://glitch.com/~getting-started-discord)** and **[on Replit 🌀](https://replit.com/github/discord/discord-example-app)**
## Project structure
Below is a basic overview of the project structure:
```
├── examples -> short, feature-specific sample apps
│ ├── button.js
│ ├── command.js
│ ├── modal.js
│ ├── selectMenu.js
├── .env.sample -> sample .env file
├── app.js -> main entrypoint for app
├── commands.js -> slash command payloads + helpers
├── game.js -> logic specific to RPS
├── utils.js -> utility functions and enums
├── package.json
├── README.md
└── .gitignore
```
## Running app locally
Before you start, you'll need to install [NodeJS](https://nodejs.org/en/download/) and [create a Discord app](https://discord.com/developers/applications) with the proper permissions:
- `applications.commands`
- `bot` (with Send Messages enabled)
Configuring the app is covered in detail in the [getting started guide](https://discord.com/developers/docs/getting-started).
### Setup project
First clone the project:
```
git clone https://github.com/discord/discord-example-app.git
```
Then navigate to its directory and install dependencies:
```
cd discord-example-app
npm install
```
### Get app credentials
Fetch the credentials from your app's settings and add them to a `.env` file (see `.env.sample` for an example). You'll need your app ID (`APP_ID`), server ID (`GUILD_ID`), bot token (`DISCORD_TOKEN`), and public key (`PUBLIC_KEY`).
Fetching credentials is covered in detail in the [getting started guide](https://discord.com/developers/docs/getting-started).
> 🔑 Environment variables can be added to the `.env` file in Glitch or when developing locally, and in the Secrets tab in Replit (the lock icon on the left).
### Run the app
After your credentials are added, go ahead and run the app:
```
node app.js
```
> ⚙️ A package [like `nodemon`](https://github.com/remy/nodemon), which watches for local changes and restarts your app, may be helpful while locally developing.
### Set up interactivity
The project needs a public endpoint where Discord can send requests. To develop and test locally, you can use something like [`ngrok`](https://ngrok.com/) to tunnel HTTP traffic.
Install ngrok if you haven't already, then start listening on port `3000`:
```
ngrok http 3000
```
You should see your connection open:
```
Tunnel Status online
Version 2.0/2.0
Web Interface http://127.0.0.1:4040
Forwarding http://1234-someurl.ngrok.io -> localhost:3000
Forwarding https://1234-someurl.ngrok.io -> localhost:3000
Connections ttl opn rt1 rt5 p50 p90
0 0 0.00 0.00 0.00 0.00
```
Copy the forwarding address that starts with `https`, in this case `https://1234-someurl.ngrok.io`, then go to your [app's settings](https://discord.com/developers/applications).
On the **General Information** tab, there will be an **Interactions Endpoint URL**. Paste your ngrok address there, and append `/interactions` to it (`https://1234-someurl.ngrok.io/interactions` in the example).
Click **Save Changes**, and your app should be ready to run 🚀
## Other resources
- Read **[the documentation](https://discord.com/developers/docs/intro)** for in-depth information about API features.
- Browse the `examples/` folder in this project for smaller, feature-specific code examples
- Join the **[Discord Developers server](https://discord.gg/discord-developers)** to ask questions about the API, attend events hosted by the Discord API team, and interact with other devs.
- Check out **[community resources](https://discord.com/developers/docs/topics/community-resources#community-resources)** for language-specific tools maintained by community members.