hangman-discord
v1.4.3
Published
Hangman module For discord.js bots
Downloads
16
Readme
Whats new in 1.4.3
- Upgraded from discord.js v12.5 to v13
- The entire package was rewritten
1.4.2
- Added github page https://github.com/dionsyran2/hangman-discord
- For issues please go here https://github.com/dionsyran2/hangman-discord/issues
Table Of Contents
1. How it works (How to use a bot with this module)
2. Documentation
3. Example bot code
1. How it works
Singleplayer
Run the command that starts the game, in my case its !start
The module will ask you to choose mode, say singleplayer in the chat
Please note that depending on your or your hosting provider's network speed the bot may be a bit slow
After the bot sends the message you will be able to type letters or words! If you would like to know the game basics click here
Multiplayer
- Run the command that starts the game, in my case its !start
- The module will ask you to choose mode, say multiplayer in the chat
- The bot will send you a Direct Message (DM) asking you to say a word
- After that all the other members will have to find the word!
Documentation
First you will have to require the module
const hangman = require("hangman-discord")
Start a game
hangman.start(client, message, discord)
End a game
hangman.stop(client, message)
Send message every time the game ends or someone wins
Hangman.on("wordFound", (message) => {
message.reply("Correct! To start another round please type !start")
})
Hangman.on("gameEnded", (message) => {
message.channel.send("No one found the word")
})
Hangman.on("gameEndedSingle", (message) => {
message.channel.send(`Sorry, <@${message.author.id}> You did not find the word!`)
})
Hangman.on("gameStop", (message) => {
message.channel.send("The game was ended using !stop")
})
Send message to tell the user to select a gamemode This is required if you want the user to get asked to select gamemode else it will just time out as it will get no response!
Hangman.on("select", (message) => {
message.channel.send("Choose Gamemode: **singleplayer** or **multiplayer**")
})
Other Events
Hangman.on("gameExists", (message) => {
message.channel.send("There is already a game running in this server!")
})
Hangman.on("wordSet", (word) => {
console.log(`Current word set to: ${word}`)
})
Hangman.on("cannotDM", (message) => {
message.reply("It looks like i cannot dm you :(")
})
Hangman.on("wordSelectTimeout", (message) => {
message.member.send("Timeout")
})
Functions:
start(client, message, discord) This will start a game
stop(client, message) This will end a game, if there is one.
Events:
selectTimeout (message) This will get called if no mode is selected within 15 seconds when using the
hangman.start(...)
.
select (message) This will get called when the
hangman.start(...)
runs.
wordFound (message) As its name says, this will get called once someone finds the word.
gameEnded (message) This gets called when the game ends, with no winner.
gameEndedSingle (message) The same as
gameEnded
but this is for singleplayer.
gameExists (message) This gets called when
hangman.start(...)
runs but there is already an active game in the server.
cannotDM (message) This gets called if the module cannot DM (Direct Message) a user.
gameStop (message) This gets called when
hangman.stop(...)
runs and there is an active game.
noGame(message) This gets called when
hangman.stop(...)
is called but there is no active game.
wordSet (word) This will get called when the word is set.
Code Example:
const Hangman = require("hangman-discord")
const discord = require("discord.js")
const Intents = new discord.Intents([
"GUILDS",
"GUILD_MESSAGES",
"DIRECT_MESSAGES",
]);
const client = new discord.Client({ intents: Intents })
let config = {
prefix: "!"
}
client.on("messageCreate", (message) => {
if (message.mentions.users.first() === client.user) {
message.channel.send("My prefix is " + config.prefix)
return
}
if (!message.content.startsWith(config.prefix) || message.author.bot) return;
const args = message.content.slice(config.prefix.length).trim().split(/ +/);
const command = args.shift().toLowerCase();
if (command == "start") {
Hangman.start(client, message, discord, args)
}
if (command == "end") {
Hangman.stop(client, message)
}
})
client.on("ready", () => {
console.log("Ready")
})
Hangman.on("selectTimeout", (message) => {
message.channel.send("Timeout!")
})
Hangman.on("select", (message) => {
message.channel.send("Choose Gamemode: **singleplayer** or **multiplayer**")
})
Hangman.on("wordFound", (message) => {
message.channel.send(`<@${message.author.id}> You found the word! To start another round please type !start`)
})
Hangman.on("gameEnded", (message) => {
message.channel.send("No one found the word")
})
Hangman.on("gameEndedSingle", (message) => {
message.channel.send(`Sorry, <@${message.author.id}> You did not find the word!`)
})
Hangman.on("wordSet", (word) => {
//For Testing!!!!!!
console.log(`Current word set to: ${word}`)
})
Hangman.on("gameExists", (message) => {
message.channel.send("There is already a game running in this server!")
})
Hangman.on("cannotDM", (message) => {
message.reply("It looks like i cannot dm you :(")
})
Hangman.on("wordSelectTimeout", (message) => {
message.member.send("Timeout")
})
Hangman.on("gameStop", (message) => {
message.channel.send("The game was ended using !stop")
})
Hangman.on("noGame", (message) => {
message.member.send("There is no game active right now!")
})
client.login("Token Goes Here")