# NekoGakuen_DiscordFeedback.js - 使用手冊

:::danger
:::

> ## ◆ 目錄
> * [如何在 RPG Maker MV/MZ 軟體安裝本插件](#%E2%97%86-%E5%A6%82%E4%BD%95%E5%9C%A8-RPG-Maker-MVMZ-%E8%BB%9F%E9%AB%94%E5%AE%89%E8%A3%9D%E6%9C%AC%E6%8F%92%E4%BB%B6)
> * [如何將本插件連接到 Discord 伺服器](#%E2%97%86-%E5%A6%82%E4%BD%95%E5%B0%87%E6%9C%AC%E6%8F%92%E4%BB%B6%E9%80%A3%E6%8E%A5%E5%88%B0-Discord-%E4%BC%BA%E6%9C%8D%E5%99%A8)
> * [關於本插件參數設定的功能介紹](#%E2%97%86-%E9%97%9C%E6%96%BC%E6%9C%AC%E6%8F%92%E4%BB%B6%E5%8F%83%E6%95%B8%E8%A8%AD%E5%AE%9A%E7%9A%84%E5%8A%9F%E8%83%BD%E4%BB%8B%E7%B4%B9)
> * [如何在 RPG Maker MV/MZ 遊戲使用本插件的功能](#%E2%97%86-%E5%A6%82%E4%BD%95%E5%9C%A8-RPG-Maker-MVMZ-%E9%81%8A%E6%88%B2%E4%BD%BF%E7%94%A8%E6%9C%AC%E6%8F%92%E4%BB%B6%E7%9A%84%E5%8A%9F%E8%83%BD)
> * [如何在 RPG Maker MV/MZ 軟體安裝來自第三方的翻譯模組](#%E2%97%86-%E5%A6%82%E4%BD%95%E5%9C%A8-RPG-Maker-MVMZ-%E8%BB%9F%E9%AB%94%E5%AE%89%E8%A3%9D%E4%BE%86%E8%87%AA%E7%AC%AC%E4%B8%89%E6%96%B9%E7%9A%84%E7%BF%BB%E8%AD%AF%E6%A8%A1%E7%B5%84)
> * [著作聲明](#%E2%97%86-%E8%91%97%E4%BD%9C%E8%81%B2%E6%98%8E)
> * [附註：參考資源](#%E2%97%86-%E9%99%84%E8%A8%BB%EF%BC%9A%E5%8F%83%E8%80%83%E8%B3%87%E6%BA%90)

## ◆ 如何在 RPG Maker MV/MZ 軟體安裝本插件

#### **1.** 下載並解壓縮檔案之後，將本插件放在您的遊戲專案的`js/plugins/`資料夾。


#### **2.** 開啟您的遊戲專案後打開「插件管理器」(鍵盤快捷鍵為 <kbd>F10</kbd> )，並使用滑鼠左鍵兩下安裝插件。
:::info
<i class="fa fa-info-circle" aria-hidden="true"></i> RPG Maker MV 軟體及專案的核心版本建議為 1.6.2 以上版本為佳。
:::
:::spoiler <span style="color:LightSlateGrey;">**RPG Maker MV 場合**</span>


:::

:::spoiler <span style="color:LightSlateGrey;">**RPG Maker MZ 場合**</span>

:::

#### **3.** 在左上方選擇本插件後，在右邊區域的「參數」設定一些功能，而本插件「參數」的詳細功能，可參閱在「[關於本插件參數設定的功能介紹](#%E2%97%86-%E9%97%9C%E6%96%BC%E6%9C%AC%E6%8F%92%E4%BB%B6%E5%8F%83%E6%95%B8%E8%A8%AD%E5%AE%9A%E7%9A%84%E5%8A%9F%E8%83%BD%E4%BB%8B%E7%B4%B9)」。

:::spoiler <span style="color:LightSlateGrey;">**RPG Maker MV 場合**</span>
:::

:::spoiler <span style="color:LightSlateGrey;">**RPG Maker MZ 場合**</span>
:::

## ◆ 如何將本插件連接到 Discord 伺服器

#### **1.** 開啟瀏覽器軟體並前往以下網址，進行註冊或登入 Discord 帳號，並且下載 Discord 客戶端軟體至電腦上安裝。

:::info
**<i class="fa fa-link" aria-hidden="true"></i>** https://discord.com
:::


#### **2.** 在你的「Disocrd 伺服器」中的任何一個「文字頻道」按下「+」按鈕來「建立討論串」。


#### **3.** 在畫面右邊設定「討論串名稱」，並輸入任何一段文字內容以建立討論串。


:::info
<i class="fa fa-info-circle" aria-hidden="true"></i> 如果需要建立一個只有「遊戲開發人員」才能看到的遊戲反饋，可以勾選「私人討論串」即可。
:::

#### **4.** 在你的「Disocrd 伺服器」畫面左上角點擊你的伺服器名稱展開選單，並選擇「伺服器設定」。


:::warning
<i class="fa fa-exclamation-triangle" aria-hidden="true"></i> 「伺服器設定」的功能僅限擁有該伺服器「管理權限」的帳號才能使用。
:::

#### **5.** 在「整合」頁籤之下，選擇「Webhook」並按下「新 Webhook」新增。



#### **6.** 設定圖示、名稱，以及剛才建立「討論串」的該「文字頻道」後按「儲存變更」，之後按「複製 Webhook 網址」，並且到「[Discord Webhook連結](#%E2%94%80-Discord-Webhook-%E7%B6%B2%E5%9D%80)」貼上。


#### **7.** 開啟瀏覽器軟體並前往以下網址，在畫面右上角進行註冊或登入 Imgur 帳號。

:::info
**<i class="fa fa-link" aria-hidden="true"></i>** https://imgur.com
:::


#### **8.** 前往以下網址，並且依序輸入「Application name」、「Authorization callback URL」、「Email」，然後「Authorization callback URL」直接填入「https://imgur.com」就好，接著按下「submit」。

:::info
**<i class="fa fa-link" aria-hidden="true"></i>** https://api.imgur.com/oauth2/addclient
:::


:::info
<i class="fa fa-info-circle" aria-hidden="true"></i> 如果你要查看或編輯目前已經新增過的App及Client ID，可以到以下網址瀏覽：
https://imgur.com/account/settings/apps
:::

#### **9.** 複製「Client ID」，並且到「[Imgur 客戶端 ID](#%E2%94%80-Imgur-%E5%AE%A2%E6%88%B6%E7%AB%AF-ID)」貼上。


#### **10.** 開啟 Discord 客戶端軟體，在畫面左下角按下使用者名稱旁邊的「齒輪」圖示開啟「使用者設定」。


#### **11.** 在「進階」頁籤之下，將「開發者模式」的功能打開。


#### **12.** 回到我們之前已經建立的「討論串」按「滑鼠右鍵」選擇「複製討論串 ID」，並且到「[Discord 討論串ID](#%E2%94%80-Discord-%E8%A8%8E%E8%AB%96%E4%B8%B2ID)」貼上。


## ◆ 關於本插件參數設定的功能介紹

### ─ Discord Webhook 網址
---

指定在 Discord 文字頻道的 Webhook 網址。


### ─ Imgur 客戶端 ID
---

指定在 Imgur API 的客戶端 ID，用於上傳螢幕截圖。


### ─ Discord 討論串ID
---

指定在Discord文字頻道的討論串ID。


## ◆ 如何在 RPG Maker MV/MZ 遊戲使用本插件的功能

### ■ 呼叫反饋表單
---

在遊戲中呼叫反饋表單的視窗。

**● 插件命令：**
`NekoCommands DiscordFeedback_CallFeedback`

**● 腳本：**
`DiscordFeedbackManager.openBugReportWindow();`

## ◆ 如何在 RPG Maker MV/MZ 軟體安裝來自第三方的翻譯模組

#### **1.** 在您的遊戲專案打開「插件管理器」(鍵盤快捷鍵為 <kbd>F10</kbd> )，並且在本插件的上方使用滑鼠左鍵兩下安裝來自第三方的翻譯模組。

#### **2.** 接著在本插件的「<span style="color:DimGray;">＃→Translation Plugin Patch</span>」參數輸入翻譯模組的插件檔案名稱，之後的插件參數設定只要在您目前使用的第三方的翻譯模組設定即可。

:::spoiler <span style="color:LightSlateGrey;">**RPG Maker MV 場合**</span>

:::

:::spoiler <span style="color:LightSlateGrey;">**RPG Maker MZ 場合**</span>

:::

:::info
<i class="fa fa-info-circle" aria-hidden="true"></i> **關於翻譯模組**
由於作者本身沒有很多時間做插件翻譯，所以作者公開 **翻譯用插件模板(NekoGakuen_DiscordFeedback_TransMod.js)** 給其他想翻譯的人方便翻譯好直接使用，而不用再特地修改本插件，看得懂插件細節的人，再使用作者提供的插件模板進行翻譯。
:::

## ◆ 著作聲明

修改或翻譯本插件無需事前告知，如果插件有 BUG 可以回報。
本插件著作權為 [貓咪學園(NekoGakuen)](https://twitter.com/NekoGakuen) 所有。
並且保留對插件使用規則的修改與更動之權利。

**- 來源標示：**<span style="color:green;">【△ 不需要，但有的話會很感謝。**(註1)**】</span>
**- 商業營利：**<span style="color:green;">【√ 允許】</span>
**- 成人用途：**<span style="color:green;">【√ 允許】</span>

:::info
<i class="fa fa-info-circle" aria-hidden="true"></i> **註1：**
但如有註明的話，可以註明「NekoGakuen」即可。
:::

## ◆ 附註：參考資源

本次使用手冊的部分截圖，所使用的圖示素材來自「[Nicolae (Xelu) Berbece](https://twitter.com/xelubest)」所設計的免費圖示素材「[FREE Keyboard and controllers prompts pack](https://opengameart.org/content/free-keyboard-and-controllers-prompts-pack)」。

**《NekoGakuen》官方推特(X)**
https://x.com/NekoGakuen

**《NekoGakuen》官方網誌**
https://nekogakuen.blogspot.com

###### tags: `插件使用手冊` `貓咪學園` `NekoGakuen` `RPG Maker MV` `RPG Maker MZ`