DRRR 機器人插件設定手冊

等房功能

定時查看房間是否有空位，如果有則跳轉該房。

匹配規則模式：

• 以房間 ID
• 以 tripcode
• 以使用者名稱
• 以房間名稱

儲存規則

跳轉模式：

• 直接跳轉
• 跳轉前詢問

搜尋使用者/房間

搜尋模式：

• 以 tripcode 搜尋
• 以使用者名稱搜尋
• 以房間名稱搜尋

搜尋
加入至收藏

收藏通知/列表

開啟收藏通知（有人上線或房間創立）
顯示所有收藏規則
顯示線上所有符合的 tripcode 使用者
顯示線上所有符合規則的使用者
顯示線上所有符合規則的房間
顯示線上所有房間

展開待播清單

功能鍵

從待播刪除 立即播放 收藏樂曲

展開收藏清單

功能鍵

加入待播 立即播放 從收藏刪除

當搜尋欄有關鍵字時

功能鍵

展開搜尋結果 播放最關聯搜尋結果 加入最關聯結果至待播清單

搜尋結果：剛好遇見你

功能鍵

加入待播 立即播放 收藏樂曲

TRPG inspired by @少女

更換角色：

• 主持人
• 一般玩家

主持人可以透過圖片 URL 更換所有玩家的背景圖

其他人可以使用 1D20 之類的 TRPG 骰子指令請求主持人擲骰

Room guard 門神

模式：

• mode 0: 訪客如果進房後沒有任何動作，將在下次進房被 kick/ban。
• mode 1: 時間內內沒說話，詢問是否 kick/ban。
• mode 2: 時間內沒說話，倒數然後 kick/ban
• mode 3: 時間內沒說話，直接 kick/ban

Background Effect 背景特效

刷新聊天室即可終止特效

模式：

• 下雪
• 煙花
• 電梯

Guess the number 猜數字遊戲

設定題目：

• 方法 1：直接用 /start 觸發，數字會隨機生成
• 方法 2：輸入四位數字並按下 完成設置，按下 宣佈遊戲開始

簡易規則：每次系統提示內容為 - NANB
A：數字正確且位置正確
B：數字正確但位置錯誤
例子：隨機數為 1658 ，聊天室輸入 2680，系統會顯示 2680：1A1B

Timer Configuration (定時器配置)

功能

定時執行定義的動作。

格式

分鐘數, "函數", ["參數", ...]

函數

提供的函數可以參考函數說明

特殊變量

可以在參數裡面使用特殊時間變量：

• %年 年份，中文數字
• %月 月份，中文數字（一至十二）
• %日 日期，中文數字
• %星 星期幾，中文
• %Y 年份，四位數字西元年
• %M 月份，一至二位數字
• %D 日期，一至二位數字
• %d 星期幾，英文全寫
• %H 時，數字（24 時制）
• %h 時，數字（12 時制）
• %c 上下午，英文 a.m. p.m.
• %m 分，數字
• %s 秒，數字
• %% 轉義字符 %

範例

10, "msg", ["every 10 mins report once!"]
2, "msg", ["It's a Report Message", "Now is %H:%m!"]

Welcome Configuration (歡迎詞配置)

功能

有人進入房間後，如果名稱匹配正則表達式，則自動發出歡迎詞。

格式

兩種格式，歡迎詞可以多個（隨機選擇並發出）

"用戶名(正則表達式)", "歡迎詞"
"用戶名(正則表達式)", ["歡迎詞", "歡迎詞", ...]

注意

• 記得要加雙引號 "。
• 由上往下匹配，匹配成功則不繼續往下匹配規則。
• 空字串 "" 或正則字串 ".*" 可以匹配全部。

特殊變量

• $user 進入房間的成員名稱。
• $ 轉義字符 $。

範例

對名字裡面有 lambda 和其後跟著 cat （中間可能夾有一些字）的使用者說 hello, kitty，對其他人則說 hello/HI!! 加上 使用者名稱。

"lambda.*cat", "hello, kitty"
".*", ["hello $user", "HI!! $user"]

WhiteList Configuration (白名單配置)

功能

使用正則表達式，自動踢出不在名單內的特定使用者。

格式

用戶名(正則表達式)

注意

• 記得要不加雙引號（除非想匹配有雙引號的 ID）。

範例

只允許以 cat 結尾或是神秘開頭為名稱的使用者。

