# 咕嚕靈波（●′∀‵）ノ♡

###### tags: `超異域公主連結☆Re:Dive` `公主連結` `Discord` `Bot` `Discord Bot` `報刀機器人`

> Discord報刀機器人
> 神奇真步魔法靈 咕嚕靈波（●′∀‵）ノ♡
> 各位都該來報刀囉!


此機器人為報刀機器人，可支援同一DC群多戰隊同時使用。
權限由高而低主要區分為四者:管理員、戰隊隊長、控刀手、一般成員，
各自擁有不同的指令可以使用。

指令全方面支援全形半形繁體/簡體/英文。
此外，英文縮寫對照表可於下方常見問題中查詢。

[**真步邀請連結**](https://discord.com/api/oauth2/authorize?client_id=806421470368104449&permissions=0&scope=bot%20applications.commands)

## 章節
[ToC]

## :memo: 特色介紹
- 支援同伺服器，多戰隊同時使用。
- 指令支援繁體、簡體、英文、全形與半形
- 可匯出CSV刀表，方便戰後統計
- 指令權限管控
- 便利排刀功能
- 自動tag出刀人員
- 週目紀錄
- 保留機制

## :memo: 初始化
### 1. 建立頻道與設定權限
:exclamation:本指令僅限**管理員**使用

權限設置教學請參考[官方說明文件](https://support.discord.com/hc/zh-tw/articles/206029707-%E5%A6%82%E4%BD%95%E8%A8%AD%E5%AE%9A%E6%AC%8A%E9%99%90-)
請**管理員**為每個戰隊新增兩個頻道，名稱不限，權限設定如下:
- 報刀頻道(僅將發言權限給予**戰隊內成員**，並給予**機器人**發言權限)
- 刀表頻道(僅將發言權限給與**戰隊隊長**，並給予**機器人**發言權限)
- 指令表頻道(選用，機器人有發言權限即可)

以兩個戰隊作為範例，如下圖

### 2. 建立戰隊並指派戰隊隊長
**管理員**在任意機器人所在頻道中，
將mention的人作為該戰隊隊長，
使用以下任一指令建立戰隊
> !建立戰隊 \[編號\] \[成員\]
> !建立战队 \[編號\] \[成員\]
> !cg \[編號\] \[成員\]


:::info
:star: **參數格式:**
\[編號\]:阿拉伯數字
\[成員\]:@Mention

:bulb: **Hint:**
你也可以同時指派很多位戰隊隊長:
> !建立戰隊 \[編號\] \[成員\] \[成員\]......\[成員\]
:::

### 3. 設定刀表頻道
:exclamation:本指令僅限**戰隊隊長**使用
由**戰隊隊長**送出以下任一指令，機器人會認定該頻道是該戰隊刀表位置。
為了解釋方便，往後稱該頻道為"刀表頻"。
> !刀表在此
> !tc


### 4. 設定報刀頻道
:exclamation:本指令僅限**戰隊隊長**使用
由**戰隊隊長**送出以下任一指令，機器人會認定該頻道是該戰隊報刀位置。
為了解釋方便，往後稱該頻道為"報刀頻"。
> !報刀在此
> !报刀在此
> !sc


### 5. 新增控刀手
:exclamation:本指令僅限**戰隊隊長**使用
機器人會將Mention的身分組作為控刀手。
> !控刀手身分組 \[身分組\]
> !cr \[身分組\]
:::info
:star: **參數格式:**
\[身分組\]:@Mention
:::

至此機器人安裝完成。

---

## :memo: \[管理員\]戰隊管理指令
### 新增戰隊
:exclamation:本指令僅限**管理員**可以使用
> !建立戰隊 \[編號\] \[成員\]
> !建立战队 \[編號\] \[成員\]
> !cg \[編號\] \[編號\]
:::info
:star: **參數格式:**
\[編號\]:阿拉伯數字
\[成員\]:@Mention

:bulb: **Hint:**
你也可以同時指派很多位戰隊隊長:
> !建立戰隊 \[編號\] \[成員\] \[成員\]......\[成員\]
:::


---

### 刪除戰隊
:exclamation:本指令僅限**管理員**可以使用
手起刀落，謹慎使用。
> !刪除戰隊 \[編號\]
> !删除战队 \[編號\]
> !dg \[編號\]
:::info
:star: **參數格式:**
\[編號\]:阿拉伯數字
:::


---
### 重新設定戰隊隊長
:exclamation:本指令僅限**管理員**可以使用
就是重新設定戰隊隊長
> !戰隊隊長 \[編號\] \[成員\]
> !战队队长 \[編號\] \[成員\]
> !gc \[編號\] \[成員\]
:::info
:star: **參數格式:**
\[編號\]:阿拉伯數字
\[成員\]:@Mention

:bulb: **Hint:**
你也可以同時指派很多位戰隊隊長:
> !戰隊隊長 \[編號\] \[成員\] \[成員\]......\[成員\]
:::


---

### 顯示所有戰隊資訊
:exclamation:本指令僅限**管理員**可以使用
亦可用來檢查機器人是否存活，又或是資料有無健在。
> !戰隊列表
> !战队列表
> !gl


## :memo: \[戰隊隊長\] 戰隊隊長管理指令
### 控刀手身分組
把mention身分組設定為控刀手。
> !控刀手身分組 [身分組]
> !控刀手身分组 [身分組]
> !cr [身分組]

---

### 刀表在此
指定某一頻道作為顯示刀表的頻道，建議設定不可發言。
> !刀表在此
> !刀表在此
> !tc

---

### 報刀在此
指定某一頻道作為報刀的頻道，請用權限控制，僅有戰隊成員可發言。
> !報刀在此
> !报刀在此
> !sc

---

### 提前週目
設定可以提前幾個週目預約。
> !提前週目 [幾週]
> !提前周目 [幾週]
> !wo [幾週]

---

### 清除刀表
清除刀表，打掉重來。
> !清除刀表
> !清除刀表
> !ct

---

### 刀表樣式
切換刀表樣式。
0:Embed, 1:Text。
> !刀表樣式 [代號]
> !刀表样式 [代號]
> !ts [代號]

---

### 匯出刀表
傳送完整csv刀表到私人訊息。
> !匯出刀表
> !汇出刀表
> !e

---

## :memo: \[控刀手\]控刀指令
### 移動某一刀
:exclamation:本指令僅限控刀手可以使用
可用來調整刀表次序。
> !移動 \[週目\] \[boss\] \[第幾刀\] \[新週目\] \[新boss\]
> !k \[週目\] \[boss\] \[第幾刀\] \[新週目\] \[新boss\]

:::info
:star: **參數格式:**
\[週目\]:阿拉伯數字
\[boss\]:阿拉伯數字
\[第幾刀\]:阿拉伯數字
\[新週目\]:阿拉伯數字
\[新boss\]:阿拉伯數字
:::


---

### 刪除某一刀
:exclamation:本指令僅限控刀手可以使用
從刀表上砍了某刀，謹慎使用。
> !刪除 \[週目\] \[幾王\] \[第幾刀\]
> !删除 \[週目\] \[幾王\] \[第幾刀\]
> !fd \[週目\] \[幾王\] \[第幾刀\]

:::info
:star: **參數格式:**
\[週目\]:阿拉伯數字
\[幾王\]:阿拉伯數字
\[第幾刀\]:阿拉伯數字
:::


---

### 幫某人報刀
:exclamation:本指令僅限控刀手可以使用
就是幫某個人報刀，記得Memtion對人。
> !幫報 \[週目\] \[幾王\] \[註解\] \[成員\]
> !帮报 \[週目\] \[幾王\] \[註解\] \[成員\]
> !hp \[週目\] \[幾王\] \[註解\] \[成員\]
:::info
:star: **參數格式:**
\[週目\]:阿拉伯數字
\[幾王\]:阿拉伯數字
\[註解\]:任意，但不可包含空白
\[成員\]:@Mention
:::

---

### 幫某人報"保留"刀
:exclamation:本指令僅限控刀手可以使用
就是幫某個人報**保留**刀，記得Memtion對人。
> !幫報 \[週目\] \[幾王\] \[註解\] \[成員\]
> !帮报 \[週目\] \[幾王\] \[註解\] \[成員\]
> !hp \[週目\] \[幾王\] \[註解\] \[成員\]
:::info
:star: **參數格式:**
\[週目\]:阿拉伯數字
\[幾王\]:阿拉伯數字
\[註解\]:任意，但不可包含空白
\[成員\]:@Mention
:::


---

### 刪除保留刀
:exclamation:本指令僅限控刀手可以使用
從刀表上砍了某刀，謹慎使用。
> !刪除保留刀 \[第幾刀\]
> !删除保留刀 \[第幾刀\]
> !fdkp \[第幾刀\]

:::info
:star: **參數格式:**
\[第幾刀\]:阿拉伯數字
:::


---

### 設定週目
:exclamation:本指令僅限控刀手可以使用
強制調整當前boss進度，請指明週目與第幾boss。
> !設定 \[週目\] \[幾王\]
> !设定 \[週目\] \[幾王\]
> !s \[週目\] \[幾王\]

:::info
:star: **參數格式:**
\[週目\]:阿拉伯數字
\[幾王\]:阿拉伯數字
:::


---

## :memo: 一般指令
### 報刀
:exclamation:本指令僅能在報刀頻使用
預約報刀指令如下，請指明週目、幾王、以及想要留下的註解:
> !預約 \[週目\] \[幾王\] \[註解\]
> !预约 \[週目\] \[幾王\] \[註解\]
> !p \[週目\] \[幾王\] \[註解\]
:::info
:star: **參數格式:**
\[週目\]:阿拉伯數字
\[幾王\]:阿拉伯數字
\[註解\]:任意，但不可包含空白
:::

---

### 取消報刀
:exclamation:本指令僅能在報刀頻使用，只能取消自己的刀。
取消預約報刀指令如下，請指明週目、幾王、第幾刀:
> !取消預約 \[週目\] \[幾王\] \[第幾刀\]
> !取消预约 \[週目\] \[幾王\] \[第幾刀\]
> !cp \[週目\] \[幾王\] \[第幾刀\]
:::info
:star: **參數格式:**
\[週目\]:阿拉伯數字
\[幾王\]:阿拉伯數字
\[第幾刀\]:阿拉伯數字
:::


---

### 報"保留"刀
:exclamation:本指令僅能在報刀頻使用
報保留刀指令如下，請指明是幾王刀、以及想要留下的註解:
> !報保留刀 \[幾王\] \[註解\]
> !报保留刀 \[幾王\] \[註解\]
> !kp \[幾王\] \[註解\]
:::info
:star: **參數格式:**
\[幾王\]:阿拉伯數字
\[註解\]:任意，但不可包含空白
:::


---

### 使用"保留"刀
:exclamation:本指令僅能在報刀頻使用
將保留刀使用於指定週目與boss。
> !使用保留刀 \[第幾刀\] \[週目\] \[boss\]
> !使用保留刀 \[第幾刀\] \[週目\] \[boss\]
> !ukp \[第幾刀\] \[週目\] \[boss\]
:::info
:star: **參數格式:**
\[第幾刀\]:阿拉伯數字
\[週目\]:阿拉伯數字
\[boss\]:阿拉伯數字
:::


---

### 取消"保留"刀
:exclamation:本指令僅能在報刀頻使用
刪除自己報的保留刀。
> !取消保留刀 \[第幾刀\]
> !取消保留刀 \[第幾刀\]
> !ckp \[第幾刀\]
:::info
:star: **參數格式:**
\[第幾刀\]:阿拉伯數字
:::


---

### 現在進度如何?
:exclamation:本指令僅能在報刀頻使用
顯示當前進度。
> !目前進度
> !目前进度
> !ns


---

### 王死了，下一王
:exclamation:本指令僅能在報刀頻使用
推進進度，並mention下一王的人來出刀。
> !下面一位
> !n


---

### 大佬該出來打王了
:exclamation:本指令僅能在報刀頻使用
推進進度，並mention下一王的人來出刀。
> !出來打王
> !出来打王
> !hb


---
### 機器人怎麼用?
顯示指令表。
> !幫助
> !帮助
> !h

## 常見問題 Q&A
### 繁簡英縮對照表
繁體中文|簡體中文|英文|英文縮寫
-----------|----------|---------------|-------
建立戰隊 |建立战队 |create guild |cg
刪除戰隊 |删除战队 |delete guild |dg
戰隊隊長 |战队队长 |guild captain |gc
戰隊列表 |战队列表 |guild list |gl
控刀手身分組 |控刀手身分组|controller role |cr
刀表在此 |刀表在此 |table channel |tc
報刀在此 |报刀在此 |sign channel |sc
提前週目 |提前周目 |week offset |wo
設定 |设定 |setting |s
歷史紀錄在此 |历史纪录在此 |log channel |lc
保存 |保存 |keep |k
移動 |移动 |move |m
刪除 |删除 |force delete |fd
幫報 |帮报 |help propose |hp
預約 |预约 |propose |p
取消預約 |取消预约 |cancel propose |cp
取消所有 |取消所有 |cancel propose all|cpa
目前進度 |目前进度 |now schedule |ns
下面一位 |下面一位 |next |n
出來打王 |出来打王 |hit boss |hb

---

### 如果巴拉怎麼辦?
不要理他!

---

### 如果巴拉巴拉怎麼辦?
不要理他!

---

### 如果巴拉巴拉巴拉怎麼辦?
很重要要說三次，不要理他!