Skip to main content

如何回報錯誤

回報錯誤對於這個開源專案至關重要。

所以請考慮在我們的 問題跟踪器 上報告錯誤

但在報告錯誤之前,你應該閱讀以下故障排除指南。

你遇到的許多問題都可以由你解決,為我們節省大量時間和精力。

故障排除指南

本指南旨在幫助你識別問題並告知 可以採取哪些措施來防止這些問題。

如果都沒有用,我們也會教你如何製作詳細和有效的錯誤報告,以便給你最好的幫助。

另請參閱: 常見問題

但首先:

永遠記住,黏液科技是開源和社區開發的。

但最重要的是:它是免費的...

所以 請不要 期望我們神奇地為你解決所有問題並 24/7 提供服務。

如果你真的喜歡這個插件,那麼請遵循這個指南,它會讓我們的生活更輕鬆,並幫助我們專注於重要問題。

這是你最起碼能做到並可以減輕我們的負擔的事。

1. 檢查你在使用的版本

檢查版本是 絕對的關鍵 ,僅此步驟就可以解決 90%的問題。

收集下列資訊:

  • 你的伺服器軟件 (你正在運行 Bukkit、Spigot、Paper 還是其他軟件?)
  • 你的 Minecraft 版本 (是 1.8,是 1.14,還是 1.9001? 你應該知道的。)
  • 你的黏液科技版本 (你安裝了什麼版本? 它是 DEV 版本還是 “穩定” 版本?)

你可以通過運行指令 /sf versions 快速收集所有這些信息。

如果你的伺服器管理員沒有授予你訪問此命令的權限,則 Shift 並右鍵單擊您的 Slimefun 指南,那裡應該有一本書籍和羽毛筆,至少可以告訴你你的 Minecraft 和黏液科技版本。 這已經很有幫助了!

如果你向我們報告錯誤,那麼我們將需要此信息,否則我們絕對沒有機會弄清楚需要處理的問題。

這就像在一堆乾草中發現一根釘子,但是這堆乾草著火了,並且與釘子在完全不同的星球上。

所以,請,拜託告訴我們你正在運行的確切版本,“最新” 沒有幫助

2. 檢查有無更新

下一步是將你在第 1 步中獲得的版本與最新版本進行比較。

  • 你的服務器軟件是最新的嗎? (檢查 Spigot、Paper、Bukkit 或你正在使用的任何東西是否有更新)
  • 黏液科技是最新的嗎? (你可以在下載頁面查看是否有比你的版本 更新的版本
  • 你使用的是 DEV 構建嗎? (穩定的構建非常 “穩定” 但並非無缺陷)

補充最後一點:我們不會接受來自 “穩定” 版本的錯誤報告,請切換到更高版本的開發版本,然後先查看你的問題是否仍然存在。

如果你沒有對服務器的文件訪問權限,請聯繫你的一位管理員,向他們解釋你的問題並將他們鏈接到本指南。

3. 嘗試重開你的伺服器

這不是一個玩笑。 嘗試將其關閉再打開,通常它可以正常運作並解決你的問題。

4. 看看是不是已知問題

看看我們的 問題跟踪器

可能你的問題已經被回報過了,這種情況下請不要再回報。 但我們鼓勵你對該問題發表評論,並提供一些有關你如何重現該問題的信息。

5. 搜索錯誤報告和堆棧跟蹤

在你冒險尋找那些錯誤報告和堆棧跟蹤之前,請記住,在通過我們的問題跟蹤器報告時,這些內容應該始終通過 pastebin 發布。

  1. 導航到目錄 /plugins/Slimefun/error-reports/ 並檢查那裡是否生成了任何錯誤報告。

    如果它們與問題相關,請將它們與你的問題一起發布。

  2. 打開伺服器的控制台並檢查是否可以看到任何堆棧跟蹤。

(堆棧跟蹤是那些看起來非常可怕的東西,你無法思考如何閱讀它們) 看看裡面是否出現了 “slimefun” 這個短語。 然後將其附加到你的錯誤報告中。

始終發布完整的堆棧跟踪非常重要,少了一個字它就沒用了,所以請確保你有完整發布所有內容。

請注意,其中有 “slimefun” 字眼的堆棧跟踪甚至直會接說它們是由 Slimefun 引起的BUG,但它們可能無關黏液科技。

如果你安裝的插件之一的名稱出現在該堆棧跟踪中,請將其發佈在該插件的錯誤跟踪器上。

如果你沒有對服務器的文件訪問權限,請聯繫你的一位管理員,向他們解釋你的問題並將他們鏈接到本指南。

6. 確保它是黏液科技!

當你在黏液科技中遇到內容問題時,請確保物品目 / 方塊 / 機器實際上來自黏液科技,而不是來自其他附加。

如果你的問題與異域花園或任何其他黏液科技插件的附加有關,請在它們的錯誤跟踪器上回報,而不是在這裡。

7. 收集盡可能多的資訊

當我們說你應該詳細點的時候,我們是認真的。

請在報告前試試一些東西。

  • 是只有那個物品受到影響,還是其他(類似)物品也壞掉了?
  • 該錯誤是否僅在你持有某個物品時才會發生?
  • 你是否有試過跳躍、左鍵或右鍵點擊或四處跑跳?
  • 這個問題是否需要一個人在你背後觀察?
  • 這個問題只發生在你的伺服器上嗎? 你有在我們的Discord伺服器上跟別人聊過嗎?

這只是些或多或少嚴重的例子。 每一個資訊都會有幫助。

越詳細、範圍越窄越好

8. 透過 GitHub 回報問題

如果更新或重啟沒有效果,請透過我們的 問題跟踪器 報告你的問題。

  • 我們需要你在步驟 1 中收集的所有版本信息。
  • 請詳細描述你的問題
  • 向我們提供有關你在該問題發生時所做的事的具體資料
  • 解釋你 期望 會發生什麼,對應該發生什麼的誤解也可能是問題的根本原因

我們希望這個小指南可以幫助你做出有用且準確的錯誤報告。

謝謝你走到這一步!