cat$
^神秘

BlackList Configuration (黑名單配置)

功能

使用正則表達式，自動踢出名單內的特定使用者。

格式

用戶名(正則表達式)

注意

• 記得要不加雙引號（除非想匹配有雙引號的 ID）。

範例

踢出名字含有 otoko 的使用者及一些符合條件的機器人。

otoko
机器人|機器人
小冰|小氷|测试姬

BanAbuse Configuration (禁止詞配置)

功能

使用正則表達式過濾聊天內容，自動踢出說出禁用詞的使用者。

格式

禁用詞(正則表達式)

注意

• 記得要不加雙引號（除非想匹配有雙引號的禁用詞）。

範例

聊天內容含有說到 狗 或是 阿姆斯特朗炮 的成員會被踢出。

狗
阿姆斯特朗炮

EventAction Configuration (事件動作配置)

功能

對於一些事件，這裡提供一些函數，可以訂一些相應的動作。
定義的動作只有在用戶名稱及用戶發送的內容符合正則表達式 (RegExp) 才會被觸發。
其實前面的功能：歡迎詞/白名單/黑名單/禁止詞，都可用此功能實作。

格式

"事件類型", "用戶匹配", "內容匹配", "函數", ["參數", ...]
["事件類型", ...], "用戶匹配", "內容匹配", "函數", ["參數", ...]

事件類型

當…

• new-host 房主易位
• room-profile 房名改變
• new-description 房間敘述改變
• join 成員加入
• leave 成員離開
• kick 有人被踢出
• ban 有人被禁止進入
• unban 有人被解除禁止進入
• dm 私訊
• msg 普通訊息
• me 以 /me 發出的訊息（小字）
• dmto 自己私訊給別人
• submit 自己送出訊息
• roll 有人搖了一個人
• music 播放音樂（某人播放了音樂）
• musicbeg 音樂開始（進度條開始）
• musicend 音樂結束（進度條結束）

用戶匹配

用戶匹配可以是一個人名的 RegExp 或是 Tripcode 的 RegExp，
如果兩個規則都有的話則都需要滿足。

"浪打" <- 名字有 "浪打" 的人
"#.*cat" <- tc 有 cat 的人（忽略大小寫）
"浪打#.*cat" <- 名字有 "浪打" 且 tc 有 cat 的人

內容匹配

內容匹配則是單純的一串 RegExp。

函數

提供的函數可以參考函數說明

特殊參數變量

• %Y 年份，四位數字西元年
• %年 年份，中文數字
• %M 月份，一至二位數字
• %月 月份，中文數字（一至十二）
• %D 日期，一至二位數字
• %日 日期，中文數字
• %d 星期幾，英文全寫
• %星 星期幾，中文
• %H 時，數字（24 時制）
• %h 時，數字（12 時制）
• %c 上下午，英文 a.m. p.m.
• %m 分，數字
• %s 秒，數字
• %% 轉義字符 %

• $user 發送訊息的使用者名稱
• $cont 使用者發送的內容
• $args 使用者發送內容第一個空格後的所有內容
  使用者發送：play BUMP OF CHICKEN「Hello,world!」
$args：BUMP OF CHICKEN「Hello,world!」
• $url 使用者夾上的 URL
• $ 轉義字符 $

特殊參數用法

這裡還有一些特殊用法。
對於收到的訊息，會以空格分開成參數列，而用引號可以避免分開。
而對分開的內容，可以用以下方法作為參數。

• $N N 為數字，以數字取第 N 個參數，從零開始。
• $[N-M] 取從 N 到 M 的參數。N 不給則從零開始，M 不給取到最後。

特殊函數

• $tenor(keyword) 回傳 tenor 搜尋的 gif URL
• $giphy(keyword) 回傳 giphy 搜尋的 gif URL

參數圖示

this is  a  message send from user
---- --  -  ------- ---- ---- ----
$0   $1  $2 $3      $4   $5   $6
----------------------------------
$cont

發送字串：
this is a "another message" send from 'another user'

引號會被拿掉，但裡面空格不會被切開：
this is a  another message  send from  another user
---- -- -  ---------------  ---- ----  ------------
$0   $1 $2 $3               $4   $5    $6
     ----------------------------------------------
     $args
---------  --------------------- ------------------
$[-2]      $[3-4]                $[5-]
---------------------------------------------------
$[-]

