So that when rate limits kick in, the user can tell the bot has heard their command and is trying to do something

Similar to Storytellers, Spectators could have their names prefixed/suffixed and can be thrown into the same cottage together at night.

When run from the control channel, it would infer as much as possible via naming/regexes:

• assume the control channel is in the Day category
• assume the night category is "{day} - Night"
• assume the roles are "{day} Storyteller" and "{day} Villager"
• assume the first voice channel in the Day category is Town Square

Doing:

!createtown TestTown

Followed pretty immediately by:

!destroytown TestTown

Appears to fail to destroy some stuff. Message:

I destroyed what I knew about for Town TestTown2.

I did not destroy some things I was unfamiliar with:

• TestTown2 - Night / Cottage (channel)
• TestTown2 / Graveyard (channel)

You can destroy them and run this command again.

I did not destroy these things yet, just in case you still need them:

• TestTown2 - Night (category)
• TestTown2 / botc_mover (channel)
• TestTown2 (category)
• TestTown2 Villager (role)
• TestTown2 Storyteller (role)

However, as far as I can tell, the Cottage and the Graveyard DID get destroyed. So there appears to be a bug where it thinks it didn't destroy the Graveyard, or something. Might be a lag issue of some kind, may need to tweak how we determine whether a channel was destroyed.

Running it again works fine.

!legion is like !evil, but:

• Everyone is "the demon"
• There CAN be minions, but usually not. Not sure how to handle that!
• Should also tell the Legion members who is NOT Legion, as that would be a lot easier information to digest
• They all get the same not-in-play roles

I think this would be easier to handle as 1 command rather than visiting each person individually. But I dunno what the syntax should be.

• Allow a guild to specify the category, channel, and role names by storing guild info in a DB somewhere

We might not want our local-running bots to touch the "prod" mongo cluster/db

If no commands come in to a town after like 6-12 hours, and the bot still thinks a game is in progress for that town, run the !endgame command to clean up roles.

For the last 2 weeks, the automatic cleanup of the game has not worked. I'm guessing it's hitting an exception somewhere and aborting

Lots of ...s hide text:

​Commands:
  currgame Set the current users in all standard BotC voice channels as playe...
  day      Move users from Cottages back to Town Square
  evil     Send evil info to evil team. Format is `!evil <demon> <minion> <mi...
  help     Shows this message
  lunatic  Send fake evil info to the Lunatic. Format is `!lunatic <Lunatic> ...
  night    Move users to Cottages in the BotC - Nighttime category
  vote     Move users from other channels back to Town Square

It could use the DB to pull data on what channels/categories etc to remove instead of assuming they have certain names

It could also be used within the control channel with no parameters if we want

• Add a way that you can specify a number of minutes when you start the !day phase
• After N-1 minutes the bot will post a 1-minute warning to the players (or to the text chat if we add knowledge of the text chat)
• After N minutes the bot will auto-run the !vote command

Otherwise if they were playing in the round before they'll have their perms for the Cottage they were in suppressed

Suggestion:

!setStorytellers Colin Mark

If one of the mover commands is used by someone who is NOT in the current Storyteller list, it should clear the previous Storytellers and set the 1 who used the command.

!endgame should also clear the STs

Depends on #5

We're getting to the point where we are almost full up for a single game of BotC, with around 12-13 players. If we eventually hit 16 players, that's sort of 1 too many (although travelers can alleviate that) and there's a LOT of crosstalk. It may very well be better, in such a case, to split up into 2 groups (8 players and 7 players, or more).

In order to facilitate this, the mover bot would need some extra sauce:

Assuming there will be 2 separate #botc_mover channels, and that each of those represents its own game. For each #botc_mover channel:

• It needs to be able to set what the nighttime category is (e.g. !set nightcategory <id or string>)
• It should be able to figure out what the daytime category is, as the #botc_mover channel is already in that category, so no extra command likely required there.
• It needs to be able to set what the Current Storyteller Role is (e.g. !set strole <id or string>)
• It needs to be able to set what the Current Player Role is (e.g. !set playerrole <id or string>)

• Check that there are "enough" channels in the day category and recommend more
• Check that there are "enough" Cottages in the night category and recommend more
• Check that the night category has the right perms for the category as a whole (only visible to current players?) and on the cottages (only visible to storyteller)

I storytold and got the BotC Current Storyteller role. Then, Tommy was storyteller, and he got the role but I still had it also.

class botcBot -> function getTownInfo. There's no need to else statement there.

Explanation:
If the IF statement returns True it will return TownInfo(ctx.guild, doc) and jumps out of the function else the interpreter will go to the next line and then it will return None and jump out of the function.

Would need to talk to bra1n to see if this is possible.

TypeError('sequence item 0: expected str instance, Member found',) (from message !currgame)

I thought this was because nobody was in a voice channel but it happened even when I was in a voice channel

Storyteller should be able to move members in the cottages (like, to put 2 players into 1 cottage)

• Remove person-specific permissions from all the cottages
• Remove "(ST) " from storyteller name
• Remove current game and current storyteller roles

