An innovative Bot for playing Tic Tac Toe on Discord!
Created with discord.js.
"Discord TicTacToe" is a self-hosted NodeJS bot which allows you to play the popular TicTacToe game on Discord.
Invite your friends or play against our robot, a fearsome opponent. Use /tictactoe command to challenge someone else
and use buttons to play, so simple! Works out-of-the-box, no configuration needed.
If you have a problem when using the bot, or you want to propose a new feature, feel free to open an issue.
Have fun!
Requirements
Before installing the bot, you need to create your own Discord Application. Then, you can install the bot via Docker or npm (check below!). If you are not a programmer, I recommend you to opt for Docker because its the easiest solution.
⚠️ Make sure your Discord bot has these permissions in all channels where games can be played: "Read message history", "Send messages", "View channel", "Application commands" or "Add reactions" depending on what you plan to use.
Installation
The module is suitable for discord.js v12, v13 and v14. Check the table below to see which version meets your needs.
| discord.js | Node.JS | Module version | Status | NPM package | Docker image |
|---|---|---|---|---|---|
| v14.* | 16.9+ | v4.* | Active | discord-tictactoe@^4 | utarwyn/discord-tictactoe@4 |
| v13.* | 16.6+ | v3.* | Active | discord-tictactoe@^3 | utarwyn/discord-tictactoe@3 |
| v12.* | 14+ | v2.* | Legacy | discord-tictactoe@^2 | utarwyn/discord-tictactoe@2 |
The bot works out-of-the-box. But if you want to configure it, check config.example.json file in the config folder.
🔥 Discord buttons are only supported from v3 of the module.
Running via Docker
- Make sure to have Docker installed.
- Start Docker container based on one of our DockerHub images using an API token:
docker run -e TOKEN=YOUR_TOKEN utarwyn/discord-tictactoe@4 - You can pass options directly with
-e OPTION_NAME=option_valueor use the option-v $(pwd)/config/config.json:/app/config/config.jsonto load an entire config file.
Running via Node.js
- Check with
node -vthat you are running appropriate Node.js version. - Install the project from npm:
npm install discord-tictactoe@^4oryarn add discord-tictactoe@^4 - Import module into your script:
const TicTacToe = require('discord-tictactoe');
- Check usage examples in this wiki page.
Setup slash command ✨
Slash command are enabled by default starting from v3!
Just mention the bot with tttdeploy somewhere in your server to install it (admin only).
License
"Discord TicTacToe" is open-sourced software licensed under the Apache-2.0 license.