TG.line.Discord.Roll.Bot

RoboYabaso@HKTRPG

【HKTRPG掷骰BOT】

• 最后更新时间

HKTRPG掷骰子专用机械人Roll Dice Robot

• HKTRPG是在Discord, Line, Telegram, Whatsapp, Plurk, API 和网页上都可以使用的骰子机械人！
  • 功能：暗骰, 各类TRPG骰子掷骰, 自定义骰子, 身分组管理, 频道经验值, 占卜, 先攻表, TRPG角色卡, 搜图, 翻译, Discord 聊天纪录汇出, 数学计算, 做笔记,随机抽选, wiki查询, 资料库快速查询功能, 定时发讯息功能, 每日笑话, 每日动漫, 每日一言, 每日黄历, 每日毒汤, 每日情话, 每日灵签, 每日大事, 每日(星座), 每日解答
• 使用方法请看HKTRPG 官方使用教学
  • 欢迎加入开发，求助及TRPG Discord 群组
  • 邀请HKTRPG 加入
    • Discord 邀请连结
    • Telegram 邀请连结
    • Line 邀请连结
    • 网页版邀请连结
    • Plurk 邀请连结
    • TRPG API 连结
  • HKTRPG 研究社Facebook
  • TRPG 百科
  • 名人堂
  • 赞助HKTRPG

鸣谢

• 最后感谢不同人的帮助，才可以完成这个BOT
  • LarryLo Retsnimle - 写出如何建BOT的教程和开源程式，开始这个BOT的成长
  • 布大狮- 教导我如何写好程式，还亲手写出不同改进方式
  • LOKI Lokinen，木易陈，Luo Ray，Vivian - 因为有他们捐助，才可以把HKTRPG搬到更好的机子上
  • 以及其他一直帮助和意见的朋友

以下为旧版说明,将会废弃或修改

关于RoboYabaso

RoboYabaso最早由LarryLo Retsnimle开发。
是一个开放源码骰子机器人计画。
来源自https://docs.google.com/document/d/1dYnJqF2_QTp90ld4YXj6X8kgxvjUoHrB4E2seqlDlAk/edit

现在改成三合一Line x Discord x Telegram。
虽然是三合一，但可以单独使用，只是共用骰组，
启动条件是在HEROUKU 输入BOT的CHANNEL_SECRET

不然的话没这么多伺服器开这么多ＢＯＴ。
最期待Whatsapp快开放权限，香港都是比较多使用Whatsapp

这是建立在Heroku的免费伺服器上，所以大家都可以按照下面的教程，客制化做一个自己的BOT！
现支援普通掷骰，纯计算，趣味掷机掷骰，运势，克苏鲁神话朱の孤塔，神我狩，迷宫王国，亚侠必死的冒险，忍神，DX2nd,3rd
命运Fate，永远的后日谈，剑世界2.5，WOD黑暗世界，
自定义骰子功能，储存掷骰指令功能，掷骰开关功能及资料库功能

顺便宣传香港TRPG区TRPG百科招技术人员

ToDo list

• 暗骰同时把结果传给指定对象
• 可以给非Admin GM权限
• 设定名字, 每次掷骰时显示
• 定时功能. GM 可以发布任务, 定时提示时限, 玩家查询等等
• 投票功能
• 存好指定掷骰方法, 输入指定即可快速打出来
• 选择图书式游戏(好像COC 单人TRPG 「向火独行」一样, 输入页码, 就会显示故事, 好像跑团一样,以后不怕没有同伴了,不过首先要有故事ORZ)
• 增加mee6式LV 排名升级功能(需修改触发方法)
• 增加战斗轮回合功能.round next hide public init del
• 增加角色卡功能.char set del
• 增加LOG功能可以自动变成LOG

其他功能,欢迎留言建议

特色介绍

占卜运气功能。
支持大小阶。
增加HELP功能。详情BOT内输入bothelp 查看说明支持直接1d100 5d20。
cc<= 改成cc cc1 cc2 ccn1 ccn2。
增加永远后日谈的NC掷骰来自Rainsting/TarotLineBot。
增加wod 黑暗世界DX3 SW2.0的掷骰。
模组化设计。

