原
雲羽機器人、CloudFeather Announcement Bot等名稱，因為名稱太亂，就整理一下了
Important
本機器人為 510208 為雲羽生存服開發的機器人，專案所有權仍為 510208 所有，因此即使雲羽生存服關閉，你也仍然可以使用它！
這是一個提供給 🪶Minecraft 雲羽伺服器 的 Discord Bot，由服主 SamHacker 編寫。為了幫助更多人而不限於我們伺服器內部，我將此專案開源出來給大家使用
你可以使用虛擬環境或直接搭建，以下分析兩種方式的優缺點：
| 📦 虛擬環境 | ⏰ 直接搭建 | |
|---|---|---|
| 原理 | 在電腦上建立一個虛擬的、與本機隔離的獨立 Python 環境， 並在那之中運行機器人，就像沙箱一樣！ |
使用原本就安裝在電腦上的 Python 原生環境直接運行機器人， 這種方法你可以打少少的指令完成一個部署，期待嗎？ |
| 優點 | ||
| 缺點 |
搭建在 Python 虛擬環境中是個不錯的主意！如此一來，你可以比較不需要擔心插件衝突的問題，並且它提供了你未來擴充機器人的彈性。想像一下，未來你的機器人可以幫你管整個 Minecraft 伺服器，聽起來是不是很心動？
心動不如馬上行動，我們開始吧！
- 先前往 Python 官網 下載並安裝 Python
喔對了！我使用的是 Python 3.10.6，我可以保證這個版本下的程式可以正常運作！
請記得，安裝時必須要勾選
Add Python 3.x to PATH，否則待會的操作會很麻煩喔... - 安裝完成後，你可以在網頁最上面有綠色
<> Code按紐，按下它之後點選"Download ZIP"（在最下方），下載後解壓縮 （Zip 格式可以用 Windows 10 以上的系統解壓），或是使用以下兩個按鈕下載發行版與開發中版本
- 按住 Shift 鍵並在資料夾中右鍵，選擇"使用 PowerShell 開啟"
- 會跳出一個看起來很複雜的視窗，不用怕，直接貼上下面這段就好，記得一行一行貼：
$ python -m venv
$ cd .venv/Scripts
$ activate
$ pip install -r requirements.txt請記得，前面的錢號不用打進去，那代表你要自己輸入的意思 5. 現在你搭建好了！恭喜你！！
Important
建議採用虛擬環境安裝方式，請跳過本章，前往 建立機器人
很簡單，首先先照上方虛擬方式的方法執行，但你只需要打這些指令即可：
$ pip install -r requirements.txt（是的沒錯就這麼少）
如果你看到了這裡，恭喜你已經完成了一半！再來你需要去建立一個 Discord 機器人，請照以下教學處理：
- 前往 https://discord.com/developers/applications 網站並登入自己的 Discord 帳號
- 單按右上紫色的 "New Applaction"，它會幫你建立一個新的機器人。然後會跳出一個如圖的訊息，輸入你希望機器人的名字，然後打勾勾按 Create 建立機器人：
- 切換到左列的 Bot，將底下三個 "Privileged Gateway Intents" 的勾都勾上：
- 滑到上方，單按 Token 下大大的 "Reset Token"。點下去，如果你有雙步驟驗證請打一下驗證碼：
- 看到一組亂碼，存下來千萬別告訴別人。打開軟體的資料夾找到
token.txt（無請自行建立） ，將剛剛的亂碼貼進這個文件中這組亂碼跟你的密碼是一樣的，因此千萬要小心不要分享給人。只要別人擁有這組亂碼，他就可以在你的 Discord 群組中為所欲為！
- 如果因為某些原因不方便將 TOKEN 貼在檔案中，或是使用 Bot 託管服務有需要，可不建立
token.txt改採建立環境變數CFBOT_TOKEN的方式 （1.0.5 更新，此項特性僅適用於更新後的 CFBot）
恭喜你進度條到了 99%，剩下最後一件事就是雙按 main.py 啟動機器人。
如果看到類似以下的訊息，代表你已經可以去找機器人...了嗎？
228: [2024-06-29 21:16:46,384][INFO] - [main] 載入annou_stat.py中...
30: [2024-06-29 21:16:46,412][INFO] - [annou_stat] AnnouStat cog 已經載入
230: [2024-06-29 21:16:46,415][INFO] - [main] 載入annou_stat.py成功
237: [2024-06-29 21:16:46,416][INFO] - [main] 跳過nlfile.py, 原因：採用nl方式跳過載入
239: [2024-06-29 21:16:46,416][INFO] - [main] 跳過__pycache__
603: [2024-06-29 21:16:46,417][INFO] - [client] logging in using static token
561: [2024-06-29 21:16:48,248][INFO] - [gateway] Shard ID None has connected to Gateway (Session ID: 6989b35e31230ee56a079ae50220d5a3).
28: [2024-06-29 21:16:50,347][INFO] - [main] Logged in as (機器人名稱)#(機器人編號) (ID: 機器人ID)
對，現在機器人啟動了。但你有沒有發現一件事情：
我的伺服器裡還是沒這隻機器人啊！！！！
因此讓我們邀請機器人吧！
- 切換到 https://discord.com/developers/applications，點擊你剛剛建立好的機器人之後切換到左列 OAuth 中：
- 拉到下方
OAuth2 URL Generator，勾選 bot，然後勾選"Adminstrator"給機器人管理權限 GENERATED URL即為邀機器人進服的方法！
Caution
編輯完配置後記得要使用 Reload 指令以加載新版本
請參考 cfg.yml 中的設定資訊來做執行
首先，我個人也不是什麼太厲害的人，對於這邊的貢獻流程如果有建議歡迎提 Issue 補充！總之非常感謝你願意看到這一步，如果你也想為這個專案做貢獻，請照以下說明操作：
discord.errors.PrivilegedIntentsRequired: Shard ID None is requesting privileged intents that have not been explicitly enabled in the developer portal. It is recommended to go to https://discord.com/developers/applications/ and explicitly enable the privileged intents within your application's page. If this is not possible, then consider disabling the privileged intents instead.
以上是特權網關意圖錯誤，如果你的錯誤碼類似這樣，請前往 Discord Developer Portal，進入機器人選項後在 Bots 底下的"Privileged Gateway Intents"全部勾選後 Save 並且重啟即可排除
discord.errors.LoginFailure: Improper token has been passed.
類似以上訊息，可能是你的 Token 錯誤。請照上方教學重新前往開發者面板並取得新的 Token 後 再次嘗試，仍然錯誤再前來詢問
Caution
如果 Token 被你誤發到 Github 等平台，Discord 也會自動重置該組 Token 以防止意外發生
如果你遇到以下情況，請照這個章節的說明操作：
- 遇到 Traceback 錯誤以致無法執行或啟動
- 執行或啟動過程中遇到 Traceback 錯誤，但仍能繼續走流程
- 或其他問題適合提 Issue
請在 Issues 中提出問題，並提供以下必須資訊（如果不提供或找不到，我們有權利不做受理）：
- Python 版本與機器人版本（可以透過 Git 檢視 Commit 的編號）
- 錯誤內容
- 如何啟動這個錯誤
- 發現時間
- 是否已經確定不是自己問題
有部分錯誤已知解決方法並列在常見錯誤區段中，請自行先做檢查後再提 Issue，否則我們有權不受理
非常謝謝你願意協助這個機器人的完善，未來我會考慮更換一下這個機器人的名稱。順帶一提，本機器人應該不會是 Nether Bot 的繼承人（至少現在不會）
如果你要協助開發，請參考CONTRIBUTING.md的描述，謝謝您
Important
我們目前不接受任何格式的贊助，非常遺憾
非常感謝 @510208 的開發，與以下用戶的協助：
| 用戶或團體 | 內容 |
|---|---|
| 雲羽生存服 | 提供 Discord 群組做為測試之用 |
| Asteroid Bot Hosting | 提供機器人 24 小時託管 |
| LunarKdeo3147 | 協助測試專案與提供建議 |
| !夜間部（ @woodypegasus382 ） | 提供 ticket.py 開發協助 |
與你的使用！