Discord Wheel Bot

A Discord bot that manages a spin-the-wheel list for random selection, built with TypeScript and discord.js.

Invite Link: https://discord.com/oauth2/authorize?client_id=1437176399373930618&permissions=2147503104&integration_type=0&scope=bot+applications.commands

Table of Contents

• Commands
  • Add
  • List
  • Spin
  • Reset
  • Remove
  • Shuffle
• Installation
• Creating Issues

Commands

/add

Description

Adds one or more items to the wheel. Items should be space-separated.

Usage

/add <items>

Parameters

• <items> — The items you want to add, separated by spaces.

Example

/add apple banana cherry

✅ Adds apple, banana, and cherry to the wheel.

---

/list

Description

Shows all current items currently on the wheel.

Usage

/list

🧾 Displays all items with their corresponding index numbers.

---

/spin

Description

Spins the wheel and randomly selects one item. The selected item is removed from the list after spinning.

Usage

/spin

🎡 Example Output:

🎡 The Wheel has spoken. The chosen one is: banana. Remaining: apple, cherry

---

/reset

Description

Resets the wheel, removing all items.

Usage

/reset

🔄 Clears the wheel completely.

---

/remove

Description

Removes a specific item from the wheel by name.

Usage

/remove <item>

Parameters

• <item> — The name of the item you want to remove.

Example

/remove banana

🗑️ Removes banana from the wheel.

---

/shuffle

Description

Shuffles all items in the wheel randomly.

Usage

/shuffle

🔀 Reorders the items to randomize their positions.

Installation

Clone the repository:

git clone https://github.com/CShatto99/discord-wheel-bot.git
# or
gh repo clone CShatto99/discord-wheel-bot

Install the dependencies:

npm install

In the root of the project, rename .env.example to .env and fill out the empty environment variables.

Run the development server:

npm run dev

Creating Issues

If you encounter any bugs, issues, or have suggestions for improvement, feel free to create a new issue on this repository using this link.

When creating an issue, please include:

• The command you were using
• A short description of what happened
• (Optional) Console logs or screenshots

License

This project is license under the MIT License.