TG.line.Discord.Roll.Bot

RoboYabaso@HKTRPG

【HKTRPG Dice BOT】

• Last updated

HKTRPG dice-throwing robot Roll Dice Robot

• HKTRPG is a dice bot available on Discord, Line, Telegram, Whatsapp, Plurk, API and web!
  • Functions: Dark dice, various TRPG dice rolling, custom dice, identity group management, channel experience points, divination, initiative table, TRPG character card, image search, translation, Discord chat record export, mathematical calculations, note-taking, Random selection, wiki query, database quick search function, scheduled message sending function, daily joke, daily animation, daily word, daily almanac, daily poisonous soup, daily love words, daily fortune-telling, every Daily events, daily (horoscope), daily answers
• Please see HKTRPG official tutorial for how to use it.
  • Welcome to join the development, help and TRPG Discord group
  • Invite HKTRPG to join
    • Discord invitation link
    • Telegram invitation link
    • Line invitation link
    • Web version invitation link
    • Plurk invitation link
    • TRPG API link
  • HKTRPG Research Agency Facebook
  • TRPG Encyclopedia
  • Hall of Fame
  • Sponsor HKTRPG

Acknowledgments

• Finally, I would like to thank different people for their help to complete this BOT.
  • LarryLo Retsnimle - wrote tutorials and open source programs on how to build BOT and started the growth of this BOT
  • Bu Dashi - taught me how to write good programs, and also wrote out different ways to improve them by hand
  • LOKI Lokinen, Mu Yichen, Luo Ray, Vivian - because of their donations, HKTRPG can be moved to better machines
  • and other friends who have always provided help and advice.

The following are old version instructions, which will be discarded or modified.

About RoboYabaso

RoboYabaso was first developed by LarryLo Retsnimle.
is an open source dice robot project.
Sourced from https://docs.google.com/document/d/1dYnJqF2_QTp90ld4YXj6X8kgxvjUoHrB4E2seqlDlAk/edit

Now it is changed to three-in-one Line x Discord x Telegram.
Although it is three-in-one, it can be used individually, but the dice set is shared.
The startup condition is to enter BOT's CHANNEL_SECRET in HEROUKU

Otherwise, there wouldn’t be so many servers to open so many BOTs.
Whatsapp is most looking forward to opening up its permissions soon. Hong Kong people use Whatsapp more

This is built on Heroku's free server, so everyone can follow the tutorial below to customize and make your own BOT!
Now supports ordinary dice rolls, pure calculations, fun dice rolls, fortune, Cthulhu Mythology Zhu's Lonely Tower, God's Hunting, Labyrinth Kingdom, Ya Xia's Mortal Adventure, Ninja God, DX2nd, 3rd
Fate, Eternal Tomorrow, Sword World 2.5, WOD Dark World,
Customize dice function, store dice rolling instruction function, dice rolling switch function and database function

By the way, we are promoting the Hong Kong TRPG District TRPG Encyclopedia to recruit technical personnel.

ToDo list

• Dark die and pass the result to the specified object at the same time
• Can give non-Admin GM permissions
• Set a name to be displayed every time the dice is rolled
• Timing function. GM can publish tasks, time limit prompts, player inquiries, etc.
• voting function
• Save the specified dice rolling method and enter the specified method to quickly play it out
• Choose a book-style game (like the COC single-player TRPG "Walking to the Fire Alone", enter the page number, and the story will be displayed, just like running a group, you will not be afraid of having no companions in the future, but you must first have a story ORZ)
• Add mee6 style LV ranking upgrade function (need to modify the trigger method)
• Added combat round function.round next hide public init del
• Add role card function.char set del
• Adding LOG function can automatically turn it into LOG

For other functions, please leave comments and suggestions.

Feature introduction

Divination function.
Supports large and small steps.
Add HELP function. For details, enter bothelp in the BOT to view instructions and support direct 1d100 5d20.
cc<= changed to cc cc1 cc2 ccn1 ccn2.
Added NC rolls for Forever Tomorrow from Rainsting/TarotLineBot.
Added wod dice rolls for World of Darkness DX3 SW2.0.
Modular design.

