search

Rolisteam / DiceParser

Powerful dice Roller is used as discord bot, irc bot, cli tool and inside Rolisteam : 1d20+4, 1L[head,arm,leg,belly,chest], 1d6+1d8, 8+5*3
http://www.rolisteam.org/
GNU General Public License v3.0
125 stars 31 forks source link

Help Noob please! Bot Setup steps for RPG #152

Open Gluth60 opened 2 years ago

Gluth60 commented 2 years ago

Hello,

I'm a beginner on Discord, and I don't understand at all how to configure the bot. I would like to be able to put text for each 1D100 result, in order to make an RP random encounter generator.

The problem is that I understand absolutely nothing about bots, and even less about coding. So I don't know how to do it. The "readMe" and the explanations are incomprehensible to me.

What are the steps to get the DiceParser Bot to allow something like simply "!1D100=74=You encounter a dragon"

obiwankennedy commented 2 years ago

since one month, the bot no longer use the ! syntax. It is using what discord called: "Slash command" see: Run command section on this page https://rolisteam.org/discord.html you have a gif which shows how to roll a simple dice.

Basically, if you type / discord should show a panel allowing you to select the command /r for diceparser to be rolled. Again see the gif on the web page to see how it how look. If it does not work, it means you have set bad permission to the bot. The first to check is the permission in server settings > integration > app and bots > diceparser If it still does not work after what you must check permession on channel and server levels. It is not my role to fix your permission issue into your server.

You want to make a random encounter generator with dice parser it is easy:

/r command: 1L[dragon,lion,crab,turtle,crane,unicorn] it can be improve to that: /r command: 1L[dragon,lion,crab,turtle,crane,unicorn];"You encounter a $1"

then you can create a macro: /macro add encGen 1L[dragon,lion,crab,turtle,crane,unicorn];"You encounter a $1" False

In this example:  -encGen is the key. -1L[dragon,lion,crab,turtle,crane,unicorn];"You encounter a $1" is the value.

After setting the macro, instead of typing the whole command, you will just have to type: encGen to roll in the encounter command. Much easier/shorter to write. I set encGen but you can change to anything, just don't set one letter, it can conflict with DiceParser operator and stuff. use a key that may never occur in other commands.

Bad example: if you define the macro on d, when you type for example the simple command "1d100", the command will change to 11L[dragon,lion,crab,turtle,crane,unicorn];"You encounter a $1"100. The letter d has been change to the value. And it makes impossible to roll a simple dice. So use a multi letter key to trigger your command and you will be fine.

Gluth60 commented 2 years ago

Thank you very much for your clear and detailed explanations! I didn't expect such a quick response, and thank you very much for that!

Indeed, with all these details, I was able to configure the bot easily, and I am very grateful to you. Thank you so much !