As of May 4, 2021, Discord added some first-class support for slash commands, including autocomplete. Bot on the Clocktower should make use of this (perhaps only if it has Slash Command permission for the server?)

New slash commands for bots! Performing actions with bots is easier than ever. Bot developers—when they’re ready, please don’t scare them—can have a list of commands available for their bots accessible by the forwardslash key (/). You won’t have to remember bot commands anymore and get laughed at when you get the command wrong :( !help…..!help….please

Added use Slash Commands permission. If you run a server, make sure to configure this permission for your bot channels. Bots that upgrade to Slash Commands require this permission.

Give the storyteller some additional tools for use on this rowdy bunch, perhaps

• Possibly respond when you start a new game
• Possibly just post into the control channel when it starts up
• But only once per version
• And only if there is a big enough feature to announce

• I was ST
• Tommy did !currgame and !night
• Our roles were updated correctly
• Our (ST) nickname was updated correctly
• However, I still have permission to see Tommy's cottage (along with Tommy)

So something about when we swap storyteller in this way is not properly updating the Cottage view permissions

This would talk to a user (via DMs?) and interactively add a town by asking questions

Alternately, this flow could even create the channels for a town with the correct permissions etc (though that would require new permissions on the bot)

I did 2 "!evil Colin Colin" commands in fairly quick succession when not connected to the Town Square, and the 2nd one did not get deleted. Rate limits?

"cory" was at the bottom of the list

I used !endgame with nobody in the Town Square, and nothing happened.
Then I remembered that someone usually has to be connected, and I used it again. Here's what happened:

• It appears everyone lost the BotC Current Player role
• I lost the BotC Current Storyteller role
• I still had permissions to view ONE of the Cottages
• I still had (ST) in front of my name

I then though maybe doing it first when not in Town Square was a problem, so I did !curgame (typo!) followed by !endgame. Same visible results after !endgame, but I was also sent this error:

Traceback (most recent call last):
  File "bot.py", line 114, in onEndGame
    await prevSt.remove_roles(stRole)
AttributeError: 'NoneType' object has no attribute 'remove_roles'

I then realized the command was actually !currgame, so I tried again to do !currgame !endgame. This time, the Cottages went away, but I still had (ST) on my name, and I got the whisper with the same error above again.

Right now Mark & Jaime (followed by Mel and Richie) are always the last moved out of Town Square

I don't know how easy this is, but some bots have a web-based control panel that can be used to poke at a bot, rather than needing to send messages to a channel. This would be a super cool API, and something you could pop out to another window and use buttons to (for example) switch to night and day.

Not that you would have just 1 evil player, but if you try the message says "Your minions are:"

We play weekly, and many weeks when the first night starts I notice we have a chat channel full of messages I haven't read from the previous week. This is usually because I storytell the last game, and don't have time for the chat channel anyway.

There should be an option to, probably during periodic cleanup, clear out the chat channel. It's intended to be a temporary thing just for the current game anyway, so I think we would set this option on our Town.

Presumably people will not always tell our bot when they don't want it anymore (kick from guild) or have removed their day categories, but we'll still have data about them sitting around in the DB.

This task is to have a (weekly?) maintenance task to check on towns and see if we can still access the guild/day category. If we can't, then we might as well eject them from the db.

You can use inverse logic in the code below

Actual code:

if info is not None:
            await self.sendEmbed(ctx, info)
        else:
            await ctx.send("Sorry, I couldn't find a town registered to this channel.")

Suggested code:

if info:
          await self.sendEmbed(ctx, info)
else:
            await ctx.send("Sorry, I couldn't find a town registered to this channel.")

There are many lines of code very you can apply this improvement.

Moved the storyteller to their cottage but then failed to set the permissions on that cottage

  File "bot.py", line 941, in onNight
    await cottage.set_permissions(user, view_channel=True)
  File "/app/.heroku/python/lib/python3.6/site-packages/discord/abc.py", line 658, in set_permissions
    await http.edit_channel_permissions(self.id, target.id, allow.value, deny.value, perm_type, reason=reason)
  File "/app/.heroku/python/lib/python3.6/site-packages/discord/http.py", line 241, in request
    raise Forbidden(r, data)
discord.errors.Forbidden: 403 Forbidden (error code: 50013): Missing Permissions

The users need the "View Channel" permission for that particular channel, not any mucking around with roles.

If the person whose nickname needs to be changed has a role higher in the role list than the bot - including being the owner of the server - then the error message is messy. We should catch this error message and send an explanation about what can be done to fix it, e.g.:

Attempted to change nickname "Colin" to "(ST) Colin" but was unable. This is likely for one of these reasons:

• Colin has a role that is higher in the role list than the Bot on the Clocktower role
• Colin is the owner of the server
• Bot on the Clocktower needs to be re-invited to the server to grant it nickname-changing permissions

This could be sent to the mover channel rather than being a private message

Hi!
Intrigued by this bot, but the group I play with doesn't prefer cottages.
Would it be possible to disable !day !night and cottage creation in some way?