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