Initial setup (Windows)

[driftwoodlk]

I saw the previous issue (#55) on setting up the bot, but still having some trouble.

I installed GitHub, cloned the repo, installed node.js, created an application, created a bot, got the bot credential, set a Windows environment variable of DISCORD_TOKEN = to it (all of this took quite a while to figure out, although not complicated).

So now I can run the code and it logs in to my application, stupidbot1, on my server. Yay. But when I try to add a player, I get told to run !omni setup first. (I don't see that in !omni help) When I try running that, I get permission errors (50013) in /roles and /channels.

I've tried to pick what I think are the right permissions for the application: Role = Bot, View Channels, Send Messages, Read Message History (plus a bunch of others that seem unlikely but possible). Can you specify what permissions are needed? Or is that not the problem?

You also say that a hidden bot-data channel is needed in which the bot can save state. I created a #bot-data channel that is private to myself and stupidbot1, but still get the permissions error. Does it need some special name?

Thanks for any help! BTW, I'm going to use this to run Runners in the Shadows, a mod of Blades in the Dark for the Shadowrun setting.

[TheCraiggers]

OK, sorry about this, the needed permissions really should have been documented. It was very much a trial-and-error process to come up with them.

Here's the easiest way.... I think. Take the following URI https://discord.com/oauth2/authorize?client_id=<INSERT_ID_HERE>&permissions=268512272&scope=bot and put your client ID in it. When you go to that link, it should ask you which server you wish to add your bot to (you may have to remove the bot you've currently invited). This will add the bot to your channel with the correct permissions.

(If the above doesn't work, let me know and we can do it the slightly longer way. Permissions in Discord are kinda a pain.)

After this, !omni setup should automatically create the data channel for you and create all the roles / permissions that are needed on the server. You shouldn't have to do any of that manually, and in fact I'd delete that data channel you created just in case it causes confusion. That said, !omni setup was designed to be idempotent.

[driftwoodlk]

That worked! I didn't add enough Manage permissions on my own.

Is the list of Omni commands in the help complete? Or are there others? Is there a command that rolls a die a number of times equal to a stat?

[TheCraiggers]

Well, I tried to make the help command be as accurate as possible, but the true intent of the help command is to teach the command structure, and hopefully with that you'll see the various combinations. For example, to roll a stat like you were saying, !omni roll stat PlayerName perception Assuming that stat contains some kind of parsable dice command, it'll do it. That said, there may be missing interactions, and a couple things that were planned but not finished. But it's complete enough that the bot has been used for a bunch of games without too much issue. Dec 20, 2020 12:07:59 AM driftwoodlk <[email protected]>:

…

That worked! I didn't add enough Manage permissions on my own. Is the list of Omni commands in the help complete? Or are there others? Is there a command that rolls a die a number of times equal to a stat? — You are receiving this because you commented. Reply to this email directly, view it on GitHub[#63 (comment)], or unsubscribe[https://github.com/notifications/unsubscribe-auth/AALJDOZQLQORH2Y3FEMRYRDSVWBCNANCNFSM4VCXXY3Q]. [data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAFQAAABUCAYAAAAcaxDBAAAABHNCSVQICAgIfAhkiAAAADJJREFUeJztwQENAAAAwqD3T20ON6AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAB4NW6UAAFvMNJxAAAAAElFTkSuQmCC###24x24:true###][Tracking image][https://github.com/notifications/beacon/AALJDO3PU2IPPHMWBSKVSVDSVWBCNA5CNFSM4VCXXY32YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOFSPCZSQ.gif]