範例

"msg", "", "^/tenor", "umsg", ["$tenor($args)", "$args"]
"msg", "", "^/giphy", "umsg", ["$giphy($args)", "$args"]
"msg", "", "^/play", "plym", ["$args"]
"leave", "", "", "msg", ["$user bye!"]

調用

/tenor 貓
/giphy iron man
/play yellow

函數 [參數列] 說明：

• msg ["訊息", "訊息", ...]
  從訊息中選擇一個推送。
• umsg ["URL", "訊息", ...]
  夾帶 URL 並隨機選擇一個訊息推送。
• dm ["使用者名稱", "訊息", "訊息", ...]
  私訊使用者，選擇一個訊息私訊。
• udm ["使用者名稱", "URL", "訊息", ...]
  私訊使用者，夾帶 URL 並隨機選擇一個訊息私訊。
• kick ["使用者名稱"]
  踢出使用者。
• ban ["使用者名稱"]
  踢出並屏蔽使用者。
• banrpt ["使用者名稱"]
  踢出並屏蔽舉報使用者。
• plym ["歌曲關鍵字"]
plym ["歌曲關鍵字", "數字"]
plym ["歌曲關鍵字", "音源"]
plym ["歌曲關鍵字", "數字", "音源"]
plym ["歌曲關鍵字", "音源", "數字"]
  播放音樂。
  1. “關鍵字”：歌曲關鍵字。
  2. “數字”：第 “數字” 個搜尋結果。
  3. “音源”：音源，目前有 “千” 和 “易”, “狗”, “我” 及 “Ｙ” 可以使用。
• addm ["歌曲關鍵字"]
addm ["歌曲關鍵字", "數字"]
addm ["歌曲關鍵字", "音源"]
addm ["歌曲關鍵字", "數字", "音源"]
addm ["歌曲關鍵字", "音源", "數字"]
  加入音樂至待播清單。
  1. “關鍵字”：歌曲關鍵字。
  2. “數字”：第 “數字” 個搜尋結果。
  3. “音源”：音源，目前有 “千” 和 “易”, “狗”, “我” 及 “Ｙ” 可以使用。
• delm ["數字"]
  從清單刪除音樂（依索引數字）。
• lstm []
  列出待播清單。
• nxtm []
  播放下一首曲子。
• pndm []
pndm ["歌曲關鍵字"]
pndm ["歌曲關鍵字", "數字"]
pndm ["歌曲關鍵字", "音源"]
pndm ["歌曲關鍵字", "數字", "音源"]
pndm ["歌曲關鍵字", "音源", "數字"]
  無參數則列出待播清單。
  如當前沒音樂，播放音樂。
  如有音樂，將音樂加入清單
  如關鍵字為空字串，列出待播清單。
  1. “關鍵字”：歌曲關鍵字。
  2. “數字”：第 “數字” 個搜尋結果。
  3. “音源”：音源，目前有 “千” 和 “易”, “狗”, “我” 及 “Ｙ” 可以使用。
• schm ["歌曲關鍵字"]
schm ["歌曲關鍵字", "音源"]
  列出搜尋結果。
  1. “關鍵字”：歌曲關鍵字。
  2. “音源”：音源，目前有 “千” 和 “易”, “狗”, “我” 及 “Ｙ” 可以使用。
• horm ["使用者名稱"]
  轉移房主權限給該使用者。
• ocdr []
  離開房間又進入房間。
• gofr ["房間名稱(RegExp)"]
  前往符合房間名稱的房間。若失敗則回到原房間。

me 可以用 /me + 推送訊息 以 msg 達成。

浪語

細節請參考 wiki。

套件管理器

選擇 mirror 後，點選 update 更新套件索引。
之後可以選擇分類和套件，可以把他載入到編輯器或是儲存到本地。

本地的套件勾選後，可以選擇預載入，或是刪除。
重新開啟視窗，如果是有句選，就代表為預載入套件。

確定預載入後，在編輯器以套件名作為函數調用。
（套件通常會提供這個函數，但具體還是要看套件內容定義）

運行成功！

你也可以 fork 一份 bs-pkgs 維護一個 mirror，
然後透過 add_mirror(alias, repo) 來添加你的 mirror。

或者直接呼叫也行

要刪除的話就呼叫 del_mirror(alias)。