將 Evennia 個頻道連線到 Discord¶

Discord 是一種受歡迎的聊天服務，尤其是遊戲社群。如果您的遊戲有 Discord 伺服器，您可以連線它到您的遊戲內頻道，以便在遊戲內和遊戲外之間進行交流。

設定不和諧¶

您需要做的第一件事是設定一個 Discord 機器人來連線到您的遊戲。進入機器人應用程式頁面並建立一個新的應用程式。你將需要「MESSAGE CONTENT」切換開啟，並將您的機器人代幣新增至您的設定。

# mygame/server/conf/secret_settings.py
DISCORD_BOT_TOKEN = '<your Discord bot token>'

如果尚未安裝，您還需要 pyopenssl 模組。將其安裝到您的 Evennia python 環境中

pip install pyopenssl

最後，在您的設定中啟用 Discord

DISCORD_ENABLED = True

啟動/重新載入 Evennia 並以特權使用者身分登入。你現在應該有一個新的可用指令：discord2chan。輸入 help discord2chan 進行解釋它的選項。

使用以下指令新增新的頻道連結：

 discord2chan <evennia_channel> = <discord_channel_id>

evennia_channel 引數必須是現有 Evennia 頻道的名稱， discord_channel_id 是 Discord 頻道的完整數字 ID。

您的機器人需要新增到正確的 Discord 伺服器並有權訪問通道以傳送或接收訊息。此指令NOT驗證你的機器人有 Discord 許可權！

逐步 Discord 設定¶

本節將介紹設定 Discord 的整個過程逐步連線到您的 Evennia 遊戲。如果您已完成其中任何一項步驟已經完成，請隨意跳到下一步。

建立 Discord 機器人應用程式¶

您將需要一個活躍的 Discord 帳戶和對 Discord 伺服器的管理員存取許可權以便將 Evennia 連線到它。這假設您已經這樣做了。

確保您已登入 Discord 網站，然後造訪 https://discord.com/developers/applications. 點選“新應用程式” 按鈕，然後輸入新應用程式的名稱 - 您的 Evennia 遊戲的名稱是不錯的選擇。

接下來，您將進入新應用程式的設定頁面。點選“機器人” 在側邊欄選單上，然後選擇“Build-a-Bot”以建立您的機器人帳戶。

**儲存顯示的令牌！ ** 這將是 Discord 允許的 ONLY 時間您可以看到該令牌 - 如果您遺失了它，則必須重設它。這個令牌是您的機器人如何確認其身份，因此非常重要。

接下來，將此令牌新增到您的_secret_ 設定中。

# file: mygame/server/conf/secret_settings.py

DISCORD_BOT_TOKEN = '<token>'

儲存後，向下滾動機器人頁面一點，找到切換按鈕 “訊息內容意圖”。您需要將其切換為 ON，否則您的機器人不會能夠閱讀任何人的訊息。

最後，您可以為新的機器人帳戶新增任何其他設定：顯示影象、顯示暱稱、簡介等。您可以隨時返回並更改這些內容，因此現在不用太擔心。

將您的機器人新增到您的伺服器¶

仍在新應用程式中時，請點選側面選單上的“OAuth2”，然後點選“URL 發電機」。在此頁面上，您將為您的應用程式產生邀請 URL，然後訪問 URL 將其新增至您的伺服器。

在頂部框中，找到 bot 的核取方塊並選中它：這將建立第二個出現許可權框。在該方塊中，您至少要勾選以下框：

閱讀訊息/檢影片道（在「一般許可權」）
傳送訊息（在「文字許可權」中）

最後，向下捲動到頁面底部並複製結果 URL。應該看起來像這樣：

https://discord.com/api/oauth2/authorize?client_id=55555555555555555&permissions=3072&scope=bot

訪問該連結，選擇用於 Evennia 連線的伺服器，然後確認。

將機器人新增至您的伺服器後，您可以進一步微調許可權透過通常的 Discord 伺服器管理。

啟動 Evennia 中的 Discord¶

在連線之前，您還需要對 Evennia 遊戲執行兩件事不和諧。

首先，將 pyopenssl 安裝到您的虛擬環境中（如果尚未安裝）。

pip install pyopenssl

其次，在您的設定檔中啟用 Discord 整合。

# file: server/conf/settings.py
DISCORD_ENABLED = True

啟動或重新載入遊戲以應用更改的設定，然後以帳戶身份登入至少具有 Developer 許可權並在 Evennia 上初始化機器人帳戶 discord2chan 指令。您應該會收到一條訊息，表明機器人已建立，並且沒有與 Discord 的活動連結。

將 Evennia 頻道連線到 Discord 頻道¶

您將需要 Evennia 頻道的名稱以及 Discord 的頻道 ID 頻道。當您造訪某個頻道時，頻道 ID 是 URL 的最後一部分。

e.g。如果網址是https://discord.com/channels/55555555555555555/12345678901234567890 那麼您的頻道 ID 是 12345678901234567890

使用以下指令連結兩個通道：

discord2chan <evennia channel> = <discord channel id>

兩個通道現在應該互相中繼。透過發布來確認這是否有效 evennia 頻道上的訊息，以及 Discord 頻道上的另一個訊息 - 他們應該兩者都出現在另一端。

如果您沒有看到任何來自 Discord 的訊息，請確保您的機器人有權讀取和傳送訊息並且您的應用程式具有 “訊息內容意圖”標誌設定。

進一步定製¶

discord2chan 的幫助檔案包含有關如何使用該指令的更多資訊自訂您轉發的訊息。

但是，對於更複雜的事情，您可以建立自己的子類 DiscordBot 並將其新增到您的設定中。

# file: mygame/server/conf/settings.py
# EXAMPLE
DISCORD_BOT_CLASS = 'accounts.bots.DiscordBot'

如果您已經設定了 Discord 中繼並且想要更改此設定，請確保您要麼刪除 Evennia 中的舊機器人帳戶，要麼更改其 typeclass，否則不會生效。

核心 DiscordBot 帳戶類別已經設定了幾個有用的掛鉤處理和中繼 Discord 和 Evennia 頻道之間的頻道訊息，以及（預設未使用）direct_msg 鉤子，用於處理傳送到的 DM Discord 上的機器人。

預設僅處理訊息和伺服器更新，但 Discord 自訂協議將所有其他未處理的排程資料傳遞到 Evennia 機器人帳戶這樣您就可以自己新增額外的處理。但是，此整合不是完整的庫 並且沒有記錄所有可能發生的 Discord 事件。