There are instructions for Line Discord and Telegram below respectively. Which one to use depends on which one. In addition, you need to apply for an mlab ACC. The teaching will be written later.

How to build your own Line dice robot

Prepare for action

• Apply for a Line account first (nonsense)

• Apply for a Github account first

• It is enough to apply for a Heroku account first and choose free services for all the following. Please do not hesitate to choose to pay.

Step1: Fork this project back first

• Go to the button in the upper right corner and press it.
  Save this project to your Github.

Step2: Create a lineBot account

• Go to https://developers.line.me/en/ to log in to a Line account.
  Click "Start using Messaging API" and follow the instructions to register your line Bot account.
  

---

• Click "Free Account" below

---

• Enter the line Bot account you just registered

---

• According to this screen setting, set Use webhooks to On, Auto-reply messages and Greeting messages to Disable
  

---

• Then leave the web page open and don’t close it.
  

---

Step3: Deploy LineBot to Heroku

• Click the button below and press it →← press it

---

• you will see this
  
  Of course, first pick up an App name and return to the LINE Developers webpage in the previous step.

Step4: Obtain Channel Access Token and Channel Secret

• First get the Channel Secret and press the button on the right
  
  Copy the obtained string to LINE_CHANNEL_SECRET in Step 3

---

• Then get the Channel Access Token and press the button on the right
  
  Copy the obtained string to LINE_CHANNEL_ACCESSTOKEN in Step 3
  Then, press the Deploy app, and after he finishes running, press the Manage App
  We are only one step away from deploying the robot!

Step5: Link Line with Heroku

• Click settings
  

---

• Find the entry Domains and certificates, there will be a "Your app can be found at..." next to it, add a string of URLs, and copy the URL.
  

---

• Go back to the LINE Developers web page, select edit at the bottom, find the Webhook URL, remove the URL https:// and copy it up.
  

---

• Press Save. Do you see a VERIFY button next to the Webhook URL? Press it.
  If Success. appears, it means you have completed it successfully!
  

How to modify and upload program code

Go back to the Heroku web page and click Deploy above. You will see four ways to configure the code.

I guess if you are someone who knows how to use the first type (Heroku Git) or the fourth type (Container Registry), you probably won’t read this kind of tutorial~ So I won’t introduce it~
Definitely, definitely not a relationship that I don’t know how to do (eyes drifting)

Taking the second type (Github) as an example, you can bind your Github account - didn't we just fork a copy of the code back? Connect it so that you can modify the code you want on Github and then deploy it.
Or you can use the third one (Dropbox). After you link, it will automatically download the code you just launched to your dropbox. After you complete the modification, just deploy it.

Prepare for action

• Apply for a Discord account first (nonsense)

• Apply for a Github account first

• It is enough to apply for a Heroku account first and choose free services for all the following. Please do not hesitate to choose to pay.

Step1: Fork this project back first

• Go to the button in the upper right corner and press it.
  Save this project to your Github.

Step2: Create a DiscordBot account

• Go to http://discordapp.com/developers/applications/me to log in to a Discord account.
  Click "New Application" and follow the instructions to register your Discord Bot.

---

• Make a note of that "CLIENT ID"

• Enter the Setting Bot on the left

• In BUILD-A-BOT, click Add Bot->Yes Do It. Then copy the "Token"

Step3: Deploy DiscordBot to Heroku

• Click the button below and press it →← press it

---

• you will see this
  
  Of course, first get an App name, and then paste the "Token" you wrote down before.
  If you want a startup word, you can type it in. For example, the startup word !trpg will become !trpg 1d100
  Then, press the Deploy app, and after he finishes running, press the Manage App
  We are only one step away from deploying the robot!

Step4: Invite the robot to your channel

--

• I just copied a "CLIENT ID" and replaced it in the middle of the following URL

https://discordapp.com/oauth2/authorize?&client_id=CLIENTID&scope=bot&permissions=8

• Click and select your channel
• Then you can use your Bot in the channel.