以下分别有Line Discord 和telegram 的说明用那个就看那个吧另外要申请一个mlab ACC, 教学迟些再写

如何建立自己的Line骰子机器人

准备动作

• 先申请好Line帐号（废话）

• 先申请好Github帐号

• 先申请好Heroku帐号以下全部选择用免费的服务就够了，请不要手残选到付费。

Step1：先把这个专案Fork回去

• 到右上角的按钮吗，按下去。
  把这个专案存到你的Github里。

Step2：建立lineBot账号

• 到https://developers.line.me/en/ 登入一个Line帐号，
  点选「开始使用Messaging API」，按照指示注册你的line Bot账号。
  

---

• 点下方那个「免费帐号」

---

• 进入你刚注册的line Bot账号

---

• 照着这个画面设定,把Use webhooks 定为开启，Auto-reply messages 及Greeting messages 定为Disable
  

---

• 然后开着网页不要关。
  

---

Step3：将LineBot部署到Heroku

• 按一下下面这个按钮按它→←按它

---

• 你会看到这个
  
  当然，先取一个App name，回到上个步骤的LINE Developers网页

Step4：取得Channel Access Token和Channel Secret

• 先取得Channel Secret，按右边的按钮
  
  把取得的字串复制到Step3的LINE_CHANNEL_SECRET

---

• 再取得Channel Access Token，按右边的按钮
  
  把取得的字串复制到Step3的LINE_CHANNEL_ACCESSTOKEN
  接着，按下Deploy app，等他跑完之后按下Manage App
  距离部署完机器人只差一步啦！

Step5：链接Line与Heroku

• 点选settings
  

---

• 找到Domains and certificates这个条目，旁边会有个「Your app can be found at……」加一串网址，把网址复制起来。
  

---

• 回到LINE Developers网页，选取最底下的edit，找到Webhook URL，把那串网址去除https://复制上去
  

---

• 按下Save。看到在Webhook URL 旁边有个VERIFY 按钮吗，按下去。
  如果出现Success. 就表示你成功完成啦！
  

如何修改并上传程式码咧

回到Heroku网页，点选上面的Deploy，你会看到四种配置程式码的方法。

我猜想如果你是会用第一种（Heroku Git）或是第四种（Container Registry）的人，应该是不会看这种教学文～所以我就不介绍了～
绝、绝对不是我自己也不会的关系哦（眼神漂移）

以第二种（Github）来说的话，你可以绑定你的Github账号——刚刚我们不是fork了一份程式码回去吗？把它连接上去，这样你就可以在Github那边修改你要的程式码，再Deploy过来。
或是你可以使用第三种（Dropbox），当你链接之后，它会自动帮你把你刚刚上线的程式码下载到你的dropbox里面。你修改完之后再上来Deploy就好咯。

准备动作

• 先申请好Discord帐号（废话）

• 先申请好Github帐号

• 先申请好Heroku帐号以下全部选择用免费的服务就够了，请不要手残选到付费。

Step1：先把这个专案Fork回去

• 到右上角的按钮吗，按下去。
  把这个专案存到你的Github里。

Step2：建立DiscordBot账号

• 到http://discordapp.com/developers/applications/me登入一个Discord帐号，
  点选「New Application」，按照指示注册你的Discord Bot。

---

• 记下那个「CLIENT ID」

• 进入左方Setting 的Bot

• 在BUILD-A-BOT中点选Add Bot->Yes Do It. 接着把「Token」复制(Copy)下来

Step3：将DiscordBot部署到Heroku

• 按一下下面这个按钮按它→←按它

---

• 你会看到这个
  
  当然，先取一个App name，然后把以前记下的「Token」贴上.
  如果想要启动语,可以顺便打上. 例如启动语!trpg 便会变成!trpg 1d100
  接着，按下Deploy app，等他跑完之后按下Manage App
  距离部署完机器人只差一步啦！

Step4：把机器人邀请到你的频道

--

