');\r\n\t\tthis.room.add(\"The game of hangman was ended.\");\r\n\t\tthis.room.game = null;\r\n\t}\r\n\r\n\tfinish() {\r\n\t\tthis.room.uhtmlchange(`hangman${this.gameNumber}`, '
(The game of hangman has ended – scroll down to see the results)
');\r\n\t\tthis.room.add(`|html|${this.generateWindow()}`);\r\n\t\tthis.room.game = null;\r\n\t}\r\n\tstatic save() {\r\n\t\tFS(HANGMAN_FILE).writeUpdate(() => JSON.stringify(hangmanData));\r\n\t}\r\n\tstatic getRandom(room: RoomID, tag?: string) {\r\n\t\tif (!hangmanData[room]) {\r\n\t\t\thangmanData[room] = {};\r\n\t\t\tthis.save();\r\n\t\t}\r\n\t\tlet phrases = Object.keys(hangmanData[room]);\r\n\t\tif (!phrases.length) throw new Chat.ErrorMessage(`The room ${room} has no saved hangman words.`);\r\n\t\tif (tag) {\r\n\t\t\ttag = toID(tag);\r\n\t\t\tphrases = phrases.filter(key => hangmanData[room][key].tags?.map(toID).includes(tag as ID));\r\n\t\t\tif (!phrases.length) {\r\n\t\t\t\tthrow new Chat.ErrorMessage(`No terms found with tag ${tag}`);\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\tconst shuffled = Utils.randomElement(phrases);\r\n\t\tconst entry = hangmanData[room][shuffled];\r\n\t\treturn {\r\n\t\t\tquestion: shuffled,\r\n\t\t\thint: Utils.randomElement(entry.hints),\r\n\t\t};\r\n\t}\r\n\tstatic validateParams(params: string[]) {\r\n\t\t// NFD splits diacritics apart from letters, allowing the letters to be guessed\r\n\t\t// underscore is used to signal \"letter hasn't been guessed yet\", so replace it with Japanese underscore as a workaround\r\n\t\tconst phrase = params[0].normalize('NFD').trim().replace(/_/g, '\\uFF3F');\r\n\r\n\t\tif (!phrase.length) throw new Chat.ErrorMessage(\"Enter a valid word\");\r\n\t\tif (phrase.length > MAX_HANGMAN_LENGTH) {\r\n\t\t\tthrow new Chat.ErrorMessage(`Phrase must be less than ${MAX_HANGMAN_LENGTH} characters long.`);\r\n\t\t}\r\n\t\tif (phrase.split(' ').some(w => w.length > MAX_INDIVIDUAL_WORD_LENGTH)) {\r\n\t\t\tthrow new Chat.ErrorMessage(`Each word in the phrase must be less than ${MAX_INDIVIDUAL_WORD_LENGTH} characters long.`);\r\n\t\t}\r\n\t\tif (!/[a-zA-Z]/.test(phrase)) throw new Chat.ErrorMessage(\"Word must contain at least one letter.\");\r\n\t\tlet hint;\r\n\t\tif (params.length > 1) {\r\n\t\t\thint = params.slice(1).join(',').trim();\r\n\t\t\tif (hint.length > MAX_HINT_LENGTH) {\r\n\t\t\t\tthrow new Chat.ErrorMessage(`Hint must be less than ${MAX_HINT_LENGTH} characters long.`);\r\n\t\t\t}\r\n\t\t}\r\n\t\treturn {phrase, hint};\r\n\t}\r\n}\r\n\r\nexport const commands: Chat.ChatCommands = {\r\n\thangman: {\r\n\t\tcreate: 'new',\r\n\t\tnew(target, room, user, connection) {\r\n\t\t\troom = this.requireRoom();\r\n\t\t\ttarget = target.trim();\r\n\t\t\tconst text = this.filter(target);\r\n\t\t\tif (target !== text) return this.errorReply(\"You are not allowed to use filtered words in hangmans.\");\r\n\t\t\tconst params = text.split(',');\r\n\r\n\t\t\tthis.checkCan('minigame', null, room);\r\n\t\t\tif (room.settings.hangmanDisabled) return this.errorReply(\"Hangman is disabled for this room.\");\r\n\t\t\tthis.checkChat();\r\n\t\t\tif (room.game) return this.errorReply(`There is already a game of ${room.game.title} in progress in this room.`);\r\n\r\n\t\t\tif (!params) return this.errorReply(\"No word entered.\");\r\n\t\t\tconst {phrase, hint} = Hangman.validateParams(params);\r\n\r\n\t\t\tconst game = new Hangman(room, user, phrase, hint);\r\n\t\t\troom.game = game;\r\n\t\t\tgame.display(user, true);\r\n\r\n\t\t\tthis.modlog('HANGMAN');\r\n\t\t\treturn this.addModAction(`A game of hangman was started by ${user.name} \u2013 use /guess to play!`);\r\n\t\t},\r\n\t\tcreatehelp: [\"/hangman create [word], [hint] - Makes a new hangman game. Requires: % @ # &\"],\r\n\r\n\t\tguess(target, room, user) {\r\n\t\t\tconst word = this.filter(target);\r\n\t\t\tif (word !== target) return this.errorReply(`You may not use filtered words in guesses.`);\r\n\t\t\tthis.parse(`/choose ${target}`);\r\n\t\t},\r\n\t\tguesshelp: [\r\n\t\t\t`/guess [letter] - Makes a guess for the letter entered.`,\r\n\t\t\t`/guess [word] - Same as a letter, but guesses an entire word.`,\r\n\t\t],\r\n\r\n\t\tstop: 'end',\r\n\t\tend(target, room, user) {\r\n\t\t\troom = this.requireRoom();\r\n\t\t\tthis.checkCan('minigame', null, room);\r\n\t\t\tthis.checkChat();\r\n\t\t\tconst game = this.requireGame(Hangman);\r\n\t\t\tgame.end();\r\n\t\t\tthis.modlog('ENDHANGMAN');\r\n\t\t\treturn this.privateModAction(`The game of hangman was ended by ${user.name}.`);\r\n\t\t},\r\n\t\tendhelp: [\"/hangman end - Ends the game of hangman before the man is hanged or word is guessed. Requires: % @ # &\"],\r\n\r\n\t\tdisable(target, room, user) {\r\n\t\t\troom = this.requireRoom();\r\n\t\t\tthis.checkCan('gamemanagement', null, room);\r\n\t\t\tif (room.settings.hangmanDisabled) {\r\n\t\t\t\treturn this.errorReply(\"Hangman is already disabled.\");\r\n\t\t\t}\r\n\t\t\troom.settings.hangmanDisabled = true;\r\n\t\t\troom.saveSettings();\r\n\t\t\treturn this.sendReply(\"Hangman has been disabled for this room.\");\r\n\t\t},\r\n\r\n\t\tenable(target, room, user) {\r\n\t\t\troom = this.requireRoom();\r\n\t\t\tthis.checkCan('gamemanagement', null, room);\r\n\t\t\tif (!room.settings.hangmanDisabled) {\r\n\t\t\t\treturn this.errorReply(\"Hangman is already enabled.\");\r\n\t\t\t}\r\n\t\t\tdelete room.settings.hangmanDisabled;\r\n\t\t\troom.saveSettings();\r\n\t\t\treturn this.sendReply(\"Hangman has been enabled for this room.\");\r\n\t\t},\r\n\r\n\t\tdisplay(target, room, user) {\r\n\t\t\troom = this.requireRoom();\r\n\t\t\tconst game = this.requireGame(Hangman);\r\n\t\t\tif (!this.runBroadcast()) return;\r\n\t\t\troom.update();\r\n\r\n\t\t\tgame.display(user, this.broadcasting);\r\n\t\t},\r\n\r\n\t\t''(target, room, user) {\r\n\t\t\treturn this.parse('/help hangman');\r\n\t\t},\r\n\r\n\t\trandom(target, room, user) {\r\n\t\t\troom = this.requireRoom();\r\n\t\t\tthis.checkCan('mute', null, room);\r\n\t\t\tif (room.game) {\r\n\t\t\t\tthrow new Chat.ErrorMessage(`There is already a game of ${room.game.title} running.`);\r\n\t\t\t}\r\n\t\t\ttarget = toID(target);\r\n\t\t\tconst {question, hint} = Hangman.getRandom(room.roomid, target);\r\n\t\t\tconst game = new Hangman(room, user, question, hint, {allowCreator: true});\r\n\t\t\troom.game = game;\r\n\t\t\tthis.addModAction(`${user.name} started a random game of hangman - use /guess to play!`);\r\n\t\t\tgame.display(user, true);\r\n\t\t\tthis.modlog(`HANGMAN RANDOM`, null, target ? `tag: ${target}` : '');\r\n\t\t},\r\n\t\taddrandom(target, room, user) {\r\n\t\t\troom = this.requireRoom();\r\n\t\t\tthis.checkCan('mute', null, room);\r\n\t\t\tif (!hangmanData[room.roomid]) hangmanData[room.roomid] = {};\r\n\t\t\tif (!target) return this.parse('/help hangman');\r\n\t\t\t// validation\r\n\t\t\tconst args = target.split(target.includes('|') ? '|' : ',');\r\n\t\t\tconst {phrase} = Hangman.validateParams(args);\r\n\t\t\tif (!hangmanData[room.roomid][phrase]) hangmanData[room.roomid][phrase] = {hints: []};\r\n\t\t\targs.shift();\r\n\t\t\thangmanData[room.roomid][phrase].hints.push(...args);\r\n\t\t\tHangman.save();\r\n\t\t\tthis.privateModAction(`${user.name} added a random hangman with ${Chat.count(args.length, 'hints')}.`);\r\n\t\t\tthis.modlog(`HANGMAN ADDRANDOM`, null, `${phrase}: ${args.join(', ')}`);\r\n\t\t},\r\n\t\trr: 'removerandom',\r\n\t\tremoverandom(target, room, user) {\r\n\t\t\troom = this.requireRoom();\r\n\t\t\tthis.checkCan('mute', null, room);\r\n\t\t\tlet [word, ...hints] = target.split(',');\r\n\t\t\tif (!toID(target) || !word) return this.parse('/help hangman');\r\n\t\t\tfor (const [i, hint] of hints.entries()) {\r\n\t\t\t\tif (hint.startsWith('room:')) {\r\n\t\t\t\t\tconst newID = hint.slice(5);\r\n\t\t\t\t\tconst targetRoom = Rooms.search(newID);\r\n\t\t\t\t\tif (!targetRoom) {\r\n\t\t\t\t\t\treturn this.errorReply(`Invalid room: ${newID}`);\r\n\t\t\t\t\t}\r\n\t\t\t\t\tthis.room = targetRoom;\r\n\t\t\t\t\troom = targetRoom;\r\n\t\t\t\t\thints.splice(i, 1);\r\n\t\t\t\t}\r\n\t\t\t}\r\n\t\t\tif (!hangmanData[room.roomid]) {\r\n\t\t\t\treturn this.errorReply(\"There are no hangman words for this room.\");\r\n\t\t\t}\r\n\t\t\tconst roomKeys = Object.keys(hangmanData[room.roomid]);\r\n\t\t\tconst roomKeyIDs = roomKeys.map(toID);\r\n\t\t\tconst index = roomKeyIDs.indexOf(toID(word));\r\n\t\t\tif (index < 0) {\r\n\t\t\t\treturn this.errorReply(`That word is not a saved hangman.`);\r\n\t\t\t}\r\n\t\t\tword = roomKeys[index];\r\n\t\t\thints = hints.map(toID);\r\n\r\n\t\t\tif (!hints.length) {\r\n\t\t\t\tdelete hangmanData[room.roomid][word];\r\n\t\t\t\tthis.privateModAction(`${user.name} deleted the hangman entry for '${word}'`);\r\n\t\t\t\tthis.modlog(`HANGMAN REMOVERANDOM`, null, word);\r\n\t\t\t} else {\r\n\t\t\t\thangmanData[room.roomid][word].hints = hangmanData[room.roomid][word].hints.filter(item => !hints.includes(toID(item)));\r\n\t\t\t\tif (!hangmanData[room.roomid][word].hints.length) {\r\n\t\t\t\t\tdelete hangmanData[room.roomid][word];\r\n\t\t\t\t}\r\n\t\t\t\tthis.privateModAction(`${user.name} deleted ${Chat.count(hints, 'hints')} for the hangman term '${word}'`);\r\n\t\t\t\tthis.modlog(`HANGMAN REMOVERANDOM`, null, `${word}: ${hints.join(', ')}`);\r\n\t\t\t}\r\n\t\t\tthis.refreshPage(`hangman-${room.roomid}`);\r\n\t\t\tHangman.save();\r\n\t\t},\r\n\t\taddtag(target, room, user) {\r\n\t\t\troom = this.requireRoom();\r\n\t\t\tthis.checkCan('mute', null, room);\r\n\t\t\tlet [term, ...tags] = target.split(',');\r\n\t\t\t// only a .trim() because toID will make it unable to find the term if it has caps\r\n\t\t\tterm = term.trim();\r\n\t\t\ttags = tags.map(i => toID(i)).filter(Boolean);\r\n\t\t\tif (!term || !tags || !tags.length) {\r\n\t\t\t\treturn this.parse('/help hangman');\r\n\t\t\t}\r\n\t\t\tif (!hangmanData[room.roomid]) {\r\n\t\t\t\thangmanData[room.roomid] = {};\r\n\t\t\t}\r\n\t\t\tif (!hangmanData[room.roomid][term]) {\r\n\t\t\t\treturn this.errorReply(`Term ${term} not found.`);\r\n\t\t\t}\r\n\t\t\tif (!hangmanData[room.roomid][term].tags) hangmanData[room.roomid][term].tags = [];\r\n\t\t\tfor (const [i, tag] of tags.entries()) {\r\n\t\t\t\tif (hangmanData[room.roomid][term].tags!.includes(tag)) {\r\n\t\t\t\t\tthis.errorReply(`The tag ${tag} is already on the term ${term} and has been skipped.`);\r\n\t\t\t\t\ttags.splice(i, 1);\r\n\t\t\t\t}\r\n\t\t\t}\r\n\t\t\tif (!tags.length) {\r\n\t\t\t\tthis.errorReply(`Specify at least one valid tag.`);\r\n\t\t\t\treturn this.parse(`/help hangman`);\r\n\t\t\t}\r\n\t\t\thangmanData[room.roomid][term].tags!.push(...tags);\r\n\t\t\tHangman.save();\r\n\t\t\tthis.privateModAction(`${user.name} added ${Chat.count(tags, \"tags\")} to the hangman term ${term}`);\r\n\t\t\tthis.modlog(`HANGMAN ADDTAG`, null, `${term}: ${tags.map(Utils.escapeHTML).join(', ')}`);\r\n\t\t\tthis.refreshPage(`hangman-${room.roomid}`);\r\n\t\t},\r\n\t\tuntag(target, room, user) {\r\n\t\t\troom = this.requireRoom();\r\n\t\t\tthis.checkCan('mute', null, room);\r\n\t\t\tif (!toID(target)) {\r\n\t\t\t\treturn this.parse(`/help hangman`);\r\n\t\t\t}\r\n\t\t\tlet [term, ...tags] = target.split(',');\r\n\t\t\ttags = tags.map(i => toID(i)).filter(Boolean);\r\n\t\t\tif (!term || !tags) {\r\n\t\t\t\treturn this.parse('/help hangman');\r\n\t\t\t}\r\n\t\t\tif (!hangmanData[room.roomid]) {\r\n\t\t\t\treturn this.errorReply(`This room has no hangman terms.`);\r\n\t\t\t}\r\n\t\t\tif (!hangmanData[room.roomid][term]) {\r\n\t\t\t\treturn this.errorReply(`That term was not found.`);\r\n\t\t\t}\r\n\t\t\tif (!hangmanData[room.roomid][term].tags) {\r\n\t\t\t\treturn this.errorReply(`That term has no tags.`);\r\n\t\t\t}\r\n\t\t\tif (tags.length) {\r\n\t\t\t\tthis.privateModAction(`${user.name} removed ${Chat.count(tags, \"tags\")} from the hangman term ${term}`);\r\n\t\t\t\tthis.modlog(`HANGMAN UNTAG`, null, `${term}: ${tags.map(Utils.escapeHTML).join(', ')}`);\r\n\t\t\t\thangmanData[room.roomid][term].tags = hangmanData[room.roomid][term].tags?.filter(t => !tags.includes(t));\r\n\t\t\t} else {\r\n\t\t\t\tthis.privateModAction(`${user.name} removed all tags from the hangman term ${term}`);\r\n\t\t\t\tthis.modlog(`HANGMAN UNTAG`, null, `${term}`);\r\n\t\t\t\thangmanData[room.roomid][term].tags = [];\r\n\t\t\t}\r\n\r\n\t\t\tif (!hangmanData[room.roomid][term].tags!.length) {\r\n\t\t\t\tdelete hangmanData[room.roomid][term].tags;\r\n\t\t\t}\r\n\t\t\tHangman.save();\r\n\t\t\tthis.refreshPage(`hangman-${room.roomid}`);\r\n\t\t},\r\n\t\tview: 'terms',\r\n\t\tterms(target, room, user) {\r\n\t\t\troom = this.requireRoom();\r\n\t\t\treturn this.parse(`/j view-hangman-${target || room.roomid}`);\r\n\t\t},\r\n\t},\r\n\r\n\thangmanhelp: [\r\n\t\t`/hangman allows users to play the popular game hangman in PS rooms.`,\r\n\t\t`Accepts the following commands:`,\r\n\t\t`/hangman create [word], [hint] - Makes a new hangman game. Requires: % @ # &`,\r\n\t\t`/hangman guess [letter] - Makes a guess for the letter entered.`,\r\n\t\t`/hangman guess [word] - Same as a letter, but guesses an entire word.`,\r\n\t\t`/hangman display - Displays the game.`,\r\n\t\t`/hangman end - Ends the game of hangman before the man is hanged or word is guessed. Requires: % @ # &`,\r\n\t\t`/hangman [enable/disable] - Enables or disables hangman from being started in a room. Requires: # &`,\r\n\t\t`/hangman random [tag]- Runs a random hangman, if the room has any added. `,\r\n\t\t`If a tag is given, randomizes from only terms with those tags. Requires: % @ # &`,\r\n\t\t`/hangman addrandom [word], [...hints] - Adds an entry for [word] with the [hints] provided to the room's hangman pool. Requires: % @ # &`,\r\n\t\t`/hangman removerandom [word][, hints] - Removes data from the hangman entry for [word]. If hints are given, removes only those hints.` +\r\n\t\t` Otherwise it removes the entire entry. Requires: % @ & #`,\r\n\t\t`/hangman addtag [word], [...tags] - Adds tags to the hangman term matching [word]. Requires: % @ & #`,\r\n\t\t`/hangman untag [term][, ...tags] - Removes tags from the hangman [term]. If tags are given, removes only those tags. Requires: % @ # * `,\r\n\t\t`/hangman terms - Displays all random hangman in a room. Requires: % @ # &`,\r\n\t],\r\n};\r\n\r\nexport const pages: Chat.PageTable = {\r\n\thangman(args, user) {\r\n\t\tconst room = this.requireRoom();\r\n\t\tthis.title = `[Hangman]`;\r\n\t\tthis.checkCan('mute', null, room);\r\n\t\tlet buf = `
`;\r\n\t\tbuf += `
Hangman entries on ${room.title}
`;\r\n\t\tconst roomTerms = hangmanData[room.roomid];\r\n\t\tif (!roomTerms) {\r\n\t\t\treturn this.errorReply(`No hangman terms found for ${room.title}.`);\r\n\t\t}\r\n\t\tfor (const t in roomTerms) {\r\n\t\t\tbuf += `