---

test function

 npm install -g mocha
mocha .testanalytics.test.js

Telegram…
It is the simplest, just like above, register Telegram ACC first
Then go to https://telegram.me/botfather
Use /new bot to enter BotName and UserName
You will get a Token and an invitation code. The Token is input into Heroku and the invitation code is for Telegram users to connect to the Bot.

Reference to the above instructions
https://github.com/zeteticl/TrpgLineBot-php

I hope the next update is

1. MONGODB (But it’s so difficult... Is there any expert who can help me... I don’t want to use GOOGLE SHEET...
2. Learn frozen tofu using the dice method
3. Optimization of Help

More updates will be posted on the Discord group

【Dice BOT】

For the dark die function, enter dr before the command. The result will be a private message to you. For example, enter 2d6+1 to attack!
Will output) 2d6+1: Attack 9[6+3]+1 = 10
As above, you can make a speech by typing in the blank space behind the dice number.
There are other examples below
5 3D6: roll 5 3d6s separately
D66 D66s: The smaller D66 s is fixed in front
5B10: Roll without totaling 5B10S: Roll without totaling, sorted from largest to smallest
5B10 8: As above, also calculate how many of them are larger than 8
5U10 8: Playing 5D10, there will be a bonus die for every 8 rolled.
5U10 8 9: As above, also calculate how many of them are larger than 9
Choice: Startup language choice/random/option/choose 1
(Question) (Startup) (Question) (Option 1) (Option 2)
Example: Randomly receive the number of Christmas gifts 1 2 3 >4

Random sorting: Startup sorting
(question) (startup) (question) (option 1) (option 2) (option 3)
Example of exchanging gifts: Mr. A, Mr. C, Mr. F, Mr. G.

• COC Sixth Edition Judgment CCb (Target Value): Making a Success or Failure Judgment Example) CCb 30 CCb 80
• COC seventh edition judgment CCx (target value) x: bonus die/punishment die (2~n2). If not, you can omit it.
  Example) CC 30 CC1 50 CCn2 75
• coc7 role background: startup slogan coc7 role background
• coc7 growth or growth check: dp (skill) (name)
  Example) DP 80 Investigation
• coc7 growth or growth check: dp (skill) (name)
  Example) DP 80 Investigation

Currently supported systems: [To learn more about the dice group, please enter bothelp (number) or all or enter help after the command such as .sg help]
0: AdvancedDice.ca (calculated) D66(sn) 5B10 Dx 5U10 xy
1: Fun dice sorting (at least 3 options) choice/random (at least 2 options) daily tarot fortune flag .me
2: Cthulhu Mythos cc cc(n)1~2 ccb ccrt ccsu .dp .cc7build .cc6build .cc7bg
3: Zhu's lonely tower.al (nALx*p)
4: DX2nd,3rd .dx (xDX+y@c ET)
5: Fate .4df(m|-)(bonus)
6: 神wohunt.kk (ET RT NT KT MTx)
7: Labyrinth Kingdom.mk (nMK+m and various tables)
8: Eternal Tomorrow Talk.nc (NM xNC+m xNA+m)
9: Yaxia’s mortal adventure.ss (nR>=x[y,z,c] SRx+y FumbleT)
10: Ninja God.sg (ST FT ET and other tables)
11: Sword World 2.5 .sw (Kx Gr FT TT)
12: 歌风.UK (nUK nUK@c or nUKc)
13: WOD Dark World.xWDy
14: Cat Cat Ghost Cha.kc xDy z
15: (in public beta) Wiki query/image search/translation.wiki .image .tran
16: (In public beta) Dark dice GM function.drgm (addgm del show) dr ddr dddr
17: (in public beta) experience value function.level (show config LevelUpWord RankWord)
18: (In public beta) Custom dice function.ra(p)(number of times) (add del show custom keyword)
19: (in public beta) function of storing dice roll instructions.cmd (add del show custom keyword)
20: (In public beta) Dice switch function.bk (add del show)
21: (in public beta) database function.db(p) (add del show custom keywords)