• 刚刚复制了一个「CLIENT ID」把它取代到以下网址中间

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

• 点击然后选择你的频道
• 然后就可以在频道中使用你的Bot了.

---

测试功能

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

Telegram......
是最简单的,和上面一样,先注册Telegram ACC
然后到https://telegram.me/botfather
使用/new bot 输入BotName 和UserName
会得到Token 和邀请码，Token 就是输入到Heroku 中邀请码就是给Telegram 用家连到Bot的。

以上说明参考
https://github.com/zeteticl/TrpgLineBot-php

下一部希望更新是

1. MONGODB (但好难啊....会有高手帮忙吗....不想用GOOGLE SHEET.....
2. 骰组方法学习冻豆腐
3. Help的优化

更多更新资料放在Discord群上

【掷骰BOT】

暗骰功能在指令前输入dr 结果会私讯你例如输入2d6+1 攻撃！
会输出）2d6+1：攻撃9[6+3]+1 = 10
如上面一样,在骰子数字后方隔空白位打字,可以进行发言。
以下还有其他例子
5 3D6 ：分别骰出5次3d6
D66 D66s ：骰出D66 s小者固定在前
5B10：不加总的掷骰5B10S：不加总的掷骰，并按大至小排序
5B10 8：如上,另外计算其中有多少粒大过8
5U10 8：进行5D10 每骰出一粒8会有一粒奖励骰
5U10 8 9：如上,另外计算其中有多少粒大过9
Choice：启动语choice/随机/选项/选1
(问题)(启动语)(问题) (选项1) (选项2)
例子随机收到圣诞礼物数1 2 3 >4

随机排序：启动语排序
(问题)(启动语)(问题) (选项1) (选项2)(选项3)
例子交换礼物排序A君C君F君G君

• COC 六版判定CCb （目标値）：做出成功或失败的判定例）CCb 30 CCb 80
• COC 七版判定CCx（目标値） x：奖励骰/惩罚骰(2～n2)。没有的话可以省略。
  例）CC 30 CC1 50 CCn2 75
• coc7 角色背景：启动语coc7角色背景
• coc7 成长或增长检定：dp (技能) (名称)
  例）DP 80 侦查
• coc7 成长或增长检定：dp (技能) (名称)
  例）DP 80 侦查

现支援系统: 【了解骰组详情,请输入bothelp (编号) 或all 或在指令后输入help 如.sg help】
0: 进阶掷骰.ca (计算) D66(sn) 5B10 Dx 5U10 xy
1: 趣味掷骰排序(至少3个选项) choice/随机(至少2个选项) 每日塔罗运势立flag .me
2: 克苏鲁神话cc cc(n)1~2 ccb ccrt ccsu .dp .cc7build .cc6build .cc7bg
3: 朱の孤塔.al (nALx*p)
4: DX2nd,3rd .dx (xDX+y@c ET)
5: 命运Fate .4df(m|-)(加值)
6: 神我狩.kk (ET RT NT KT MTx)
7: 迷宫王国.mk (nMK+m 及各种表)
8: 永远的后日谈.nc (NM xNC+m xNA+m)
9: 亚侠必死的冒险.ss (nR>=x[y,z,c] SRx+y FumbleT)
10: 忍神.sg (ST FT ET等各种表)
11: 剑世界2.5 .sw (Kx Gr FT TT)
12: 歌风.UK (nUK nUK@c or nUKc)
13: WOD黑暗世界.xWDy
14: 猫猫鬼差.kc xDy z
15: (公测中)Wiki查询/图片搜索/翻译.wiki .image .tran
16: (公测中)暗骰GM功能.drgm (addgm del show) dr ddr dddr
17: (公测中)经验值功能.level (show config LevelUpWord RankWord)
18: (公测中)自定义骰子功能.ra(p)(次数) (add del show 自定关键字)
19: (公测中)储存掷骰指令功能.cmd (add del show 自定关键字)
20: (公测中)掷骰开关功能.bk (add del show)
21: (公测中)资料库功能.db(p) (add del show 自定关键字)