# 關於我們 (/docs)



# ☕ Coffee Host 超大咖託管 [#-coffee-host-超大咖託管]

想架設一個 Minecraft ⛏️ 伺服器嗎？選擇<u>**超大咖託管**</u>就對了！

## 👍 我們的優勢 [#-我們的優勢]

### ⭐ 超便宜的價格換到物超所值的伺服器體驗 [#-超便宜的價格換到物超所值的伺服器體驗]

**月繳只要 NT$89** 起，即可獲得一台高品質伺服器！

### 🇹🇼 超低延遲的抗攻擊連線 [#-超低延遲的抗攻擊連線]

採用台灣速連與多家抗 DDoS 攻擊廠商，保護伺服器的同時，延遲只有 **3ms**！<br />
臺灣本地機房，連線勝於新加坡、香港、日本等其他亞洲地區託管，遊玩不卡頓！<br />

#### 註：從臺北測試的數據，其他地區延遲可能更高或更低。中華電信光世代網路實測：新竹連線 4ms、高雄連線 7ms。 [#註從臺北測試的數據其他地區延遲可能更高或更低中華電信光世代網路實測新竹連線-4ms高雄連線-7ms]

### ⚡ 超強的硬體配置 [#-超強的硬體配置]

從 Intel® Xeon® 處理器到最新發售的 💻 **AMD Ryzen™ 9 9950X** 伺服器我們都有，您絕對能選到最適合您的系列！<br />
最高 **DDR5** 記憶體以及全系列採用**高速 NVMe SSD**，讀寫超快！

### 💾 每日檔案備份 [#-每日檔案備份]

我們**每天會進行節點檔案備份作業**，並且資料保留至少三天，全方面保護您的伺服器資料安全！

### 🎛️ 功能齊全的控制面板 [#️-功能齊全的控制面板]

使用 Pterodactyl 圖形化控制面板，並且面板擁有中文介面，我們花許多心思在建構面板上，製作了許多功能，例如**一鍵模組包安裝器**，安裝模組包不再是麻煩事！安裝後開機，即可開始遊玩您的模組世界！

### 📶 支援 UDP 基岩版通訊協議 [#-支援-udp-基岩版通訊協議]

Minecraft 伺服器全系列附贈 UDP 通訊協議，您可以輕鬆架設 Geyser，讓手機版也能與電腦版一起遊玩伺服器！
並且我們亦有販售[**基岩版伺服器**](https://store.coffeehost.net/store/tw-bedrock)，下單後啟動即可直接連線遊玩！

### 📚 教學文檔與專業客服支援 [#-教學文檔與專業客服支援]

我們提供[**教學文檔**](https://docs.coffeehost.net)以及專業支援，遇到任何問題我們都能盡可能幫您解決！

## 🔥 熱賣系列 [#-熱賣系列]

* [**臺灣 Minecraft 輕量主機**](https://store.coffeehost.net/store/tw-light)：價格絕對便宜，架設生存伺服器超輕鬆！
* [**臺灣 Minecraft 性能主機**](https://store.coffeehost.net/store/tw-performance)：最高 i9-13900 處理器，架設小型插件/模組服都可以！
* [**臺灣 Minecraft 極致主機**](https://store.coffeehost.net/store/tw-extreme)：&#x2A;*隆重當場！臺灣第一家 9950X 伺服器託管，極致效能！**

**👑 立即體驗超優質伺服器（Java 任意版本）：**test.coffeehub.club****

* ⭐ 官方網站：[https://coffeehost.net](https://coffeehost.net)
* 📚 官方文檔：[https://docs.coffeehost.net](https://docs.coffeehost.net)
* 🛒 官方商店：[https://store.coffeehost.net](https://store.coffeehost.net)
* 💬 Discord ：[https://discord.gg/hpe2aWVaYs](https://discord.gg/hpe2aWVaYs)



<Accordions>
  <Accordion title="Coffee Host 可以做什麼？">
    您可以在我們這裡架設 Minecraft 伺服器、Discord 機器人或者是其他服務。
  </Accordion>

  <Accordion title="可以 24 小時運行伺服器嗎？">
    只要不要遇到設備維護或不可抗力因素，都是可以 24 小時運行的。
  </Accordion>

  <Accordion title="我要怎麼選購？">
    立即前往 [官方商店](https://store.coffeehost.net/) 購買！
  </Accordion>

  <Accordion title="遇到問題怎麼辦？">
    您可以透過 [Discord](https://discord.gg/hpe2aWVaYs) 客服單聯繫我們的客服人員。
  </Accordion>
</Accordions>


# 連線問題排查 (/docs/debug/connection)





使用超大咖託管服務時，若遇到連線問題，請先依照您使用的服務類型，按照以下步驟快速排查原因。

<Callout type="info" title="回報問題前請先準備">
  請記下發生問題的時間、使用的網路環境（家用網路、公司網路或行動網路）、連線位址與連接埠，以及完整的錯誤訊息。需要提供截圖時，請保留完整畫面，不要只截取單一錯誤文字。
</Callout>

## 依服務類型排查 [#依服務類型排查]

<Accordions>
  <Accordion title="Minecraft Java">
    <Steps>
      <Step>
        ### 檢查封鎖狀態並視情況更換連線位址 [#檢查封鎖狀態並視情況更換連線位址]

        請先在瀏覽器開啟 [https://fast-line.tw/](https://fast-line.tw/)。如果無法瀏覽，通常表示目前連線已被抗攻擊上游的防火牆判定為異常流量並封鎖。

        如果確認被封鎖，請暫時將 Minecraft 的連線位址改為 `udp.cfh.tw:<連接埠>`。例如原本使用 `a.x.cfh.tw:13105`，請暫時改為 `udp.cfh.tw:13105`。

        若後續上游已解除封鎖，建議使用原本的連線位址。為避免再次遭到封鎖，請不要頻繁進出伺服器，也不要太頻繁重新整理伺服器列表，避免短時間內產生大量連線請求。
      </Step>

      <Step>
        ### 設定 Google DNS 並清除快取 [#設定-google-dns-並清除快取]

        完成第一步後若仍然無法連線，請依照 [Google DNS 教學](/docs/debug/googledns) 將 DNS 設定為 `8.8.8.8` 與 `8.8.4.4`。

        開啟命令提示字元，執行以下指令清除 DNS 快取：

        ```text
        ipconfig /flushdns
        ```

        使用 `nslookup <主機位址>` 確認輸出中的 **Server** 或 **伺服器** 是否為 `8.8.8.8` 或 `8.8.4.4`，再重新開啟 Minecraft 連線。
      </Step>

      <Step>
        ### 3. 使用 Cloudflare WARP 改善路由 [#3-使用-cloudflare-warp-改善路由]

        如果 Google DNS 及清除 DNS 快取後仍然無法連線，請依照 [Cloudflare WARP 教學](/docs/debug/warp) 安裝並連線，再使用相同的 Minecraft 連線位址重新嘗試。
      </Step>

      <Step>
        ### 4. 仍無法連線或延遲很高時回報 [#4-仍無法連線或延遲很高時回報]

        如果上述方法都無法解決問題，或使用原本位址及 `udp.cfh.tw:<連接埠>` 時延遲都很高，請前往 [Discord 客服群組](https://discord.gg/hpe2aWVaYs) 開啟「售後服務」客服單，並提供：

        * [MTR 路由追蹤](/docs/debug/mtr) 的完整 WinMTR 截圖。
        * Minecraft 無法連線、Connection Reset、逾時或延遲異常的完整遊戲畫面截圖。
        * 使用的連線位址與連接埠、發生時間、網路環境，以及已嘗試過的 Google DNS、替代位址或 WARP 步驟。
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Minecraft 基岩版／Hytale／Palworld">
    <Steps>
      <Step>
        ### 1. 先確認連線位址 [#1-先確認連線位址]

        這些遊戲請使用包含 `udp.cfh.tw` 的正確連線位址，例如 `udp.cfh.tw:<連接埠>`。請確認連接埠數字與客服或服務面板提供的資料一致，不要直接套用 Minecraft Java 的連線位址或連接埠。
      </Step>

      <Step>
        ### 2. 使用 Cloudflare WARP 改善路由 [#2-使用-cloudflare-warp-改善路由]

        如果確認連線位址正確後仍然無法連線，請依照 [Cloudflare WARP 教學](/docs/debug/warp) 開啟 WARP，等待顯示已連線後，再使用相同的 `udp.cfh.tw:<連接埠>` 位址重新嘗試。
      </Step>

      <Step>
        ### 3. 仍無法連線時提供資料 [#3-仍無法連線時提供資料]

        如果開啟 WARP 後仍然無法連線，請依照 [MTR 路由追蹤](/docs/debug/mtr) 執行 WinMTR，並在問題發生時保存完整結果。

        前往 [Discord 客服群組](https://discord.gg/hpe2aWVaYs) 開啟「售後服務」客服單時，請一併提供：

        * 以 `udp.cfh.tw:<連接埠>` 為目標的完整 MTR／WinMTR 截圖。
        * 遊戲顯示無法連線、逾時、Connection Reset 或其他錯誤的完整畫面截圖。
        * 使用的遊戲、連線位址與連接埠、發生時間、網路環境，以及詳細問題描述。
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="VPS">
    <Steps>
      <Step>
        ### 1. 確認 VPS 位址並執行 MTR [#1-確認-vps-位址並執行-mtr]

        如果 VPS 上的網站、面板、遠端桌面或其他服務無法連線，請先確認使用的是正確的 VPS IP 位址或網域，以及正確的服務連接埠。接著依照 [MTR 路由追蹤](/docs/debug/mtr) 執行 WinMTR，主機欄位填入 VPS 的 IP 位址或網域，不要填入連接埠。
      </Step>

      <Step>
        ### 2. 使用 Cloudflare WARP 改善路由 [#2-使用-cloudflare-warp-改善路由-1]

        完成第一步後，請依照 [Cloudflare WARP 教學](/docs/debug/warp) 開啟 WARP，等待顯示已連線後，再使用相同的 VPS 位址及服務連接埠重新嘗試連線。
      </Step>

      <Step>
        ### 3. 提供服務連線問題資料 [#3-提供服務連線問題資料]

        請前往 [Discord 客服群組](https://discord.gg/hpe2aWVaYs) 開啟「售後服務」客服單，並提供：

        * 以 VPS IP 位址或網域為目標的完整 MTR／WinMTR 截圖。
        * 您的服務連線有問題的完整截圖，例如瀏覽器錯誤、SSH、遠端桌面或服務端的錯誤訊息。
        * 發生時間、服務名稱與連接埠、使用的網路環境，以及問題的詳細情況。
      </Step>
    </Steps>
  </Accordion>
</Accordions>

<Callout type="warn" title="MTR 截圖注意事項">
  請在發生問題的那台電腦與相同網路環境下執行 WinMTR，等待 **Sent** 超過 100 後提供完整視窗截圖。請不要裁切節點、遺失率或最後一列的資料，這些資訊有助於我們判斷問題所在。
</Callout>


# Google DNS (/docs/debug/googledns)

















當您遇到 Minecraft 主機無法連線、網域解析失敗、顯示找不到主機，或不同網路環境取得的解析結果不一致時，可以先將 Windows 的 DNS（網域名稱系統）改為 **Google Public DNS** 測試。

Coffee Host 使用的網路線路皆具備備援機制；當單一線路或節點發生故障時，系統會自動切換至可用的備援路徑。因此，如果 Minecraft 主機本身正常，但您遇到暫時連不進去的情況，建議先改用 Google DNS，讓電腦重新取得較新的主機解析結果。

相較於部分 ISP 預設 DNS，Google DNS 通常能較快重新查詢並取得更新後的 DNS 記錄，對剛完成切換、異動或修復的 Minecraft 主機尤其有幫助；實際更新時間仍會受網域 TTL、ISP 快取及各地 DNS 狀況影響。

<Callout type="info" title="Google DNS 的額外優點：ECS">
  Google Public DNS 支援 &#x2A;*EDNS Client Subnet（ECS）**。在 ISP、CDN 及權威 DNS 支援 ECS 的情況下，解析服務可以依據使用者所在網路的大致位置，選擇較合適的 IP 及網路路由，讓 ISP 有機會將連線導向較好的路徑。ECS 只提供部分網段資訊，並不保證每次都會降低延遲或改善路由。
</Callout>

Google Public DNS 主要負責網域解析，不會修復伺服器離線、連接埠封鎖、實體線路中斷或服務本身故障。完成設定後若問題仍然存在，請將測試結果、錯誤訊息與發生時間一併提供給客服團隊。

<Callout type="warn" title="修改前請先確認">
  本教學只需要修改 DNS 伺服器欄位，請勿任意變更 IP 位址、子網路遮罩、預設閘道或其他網路設定。若這台電腦由公司、學校或 VPN 管理，DNS 可能會被管理政策自動覆寫。
</Callout>

## Google Public DNS 位址 [#google-public-dns-位址]

| 通訊協定 | 慣用 DNS 伺服器             | 其他 DNS 伺服器             |
| ---- | ---------------------- | ---------------------- |
| IPv4 | `8.8.8.8`              | `8.8.4.4`              |
| IPv6 | `2001:4860:4860::8888` | `2001:4860:4860::8844` |

## Windows 通用設定方式（以 Windows 10 示範） [#windows-通用設定方式以-windows-10-示範]

以下使用 Windows 10 的傳統「網路連線」介面示範。這個方法透過 `ncpa.cpl` 開啟網路介面卡設定，不依賴特定版本的「設定」頁面；其他 Windows 版本只要能開啟相同介面，也可以按照相同步驟操作。

請依照下列步驟在 Windows 10 的傳統網路介面中設定 DNS；其他 Windows 版本若畫面文字略有不同，請尋找相同功能名稱即可。

<Steps>
  <Step>
    ### 開啟網路介面卡清單 [#開啟網路介面卡清單]

    1. 按下 **Win + R** 開啟「執行」視窗。
       <img alt="圖片" src="__img0" />
    2. 輸入 `ncpa.cpl`，按下 **Enter**。
       <img alt="圖片" src="__img1" />
    3. 在「網路連線」視窗中，找出目前正在使用的 Wi-Fi 或乙太網路介面卡。
       <img alt="圖片" src="__img2" />
  </Step>

  <Step>
    ### 開啟 IPv4 內容 [#開啟-ipv4-內容]

    在介面卡上按右鍵，選擇 **內容**。在清單中點選 &#x2A;*網際網路通訊協定第 4 版（TCP/IPv4）**，再按 **內容**。
        <img alt="圖片" src="__img3" />
  </Step>

  <Step>
    ### 填入 DNS 並套用 [#填入-dns-並套用]

    在 IPv4 內容視窗中：

    1. 保持 **自動取得 IP 位址** 的選項及原有 IP 設定不變。
    2. 選取 **使用下列 DNS 伺服器位址**。
    3. 慣用 DNS 輸入 `8.8.8.8`，其他 DNS 輸入 `8.8.4.4`。
    4. 按 **確定**，再按介面卡內容視窗的 **確定**。
       <img alt="圖片" src="__img4" />
  </Step>
</Steps>

## 清除 DNS 快取並確認設定 [#清除-dns-快取並確認設定]

修改完成後，建議清除 Windows 的 DNS 快取，再確認系統是否使用 Google DNS：

1. 按下 **Win + R**，輸入 `cmd`，按下 **Enter**。

2. 在命令提示字元輸入以下指令並按下 **Enter**：

   ```text
   ipconfig /flushdns
   ```

3. 接著輸入以下指令：

   ```text
   nslookup coffeehost.net
   ```

4. 查看輸出內容中的 **Server** 或 **伺服器**，確認 DNS 位址顯示為 `8.8.8.8` 或 `8.8.4.4`。如果顯示的是 VPN、路由器或公司內部 DNS，表示目前設定可能被其他網路服務覆寫。
   <img alt="圖片" src="__img5" />

## 遇到問題時 [#遇到問題時]

<Callout type="warn" title="設定後無法上網">
  回到相同的 DNS 設定畫面，將設定方式改回 &#x2A;*自動（DHCP）**，或在 Windows 10 的 IPv4 內容選擇 **自動取得 DNS 伺服器位址**，儲存後重新連線。請不要自行修改 IP 位址、子網路遮罩或預設閘道。
</Callout>

* VPN、防毒軟體、公司／學校網路政策或瀏覽器的安全 DNS 功能，可能會覆寫 Windows 的 DNS 設定。
* DNS 變更無法修復伺服器離線、路由異常、連接埠封鎖或服務本身故障；這些問題請另外提供錯誤訊息及連線測試結果。
* Google Public DNS 是第三方 DNS 服務。若您不希望使用，請將設定恢復為自動（DHCP）。

<Callout type="info" title="Google DNS 仍無法解決時">
  如果已完成本教學、清除 DNS 快取並確認設定，Minecraft 仍然無法連線、頻繁逾時或延遲偏高，請接著參考 [Cloudflare WARP 教學](/docs/debug/warp)，改用另一條網路傳輸路徑。WARP 是 Google DNS 之後的下一步，不需要重複修改本頁的 DNS 設定。
</Callout>

如果 Google DNS 與 WARP 都無法解決問題，請將 `nslookup` 結果、錯誤訊息及發生問題的時間一併回報客服，以便我們進一步協助。


# ChatGPT (/docs/debug/gpt)

















<Callout title="善用 AI 工具">
  ChatGPT 是一個強大的 AI 工具，可以幫助您快速分析伺服器錯誤訊息，找出問題所在。
</Callout>

# 什麼時候該使用 ChatGPT？ [#什麼時候該使用-chatgpt]

當您的伺服器發生錯誤時，控制台會顯示錯誤訊息（Error
Log）。這些訊息通常包含了問題的原因，但對於新手來說可能不太容易理解。這時候就可以利用 ChatGPT 來幫助您分析這些錯誤訊息。

常見的錯誤情況包括：

* 伺服器無法啟動
* 插件發生衝突或錯誤
* 遊戲崩潰（Crash）
* 記憶體不足（Out of Memory）

<img alt="錯誤訊息範例" src="__img0" />

# 如何使用 ChatGPT 分析錯誤 [#如何使用-chatgpt-分析錯誤]

<Steps>
  <Step>
    ### 複製錯誤訊息 [#複製錯誤訊息]

    在控制台中找到錯誤訊息，通常會以紅色或黃色顯示，並包含 `ERROR`、`WARN`、`Exception` 等關鍵字。

    1. 前往面板的「控制台」頁面
    2. 在終端區域找到錯誤訊息，錯誤通常會有以下特徵：
       * 以 `[ERROR]` 或 `[WARN]` 開頭
       * 包含 `Exception`、`Error`、`Caused by` 等字樣
       * 顯示一長串以 `at` 開頭的堆疊追蹤（Stack Trace）
    3. 使用滑鼠選取錯誤訊息，建議從錯誤開始往上多選幾行，以包含更多上下文
    4. 使用滑鼠右鍵並點擊 `複製/Copy` 複製選取的內容

        <img alt="複製錯誤訊息" src="__img1" />

    <Callout type="info">
      如果錯誤訊息很長，建議全部複製。不完整的錯誤訊息可能會導致分析不準確。
    </Callout>
  </Step>

  <Step>
    ### 打開 ChatGPT [#打開-chatgpt]

    1. 前往 [ChatGPT](https://chat.openai.com/) 網站
    2. 您無需建立帳號即可直接使用基本功能
    3. 若您希望未來能回顧這些除錯紀錄，建議您免費註冊一個專屬帳號。

        <img alt="ChatGPT 首頁" src="__img2" />

    <Callout type="info">
      您也可以使用其他 AI 工具，例如 

      [Claude](https://claude.ai/)

      、

      [Google Gemini](https://gemini.google.com/)

       或 

      [Bing Copilot](https://copilot.microsoft.com/)

      ，操作方式類似。
    </Callout>
  </Step>

  <Step>
    ### 詢問 ChatGPT [#詢問-chatgpt]

    1. 在對話框中輸入您的問題，建議使用以下格式：

    ```
    我的 Minecraft 伺服器出現以下錯誤，請幫我分析原因並提供解決方案：

    伺服器類型：Paper 1.20.4
    問題描述：伺服器啟動時崩潰

    錯誤訊息：
    [貼上錯誤訊息]
    ```

    2. 將剛才複製的錯誤訊息貼上（`Ctrl + V`）
    3. 按下 Enter 或點擊發送按鈕

        <img alt="詢問 ChatGPT" src="__img3" />
  </Step>

  <Step>
    ### 閱讀分析結果 [#閱讀分析結果]

    ChatGPT 會為您分析錯誤原因，並提供可能的解決方案。回覆通常會包含：

    * **錯誤原因**：說明為什麼會發生這個錯誤
    * **問題插件/模組**：如果是插件問題，會指出是哪個插件造成的
    * **解決方案**：一步一步的修復建議

        <img alt="ChatGPT 分析結果" src="__img4" />

    請仔細閱讀並嘗試建議的解決方法。如果解決方案不夠清楚，可以繼續追問。
  </Step>

  <Step>
    ### 執行解決方案 [#執行解決方案]

    根據 ChatGPT 的建議進行操作，常見的解決方式包括：

    * **更新插件**：前往插件的官方頁面下載最新版本
    * **移除衝突插件**：將有問題的插件從 `plugins` 資料夾移除
    * **修改設定檔**：根據建議修改相關的 `.yml` 或 `.properties` 檔案
    * **增加記憶體**：如果是記憶體不足，考慮升級方案

    完成修改後，重新啟動伺服器測試是否解決問題。
  </Step>
</Steps>

<Callout type="warn" title="注意事項">
  * ChatGPT 的回答可能不一定完全正確，請謹慎評估後再執行建議的操作。 -
    如果問題仍然無法解決，請將錯誤訊息與 ChatGPT
    的分析結果一併提交給客服，以便我們更快速地協助您。 -
    請勿在對話中透露任何敏感資訊，例如密碼、API 金鑰等。
</Callout>

# 提問技巧 [#提問技巧]

為了讓 ChatGPT 給出更準確的回答，您可以：

1. **提供完整的錯誤訊息**：不要只複製一小段，盡量包含完整的錯誤堆疊（Stack
   Trace）。
2. **說明您的環境**：告訴 ChatGPT 您使用的伺服器類型（Paper、Spigot、Forge 等）和版本。
3. **描述發生情況**：說明錯誤是在什麼情況下發生的，例如「安裝新插件後」或「更新伺服器後」。
4. **追問細節**：如果 ChatGPT 的回答不夠清楚，可以繼續追問更多細節。

# 常見問題範例 [#常見問題範例]

以下是一些常見的錯誤類型和對應的提問方式：

### 插件錯誤 [#插件錯誤]

```
我的 Paper 1.20.4 伺服器在啟動時出現插件錯誤，請幫我分析：

[17:32:45 ERROR]: Error occurred while enabling ExamplePlugin v1.0
org.bukkit.plugin.InvalidPluginException: java.lang.NoClassDefFoundError...
```

### 記憶體不足 [#記憶體不足]

```
我的 Minecraft 伺服器出現 OutOfMemoryError，伺服器配置為 4GB 記憶體，
約有 30 個插件，請問該如何解決？

java.lang.OutOfMemoryError: Java heap space
```

### 版本不相容 [#版本不相容]

```
我將伺服器從 1.19 升級到 1.20 後出現以下錯誤，請問是什麼原因？

[錯誤訊息]
```

# 問題仍然無法解決？ [#問題仍然無法解決]

如果嘗試了 ChatGPT 的建議後問題仍然存在，請透過以下方式聯繫我們：

1. 將完整的錯誤訊息複製保存
2. 截圖 ChatGPT 的分析結果
3. 記錄您已經嘗試過的解決方法
4. 前往 [Discord 群組](https://discord.gg/hpe2aWVaYs)
   或開啟客服單，並提供以上資訊

<img alt="聯繫客服" src="__img5" />

<Callout type="info">
  提供越完整的資訊，我們就能越快幫您解決問題！
</Callout>


# 路由追蹤 (/docs/debug/mtr)











當您在遊玩過程中遭遇與伺服器連線不穩定、頻繁斷線，或是完全無法建立連線的情況時，問題可能出在您的網路與伺服器節點之間的路由傳輸上。為了讓我們能更有效地協助您排解問題，請在 Windows 系統上使用 **WinMTR** 工具進行路由追蹤（Traceroute）。

<Callout type="info">
  **什麼是 WinMTR？**\
  WinMTR 是一款結合了 `ping` 與 `traceroute` 功能的網路診斷工具，它能顯示封包從您的電腦傳送到伺服器所經過的所有節點，以及各節點的延遲與遺失率。
</Callout>

### 必備工具下載 [#必備工具下載]

請先點擊下方連結下載 WinMTR 工具：
[下載 WinMTR 工具 (https://cdn.hypernetwork.tw/WinMTR.exe)](https://cdn.hypernetwork.tw/WinMTR.exe)

### 執行路由追蹤教學 [#執行路由追蹤教學]

<Steps>
  <Step>
    ### 輸入伺服器位址 [#輸入伺服器位址]

    開啟 WinMTR 後，請在介面上方的「主機 (Host)」欄位中輸入您伺服器的**連線位址**。
    &#x2A;注意：請勿輸入連接埠 (Port)。例如，若連線位址為 `a.x.cfh.tw:13105`，您只需輸入 `a.x.cfh.tw` 即可。*
        <img alt="圖片" src="__img0" />
  </Step>

  <Step>
    ### 開始測試並等待數據收集 [#開始測試並等待數據收集]

    點擊「開始 (Start)」按鈕讓程式開始傳送封包。請耐心等待列表中「Sent (已傳送)」的數值超過 **100**，這能確保收集到的連線數據具有足夠的參考價值。
        <img alt="圖片" src="__img1" />
  </Step>

  <Step>
    ### 截圖與回報 [#截圖與回報]

    當「Sent」超過 100 後，請點擊「截圖至剪貼簿」按鈕，並連同您的問題描述一併回傳給我們的客服團隊。
        <img alt="圖片" src="__img2" />
  </Step>
</Steps>

### ⚠️ 測試注意事項 [#️-測試注意事項]

<Callout type="warn">
  **網路環境限制**\
  請務必在**發生連線問題的那台客戶端電腦**上直接進行測試，且測試期間**請勿使用 VPN、加速器或任何代理服務**，否則測試結果將無法真實反映您原始網路的連線狀況。
</Callout>

<Callout type="error">
  **完整截圖要求**\
  請提供 WinMTR 的**完整視窗截圖**，切勿裁切或遮蔽任何內容。畫面中的任何詳細資訊對於我們交叉比對連線紀錄至關重要。
</Callout>

**💡 額外提示：**

* 建議在連線異常發生的**當下立即執行**此工具，以捕捉最真實的錯誤狀態。
* 若您遭遇的是 Minecraft 伺服器無法連線的問題，回報時請**額外附上 Minecraft 遊戲客戶端畫面中顯示的錯誤訊息截圖**。


# 找不到 Jar (/docs/debug/nojar)











當您啟動伺服器卻立刻遭遇崩潰時，其中一個最常見的原因是控制面板無法找到指定的啟動檔案。在 Java 環境中，這通常會反映為無法存取 `.jar` 檔案。

以下為控制面板終端機可能輸出的錯誤訊息範例：

```text
[Coffee Host 主控臺]: 正在更新进程配置文件...
[Coffee Host 主控臺]: 确保文件权限设置正确，这可能需要几秒钟...
container@coffeehost~ Server marked as starting...
[Coffee Host 主控臺]: 正在拉取 Docker 容器镜像，这可能需要几分钟才能完成...
Pulling from ptero-eggs/yolks 
Digest: sha256:afbe93630fc543361cd463630335fc04d799d52e1e87ca8d87005938e0508ad2 
Status: Image is up to date for ghcr.io/ptero-eggs/yolks:java_25 
[Coffee Host 主控臺]: Docker 容器镜像已拉取完成
container@coffeehost~ java -version
openjdk version "25.0.3" 2026-04-21 LTS
OpenJDK Runtime Environment Temurin-25.0.3+9 (build 25.0.3+9-LTS)
OpenJDK 64-Bit Server VM Temurin-25.0.3+9 (build 25.0.3+9-LTS, mixed mode, sharing)
container@coffeehost~ java -Xms128M -XX:MaxRAMPercentage=95.0 -Dterminal.jline=false -Dterminal.ansi=true -jar server.jar
Error: Unable to access jarfile server.jar
container@coffeehost~ Server marked as offline...
[Coffee Host 主控臺]: ---------- 检测到服务器进程处于崩溃状态！ ----------
[Coffee Host 主控臺]: 退出代码: 1
[Coffee Host 主控臺]: 内存不足: false
```

### 診斷問題 [#診斷問題]

<Callout type="info">
  在上述繁雜的啟動日誌中，請注意這行關鍵錯誤訊息：\
  `Error: Unable to access jarfile server.jar`\
  這句話明確表示伺服器啟動程序在嘗試執行 `server.jar` 時失敗，因為該檔案不存在於根目錄，或是檔案名稱與啟動指令不符。
</Callout>

### 解決方案 [#解決方案]

根據您建置伺服器的方式，請參考以下對應的修復步驟：

<Steps>
  <Step>
    ### 情況一：您是自行上傳伺服器核心檔案 [#情況一您是自行上傳伺服器核心檔案]

    如果您是從外部下載核心檔案並手動上傳至檔案管理中，檔名可能不一定是 `server.jar`（例如可能是 `paper-1.20.4.jar`）。
    請前往控制面板的「啟動設定」頁面，找到「伺服器啟動 Jar 檔案」欄位。請將該欄位的值修改為您實際上傳的核心檔案名稱（需包含 `.jar` 副檔名）。
        <img alt="圖片" src="__img0" />
  </Step>

  <Step>
    ### 情況二：伺服器核心檔案遺失 [#情況二伺服器核心檔案遺失]

    如果您原本使用面板自動化安裝核心，但不小心誤刪了該檔案。
    請前往控制面板的「其他設定」頁面，點選重新安裝伺服器選項。系統會根據您當前的設定，自動重新下載並補齊遺失的核心檔案。
        <img alt="圖片" src="__img1" />
  </Step>

  <Step>
    ### 情況三：啟動參數錯誤 [#情況三啟動參數錯誤]

    如果您已經重新安裝過核心，且檔案確實存在於目錄中，但仍出現此錯誤。
    請回到「啟動設定」頁面，仔細檢查您的 <b>啟動參數設定</b> 是否有輸入錯誤，或是引入了無法解析的特殊字元，這可能導致指令解析錯亂而無法正確指向 Jar 檔案。
        <img alt="圖片" src="__img2" />
  </Step>
</Steps>

<Callout type="warn">
  **最佳實踐**\
  為了避免日後混淆，建議您在手動上傳核心時，直接將該檔案重新命名為 `server.jar`，這樣就能維持預設的啟動設定而無須額外修改參數。
</Callout>


# Cloudflare WARP (/docs/debug/warp)





















如果您已完成 [Google DNS 教學](/docs/debug/googledns)，但 Minecraft 主機仍無法連線、頻繁逾時、封包遺失或延遲偏高，可以再使用 Cloudflare WARP。WARP 會將裝置的網路流量經由 Cloudflare 網路傳送，改用另一條傳輸路徑。

WARP 不一定會讓所有連線變快；如果原本的路徑已經是最佳路徑，開啟後反而可能增加延遲。若開啟 WARP 後沒有改善，請關閉 WARP 並回報客服。

<Callout type="info" title="什麼情況適合使用 WARP？">
  * 已完成 [Google DNS 教學](/docs/debug/googledns)，Minecraft 主機仍然無法連線。
  * 已經可以連線，但延遲突然升高、頻繁逾時或遊戲中斷線。
  * 同一台主機在其他網路可以正常連線，只有目前網路異常。
</Callout>

<Callout type="warn" title="使用前請先知道">
  WARP 不是匿名工具，也不能讓您偽裝成其他國家的使用者。它只會改變裝置前往網際網路的傳輸路徑；伺服器離線、連接埠關閉、帳號權限錯誤或遊戲服務本身故障，無法透過 WARP 修復。
</Callout>

## 使用 WARP 前請先完成 Google DNS [#使用-warp-前請先完成-google-dns]

請先依照 [Google DNS 教學](/docs/debug/googledns) 將 Windows DNS 改為 Google Public DNS，清除 DNS 快取並重新連線，然後再次嘗試進入 Minecraft 伺服器。

如果改用 Google DNS 後已經可以正常連線，就不需要再使用 WARP；只有在問題仍然存在時，才繼續本頁的安裝與連線步驟。

<Callout type="info" title="建議處理順序">
  1. 先完成 [Google DNS 教學](/docs/debug/googledns)。
  2. 重新開啟 Minecraft，確認是否已經可以連線。
  3. 如果仍然無法連線、頻繁逾時或延遲偏高，再開啟本頁的 Cloudflare WARP。
</Callout>

## 從官方頁面下載 Cloudflare WARP [#從官方頁面下載-cloudflare-warp]

<Steps>
  <Step>
    ### 開啟 Cloudflare 繁體中文頁面 [#開啟-cloudflare-繁體中文頁面]

    請在瀏覽器開啟以下網址：

    [https://one.one.one.one/zh-Hant/](https://one.one.one.one/zh-Hant/)

    進入頁面後，直接點擊 **Windows** 下載按鈕。請勿從搜尋結果中的不明網站或第三方下載站取得安裝檔。
        <img alt="圖片" src="__img0" />
  </Step>

  <Step>
    ### 執行下載的安裝程式 [#執行下載的安裝程式]

    1. 開啟瀏覽器的下載清單，找到剛下載的 Cloudflare WARP Windows 安裝程式。
    2. 點擊安裝程式開始執行。
    3. 若 Windows 顯示使用者帳戶控制視窗，確認發行者是 Cloudflare 後按 **是**。
    4. 依安裝畫面按 **Next** 或 **下一步** 完成安裝；安裝完成後會直接跳出 Cloudflare One Client 的初次設定視窗。
       <img alt="圖片" src="__img1" />
  </Step>

  <Step>
    ### 選擇個人瀏覽 [#選擇個人瀏覽]

    安裝完成後，畫面會詢問「您希望如何使用此用戶端？」。請選擇左側的 **私人瀏覽**，再按下 **同意條款並繼續**。

    右側的 **Cloudflare One Client** 需要 Cloudflare One 登入，不是本教學要使用的選項。

        <img alt="圖片" src="__img2" />
  </Step>

  <Step>
    ### 開啟 WARP 連線 [#開啟-warp-連線]

    按下 **同意條款並繼續** 後，會進入 Cloudflare One Client 主畫面。此時狀態會顯示 **已中斷連線**，請按畫面中央的藍色 **連線** 按鈕；畫面下方的連線模式維持預設值即可，不需要修改。

        <img alt="圖片" src="__img3" />

    如果主畫面沒有自動顯示，請從工作列右下角通知區域點擊 WARP 圖示；看不到圖示時，點擊 &#x2A;*^** 展開隱藏圖示，或在開始功能表搜尋 **Cloudflare WARP**。

        <img alt="工作列中的 WARP 圖示" src="__img4" />
  </Step>
</Steps>

## 開啟 WARP 並連線 [#開啟-warp-並連線]

<Steps>
  <Step>
    ### 確認 WARP 已連線 [#確認-warp-已連線]

    按下前一步的 **連線** 後，請等待數秒，直到畫面顯示 **Connected**、**已連線** 或類似的連線成功狀態。

    如果仍顯示 **已中斷連線**，請再按一次中央的 **連線** 按鈕；不需要修改其他進階設定。

        <img alt="WARP 已連線" src="__img5" />
  </Step>
</Steps>

## 使用 WARP 後進入 Minecraft [#使用-warp-後進入-minecraft]

1. 保持 WARP 顯示 **Connected／已連線**。
2. 開啟 Minecraft，進入多人遊戲或伺服器清單。
3. 使用原本的伺服器位址與連接埠，不要因為開啟 WARP 而修改遊戲內設定。
4. 進入伺服器後，實際移動、開啟箱子或進行幾分鐘遊戲，觀察是否仍會斷線或延遲升高。

如果開啟 WARP 後可以連線或狀況改善，請記下發生時間、使用的網路環境及 Minecraft 的連線結果，回報客服協助判斷原本的 ISP 路由問題。

<img alt="Minecraft 伺服器清單" src="__img6" />

## 關閉 WARP 或恢復原本連線 [#關閉-warp-或恢復原本連線]

如果 WARP 沒有改善問題，或開啟後反而變慢，請在工作列通知區域點擊 WARP 圖示，再按一下主畫面中央開關，直到狀態顯示 **Disconnected／已中斷**。關閉 WARP 後，Windows 會恢復使用原本的網路連線。

若關閉後網路沒有恢復：

1. 等待約 10 秒後重新連接 Wi-Fi 或網路線。
2. 關閉其他 VPN、Proxy 或加速器。
3. 重新啟動 WARP，再關閉一次。
4. 仍然無法上網時，重新啟動電腦並確認一般網路是否正常。

<img alt="關閉 WARP 的按鈕" src="__img7" />

## 常見問題 [#常見問題]

<Callout type="warn" title="WARP 無法連線">
  先確認一般網路可以開啟網站，再暫時關閉其他 VPN、Proxy、加速器及防毒軟體的網路過濾功能。若仍無法連線，請重新啟動 WARP 或電腦；不要同時啟用多個 VPN 工具。
</Callout>

* **開啟 WARP 後所有網站都無法開啟：** 先關閉 WARP，確認原本網路恢復後，再嘗試重新連線。
* **Minecraft 仍然無法連線：** 確認伺服器位址、連接埠及伺服器狀態；如果 Google DNS 與 WARP 都沒有改善，請提供完整錯誤訊息與發生時間給客服。
* **延遲沒有降低：** WARP 不保證每個 ISP 或每個目的地都會有更短路徑；如果實際遊戲體驗沒有改善，請關閉 WARP。
* **WARP 連線一下就中斷：** 檢查 Wi-Fi 是否穩定，並確認公司、學校或公共網路沒有封鎖 WARP 所需的連線。

回報問題時，請提供發生時間、主機位址與連接埠、Google DNS 設定結果、WARP 顯示的連線狀態，以及 Minecraft 的完整錯誤訊息。截圖前請先遮蔽帳號、玩家名稱、公開 IP 與其他個人資訊。


# VPS 雲端主機服務條款 (/docs/legal/1033-tos)



超達網路科技有限公司販售之 VPS 雲端主機由一零三三網路資訊有限公司提供，使用時必須遵守[《超達網路科技有限公司服務條款》](https://docs.coffeehost.net/docs/documents/terms-of-service)及《一零三三網路資訊有限公司服務條款》（本條款）。

本文件係一零三三網路資訊有限公司（以下簡稱一零三三）提供之 VPS 雲端主機服務之使用規範與契約要點。客戶（以下簡稱您）在使用本服務時，應遵守本條款；若與服務申請書或其他約定不一致，雙方以書面或電子簽章所示之最新約定為準。

# 一、定義 [#一定義]

* 一零三三：指一零三三網路資訊有限公司。
* 客戶／您：指與一零三三簽約或使用一零三三服務之自然人、公司或法人。
* 本服務：指一零三三提供之 VPS、相關連線及代管服務。

# 二、服務範圍與責任限制 [#二服務範圍與責任限制]

1. 一零三三提供網路資源與平台供您部署與管理應用程式。由於網際網路之開放與多方連結特性，一零三三無法保證第三方內容之正確性或可用性。
2. 對於因第三方網路或其他非一零三三可控制之因素所生之斷線、速度或資料遺失，一零三三僅負協助聯繫與合理的修復義務，但不就間接或非直接之損害負賠償責任。

# 三、禁止使用 [#三禁止使用]

您同意於使用本服務時不得：

* 進行入侵、未經授權存取或干擾其他系統之行為
* 大量發送未經請求之電子郵件（垃圾郵件）、進行分散式阻斷服務（DDoS）或其他使系統過載之行為
* 散布惡意程式或其他可能損害網路或第三方權益之內容
* 發布違反法令、侵害他人權益或違反公序良俗之資訊
* 非經授權轉售、讓與或移轉一零三三提供之 IP、帳號或服務資源

若您有違反上述任一行為，一零三三得視情節暫停或終止相關服務，並保留追償及報警或移送司法之權利，如因上述濫用行為產生之罰款，須由您全額承擔。

# 四、濫用處理與費用 [#四濫用處理與費用]

1. 對於已確認之濫用行為（包括但不限於垃圾郵件發送、資源濫用、攻擊他人系統、散布病毒等），一零三三將進行必要之調查與處置（包含暫停服務、封鎖 IP、移除內容等）。
2. 每次確認之濫用事件，一零三三得向該客戶收取新台幣 2,000 元整作為處理費及濫用罰款（以下簡稱「濫用處理費」）。本條金額係對應行政處理成本與警示性罰金，並不排除一零三三依情節求償之權利。
3. 若濫用情節嚴重或屢次重犯，一零三三得視情況加收費用、延長停權時間或直接終止契約，並保留向客戶求償實際損害之權利。

# 五、法院傳票與司法程序之處理及費用 [#五法院傳票與司法程序之處理及費用]

1. 若一零三三因您之服務使用而接獲法院傳票、司法調查或其他法律程序，您應協助並配合提供必要資料。為補償一零三三處理相關事務所需之行政與法務成本，您同意：

   * 須先支付新台幣 5,000 元整作為初步處理費用
   * 並補償一零三三為處理該司法程序而實際支出之全部合理費用（包括但不限於律師費、公證費、訴訟費、差旅費及其他必要之行政支出）。

2. 若前述費用未能如期支付，一零三三得暫停或終止相關服務，並保留追索全部未付費用與相關損害之權利。

# 六、費用、付款與逾期 [#六費用付款與逾期]

1. 本服務依申請書及雙方約定計價並定期開立帳單，客戶應於帳單指定期限內完成付款。若採電子帳單或電子郵件通知，視為有效送達。若對帳單內容有異議，客戶應於收到帳單後五日內以書面提出，逾期視為接受。
2. 逾期未付者，一零三三得課徵滯納金（由超大咖託管制定，請參見[《超達網路科技有限公司服務條款》「續費、逾期繳款與到期資料」](https://docs.coffeehost.net/docs/documents/terms-of-service#續費逾期繳款與到期資料)），並得暫停服務直至款項補足。
3. 本條另定之濫用處理費與司法處理費屬特殊費用，應於一零三三通知後依指示繳納。

# 七、個人資料保護 [#七個人資料保護]

一零三三依個人資料保護法與相關法令管理客戶資料，僅於履行契約或符合法令之情況下蒐集、處理或利用客戶資料。關於資料查詢、更正或刪除等權利，請依隱私政策或聯絡客服辦理。

# 八、服務終止與解約 [#八服務終止與解約]

1. 客戶或一零三三得依約解除契約。若客戶違反本條款（包括但不限於濫用行為），一零三三得立即終止服務並不退還相關費用，且保留求償權利。
2. 客戶提前解約可能需負擔協議或申請書所定之違約金或未履行期間之費用，具體以雙方約定為準。

# 九、不可抗力 [#九不可抗力]

因天災、戰亂、政府管制、電信業者故障或其他不可歸責於一方之事由，致服務部分或全部中斷或無法履行時，雙方互不負損害賠償責任，但應盡最大努力減少影響並恢復服務。

# 十、未盡事宜與管轄法院 [#十未盡事宜與管轄法院]

1. 本條款如有未盡事宜，雙方同意依中華民國相關法令及主管機關之規定辦理。
2. 因本契約產生之爭議，雙方同意以臺灣臺北地方法院為第一審管轄法院。


# 隱私政策 (/docs/legal/privacy)



本隱私政策描述了 Coffee Host 超大咖託管 (以下簡稱我們、本團隊) 如何收集、使用和分享您在我們網站\
(包括 coffeehost.net、panel.coffeehost.net、store.coffeehost.net 或其他 Coffee Host 網域）。

通過使用我們的任何服務、我們的網站、控制面板或其他方式，您均同意本隱私政策的全部內容。

# 一、個人資料的蒐集、處理及利用方式 [#一個人資料的蒐集處理及利用方式]

* 當您造訪本網站或使用本網站所提供之功能服務時，我們將視該服務功能性質，請您提供必要的個人資料，並在該特定目的範圍內處理及利用您的個人資料；非經您書面同意，本網站不會將個人資料用於其他用途。
* 本網站在您使用服務信箱、問卷調查等互動性功能時，會保留您所提供的姓名、電子郵件地址、聯絡方式及使用時間等。
* 於一般瀏覽時，伺服器會自行記錄相關行徑，包括您使用連線設備的IP位址、使用時間、使用的瀏覽器、瀏覽及點選資料記錄等，做為我們增進網站服務的參考依據，此記錄為內部應用，決不對外公佈。
* 我們還可能從第三方服務接收有關您帳戶的數據，並將其與我們擁有的有關您的數據進行調整、合併或比較。

# 二、資料之保護 [#二資料之保護]

我們採取合理措施保護您個人的資料遭丟失、濫用和未經授權的訪問、分享、更改或破壞。但是，我們將不承擔任何責任。

# 三、Cookie 之使用 [#三cookie-之使用]

為了提供您最佳的服務，本網站會在您的電腦中放置並取用我們的 Cookie，若您不願接受 Cookie 的寫入，您可在您使用的瀏覽器功能項中設定隱私權等級為高，即可拒絕 Cookie 的寫入，但可能會導致網站某些功能無法正常執行 。

# 四、隱私政策變更 [#四隱私政策變更]

本網站隱私權保護政策將因應需求隨時進行修正，修正後的條款將刊登於網站上。

# 五、資料的刪除 [#五資料的刪除]

若您希望我們刪除您在我們這邊所留下的紀錄，我們會根據各紀錄的性質不同，有不同的處理流程。

## 伺服器資料 [#伺服器資料]

伺服器到期後 7 天由系統刪除

## 伺服器備份資料 [#伺服器備份資料]

伺服器到期 7 天後刪除，期間若要調度檔案需支付 NT$250 檔案調度費。

## 訂單與帳單資料 [#訂單與帳單資料]

客戶提出刪除要求後封存 1 年刪除

## 基本聯絡資料 [#基本聯絡資料]

客戶提出刪除要求後封存 1 年刪除

## 客服單資料 [#客服單資料]

客戶單獨對本項提出刪除要求後封存 1 年刪除

# 六、聯絡我們 [#六聯絡我們]

如果您對我們的隱私政策有任何疑問，請發送電子郵件至 [support@coffeehost.net](mailto:support@coffeehost.net)。


# 服務條款 (/docs/legal/tos)



「Coffee Host 超大咖託管」（下稱「本服務」）由「超達網路科技有限公司」（下稱「本公司」，統一編號 62252310）營運。本服務條款（下稱「本條款」）適用於本服務的申請及使用；若雙方另有書面約定，則從其約定。用戶完成帳戶註冊，或實際啟用本服務任何部分，即表示已閱讀、理解並同意本條款及相關使用規範。對其中任何內容仍有疑義或不願接受者，請勿申請，並應立即停止使用本服務。

申請人應為具完全行為能力之自然人，或依法成立之法人、團體。未成年人、受監護宣告或受輔助宣告之人，須先由其法定代理人或監護人審閱並同意本條款及日後修訂，方可使用或繼續使用本服務；一旦開始或持續使用，即視為本人及其法定代理人或監護人均已了解並接受相關約定與變更。

# 一、條款適用與法令遵循 [#一條款適用與法令遵循]

1. 無論使用正式方案或試用方案，用戶一經使用本公司提供的服務，即同意受本條款及其他會員規範拘束；該等規範包括但不限於客服中心說明、管理規則、公告與注意事項。用戶並應遵循所在地及中華民國現行法令。
2. 為組成完整的網路服務方案，本公司得整合第三方提供的附加服務。用戶選用此類服務時，亦須接受該第三方所訂的條款與規則。
3. 本公司得自行決定是否受理任何申請，並保留拒絕用戶使用本服務之權利。

# 二、申辦、計價與付款 [#二申辦計價與付款]

1. 租用內容及付款方式，以用戶與本公司簽署確認之申請文件、線上申請頁面所載資訊，以及本條款為依據。
2. 本公司得變更服務價格，並應在新費率實施前透過電子郵件或其他方式通知用戶。費率變更不溯及既往；先前已支付的款項無須補差額，亦不得因調價要求返還。
3. 由合作夥伴或其他第三方供應的項目，其計費期間依該供應單位的規定認定，用戶不得就此提出異議。
4. 用戶應在付款通知所定期限內付清全部應繳款項。若認為費用明細有誤，須於截止日前敘明理由，以書面或電子郵件向本公司提出；逾期未提出者，不得以此拒絕付款。本公司得追收欠款，追收所生之一切費用均由用戶負擔。
5. 款項逾期仍未繳納時，本公司得隨時停止或終止該用戶租用的服務，並採取必要的後續處理；由此產生的損害，本公司不負責任。
6. 因欠費終止服務而發生的資料遺失或滅失，概由用戶自行承擔，本公司不負賠償責任。
7. 每一計費月自服務啟用日起按三十日計算；即使實際使用時間不足三十日，仍按一個月收取各項費用。

# 三、暫停或結束服務 [#三暫停或結束服務]

1. 用戶自行停止使用，或因違反本條款而遭本公司終止服務者，本公司在任何情況下均無須退還已收費用之全部或任何部分。
2. 因情勢改變或營運需要，本公司如擬停止或結束全部或部分服務，將在預定日期前通知用戶；用戶同意配合相關作業且不提出異議。本公司得將已收取但尚未使用的款項退還用戶。
3. 若合作夥伴或其他網路服務業者因情勢變動或營運考量，停止其所提供的全部或部分服務，此屬不可抗力事由，本公司不負相關責任。本公司將盡力協助尋找替代方案，但改用新服務所需的所有費用由用戶自行負擔。
4. 涉及合作夥伴或第三方供應之服務時，租用終止程序依該供應單位的條款辦理，用戶不得異議。

# 四、帳戶與服務資源的使用 [#四帳戶與服務資源的使用]

1. 用戶應在本公司指定的用途及範圍內，以合理方式使用本服務。
2. 僅用戶本人及申請時經其授權之人得使用該帳戶。本公司配發的帳號與密碼應由用戶妥善保存，其保管及使用所生責任由用戶自行承擔。
3. 使用行為不得妨害其他人使用服務，也不得影響本公司系統正常運作。經通知後二十四小時仍未改善，或違規行為已對系統或他人造成障礙時，本公司得直接暫停或終止服務。
4. 如用戶干擾其他用戶的服務，或使硬體及其他可用資源承受過度負荷，本公司得對其服務加設限制或暫時中斷連線。
5. 本公司得監測產品及服務的使用狀況；如判定主機資源遭過度使用，得進一步限制使用或暫停連線。
6. 因用戶自行租用的實體線路品質不佳而受有損失者，應洽該線路供應商維修；本公司不負線路修復義務，亦不賠償因此產生的損害。
7. 因颱風、地震、海嘯、洪水、停電、戰爭、國際海底電纜斷裂或其他不可抗力，造成線路中斷或毀損時，後續處理及損害賠償均不由本公司負責。
8. 本公司直接供應的服務若因可歸責於本公司的原因而無法使用，且用戶通知後經四十八小時仍未修復，用戶得終止使用；本公司得退還已繳而尚未使用之款項，除此以外不負其他賠償責任。
9. 除本條款明文約定者外，用戶因租用本服務所生的其他損害，本公司均不負賠償責任。
10. 本公司得自行判斷是否允許或拒絕用戶使用本服務，並得採取退費後終止租用、封鎖帳戶等措施，無須事前通知或說明理由。
11. 因法令要求或供應商政策，本公司得要求用戶提交數項身分證明。未完整提供或未通過核對者，本公司得隨時終止其租用服務。

# 五、使用限制 [#五使用限制]

下列內容或行為不得利用本公司服務從事；本清單僅為例示，並非全部：

* 執行比特幣、以太坊或其他加密貨幣的挖礦作業
* 儲存、發布或傳送兒童色情及其他色情內容
* 製作、使用或散布惡意程式、病毒，或利用系統漏洞
* 傳送或散播電腦病毒
* 從事或協助恐怖活動
* 寄送垃圾郵件
* 進行網路釣魚
* 掃描連接埠、暴力破解，或進行其他駭客入侵嘗試
* 發動或參與 DDoS、DoS、booters、network flood 等類似網路攻擊
* 提供賭博資訊，或以任何形式招攬、誘使他人賭博
* 進行非法交易，或發布虛假不實、引導他人犯罪的訊息
* 從事違反公共秩序、善良風俗或法令禁止的活動
* 涉及暴力、賭博、詐騙、侵權、攻擊、垃圾訊息傳送或代理伺服器（VPN）之使用

如系統偵測或其他用戶回報涉及上述任一濫用情形，本公司得不經另行通知立即停權，且不退還費用。

# 六、用戶內容與資料處理 [#六用戶內容與資料處理]

1. 用戶應自行建立、維護及更新其內容與資料，並僅得存放於本公司指定配置的目錄。用戶對存入本公司系統之資料享有相關所有權、智慧財產權及使用權，並就該等資料負完全法律責任。
2. 本公司就存放於其系統內的用戶資料負保管責任。若因可歸責於本公司的事由造成資料毀損，處理方式為免收當月服務月租費，減免費用最高以三個月月租費為限；除此之外，本公司不負其他賠償責任。
3. 為遵循政府法令或執行本條款所需，用戶同意本公司得保存其申請資料、聯絡資訊及帳戶內的所有資料，並得向政府機關、司法機關或警政機關揭露。
4. 用戶如為未成年人，本公司得將其申請資料、聯絡資訊及帳戶內資料予以保存，或向該用戶的合法監護人揭露。
5. 用戶應依自身需求另行備份資料，以降低可能發生的損失。

# 七、資訊保密 [#七資訊保密]

1. 用戶與本公司間的一切服務關係終止後，除業務執行或法令另有保存需要外，本公司得以適當方式處理並銷毀該用戶的隱私資料。
2. 除有下列任一情況外，本公司不得向第三方揭露用戶提供的隱私資訊、網站資料或電子郵件內容：
   * 本條款已有相關約定。
   * 為交付用戶要求的產品或服務，必須向第三方提供客戶資料。
   * 用戶所需的產品或服務須由本公司與第三方合作供應。
   * 用戶違反本條款。
   * 司法機關或政府機關依法提出要求。
   * 為保護本公司、服務使用者或公眾的人身安全、財產及其他權利所必要。
   * 本公司進行合併、收購或組織重整。
   * 用戶已以書面表示同意。

# 八、條款變更與管轄 [#八條款變更與管轄]

1. 第三方供應服務所適用的條款如有修改，本公司無義務就該修改另行通知用戶。
2. 本公司得隨時修訂本條款，並可在修訂後立即將內容公布於網站，本公司不另負個別通知義務。
3. 因租用或使用本服務所生的一切爭議，雙方同意以臺灣臺中地方法院為第一審管轄法院。

# 九、補充條款 [#九補充條款]

## 服務存取、轉租與身分查核 [#服務存取轉租與身分查核]

1. 除本公司另有明確書面許可，用戶無權且不得向任何第三方出租、租賃或出售本服務之存取權限。
2. 如本公司於服務使用期間發現用戶提供不實資料或疑似盜用他人身分，本公司有權基於交易風險拒絕用戶繼續使用本服務，並得視情況退還款項，或保留款項並移交有關機關處置。

## 續費、逾期繳款與到期資料 [#續費逾期繳款與到期資料]

1. 所有服務續費帳單將於到期日前七日產生。如用戶未於到期日前付款，將導致服務終止；逾期繳費者將收取應繳費用 10% 之滯納金，最低收取新臺幣 30 元。
2. 系統將於服務到期日前三日再次透過電子郵件或 Discord 通知用戶付款。
3. 繳費後，帳單資訊及服務期間可於客戶中心或電子郵件中查詢。如對啟用日、到期日或其他帳務內容有疑義，應於購買後三日內向客服提出，逾期不予受理。
4. 本公司不對因逾期付款而導致服務終止所造成的任何資料遺失負責。
5. 本公司保留於服務到期後拒絕提供伺服器或服務內資料之權利。
6. 本公司保留於服務到期後三日（七十二小時）或更短期間內終止服務之權利。

## 退款政策 [#退款政策]

1. 本公司保留依個案情況拒絕退款之權利。
2. 購買後如遇產品缺貨或無法使用，本公司將提供更換其他服務，或將款項退還至用戶之錢包餘額。
3. 因退款所產生之額外費用或手續費，由用戶自行負擔。
4. 因違反本條款或其他原因導致服務終止者，本公司不負退款責任。
5. 如用戶向本公司之收款服務商提出帳款爭議，致本公司名譽或商譽受損，本公司保留立即暫停或終止用戶所有服務且不予退款之權利。
6. 用戶一經開始使用本服務，本公司不提供任何形式之退款。

## 技術支援與免責 [#技術支援與免責]

1. 用戶理解並同意技術服務並非毫無限制，技術人員可能於處理途中停止繼續提供協助。
2. 用戶應確保所使用之任何外掛程式及其資料均具合法來源。如非正當來源，本公司有權拒絕提供協助，並得於必要時暫停相關服務。
3. 用戶同意於提供技術服務之必要範圍內，配合提供更多詳細資訊。
4. 用戶了解技術服務僅提供基本支援，包括但不限於服務障礙排除及基本面板設定。

## 法院傳票與司法程序之處理及費用 [#法院傳票與司法程序之處理及費用]

1. 若因用戶不法使用本服務，致本公司接獲法院傳票、司法調查或其他法律程序，用戶應協助並配合提供必要資料。為補償本公司處理相關事務所需之行政與法務成本，用戶同意：
   * 預先支付新臺幣 5,000 元作為初步處理費用。
   * 補償本公司為處理該司法程序而實際支出之全部合理費用，包括但不限於律師費、公證費、訴訟費、差旅費、資料蒐集費、時間成本、客服處理費及其他必要之行政支出。
2. 若前述費用未能如期支付，本公司得暫停或終止相關服務，並保留追索全部未付費用及相關損害之權利。


# 啟動伺服器 (/docs/panel/start-server)























如您是首次購買，您將會在服務開通後收到控制面板帳號創建通知。

點擊中間 「開始設定您的帳號」，進入控制面板網頁。
<img alt="圖片" src="__img0" />

輸入您帳號的新密碼後，點擊重設密碼即可開始使用。
<img alt="圖片" src="__img1" />

<Callout title="除了可以使用帳號密碼登入外，還可以透過 Google 或 Discord 等社群帳號登入。" type="info">
  只要社群帳號 Email 地址與控制面板帳號 Email 相同，即可快速登入！
</Callout>

登入後即可看到伺服器列表，左下角可管理您的帳號。
<img alt="圖片" src="__img2" />

切換至「控制台」分頁。
<img alt="圖片" src="__img3" />

點擊「啟動」按鈕。
<img alt="圖片" src="__img4" />

按「I Accept」以同意 Eula。
<img alt="圖片" src="__img5" />

看到「Done! For help, type "help"」即啟動成功。
<img alt="圖片" src="__img6" />

點擊上方紅框複製連線位址。
<img alt="圖片" src="__img7" />

至遊戲貼上並連線。
<img alt="圖片" src="__img8" />


# Geyser (/docs/practice/geyser)







<Callout title="連線方式">
  基岩版請使用 

  `udp.cfh.tw + <端口>`

   連線 ！
</Callout>

# 如何架設 Geyser [#如何架設-geyser]

<Steps>
  <Step>
    ### 下載 Geyser 插件 [#下載-geyser-插件]

    到 [**Geyser 下載介面**](https://geysermc.org/download) 下載 Geyser，選擇您要的版本並安裝（以 Spigot/Paper 示範）。
  </Step>

  <Step>
    ### 將插件放入 `/home/container/plugins` [#將插件放入-homecontainerplugins]

    放完插件後重啟伺服器後，會發現多了一個 `Geyser-Spigot` 資料夾。
  </Step>

  <Step>
    ### 打開 Geyser-Spigot 資料夾裡面的 config.yml [#打開-geyser-spigot-資料夾裡面的-configyml]

    將第 23 行的 `clone-remote-port` 從 `false` 調整為 `true`

        <img alt="圖片" src="__img0" />
  </Step>

  <Step>
    ### 儲存並套用 [#儲存並套用]

    儲存檔案後，重新啟動伺服器即可套用設定。
  </Step>
</Steps>

# 利用 Floodgate 使未購買電腦版的玩家直接加入伺服器 [#利用-floodgate-使未購買電腦版的玩家直接加入伺服器]

<Steps>
  <Step>
    ### 下載 Floodgate 插件 [#下載-floodgate-插件]

    到 [**Floodgate 下載介面**](https://geysermc.org/download) 下載 Geyser，選擇您要的版本並安裝（以 Spigot/Paper 示範）。
  </Step>

  <Step>
    ### 將插件放入 `/home/container/plugins` [#將插件放入-homecontainerplugins-1]

    放完插件後重啟伺服器即可。
  </Step>
</Steps>


# 連接網域 (/docs/practice/subdomain)







<Callout title="警告" type="warn">
  本教學僅適用於 Java 版，基岩版無法使用 SRV 紀錄。
</Callout>

<Callout title="提示">
  本教學以 Cloudflare DNS 管理作為示範。
</Callout>

# Cloudflare SRV 紀錄設定教學 [#cloudflare-srv-紀錄設定教學]

在開始之前，請至 Cloudflare 添加您的網域，並確認網域狀態為「使用中」。

<Steps>
  <Step>
    ### 前往 Cloudflare DNS 管理介面 [#前往-cloudflare-dns-管理介面]

    進入 [**Cloudflare DNS 管理介面**](https://dash.cloudflare.com/) 後，選擇您的網域，並進入「DNS」頁面。
  </Step>

  <Step>
    ### 新增 SRV 紀錄 [#新增-srv-紀錄]

    請參考圖片內容填寫，以 `test.coffeehub.club` 綁定 `tsa.cfh.tw:11102` 為例。

        <img alt="圖片" src="__img0" />
  </Step>

  <Step>
    ### 等待 DNS 更新 [#等待-dns-更新]

    完成後，請靜候 10 分鐘 \~ 24 小時，使 DNS 完全更新，即可使用您的網域直接連線。
  </Step>
</Steps>


# 綁定 Discord (/docs/store/discord)















<Callout title="警告" type="warn">
  如果要接收到 Discord 通知，請先開啟伺服器私人訊息功能。
</Callout>

如果您是我們的客戶，可以透過綁定 Discord 帳號，取得客戶、贊助專屬身份組。

取得客戶、贊助身份組後，您將可以：

* 接收最新伺服器通知
* 開啟「售後服務」類別客服單
* 存取客戶、贊助專屬聊天頻道
* 獲得客戶、贊助專屬顏色、圖示



<Steps>
  <Step>
    ### 進入「客戶中心」 [#進入客戶中心]

    從「[商店](https://store.coffeehost.net)」首頁點擊「客戶中心」進入。
        <img alt="圖片" src="__img0" />
  </Step>

  <Step>
    ### 登入商店 [#登入商店]

    使用您先前註冊的帳號登入官方商店。
        <img alt="圖片" src="__img1" />
  </Step>

  <Step>
    ### 綁定 Discord 帳號 [#綁定-discord-帳號]

    點擊 Discord 旁的「綁定」按鈕。
        <img alt="圖片" src="__img2" />
  </Step>

  <Step>
    ### 授權存取 [#授權存取]

    點擊「授權」按鈕以繼續。
        <img alt="圖片" src="__img3" />

    <Callout title="注意" type="warn">
      我們無法透過此存取您的 Discord 帳號，請您放心授權即可。
    </Callout>
  </Step>

  <Step>
    ### 綁定完成 [#綁定完成]

    看到以下畫面即代表您已成功綁定 Discord 帳號，若您先前有需要綁定後才能使用的服務，現在可以再試一次了。
        <img alt="圖片" src="__img4" />

    <Callout title="注意" type="warn">
      若綁定後仍未於 Discord 中獲得身份組，請嘗試解除綁定後再重新綁定一次
    </Callout>
  </Step>
</Steps>


# 購買伺服器 (/docs/store/order)























<Steps>
  <Step>
    ### 選擇方案 [#選擇方案]

    前往 [服務一覽](https://store.coffeehost.net/store)
    查看現有產品。     <img alt="圖片" src="__img0" />
    評估好您要購買的方案後，點擊 「立即購買」。
        <img alt="圖片" src="__img1" />
  </Step>

  <Step>
    ### 設定伺服器 [#設定伺服器]

    接下來您會看到三個區域，首先紅色的區域是您選購的方案內容。接著是藍色區域，可以選擇購買時長，月繳
    30 天、季繳 90 天、半年繳 180
    天，購買越長越有優惠。最後的黃色區域是訂單概關，您選購的服務與價格都會顯示。
        <img alt="圖片" src="__img2" />
  </Step>

  <Step>
    ### 加購服務 [#加購服務]

    往下滑，您可以看到這個方案可以加購的服務，像是端口、備份、資料庫、伺服器切分等，選配完成後，按繼續。
        <img alt="圖片" src="__img3" />

    | 選項    | 介紹                      |
    | ----- | ----------------------- |
    | 出帳循環  | 選擇季繳、半年繳，可享折扣           |
    | 端口    | 小地圖或一些插件會需要用到           |
    | 備份    | 強烈建議大家都要購買，資料回檔的時候很方便   |
    | 資料庫   | 某些插件可能會把資料儲存在 MySQL 資料庫 |
    | 伺服器切分 | 將伺服器資源靈活分配，創建多個獨立實例     |
  </Step>

  <Step>
    ### 結帳 [#結帳]

    接下來一樣也是看到三個區域。首先是紅色區域，這裡是您本次要結帳的方案總覽。接著是藍色區域，如果您有優惠代碼，您就可以在這邊使用。最後的是黃色區域是本次訂單總覽會顯示在這裡。
        <img alt="圖片" src="__img4" />
  </Step>

  <Step>
    ### 註冊帳號 [#註冊帳號]

    填入個人資料，並填寫密碼與確認密碼，您也可以先綁定社交帳號後再填寫資料，未來就可以透過社交帳號登入。
        <img alt="圖片" src="__img5" />
  </Step>

  <Step>
    ### 支付方式 [#支付方式]

    最後請於下方選擇支付方式，如果沒有您想要的支付方式，可以透過聯絡我們來詢問喔！
        <img alt="圖片" src="__img6" />
  </Step>

  <Step>
    ### 確認 [#確認]

    勾選「我已詳閱並同意[服務條款](../documents/terms-of-service)」，並按下結帳。
        <img alt="圖片" src="__img7" />
  </Step>

  <Step>
    ### 完成 [#完成]

    完成訂單，如果您不是使用帳號餘額支付，系統會轉到帳單付款頁面。
        <img alt="圖片" src="__img8" />
  </Step>
</Steps>


# 控制台 (/docs/panel/common/console)











您可以在右上角看到三個分別是開機、重啟、關機按鈕，首次使用請先點擊 「開機」 按鈕。
<img src="__img0" />

如果是首次開啟 Minecraft 伺服器，您將看到同意 Minecraft EULA 視窗。
點擊「I Accept」，即可繼續啟動伺服器。
<img src="__img1" />

接著伺服器就成功啟動了，您可以在控制台看到伺服器的啟動訊息。

紅色區域是此伺服器的連線位置，點擊文字區域即可複製。<br />
您可以在黃色區域看到此伺服器目前的狀態，包含 CPU 使用率、記憶體、儲存空間、網路使用狀態等。<br />
藍色區域為控制台的終端，您可以在此輸入要控制的指令。

<Callout>
  若為 Minecraft 伺服器，指令前則不需要加上 

  `/`

  。（例如 

  `/help`

   應輸入 

  `help`

  ）
</Callout>

<img src="__img2" />


# 設定 (/docs/panel/common/settings)











左上方顯示了 SFTP 連線資訊，點擊「啟動SFTP」來啟動本地 SFTP 工具，詳情請見 [此教學](sftp)。
<img alt="圖片" src="__img0" />

右上方顯示了伺服器資訊，修改後點擊「儲存」保存。
<img alt="圖片" src="__img1" />

點擊右下方「重新安裝伺服器」可重新安裝您的伺服器
<img alt="圖片" src="__img2" />


# SFTP (/docs/panel/common/sftp)

















控制面板的檔案管理僅供基礎使用，如需上傳大檔案或資料夾，就要使用 SFTP 來進行



<Steps>
  <Step>
    ### 安裝客戶端 [#安裝客戶端]

    如果您的電腦尚未安裝 SFTP 客戶端，可參考 [此教學](https://winscp.net/eng/docs/lang:chs) 安裝 WinSCP
  </Step>

  <Step>
    ### 取得連線資訊 [#取得連線資訊]

    至[控制面板](https://panel.coffeehost.net)選擇您的伺服器，並進入「設定」分頁。
        <img alt="圖片" src="__img0" />
  </Step>

  <Step>
    ### 連線至 SFTP [#連線至-sftp]

    若您的電腦已安裝 SFTP 客戶端，點擊「啟動 SFTP」即會自動開啟。
        <img alt="圖片" src="__img1" />
  </Step>

  <Step>
    ### 允許開啟 [#允許開啟]

    您可勾選該核取方塊，這樣您下次就不用再允許一次，點擊「開啟 WinSCP」以繼續。
        <img alt="圖片" src="__img2" />
  </Step>

  <Step>
    ### 接受視窗 [#接受視窗]

    第一次連線主機會出現此訊息，按「接受」以繼續連線。
        <img alt="圖片" src="__img3" />
  </Step>

  <Step>
    ### 輸入密碼 [#輸入密碼]

    SFTP 密碼即為您登入控制面板使用的密碼。
        <img alt="圖片" src="__img4" />
    如果是使用第三方（如 Google）登入，請先至客戶中心 > [產品 & 服務](https://store.coffeehost.net/clientarea.php?action=services) > 選擇您的服務 > 變更密碼
        <img alt="變更密碼" src="__img5" />
  </Step>

  <Step>
    ### 開始使用 [#開始使用]

    成功連線後即可照一般管理檔案的邏輯上傳或下載檔案了
        <img alt="圖片" src="__img6" />
  </Step>
</Steps>


# 排程 (/docs/panel/config/schedules)



















<Steps>
  <Step>
    在面板選擇「排程」
        <img alt="圖片" src="__img0" />
  </Step>

  <Step>
    點擊「創建排程」
        <img alt="圖片" src="__img1" />
  </Step>

  <Step>
    設定排程可以開啟「顯示快速參考指令表」來參考
        <img alt="圖片" src="__img2" />
  </Step>

  <Step>
    設定完成後點擊「創建排程」
        <img alt="圖片" src="__img3" />
  </Step>

  <Step>
    點擊「管理排程」
        <img alt="圖片" src="__img4" />
  </Step>

  <Step>
    點擊「新工作」
        <img alt="圖片" src="__img5" />
  </Step>

  <Step>
    設定完成後點擊「創建任務」
        <img alt="圖片" src="__img6" />
  </Step>
</Steps>

## 範例 [#範例]

### 每日午夜自動重啟 [#每日午夜自動重啟]

* 排程設定為 0 0 \* \* \*
* 任務動作選擇「傳送電源操作」
* 負載選擇「重啟伺服器」


# 啟動設定 (/docs/panel/config/startup)





在面板點擊「啟動設定」

可以調整的參數如下:

#### MINECRAFT 版本 [#minecraft-版本]

* 可以更改您伺服器的 Minecraft 版本

#### 伺服器 JAR 檔 [#伺服器-jar-檔]

* 可以更改您伺服器的 JAR 啟動檔案

#### Docker Image (映像檔) [#docker-image-映像檔]

* 可以更改您伺服器的 Java 版本

#### BUILD NUMBER / Forge 版本 [#build-number--forge-版本]

* 可以更改您伺服器的核心版本(無須特別指定版本則可以留空)

#### BUILD TYPE(Forge) [#build-typeforge]

* 選擇您要下載 **推薦版** 或是 **最新版** 的 Forge 核心

設定完成後在面板點擊「設定」，並選擇「重新安裝伺服器」

<Callout title="警告" type="warn">
  請注意不同 Minecraft 版本對應的 Java 版本
</Callout>

<Callout title="警告" type="warn">
  如果要更改啟動指令請至 [Discord 伺服器](https://dc.coffeehost.net)
  開啟客服單。
</Callout>


# 網域管理 (/docs/panel/config/subdomain)







<Callout title="警告" type="warn">
  子網域僅限 Java 版使用。
</Callout>

<img alt="圖片" src="__img0" />

<Steps>
  <Step>
    ### 點擊「網域管理」 [#點擊網域管理]

    點擊之後會出現一個頁面，會顯示創建和管理子網域的地方。
  </Step>

  <Step>
    ### 輸入子網域名稱 [#輸入子網域名稱]

    輸入您想要的子網域，並於右側選擇想要的網域。
  </Step>

  <Step>
    ### 點擊「創建」 [#點擊創建]

    創建後，您就可以使用這個網域連線，不需要加上連接埠。
  </Step>
</Steps>


# 使用者 (/docs/panel/config/user)

















<Callout title="什麼是子用戶？">
  子用戶功能讓您可以邀請其他人共同管理伺服器，並且可以精細控制每位子用戶的權限。
</Callout>

# 子用戶功能介紹 [#子用戶功能介紹]

子用戶可以用於以下情境：

* 邀請朋友幫忙管理伺服器
* 讓團隊成員協作管理
* 授權特定人員執行特定操作（如備份、重啟等）

# 新增子用戶 [#新增子用戶]

<Steps>
  <Step>
    ### 進入使用者管理頁面 [#進入使用者管理頁面]

    1. 前往面板的「使用者」頁面
    2. 您會看到目前所有子用戶的列表

        <img alt="使用者管理頁面" src="__img0" />
  </Step>

  <Step>
    ### 點擊「新增使用者」 [#點擊新增使用者]

    點擊頁面上的「新增使用者」按鈕，開啟新增子用戶的視窗。

        <img alt="新增使用者按鈕" src="__img1" />
  </Step>

  <Step>
    ### 輸入子用戶的電子郵件 [#輸入子用戶的電子郵件]

    輸入您想邀請的用戶的電子郵件地址。

        <img alt="輸入電子郵件" src="__img2" />
  </Step>

  <Step>
    ### 設定子用戶權限 [#設定子用戶權限]

    根據您的需求勾選要授予的權限。權限分為多個類別：

        <img alt="設定權限" src="__img3" />
  </Step>

  <Step>
    ### 確認新增 [#確認新增]

    檢查設定無誤後，點擊「邀請使用者」完成新增。子用戶將會收到邀請通知。
  </Step>
</Steps>

# 權限說明 [#權限說明]

以下是各項權限的詳細說明：

## 控制權限 [#控制權限]

| 權限名稱 | 說明           |
| ---- | ------------ |
| 控制台  | 查看控制台輸出並執行指令 |
| 啟動   | 啟動伺服器        |
| 停止   | 停止伺服器        |
| 重新啟動 | 重新啟動伺服器      |

## 使用者權限 [#使用者權限]

| 權限名稱 | 說明      |
| ---- | ------- |
| 建立   | 建立新的子用戶 |
| 讀取   | 查看子用戶列表 |
| 更新   | 修改子用戶權限 |
| 刪除   | 移除子用戶   |

## 檔案權限 [#檔案權限]

| 權限名稱 | 說明             |
| ---- | -------------- |
| 建立   | 建立新檔案或資料夾      |
| 讀取   | 查看和下載檔案        |
| 更新   | 編輯檔案內容         |
| 刪除   | 刪除檔案或資料夾       |
| 封存   | 壓縮和解壓縮檔案       |
| SFTP | 使用 SFTP 連線存取檔案 |

## 備份權限 [#備份權限]

| 權限名稱 | 說明       |
| ---- | -------- |
| 建立   | 建立新備份    |
| 讀取   | 查看備份列表   |
| 刪除   | 刪除備份     |
| 下載   | 下載備份檔案   |
| 還原   | 從備份還原伺服器 |

## 排程權限 [#排程權限]

| 權限名稱 | 說明       |
| ---- | -------- |
| 建立   | 建立新排程任務  |
| 讀取   | 查看排程任務列表 |
| 更新   | 修改排程任務   |
| 刪除   | 刪除排程任務   |

## 資料庫權限 [#資料庫權限]

| 權限名稱 | 說明      |
| ---- | ------- |
| 建立   | 建立新資料庫  |
| 讀取   | 查看資料庫列表 |
| 更新   | 修改資料庫密碼 |
| 刪除   | 刪除資料庫   |
| 檢視密碼 | 查看資料庫密碼 |

## 設定權限 [#設定權限]

| 權限名稱 | 說明      |
| ---- | ------- |
| 重新命名 | 修改伺服器名稱 |
| 重新安裝 | 重新安裝伺服器 |

<Callout type="warn" title="權限提醒">
  * 請謹慎授予「重新安裝」權限，此操作會清除所有伺服器資料
  * 建議只給予子用戶必要的最小權限
</Callout>

# 管理現有子用戶 [#管理現有子用戶]

## 修改子用戶權限 [#修改子用戶權限]

1. 在使用者列表中找到要修改的子用戶
2. 點擊該用戶旁的編輯按鈕
3. 調整權限設定
4. 點擊「更新使用者」保存變更

<img alt="編輯子用戶" src="__img4" />

## 移除子用戶 [#移除子用戶]

1. 在使用者列表中找到要移除的子用戶
2. 點擊該用戶旁的刪除按鈕
3. 確認移除操作

<img alt="移除子用戶" src="__img5" />

<Callout type="info">
  移除子用戶後，該用戶將立即失去對此伺服器的所有存取權限。
</Callout>

# 常見問題 [#常見問題]

### 子用戶找不到伺服器？ [#子用戶找不到伺服器]

請確認您輸入的電子郵件地址正確，且對方已經註冊 CoffeeHost 帳號。

### 子用戶無法執行某些操作？ [#子用戶無法執行某些操作]

請檢查是否已授予對應的權限。子用戶只能執行您授權的操作。

### 可以新增多少位子用戶？ [#可以新增多少位子用戶]

子用戶數量沒有限制，您可以根據需求新增任意數量的子用戶。


# 備份 (/docs/panel/manage/backup)















<Callout title="警告" type="warn">
  需要於商店購買時加購備份空間才可以使用此功能
</Callout>

# 創建備份 [#創建備份]

<Steps>
  <Step>
    ### 點擊「備份」 [#點擊備份]

    點擊之後會進入備份頁面，可以管理您的備份。

        <img alt="圖片" src="__img0" />
  </Step>

  <Step>
    ### 創建備份 [#創建備份-1]

    點擊「創建備份」開始創建

        <img alt="圖片" src="__img1" />
  </Step>

  <Step>
    ### 填入名稱 [#填入名稱]

    為您的備份取一個名稱後按「開始備份」
        <img alt="圖片" src="__img2" />
  </Step>
</Steps>

# 回復備份 [#回復備份]

<Steps>
  <Step>
    ### 點擊「...」 [#點擊]

    點擊之後可以根據您的需求進行下載、回復、鎖定、刪除等操作。

        <img alt="圖片" src="__img3" />
  </Step>

  <Step>
    ### 回復備份 [#回復備份-1]

    點擊「回復」後可決定是否清除原先資料，確定後按「Restore」。

        <img alt="圖片" src="__img4" />
  </Step>
</Steps>


# 編輯檔案 (/docs/panel/manage/edit)











<Callout title="警告" type="warn">
  面板編輯無法支援所有檔案類型。
</Callout>

<Steps>
  <Step>
    ### 點擊「檔案管理」 [#點擊檔案管理]

    點擊之後會出現一個頁面，有很多檔案。

        <img alt="圖片" src="__img0" />
  </Step>

  <Step>
    ### 選擇檔案 [#選擇檔案]

    滑鼠左鍵點擊想編輯的檔案

        <img alt="圖片" src="__img1" />
  </Step>

  <Step>
    ### 儲存檔案 [#儲存檔案]

    編輯完成後點擊「儲存檔案」
        <img alt="圖片" src="__img2" />
  </Step>
</Steps>


# 移動檔案 (/docs/panel/manage/move)











<Steps>
  <Step>
    ### 選擇檔案 [#選擇檔案]

    選擇你要移動的檔案

        <img alt="圖片" src="__img0" />
  </Step>

  <Step>
    ### 點擊移動 [#點擊移動]

    點擊「移動」按鈕

        <img alt="圖片" src="__img1" />
  </Step>

  <Step>
    ### 移動檔案 [#移動檔案]

    選擇目標位置後點擊移動
        <img alt="圖片" src="__img2" />
  </Step>
</Steps>


# 上傳檔案 (/docs/panel/manage/upload)









<Callout title="警告" type="warn">
  1. 超過 100MB 的檔案或者資料夾請使用 [SFTP](/docs/panel/common/sftp)。
  2. 無法透過此頁面上傳資料夾！
</Callout>

<Steps>
  <Step>
    ### 點擊「檔案管理」 [#點擊檔案管理]

    點擊之後會出現一個頁面，有很多檔案。

        <img alt="圖片" src="__img0" />
  </Step>

  <Step>
    ### 上傳檔案 [#上傳檔案]

    點擊「上傳」或將檔案直接拖曳到頁面上

        <img alt="圖片" src="__img1" />
  </Step>
</Steps>


# 自動化維護 (/docs/practice/advanced/automation)











<Callout title="為什麼需要自動化？">
  伺服器需要定期維護才能保持穩定運行。自動化維護可以減少人工操作，即使您不在線上，伺服器也能自動執行重要任務！
</Callout>

# 自動重啟 [#自動重啟]

長時間運行的伺服器可能會累積記憶體碎片或出現問題，定期重啟可以保持伺服器健康。

## 使用面板排程 [#使用面板排程]

在 Coffee Host 面板中設定排程任務：

<Steps>
  <Step>
    ### 進入排程頁面 [#進入排程頁面]

    在控制面板側邊欄點擊「**排程**」。

        <img alt="排程頁面" src="__img0" />
  </Step>

  <Step>
    ### 建立新排程 [#建立新排程]

    點擊「**創建排程**」，設定：

    * **名稱**：每日重啟
    * **時間**：例如每天凌晨 4:00，就輸入 &#x2A;*0 4 \* \* \***
      <img alt="創建排程" src="__img1" />
  </Step>

  <Step>
    ### 新增任務 [#新增任務]

    點擊「**管理排程**」後點擊「**新工作**」，在排程中新增以下任務：

    1. **傳送指令**：`say 伺服器將在 5 分鐘後重啟！`
    2. **傳送電源操作**：重啟伺服器，時間偏移設為 300

        <img alt="排程任務" src="__img2" />
  </Step>
</Steps>

## 使用 CMI 自動重啟 [#使用-cmi-自動重啟]

CMI 內建自動重啟功能：

```yaml
# plugins/CMI/config.yml
AutoRestart:
  Enabled: true
  
  # 重啟時間（24 小時制）
  Times:
    - "04:00"
    - "16:00"
  
  # 倒數計時警告（秒）
  Warn:
    - 3600    # 1 小時前
    - 1800    # 30 分鐘前
    - 600     # 10 分鐘前
    - 300     # 5 分鐘前
    - 60      # 1 分鐘前
    - 30
    - 10
    - 5
    - 4
    - 3
    - 2
    - 1
```

# 自動備份 [#自動備份]

定期備份可以在出問題時快速恢復。

## 使用面板備份 [#使用面板備份]

<Steps>
  <Step>
    ### 建立新排程 [#建立新排程-1]

    點擊「**創建排程**」，設定：

    * **名稱**：創建備份
    * **時間**：例如每天凌晨 4:00，就輸入 &#x2A;*0 4 \* \* \***
  </Step>

  <Step>
    ### 新增任務 [#新增任務-1]

    點擊「**管理排程**」後點擊「**新工作**」，在排程中新增以下任務：

    1. **創建備份**
  </Step>
</Steps>

## 使用 CMI 備份 [#使用-cmi-備份]

```yaml
# plugins/CMI/config.yml
Backup:
  Enabled: true
  
  # 備份間隔（分鐘）
  Interval: 1440    # 24 小時
  
  # 備份前儲存世界
  SaveBeforeBackup: true
  
  # 備份位置
  BackupFolder: "backups/"
  
  # 最大備份數量
  MaxBackups: 7
  
  # 要備份的世界
  Worlds:
    - world
    - world_nether
    - world_the_end
```

## 重要檔案備份清單 [#重要檔案備份清單]

| 檔案/資料夾              | 重要性   | 說明        |
| ------------------- | ----- | --------- |
| `world/`            | ⭐⭐⭐⭐⭐ | 主世界地圖     |
| `world_nether/`     | ⭐⭐⭐⭐  | 地獄地圖      |
| `world_the_end/`    | ⭐⭐⭐⭐  | 終界地圖      |
| `plugins/`          | ⭐⭐⭐⭐⭐ | 插件設定和資料   |
| `server.properties` | ⭐⭐⭐   | 伺服器設定     |
| `bukkit.yml`        | ⭐⭐⭐   | Bukkit 設定 |
| `spigot.yml`        | ⭐⭐⭐   | Spigot 設定 |
| `config/`           | ⭐⭐⭐⭐  | Paper 設定  |

# 自動清理 [#自動清理]

定期清理可以維持伺服器效能和節省空間。

## 清理掉落物 [#清理掉落物]

使用 ClearLagg 或 CMI：

```yaml
# CMI 設定
Schedule:
  ClearEntities:
    Enabled: true
    Interval: 300    # 每 5 分鐘
    
    # 警告訊息
    Warn:
      - 60
      - 30
      - 10
    
    # 要清理的實體
    Entities:
      - DROPPED_ITEM
      - ARROW
      - EXPERIENCE_ORB
```

## 清理 CoreProtect 資料 [#清理-coreprotect-資料]

CoreProtect 會記錄大量方塊變更，定期清理舊資料：

```
# 刪除 30 天前的記錄
/co purge t:30d
```

可以設定排程自動執行。

# 自動公告 [#自動公告]

定期發送公告可以提醒玩家重要資訊。

## 使用 CMI 自動訊息 [#使用-cmi-自動訊息]

```yaml
# plugins/CMI/config.yml
AutoMessages:
  Enabled: true
  
  # 訊息間隔（秒）
  Interval: 300
  
  # 隨機順序
  Random: true
  
  # 訊息列表
  Messages:
    - "&a加入我們的 Discord：discord.gg/xxxxx"
    - "&e記得用 /vote 每日投票獲得獎勵！"
    - "&b遇到問題？輸入 /help 查看幫助"
    - "&d商店開放中！輸入 /shop 查看"
```

# 監控與告警 [#監控與告警]

## 使用 Plan 監控 [#使用-plan-監控]

[Plan](https://www.spigotmc.org/resources/plan-player-analytics.32536/) 提供詳細的伺服器統計和監控。

功能包括：

* 玩家在線統計
* TPS 監控
* 玩家活動追蹤
* 網頁儀表板

## Discord 通知 [#discord-通知]

使用 [DiscordSRV](https://www.spigotmc.org/resources/discordsrv.18494/) 將伺服器事件發送到 Discord：

* 玩家加入/離開通知
* 伺服器啟動/關閉通知
* 聊天訊息同步

# 維護任務檢查清單 [#維護任務檢查清單]

| 任務               | 頻率        | 說明      |
| ---------------- | --------- | ------- |
| ☐ 自動重啟           | 每日        | 保持伺服器穩定 |
| ☐ 自動備份           | 每日        | 防止資料遺失  |
| ☐ 清理掉落物          | 每 5-10 分鐘 | 維持效能    |
| ☐ 清理 CoreProtect | 每月        | 節省空間    |
| ☐ 檢查更新           | 每週        | 安全性和新功能 |

<Callout type="info" title="測試排程">
  設定好排程後，建議先手動測試一次確保正常運作。特別是重啟排程，要確認伺服器能正確啟動。
</Callout>


# 資料庫設定 (/docs/practice/advanced/database)





<Callout type="warn" title="加購資料庫服務">
  加購資料庫請開啟 [Discord](https://discord.gg/hpe2aWVaYs) 客服單洽談。
</Callout>


# 效能優化 (/docs/practice/advanced/performance)







<Callout title="為什麼需要效能優化？">
  當伺服器的 TPS（Ticks Per Second）低於 20 時，玩家會感受到明顯的延遲。透過正確的設定，可以在不犧牲太多遊戲體驗的情況下大幅提升效能！
</Callout>

# 了解伺服器效能 [#了解伺服器效能]

## TPS 是什麼？ [#tps-是什麼]

TPS（Ticks Per Second）代表伺服器每秒處理的遊戲刻數：

| TPS   | 狀態      | 玩家感受   |
| ----- | ------- | ------ |
| 20    | ✅ 完美    | 流暢無延遲  |
| 18-19 | ⚠️ 輕微掉幀 | 幾乎無感   |
| 15-17 | ⚠️ 中等延遲 | 輕微卡頓   |
| 10-14 | ❌ 嚴重延遲  | 明顯延遲   |
| \<10  | ❌ 極度延遲  | 幾乎無法遊玩 |

## 查看 TPS [#查看-tps]

```
/tps          （Paper/Spigot）
/spark tps    （使用 Spark 插件）
```

## 常見效能問題來源 [#常見效能問題來源]

```
效能消耗排名（通常情況）：

1. 🏷️ 實體（Entity）     ████████████████████  40%
   - 怪物、動物、掉落物、船、礦車等

2. 🧩 紅石 / 漏斗        ██████████████        28%
   - 紅石機器、大量漏斗

3. 🌍 區塊載入           ████████████          24%
   - 玩家移動時載入新區塊

4. 🔌 插件               ████                   8%
   - 效能差的插件
```

# 使用 Spark 分析 [#使用-spark-分析]

Spark 是最好用的效能分析插件，可以找出導致延遲的原因。

<Steps>
  <Step>
    ### 安裝 Spark [#安裝-spark]

    下載 [Spark](https://spark.lucko.me/download) 並放入 plugins 資料夾。
  </Step>

  <Step>
    ### 開始分析 [#開始分析]

    當伺服器卡頓時，執行：

    ```
    /spark profiler start
    ```

    約 30 分鐘後：

    ```
    /spark profiler stop
    ```
  </Step>

  <Step>
    ### 查看報告 [#查看報告]

    Spark 會生成一個網址，開啟後可以看到：

    * 什麼東西佔用最多 CPU
    * 哪些插件效能最差
    * 實體數量統計

        <img alt="報告" src="__img0" />
  </Step>
</Steps>

# Paper 效能設定 [#paper-效能設定]

Paper 提供許多效能優化選項，位於 `config/paper-world-defaults.yml`。

## 實體優化 [#實體優化]

```yaml
entities:
  spawning:
    # 減少怪物生成數量（預設為 70）
    monster-spawn-limit: 50

    # 減少動物生成數量（預設為 10）
    creature-spawn-limit: 8

    # 減少水生生物
    water-animal-spawn-limit: 3
    water-ambient-spawn-limit: 10

    # 減少環境生物（蝙蝠等）
    ambient-spawn-limit: 1

  behavior:
    # 停用不必要的 AI（可能影響遊戲體驗）
    disable-chest-cat-detection: true

    # 村民優化
    tick-inactive-villagers: false

  tracking-range-y:
    enabled: true
```

## 區塊優化 [#區塊優化]

```yaml
chunks:
  # 減少實體啟用範圍（預設 32）
  entity-per-chunk-save-limit:
    experience_orb: 16
    arrow: 8
    ender_pearl: 8

  # 自動儲存間隔（tick）
  auto-save-interval: 6000
```

## 漏斗優化 [#漏斗優化]

```yaml
hopper:
  # 禁用漏斗移動事件（大幅提升效能）
  disable-move-event: true

  # 漏斗檢測間隔（tick）
  cooldown-when-full: true
```

<Callout type="warn" title="注意">
  `disable-move-event: true` 可能會導致部分保護插件的漏斗保護失效。
</Callout>

# Spigot 效能設定 [#spigot-效能設定]

編輯 `spigot.yml`：

```yaml
world-settings:
  default:
    # 怪物合併範圍（合併後只計算一個實體）
    merge-radius:
      exp: 6.0      # 經驗球
      item: 4.0     # 掉落物

    # 怪物生成範圍（較低 = 較少怪物）
    mob-spawn-range: 6

    # 實體啟用範圍（方塊）
    entity-activation-range:
      animals: 16      # 動物
      monsters: 24     # 怪物
      raiders: 48      # 掠奪者
      misc: 8          # 其他
      water: 8         # 水生
      villagers: 16    # 村民
      flying-monsters: 32  # 飛行怪物

    # 村民工作站檢測間隔
    entity-tracking-range:
      players: 48
      animals: 48
      monsters: 48
      misc: 32
      other: 64

    # 每 tick 最大生成數量
    ticks-per:
      animal-spawns: 400
      monster-spawns: 1
      autosave: 6000
```

# Bukkit 效能設定 [#bukkit-效能設定]

編輯 `bukkit.yml`：

```yaml
spawn-limits:
  monsters: 50      # 預設 70
  animals: 8        # 預設 10
  water-animals: 3  # 預設 5
  water-ambient: 10 # 預設 20
  ambient: 1        # 預設 15

chunk-gc:
  period-in-ticks: 600

ticks-per:
  animal-spawns: 400
  monster-spawns: 1
  autosave: 6000
```

# 實體清理 [#實體清理]

使用插件定期清理實體可以有效降低負載。

## ClearLagg [#clearlagg]

[ClearLagg](https://www.spigotmc.org/resources/clearlagg.68271/) 可以定期清理掉落物和實體。

```yaml
# plugins/ClearLagg/config.yml
auto-removal:
  enabled: true
  interval: 300    # 每 300 秒（5 分鐘）清理一次

  broadcast:
    enabled: true
    message: "&c[系統] 將在 60 秒後清理掉落物..."

  remove:
    items: true      # 清理掉落物
    primed-tnt: true # 清理 TNT
    falling-blocks: false
```

## CMI 清理功能 [#cmi-清理功能]

如果使用 CMI，可以使用內建的清理功能：

```
/cmi clear
```

或設定自動清理排程。

# 視距優化 [#視距優化]

視距（View Distance）對效能影響很大。

```yaml
# server.properties
view-distance=8        # 預設 10，建議 6-8

# spigot.yml（可以分世界設定）
world-settings:
  default:
    view-distance: 8
  world_nether:
    view-distance: 6
  world_the_end:
    view-distance: 6
```

## 模擬距離 [#模擬距離]

模擬距離控制區塊內實體的運算範圍：

```yaml
# server.properties
simulation-distance=6   # 預設 10，建議 4-6
```

# 預生成世界 [#預生成世界]

新區塊的生成非常消耗效能。預先生成世界可以避免這個問題。

## 使用 Chunky [#使用-chunky]

[Chunky](https://www.spigotmc.org/resources/chunky.81534/) 可以預生成區塊。

```
# 預生成半徑 5000 方塊
/chunky radius 5000

# 開始生成
/chunky start

# 暫停生成
/chunky pause
```

<Callout type="info">
  預生成過程中伺服器可能會卡頓，建議在沒有玩家時進行。
</Callout>

# 效能優化檢查清單 [#效能優化檢查清單]

| 項目            | 狀態 | 影響程度  |
| ------------- | -- | ----- |
| ☐ 安裝 Spark 分析 |    | ⭐⭐⭐⭐⭐ |
| ☐ 調整生怪數量限制    |    | ⭐⭐⭐⭐⭐ |
| ☐ 設定實體啟用範圍    |    | ⭐⭐⭐⭐  |
| ☐ 優化漏斗設定      |    | ⭐⭐⭐⭐  |
| ☐ 調整視距        |    | ⭐⭐⭐⭐  |
| ☐ 設定掉落物合併     |    | ⭐⭐⭐   |
| ☐ 預生成世界       |    | ⭐⭐⭐   |
| ☐ 定期清理實體      |    | ⭐⭐⭐   |

<Callout type="warn" title="平衡效能與體驗">
  效能優化可能會影響遊戲體驗（例如怪物變少、視距變短）。請根據實際情況找到適合您伺服器的平衡點。
</Callout>


# 群組伺服器架構 (/docs/practice/advanced/proxy)





<Callout title="什麼是群組伺服器？">
  群組伺服器（又稱 Proxy 伺服器）可以將多個 Minecraft 伺服器連接在一起，玩家可以在不同伺服器間無縫切換。大型伺服器如 Hypixel 就是使用這種架構！
</Callout>

# 群組伺服器架構 [#群組伺服器架構]

```
                    玩家連線
                       │
                       ▼
              ┌─────────────────┐
              │   Proxy 伺服器   │
              │ (Velocity/Bungee)│
              │    Port: 25565   │
              └────────┬────────┘
                       │
       ┌───────────────┼───────────────┐
       │               │               │
       ▼               ▼               ▼
┌────────────┐  ┌────────────┐  ┌────────────┐
│   大廳      │  │  生存服     │  │  小遊戲服  │
│   Lobby    │  │  Survival  │  │   Games   │
│ Port:25566 │  │ Port:25567 │  │ Port:25568│
└────────────┘  └────────────┘  └────────────┘
```

## Velocity vs BungeeCord [#velocity-vs-bungeecord]

| 特性   | Velocity    | BungeeCord |
| ---- | ----------- | ---------- |
| 效能   | ⭐⭐⭐⭐⭐ 優秀    | ⭐⭐⭐ 一般     |
| 安全性  | ⭐⭐⭐⭐⭐ 現代驗證  | ⭐⭐⭐ 傳統     |
| 插件相容 | ⭐⭐⭐ 較少（成長中） | ⭐⭐⭐⭐⭐ 很多   |
| 維護狀態 | ✅ 積極開發      | ⚠️ 較少更新    |
| 推薦度  | ⭐⭐⭐⭐⭐       | ⭐⭐⭐        |

<Callout type="info">
  **推薦使用 Velocity**，它是由 Paper 團隊開發的新一代 Proxy，效能和安全性都優於 BungeeCord。
</Callout>

# Velocity 安裝教學 [#velocity-安裝教學]

<Steps>
  <Step>
    ### 下載 Velocity [#下載-velocity]

    前往 [PaperMC 下載頁面](https://papermc.io/downloads/velocity) 下載最新版 Velocity。
  </Step>

  <Step>
    ### 建立 Proxy 伺服器 [#建立-proxy-伺服器]

    在主機面板建立一個新的伺服器，選擇 **Velocity** 類型。

    或手動建立：

    1. 建立新資料夾
    2. 放入 `velocity-xxx.jar`
    3. 建立啟動腳本
  </Step>

  <Step>
    ### 首次啟動 [#首次啟動]

    啟動 Velocity 後會生成設定檔 `velocity.toml`。
  </Step>

  <Step>
    ### 設定 velocity.toml [#設定-velocitytoml]

    ```toml
    # 綁定位址和連接埠（玩家連線用）
    bind = "0.0.0.0:25565"

    # 顯示的 MOTD
    motd = "&a我的群組伺服器"

    # 最大玩家數
    show-max-players = 100

    # 是否啟用正版驗證
    online-mode = true

    # 玩家轉發模式（重要！）
    player-info-forwarding-mode = "modern"

    [servers]
    # 定義各個子伺服器
    lobby = "127.0.0.1:25566"
    survival = "127.0.0.1:25567"
    games = "127.0.0.1:25568"

    # 預設伺服器（玩家連線後進入）
    try = ["lobby"]

    [forced-hosts]
    # 強制導向（可選）
    # 玩家連線 survival.example.com 會直接進入生存服
    "survival.example.com" = ["survival"]
    ```
  </Step>

  <Step>
    ### 複製 forwarding secret [#複製-forwarding-secret]

    Velocity 會生成 `forwarding.secret` 檔案，這是驗證用的金鑰。

    **記下這個金鑰**，稍後需要在子伺服器中設定。
  </Step>
</Steps>

# 子伺服器設定 [#子伺服器設定]

每個連接到 Velocity 的子伺服器都需要做以下設定：

<Steps>
  <Step>
    ### 關閉正版驗證 [#關閉正版驗證]

    編輯子伺服器的 `server.properties`：

    ```properties
    # 關閉正版驗證（由 Velocity 處理）
    online-mode=false
    ```

    <Callout type="warn">
      這不代表伺服器變成盜版！玩家驗證由 Velocity 處理。
    </Callout>
  </Step>

  <Step>
    ### 設定 Paper 轉發 [#設定-paper-轉發]

    編輯子伺服器的 `config/paper-global.yml`：

    ```yaml
    proxies:
      velocity:
        enabled: true
        online-mode: true
        secret: "複製 forwarding.secret 的內容貼在這裡"
    ```
  </Step>

  <Step>
    ### 重新啟動 [#重新啟動]

    重新啟動所有子伺服器和 Velocity。
  </Step>
</Steps>

# 跨服傳送 [#跨服傳送]

## 使用指令傳送 [#使用指令傳送]

在 Velocity 中，玩家可以使用指令切換伺服器：

```
/server lobby
/server survival
/server games
```

## 使用插件傳送 [#使用插件傳送]

可以使用 GUI 選單讓玩家選擇伺服器：

| 插件                                                                               | 平台       | 說明        |
| -------------------------------------------------------------------------------- | -------- | --------- |
| [HubBasics](https://github.com/4drian3d/HubBasics)                               | Velocity | 大廳功能      |
| [ServerUtils](https://modrinth.com/plugin/serverutils)                           | Velocity | 伺服器管理工具   |
| [VelocityServerSelector](https://github.com/hyperdefined/VelocityServerSelector) | Velocity | 伺服器選擇 GUI |

## 使用 BungeeCord API [#使用-bungeecord-api]

後端伺服器可以透過 BungeeCord API 傳送玩家：

```java
// Java 插件程式碼
ByteArrayDataOutput out = ByteStreams.newDataOutput();
out.writeUTF("Connect");
out.writeUTF("survival");
player.sendPluginMessage(plugin, "BungeeCord", out.toByteArray());
```

許多插件（如 CMI、EssentialsX）支援跨服傳送指令。

# 常用 Velocity 插件 [#常用-velocity-插件]

| 插件                                                           | 功能     |
| ------------------------------------------------------------ | ------ |
| [LuckPerms-Velocity](https://luckperms.net/)                 | 跨服權限管理 |
| [SignedVelocity](https://modrinth.com/plugin/signedvelocity) | 修復聊天簽章 |
| [ViaVersion](https://viaversion.com/)                        | 版本相容   |
| [LimboAPI](https://modrinth.com/plugin/limboapi)             | 虛空大廳   |

# 安全性建議 [#安全性建議]

## 1. 限制子伺服器連線 [#1-限制子伺服器連線]

只允許 Velocity 連接子伺服器，防止玩家直接連線繞過驗證：

**方法 A：使用防火牆**

```bash
# 只允許本機（Velocity）連線子伺服器
iptables -A INPUT -p tcp --dport 25566:25568 -s 127.0.0.1 -j ACCEPT
iptables -A INPUT -p tcp --dport 25566:25568 -j DROP
```

**方法 B：綁定本機位址**

在子伺服器的 `server.properties` 設定：

```properties
server-ip=127.0.0.1
```

## 2. 使用 Modern Forwarding [#2-使用-modern-forwarding]

確保 Velocity 使用 `player-info-forwarding-mode = "modern"`，這是最安全的模式。

## 3. 保護 forwarding.secret [#3-保護-forwardingsecret]

這個金鑰絕對不能洩漏！如果洩漏，惡意人士可能偽造玩家身份。

# 常見問題 [#常見問題]

## 玩家 UUID 不一致？ [#玩家-uuid-不一致]

確保所有伺服器的 forwarding 設定正確，UUID 應該由 Velocity 統一處理。

## 插件資料不同步？ [#插件資料不同步]

使用 MySQL 資料庫儲存插件資料，讓所有伺服器共用同一個資料庫。

## 跨服聊天？ [#跨服聊天]

使用跨服聊天插件：

* [AdvancedServerList](https://modrinth.com/plugin/advancedserverlist)
* [VentureChat](https://www.spigotmc.org/resources/venturechat.771/)


# 經濟系統設定 (/docs/practice/config/economy)





<Callout title="什麼是經濟系統？">
  經濟系統讓玩家可以**賺取和使用遊戲幣**，用於購買物品、交易、領地費用等。一個完善的經濟系統可以讓伺服器更有趣、更有活力！
</Callout>

# 經濟系統架構 [#經濟系統架構]

大多數 Minecraft 伺服器的經濟系統由三個部分組成：

```
┌─────────────────────────────────────────────┐
│                   Vault                      │
│          （經濟 API 橋接插件）                │
└─────────────────┬───────────────────────────┘
                  │
    ┌─────────────┼─────────────┐
    ▼             ▼             ▼
┌────────┐  ┌──────────┐  ┌──────────┐
│ CMI    │  │EssentialsX│ │ 其他經濟 │
│ 經濟   │  │  經濟    │  │   插件   │
└────────┘  └──────────┘  └──────────┘
    │             │             │
    └─────────────┼─────────────┘
                  ▼
        ┌──────────────────┐
        │   商店/交易插件   │
        │ (ChestShop 等)   │
        └──────────────────┘
```

| 組件        | 功能       | 推薦選擇                    |
| --------- | -------- | ----------------------- |
| **Vault** | 橋接不同經濟插件 | 必裝                      |
| **經濟提供者** | 儲存玩家金錢   | CMI / EssentialsX       |
| **商店插件**  | 讓玩家交易    | ChestShop / ShopGUIPlus |

# 安裝 Vault [#安裝-vault]

<Steps>
  <Step>
    ### 下載 Vault [#下載-vault]

    前往 [SpigotMC](https://www.spigotmc.org/resources/vault.34315/) 下載 Vault。
  </Step>

  <Step>
    ### 安裝插件 [#安裝插件]

    將 `Vault.jar` 放入 `plugins` 資料夾，重新啟動伺服器。
  </Step>

  <Step>
    ### 確認安裝 [#確認安裝]

    Vault 本身不提供經濟功能，它只是一個橋接器。安裝後控制台會顯示：

    ```
    [Vault] Enabling Vault v1.7.x
    [Vault] [Economy] CMI found: Loaded
    ```
  </Step>
</Steps>

# 設定 CMI 經濟 [#設定-cmi-經濟]

如果您使用 CMI 作為主要插件，CMI 內建經濟功能。

## 啟用經濟功能 [#啟用經濟功能]

編輯 `plugins/CMI/config.yml`：

```yaml
Economy:
  # 啟用 CMI 經濟（會自動註冊到 Vault）
  Enabled: true
  
  # 新玩家起始金額
  StartingBalance: 1000.0
  
  # 金錢顯示格式
  MoneyFormat: '#,##0.00'
  
  # 貨幣符號
  CurrencySymbol: '$'
  
  # 符號位置（true = 前面 $100，false = 後面 100$）
  SuffixSymbol: false
  
  # 最大金額上限
  MaxBalance: 10000000000000
  
  # 允許負數餘額
  AllowNegativeBalance: false
```

## 經濟指令 [#經濟指令]

| 指令                          | 功能      | 權限                    |
| --------------------------- | ------- | --------------------- |
| `/balance` 或 `/bal`         | 查看餘額    | `cmi.command.balance` |
| `/pay <玩家> <金額>`            | 轉帳給其他玩家 | `cmi.command.pay`     |
| `/baltop`                   | 查看財富排行榜 | `cmi.command.baltop`  |
| `/cmi money give <玩家> <金額>` | 給予玩家金錢  | `cmi.command.money`   |
| `/cmi money take <玩家> <金額>` | 扣除玩家金錢  | `cmi.command.money`   |
| `/cmi money set <玩家> <金額>`  | 設定玩家金錢  | `cmi.command.money`   |

# 設定 EssentialsX 經濟 [#設定-essentialsx-經濟]

如果您使用 EssentialsX，經濟功能預設已啟用。

## 經濟設定 [#經濟設定]

編輯 `plugins/Essentials/config.yml`：

```yaml
# 貨幣符號
currency-symbol: '$'

# 符號位置（true = 後面）
currency-symbol-suffix: false

# 新玩家起始金額
starting-balance: 1000

# 最大金額
max-money: 10000000000000

# 最小金額（負數表示可以欠債）
min-money: 0

# 是否在餘額不足時顯示確切金額
economy-log-enabled: false
```

# 商店系統 [#商店系統]

## ChestShop（箱子商店） [#chestshop箱子商店]

ChestShop 讓玩家用箱子建立自己的商店。

### 安裝 [#安裝]

下載 [ChestShop](https://www.spigotmc.org/resources/chestshop.51856/) 並放入 plugins 資料夾。

### 建立商店 [#建立商店]

<Steps>
  <Step>
    ### 放置箱子 [#放置箱子]

    放置一個箱子，並在裡面放入要販售的物品。
  </Step>

  <Step>
    ### 放置告示牌 [#放置告示牌]

    在箱子上方或旁邊放置告示牌，按照以下格式填寫：

    ```
    第一行：留空（會自動填入玩家名稱）
    第二行：數量
    第三行：B 買價 : S 賣價
    第四行：物品名稱或 ?
    ```

    **範例（賣鑽石）：**

    ```
    [空白]
    64
    B 100 : S 50
    Diamond
    ```

    這表示：玩家可以用 $100 買 64 個鑽石，或用 64 個鑽石賣給商店換 $50。
  </Step>

  <Step>
    ### 完成！ [#完成]

    告示牌會自動變色，表示商店建立成功。

    !\[ChestShop]
  </Step>
</Steps>

### 告示牌格式說明 [#告示牌格式說明]

| 行數  | 內容             | 說明                       |
| --- | -------------- | ------------------------ |
| 第一行 | 玩家名稱           | 留空會自動填入，填 `Admin` 為管理員商店 |
| 第二行 | `64`           | 每次交易的數量                  |
| 第三行 | `B 100 : S 50` | B=買價、S=賣價，可以只寫其中一個       |
| 第四行 | `Diamond`      | 物品名稱，填 `?` 會自動偵測箱內物品     |

### 管理員商店 [#管理員商店]

管理員商店有**無限庫存**，玩家可以無限購買/出售。

在第一行填入 `Admin Shop` 或在設定中指定的名稱：

```
Admin Shop
64
B 100 : S 50
Diamond
```

## ShopGUIPlus（GUI 商店） [#shopguiplusgui-商店]

ShopGUIPlus 提供漂亮的 GUI 商店介面，但需要付費購買。

### 替代方案 [#替代方案]

| 插件                                                                   | 類型     | 價格 |
| -------------------------------------------------------------------- | ------ | -- |
| [DeluxeMenus](https://www.spigotmc.org/resources/deluxemenus.11734/) | GUI 選單 | 免費 |
| [BossShopPro](https://www.spigotmc.org/resources/bossshoppro.222/)   | GUI 商店 | 免費 |
| [zShop](https://www.spigotmc.org/resources/zshop.43640/)             | GUI 商店 | 免費 |

# 賺錢方式設定 [#賺錢方式設定]

讓玩家有多種方式賺錢，經濟才會活絡！

## 工作/任務插件 [#工作任務插件]

| 插件                                                                  | 功能            |
| ------------------------------------------------------------------- | ------------- |
| [Jobs Reborn](https://www.spigotmc.org/resources/jobs-reborn.4216/) | 職業系統，做特定工作賺錢  |
| [Quests](https://www.spigotmc.org/resources/quests.3711/)           | 任務系統，完成任務獲得獎勵 |

## Jobs Reborn 快速設定 [#jobs-reborn-快速設定]

Jobs Reborn 讓玩家選擇職業，做對應工作賺錢：

* ⛏️ **礦工**：挖礦賺錢
* 🪓 **伐木工**：砍樹賺錢
* 🎣 **漁夫**：釣魚賺錢
* 🌾 **農夫**：種田賺錢
* ⚔️ **獵人**：打怪賺錢

```yaml
# plugins/Jobs/jobConfig.yml 範例
Jobs:
  Miner:
    fullname: 礦工
    shortname: M
    description: 挖掘礦物賺取金錢
    income:
      Break:
        COAL_ORE:
          income: 1.0
        IRON_ORE:
          income: 2.0
        DIAMOND_ORE:
          income: 10.0
```

# 經濟平衡建議 [#經濟平衡建議]

<Callout type="warn" title="經濟平衡很重要！">
  經濟設定不當會導致通貨膨脹（錢太多）或通貨緊縮（錢太少），影響遊戲體驗。
</Callout>

## 金錢來源 vs 消耗 [#金錢來源-vs-消耗]

確保金錢的**來源**和**消耗**大致平衡：

| 💰 金錢來源  | 💸 金錢消耗   |
| -------- | --------- |
| 打怪掉落     | 商店購買物品    |
| 賣物品給 NPC | 傳送費用      |
| 完成任務     | 領地購買/租金   |
| 職業收入     | 附魔/修復費用   |
| 投票獎勵     | 玩家間交易（轉移） |

## 建議數值 [#建議數值]

| 項目    | 建議值          | 說明       |
| ----- | ------------ | -------- |
| 起始金額  | $500 - $2000 | 夠買基本物品即可 |
| 鑽石售價  | $50 - $200   | 作為中期目標   |
| 傳送費用  | $10 - $50    | 小額消耗     |
| 設置家費用 | $100 - $500  | 中額消耗     |

<Callout type="info">
  經濟數值沒有標準答案，需要根據伺服器玩法和玩家回饋持續調整。
</Callout>


# LuckPerms 權限管理 (/docs/practice/config/luckperms)



















<Callout title="什麼是權限系統？">
  權限系統讓您可以**控制玩家能做什麼、不能做什麼**。例如：只有 VIP 玩家可以飛行、只有管理員可以踢人。LuckPerms 是目前最流行且功能最強大的權限插件！
</Callout>

# 為什麼需要權限管理？ [#為什麼需要權限管理]

在預設情況下，所有玩家的權限都是一樣的。透過權限系統，您可以：

| 功能              | 範例           |
| --------------- | ------------ |
| 🎮 **區分玩家等級**   | 一般玩家、VIP、管理員 |
| 🛡️ **保護伺服器安全** | 只有管理員能使用危險指令 |
| 💰 **創造付費價值**   | VIP 可以享有更多功能 |
| 👥 **分工管理**     | 不同管理員負責不同事務  |

# 基本概念 [#基本概念]

在開始之前，先了解 LuckPerms 的四個核心概念：

| 術語                          | 說明            | 比喻      |
| --------------------------- | ------------- | ------- |
| 🔑 &#x2A;*Permission（權限）**  | 控制玩家能做什麼的節點   | 一把鑰匙    |
| 👥 &#x2A;*Group（群組）**       | 一組權限的集合       | 一串鑰匙    |
| 👤 &#x2A;*User（使用者）**       | 個別玩家          | 拿鑰匙的人   |
| 🔗 &#x2A;*Inheritance（繼承）** | 群組可以繼承其他群組的權限 | 繼承家族的鑰匙 |

## 權限節點格式 [#權限節點格式]

權限節點通常的格式為：`插件名稱.功能.細項`

```
essentials.fly          → EssentialsX 的飛行功能
essentials.home.set     → EssentialsX 的設定家功能
worldguard.region.claim → WorldGuard 的領地宣告功能
```

<Callout type="info" title="萬用字元">
  使用 `*` 可以代表所有子權限：

  * `essentials.*` = EssentialsX 的所有權限
  * `essentials.home.*` = EssentialsX 所有家相關權限
</Callout>

# 安裝 LuckPerms [#安裝-luckperms]

<Steps>
  <Step>
    ### 下載 LuckPerms [#下載-luckperms]

    前往 [LuckPerms 官網](https://luckperms.net/download) 下載適合您伺服器的版本：

    | 伺服器類型                   | 下載版本       |
    | ----------------------- | ---------- |
    | Paper / Spigot / Purpur | Bukkit     |
    | BungeeCord / Waterfall  | BungeeCord |
    | Velocity                | Velocity   |
    | Forge                   | Forge      |
    | Fabric                  | Fabric     |

        <img alt="下載 LuckPerms" src="__img0" />
  </Step>

  <Step>
    ### 安裝插件 [#安裝插件]

    1. 將下載的 `.jar` 檔案上傳至 `plugins` 資料夾
    2. **重新啟動伺服器**
  </Step>

  <Step>
    ### 確認安裝成功 [#確認安裝成功]

    在控制台輸入 `lp` 指令，如果顯示 LuckPerms 的幫助訊息，表示安裝成功。

    ```
    > lp
    [LuckPerms] Running LuckPerms v5.4.xxx
    [LuckPerms] Usage: /lp ...
    ```

        <img alt="確認安裝" src="__img1" />
  </Step>
</Steps>

# 建立權限群組 [#建立權限群組]

## 典型的群組架構 [#典型的群組架構]

大多數伺服器會建立這樣的群組階層：

```
admin（管理員）
  ↓ 繼承
mod（版主）
  ↓ 繼承
vip（VIP）
  ↓ 繼承
default（預設玩家）
```

這樣的好處是：admin 自動擁有 mod + vip + default 的所有權限。

## 建立群組步驟 [#建立群組步驟]

<Steps>
  <Step>
    ### 建立群組 [#建立群組]

    ```
    /lp creategroup vip
    /lp creategroup mod
    /lp creategroup admin
    ```

    !\[建立群組]
  </Step>

  <Step>
    ### 設定群組繼承 [#設定群組繼承]

    讓高級群組繼承低級群組的權限：

    ```
    /lp group vip parent add default
    /lp group mod parent add vip
    /lp group admin parent add mod
    ```
  </Step>

  <Step>
    ### 為群組添加權限 [#為群組添加權限]

    ```
    # 預設玩家 - 基本功能
    /lp group default permission set essentials.home true
    /lp group default permission set essentials.tpa true

    # VIP - 額外功能
    /lp group vip permission set essentials.fly true
    /lp group vip permission set essentials.sethome.multiple.vip true

    # 版主 - 管理功能
    /lp group mod permission set essentials.kick true
    /lp group mod permission set essentials.mute true

    # 管理員 - 所有權限
    /lp group admin permission set * true
    ```

        <img alt="設定權限" src="__img2" />
  </Step>

  <Step>
    ### 設定聊天前綴 [#設定聊天前綴]

    為群組設定聊天時顯示的標籤（需要搭配聊天插件）：

    ```
    /lp group default meta addprefix 10 "&7[玩家] "
    /lp group vip meta addprefix 20 "&6[VIP] "
    /lp group mod meta addprefix 50 "&9[版主] "
    /lp group admin meta addprefix 100 "&c[管理員] "
    ```

    <Callout type="info">
      數字代表**優先順序**，數字越大優先顯示。如果玩家同時是 VIP 和 MOD，會顯示數字較大的 \[版主]。
    </Callout>

    **顏色代碼參考：**

    | 代碼   | 顏色 | 代碼   | 顏色 |
    | ---- | -- | ---- | -- |
    | `&0` | 黑色 | `&8` | 深灰 |
    | `&1` | 深藍 | `&9` | 藍色 |
    | `&2` | 深綠 | `&a` | 綠色 |
    | `&3` | 深青 | `&b` | 青色 |
    | `&4` | 深紅 | `&c` | 紅色 |
    | `&5` | 紫色 | `&d` | 粉紅 |
    | `&6` | 金色 | `&e` | 黃色 |
    | `&7` | 灰色 | `&f` | 白色 |

        <img alt="設定前綴" src="__img3" />
  </Step>
</Steps>

# 管理玩家權限 [#管理玩家權限]

## 將玩家加入群組 [#將玩家加入群組]

```
# 將玩家設為 VIP（取代原有群組）
/lp user Steve parent set vip

# 將玩家加入 Admin 群組（保留原有群組）
/lp user Alex parent add admin
```

<Callout type="warn" title="set 與 add 的區別">
  * `parent set` → 取代玩家原有的群組
  * `parent add` → 在原有群組之外再加入新群組
</Callout>

## 設定臨時權限/群組 [#設定臨時權限群組]

讓 VIP 權限在一週後自動過期：

```
# 臨時加入群組（7 天）
/lp user Steve parent addtemp vip 7d

# 臨時權限（30 天）
/lp user Steve permission settemp essentials.fly true 30d
```

**時間單位：**

* `s` = 秒、`m` = 分、`h` = 小時、`d` = 天、`w` = 週、`mo` = 月、`y` = 年

## 查看玩家資訊 [#查看玩家資訊]

```
# 查看玩家基本資訊
/lp user Steve info

# 查看玩家所有權限
/lp user Steve permission info
```

# 使用網頁編輯器 ⭐ [#使用網頁編輯器-]

LuckPerms 最強大的功能之一就是**網頁編輯器**，可以用圖形介面管理所有權限！

<Steps>
  <Step>
    ### 開啟編輯器 [#開啟編輯器]

    在控制台輸入：

    ```
    /lp editor
    ```

    系統會生成一個網址，點擊即可開啟編輯器。

        <img alt="開啟編輯器" src="__img4" />

    <Callout type="warn">
      編輯器連結會在幾分鐘後過期，請儘快完成編輯。
    </Callout>
  </Step>

  <Step>
    ### 編輯權限 [#編輯權限]

    在網頁編輯器中，您可以直覺地：

    * ✅ 建立/刪除群組
    * ✅ 添加/移除權限
    * ✅ 設定前綴和後綴
    * ✅ 管理群組繼承關係
    * ✅ 編輯個別玩家權限

        <img alt="網頁編輯器" src="__img5" />
  </Step>

  <Step>
    ### 儲存變更 [#儲存變更]

    編輯完成後：

    1. 點擊右上角的「**Save**」按鈕
    2. 複製產生的指令
    3. 在遊戲中或控制台**貼上執行**

        <img alt="儲存變更" src="__img6" />
  </Step>
</Steps>

# 常用權限節點 [#常用權限節點]

## CMI 權限 [#cmi-權限]

| 權限節點                  | 功能說明           |
| --------------------- | -------------- |
| `cmi.command.home`    | 使用 /home 指令    |
| `cmi.command.sethome` | 使用 /sethome 指令 |
| `cmi.command.tpa`     | 使用 /tpa 指令     |
| `cmi.command.fly`     | 使用 /fly 指令     |
| `cmi.command`         | 所有 CMI 指令權限    |

## EssentialsX 權限 [#essentialsx-權限]

| 權限節點                 | 功能說明              |
| -------------------- | ----------------- |
| `essentials.home`    | 使用 /home 指令       |
| `essentials.sethome` | 使用 /sethome 指令    |
| `essentials.tpa`     | 使用 /tpa 指令        |
| `essentials.fly`     | 使用 /fly 指令        |
| `essentials.*`       | 所有 EssentialsX 權限 |

## WorldEdit / WorldGuard 權限 [#worldedit--worldguard-權限]

| 權限節點                      | 功能說明     |
| ------------------------- | -------- |
| `worldedit.wand`          | 使用選取工具   |
| `worldedit.selection.*`   | 所有選取相關指令 |
| `worldguard.region.claim` | 宣告領地     |

<Callout type="info" title="如何找到權限節點？">
  1. 查閱插件官方文件
  2. 在控制台觀察玩家執行指令時缺少的權限訊息
  3. 使用 `/lp verbose on` 追蹤權限檢查
</Callout>

# 常見問題排解 [#常見問題排解]

## 權限設好了但沒有生效？ [#權限設好了但沒有生效]

| 可能原因     | 解決方法                 |
| -------- | -------------------- |
| 玩家需要重新登入 | 讓玩家重新加入伺服器           |
| 權限節點打錯   | 檢查拼寫，使用網頁編輯器         |
| OP 權限覆蓋  | OP 預設擁有所有權限，移除 OP 測試 |
| 權限被否定    | 檢查是否有 `false` 的權限覆蓋  |

## 如何查看玩家為什麼沒有權限？ [#如何查看玩家為什麼沒有權限]

使用詳細模式追蹤權限檢查：

```
/lp verbose on
```

然後讓玩家嘗試使用指令，控制台會顯示詳細的權限檢查過程。

## 如何備份權限資料？ [#如何備份權限資料]

權限資料存放在 `plugins/LuckPerms/` 資料夾，可以直接複製整個資料夾備份。

<Callout type="info" title="進階功能">
  LuckPerms 還支援 MySQL/MariaDB 資料庫儲存，適合跨伺服器同步權限。詳細設定請參考 [LuckPerms 官方文件](https://luckperms.net/wiki/Home)。
</Callout>


# Paper 全域設定 (/docs/practice/config/paper-global)





<Callout title="什麼是 Paper 設定檔？">
  Paper 伺服器有自己的設定檔，可以控制許多 **Minecraft 原版特性的開關**。Paper 為了優化效能，預設關閉了一些原版特性，但您可以手動開啟它們。
</Callout>

<Callout type="info" title="適用範圍">
  此教學適用於 **Paper、Purpur、Pufferfish** 等基於 Paper 的伺服器核心。
  如果您使用 Spigot，請參考 `spigot.yml`。
</Callout>

# 設定檔位置 [#設定檔位置]

Paper 伺服器有兩個主要設定檔，位於 `config` 資料夾中：

| 設定檔                               | 用途                     |
| --------------------------------- | ---------------------- |
| `config/paper-global.yml`         | **全域設定** - 適用於整個伺服器    |
| `config/paper-world-defaults.yml` | **世界設定** - 適用於所有世界的預設值 |

<Callout type="info">
  如果找不到 `config` 資料夾，請先啟動一次伺服器，它會自動生成。
</Callout>

# 修改設定檔 [#修改設定檔]

<Steps>
  <Step>
    ### 步驟一：關閉伺服器 [#步驟一關閉伺服器]

    建議先關閉伺服器，以確保設定正確儲存。
  </Step>

  <Step>
    ### 步驟二：開啟設定檔 [#步驟二開啟設定檔]

    1. 前往面板的「**檔案管理**」頁面
    2. 進入 `config` 資料夾
    3. 點擊要編輯的設定檔

    <Image src="/images/practice/paper-global/open.png" alt="開啟設定檔" width="800" height="600" />
  </Step>

  <Step>
    ### 步驟三：修改設定 [#步驟三修改設定]

    找到對應的設定項目，修改其值。

    <Image src="/images/practice/paper-global/edit.png" alt="修改設定" width="800" height="600" />
  </Step>

  <Step>
    ### 步驟四：儲存並重啟 [#步驟四儲存並重啟]

    儲存設定檔後，重新啟動伺服器。

    <Callout type="info">
      部分設定可用 `/paper reload` 重新載入，但建議重啟伺服器確保生效。
    </Callout>
  </Step>
</Steps>

# 🔧 生電特性設定 [#-生電特性設定]

Paper 為了優化效能，**預設關閉了一些原版特性**。如果您是生電玩家或想要還原原版行為，可以開啟這些設定。

<Callout type="info" title="什麼是生電？">
  生電（生存電路）是指在 Minecraft 生存模式下，使用紅石電路製作自動化農場、複製機等機器的玩法。許多生電機制依賴 Minecraft 的特殊行為（bug），Paper 預設會修復這些行為。
</Callout>

## 🪨 基岩破壞與活塞複製 [#-基岩破壞與活塞複製]

**用途：** 允許玩家使用活塞機器破壞基岩和進行活塞複製（如 TNT、地毯、鐵軌複製）

**設定位置：** `config/paper-global.yml`

```yaml
unsupported-settings:
  allow-headless-pistons: false              # ← 預設值
  allow-piston-duplication: false            # ← 預設值
  allow-permanent-block-break-exploits: false # ← 預設值
```

**啟用方式：** 將這些值改為 `true`

```yaml
unsupported-settings:
  allow-headless-pistons: true               # ← 允許無頭活塞
  allow-piston-duplication: true             # ← 允許 TNT / 地毯 / 鐵軌複製
  allow-permanent-block-break-exploits: true # ← 允許永久方塊破壞漏洞
```

<Callout type="warn" title="不支援的設定">
  這些設定位於 `unsupported-settings` 區塊中，代表 Paper 官方**不支援且不建議**使用。啟用這些設定可能會：

  * 導致遊戲機制異常
  * 破壞遊戲平衡
  * 在未來版本中被移除或變更

  請謹慎評估後再啟用！
</Callout>

# 📋 完整生電設定範例 [#-完整生電設定範例]

如果您想一次啟用所有生電特性，請按照以下設定：

**config/paper-global.yml**

```yaml
unsupported-settings:
  allow-headless-pistons: true               # 允許無頭活塞
  allow-piston-duplication: true             # 允許 TNT / 地毯 / 鐵軌複製
  allow-permanent-block-break-exploits: true # 允許永久方塊破壞漏洞
```

<Callout type="warn" title="效能警告">
  ⚠️ 啟用這些特性可能會影響伺服器效能，特別是：

  * 大量使用 TNT 複製機
  * 大型自動化農場
  * 多人同時使用複製機

  請根據伺服器的實際情況決定是否啟用。
</Callout>

# ⚡ 效能優化設定 [#-效能優化設定]

Paper 提供許多效能優化選項，以下是常用的設定：

## 區塊系統設定 [#區塊系統設定]

**設定位置：** `config/paper-global.yml`

```yaml
chunk-system:
  gen-parallelism: default    # 區塊生成並行度
  io-threads: -1              # IO 執行緒數（-1 = 自動）
  worker-threads: -1          # 工作執行緒數（-1 = 自動）
```

<Callout type="info">
  預設的 `-1` 表示自動偵測，通常不需要修改。
</Callout>

## 反作弊設定 [#反作弊設定]

**設定位置：** `config/paper-world-defaults.yml`

```yaml
anticheat:
  anti-xray:
    enabled: false            # 反透視（效能消耗較大）
```

| 設定               | 效果              |
| ---------------- | --------------- |
| `enabled: true`  | 啟用反透視，礦物會被假方塊遮蓋 |
| `enabled: false` | 關閉反透視，效能較好      |

# 📝 訊息自訂 [#-訊息自訂]

您可以自訂 Paper 的系統訊息：

**設定位置：** `config/paper-global.yml`

```yaml
messages:
  kick:
    authentication-servers-down: "無法驗證您的帳號，Mojang 伺服器可能故障中"
    connection-throttle: "連線過於頻繁，請稍後再試"
    flying-player: "禁止飛行！"
    flying-vehicle: "禁止載具飛行！"
```

# 🔍 常用指令 [#-常用指令]

| 指令                     | 說明                     |
| ---------------------- | ---------------------- |
| `/paper reload`        | 重新載入 Paper 設定（部分設定需重啟） |
| `/paper version`       | 查看 Paper 版本            |
| `/paper dumpplugins`   | 輸出插件資訊（除錯用）            |
| `/paper mobcaps`       | 查看生物生成上限               |
| `/paper playermobcaps` | 查看玩家周圍的生物上限            |

# 📚 相關資源 [#-相關資源]

* [Paper 官方文件](https://docs.papermc.io/paper)
* [Paper 設定檔完整參考](https://docs.papermc.io/paper/reference/configuration)

<Callout type="info">
  Paper 的設定檔結構可能會隨版本更新而變化，建議查閱官方文件以獲取最新資訊。
</Callout>


# 插件設定 (/docs/practice/config/plugin)

















<Callout title="什麼是插件設定檔？">
  幾乎所有插件都有設定檔（Config），讓您可以**自訂插件的各項功能**，而不需要修改程式碼。掌握設定檔的修改方法，是管理伺服器的必備技能！
</Callout>

# 設定檔基本介紹 [#設定檔基本介紹]

## 設定檔在哪裡？ [#設定檔在哪裡]

插件的設定檔通常位於：

```
plugins/插件名稱/config.yml
```

例如：

* LuckPerms 的設定檔：`plugins/LuckPerms/config.yml`
* EssentialsX 的設定檔：`plugins/Essentials/config.yml`
* CMI 的設定檔：`plugins/CMI/config.yml`

## 常見的設定檔類型 [#常見的設定檔類型]

| 檔案名稱                   | 用途           |
| ---------------------- | ------------ |
| `config.yml`           | 主要設定檔（最常修改）  |
| `messages.yml`         | 訊息文字設定       |
| `lang.yml` 或 `locale/` | 語言/翻譯設定      |
| `data.yml`             | 資料儲存（通常不需修改） |

<Callout type="info" title="找不到設定檔？">
  設定檔在**插件首次載入後**才會生成。如果找不到，請先啟動一次伺服器。
</Callout>

# YAML 格式教學 [#yaml-格式教學]

大多數插件使用 **YAML**（.yml）格式的設定檔。學會 YAML 格式是修改設定的基礎。

## 基本語法 [#基本語法]

```yaml
# 這是註解，用 # 開頭，不會影響設定
# 大多數設定檔都有詳細的註解說明

# 基本設定：名稱: 值
server-name: "我的伺服器"
max-players: 100
enable-pvp: true

# 巢狀設定（用空格縮排）
teleport:
  delay: 3
  cooldown: 60
  cancel-on-move: true

# 列表（用 - 開頭）
disabled-commands:
  - kill
  - suicide
  - gamemode
```

## 資料類型說明 [#資料類型說明]

| 類型      | 範例                       | 說明          |
| ------- | ------------------------ | ----------- |
| **字串**  | `"Hello World"`          | 文字，建議用引號包起來 |
| **數字**  | `100` 或 `3.14`           | 整數或小數       |
| **布林值** | `true` 或 `false`         | 是/否、開/關     |
| **列表**  | `- item1`<br />`- item2` | 多個項目        |

## ⚠️ YAML 常見錯誤 [#️-yaml-常見錯誤]

<Callout type="warn" title="YAML 對格式非常敏感！">
  **錯誤 1：使用 Tab 縮排**

  ```yaml
  # ❌ 錯誤 - 使用 Tab
  teleport:
  	delay: 3        # Tab 縮排會出錯！

  # ✅ 正確 - 使用空格
  teleport:
    delay: 3          # 用 2 個空格縮排
  ```

  **錯誤 2：冒號後面沒有空格**

  ```yaml
  # ❌ 錯誤
  delay:3

  # ✅ 正確
  delay: 3            # 冒號後面要有空格
  ```

  **錯誤 3：縮排不對齊**

  ```yaml
  # ❌ 錯誤 - 縮排不一致
  teleport:
    delay: 3
     cooldown: 60     # 多了一個空格！

  # ✅ 正確 - 同層級對齊
  teleport:
    delay: 3
    cooldown: 60
  ```
</Callout>

# 修改設定檔教學 [#修改設定檔教學]

<Steps>
  <Step>
    ### 步驟一：找到設定檔 [#步驟一找到設定檔]

    1. 前往面板的「**檔案管理**」頁面
    2. 進入 `plugins` 資料夾
    3. 找到您要修改的**插件資料夾**
    4. 點擊 `config.yml` 開啟編輯

        <img alt="找到設定檔" src="__img0" />
  </Step>

  <Step>
    ### 步驟二：閱讀註解 [#步驟二閱讀註解]

    開啟設定檔後，先**閱讀註解說明**。大多數設定檔都有詳細的英文註解，解釋每個選項的用途。

    ```yaml
    # Teleport delay in seconds
    # Set to 0 to disable
    teleport-delay: 3
    ```

        <img alt="設定檔內容" src="__img1" />

    <Callout type="info">
      如果註解是英文，可以使用 [Google 翻譯](https://translate.google.com/) 或 [ChatGPT](/docs/debug/gpt) 了解設定的意義。
    </Callout>
  </Step>

  <Step>
    ### 步驟三：修改設定值 [#步驟三修改設定值]

    找到要修改的設定，將值改成您想要的：

    ```yaml
    # 修改前
    teleport-delay: 3

    # 修改後（改成 5 秒）
    teleport-delay: 5
    ```

        <img alt="修改設定" src="__img2" />
  </Step>

  <Step>
    ### 步驟四：儲存檔案 [#步驟四儲存檔案]

    修改完成後，點擊「**儲存**」按鈕。

        <img alt="儲存設定" src="__img3" />
  </Step>

  <Step>
    ### 步驟五：重新載入設定 [#步驟五重新載入設定]

    有兩種方式可以套用新設定：

    | 方式           | 指令             | 說明        |
    | ------------ | -------------- | --------- |
    | **重新載入**（推薦） | `/插件名稱 reload` | 不需重啟，立即生效 |
    | **重新啟動**     | 重啟伺服器          | 最穩定，但需要等待 |

    常見的重新載入指令：

    * EssentialsX：`/essentials reload` 或 `/ess reload`
    * CMI：`/cmi reload`
    * LuckPerms：`/lp reload`
    * WorldGuard：`/wg reload`

        <img alt="重新載入" src="__img4" />
  </Step>
</Steps>

# 常見插件設定範例 [#常見插件設定範例]

## CMI（多功能插件） [#cmi多功能插件]

CMI 是功能最完整的多功能插件之一，設定檔位於 `plugins/CMI/`。

**傳送設定** - `config.yml`

```yaml
Teleportation:
  # 傳送請求超時時間（秒）
  Tpa:
    Time: 60
  
  # 傳送前的延遲（秒）
  Delay: 3
  
  # 傳送冷卻時間（秒）
  Cooldown: 5
  
  # 移動時取消傳送
  CancelOnMove: true
```

**經濟設定** - `config.yml`

```yaml
Economy:
  # 新玩家起始金額
  StartingBalance: 1000.0
  
  # 金錢顯示格式
  MoneyFormat: '#,##0.00'
  
  # 最大金額
  MaxBalance: 10000000000000
```

## EssentialsX [#essentialsx]

EssentialsX 是最經典的基礎插件，設定檔位於 `plugins/Essentials/`。

**傳送設定** - `config.yml`

```yaml
# 傳送延遲（秒），0 = 無延遲
teleport-delay: 3

# 傳送冷卻（秒）
teleport-cooldown: 0

# 傳送時無敵時間（秒）
teleport-invulnerability: 4
```

**新玩家設定** - `config.yml`

```yaml
newbies:
  # 新玩家出生點（設定一個 warp 名稱）
  spawnpoint: newbie
  
  # 新玩家裝備包
  kit: starter
  
  # 新玩家公告
  announce-format: "&d歡迎 {PLAYER} 加入伺服器！"
```

## WorldGuard（領地保護） [#worldguard領地保護]

WorldGuard 的設定檔位於 `plugins/WorldGuard/`。

**全域設定** - `config.yml`

```yaml
# 是否啟用建築權限
build-permission-nodes:
  enable: false

# 高度 Y 座標限制
max-region-count-per-player:
  default: 7    # 預設每人最多 7 個領地
```

# 設定檔錯誤排解 [#設定檔錯誤排解]

## 常見錯誤診斷 [#常見錯誤診斷]

| 症狀     | 可能原因      | 解決方式          |
| ------ | --------- | ------------- |
| 插件無法載入 | YAML 格式錯誤 | 使用 YAML 驗證器檢查 |
| 設定沒有生效 | 沒有重新載入    | 執行 reload 或重啟 |
| 找不到設定檔 | 插件未載入過    | 先啟動一次伺服器      |
| 部分設定不見 | 插件更新後格式改變 | 備份後刪除，讓插件重新生成 |

## 使用 YAML 驗證器 [#使用-yaml-驗證器]

如果修改後插件無法載入，可以使用線上工具檢查格式：

1. 前往 [YAML Lint](https://www.yamllint.com/)
2. 將設定檔內容貼上
3. 點擊驗證
4. 查看錯誤訊息並修正

<img alt="YAML 驗證" src="__img5" />

## 還原預設設定 [#還原預設設定]

如果設定檔損壞無法修復：

1. **備份**現有的設定檔（重新命名為 `config.yml.bak`）
2. **刪除**原始的 `config.yml`
3. **重新啟動**伺服器
4. 插件會自動生成**新的預設設定檔**
5. 參考備份檔案，重新設定您需要的選項

<Callout type="info" title="養成備份習慣">
  修改設定前建議先備份原始檔案（例如複製一份命名為 `config.yml.backup`），出問題時可以快速還原。
</Callout>


# server.properties 設定 (/docs/practice/config/server-properties)









<Callout title="什麼是 server.properties？">
  `server.properties` 是 **Minecraft 伺服器最重要的設定檔**，控制伺服器的基本行為和遊戲規則。所有類型的 Minecraft 伺服器（Paper、Forge、Fabric 等）都會使用這個設定檔。
</Callout>

# 設定檔位置 [#設定檔位置]

`server.properties` 位於伺服器的**根目錄**（最外層資料夾）。

<Callout type="info" title="首次啟動">
  如果您找不到這個檔案，請先啟動一次伺服器，它會自動生成。
</Callout>

# 修改設定檔 [#修改設定檔]

<Steps>
  <Step>
    ### 步驟一：關閉伺服器 [#步驟一關閉伺服器]

    在修改 `server.properties` 之前，**建議先關閉伺服器**，以確保設定正確儲存。
  </Step>

  <Step>
    ### 步驟二：開啟設定檔 [#步驟二開啟設定檔]

    1. 前往面板的「**檔案管理**」頁面
    2. 在**根目錄**找到 `server.properties` 檔案
    3. 點擊檔案開啟編輯器

        <img alt="開啟設定檔" src="__img0" />
  </Step>

  <Step>
    ### 步驟三：修改設定 [#步驟三修改設定]

    根據需求修改相關設定（詳見下方設定說明）。

    **格式說明：**

    ```properties
    設定名稱=設定值
    ```

        <img alt="修改設定" src="__img1" />
  </Step>

  <Step>
    ### 步驟四：儲存並重啟 [#步驟四儲存並重啟]

    儲存設定檔後，**重新啟動伺服器**以套用變更。
  </Step>
</Steps>

# 常用設定詳解 [#常用設定詳解]

## 🌐 伺服器基礎設定 [#-伺服器基礎設定]

這些設定控制伺服器的基本資訊和連線方式。

| 設定名稱          | 預設值                | 說明         | 建議值                 |
| ------------- | ------------------ | ---------- | ------------------- |
| `motd`        | A Minecraft Server | 伺服器列表顯示的描述 | 自訂歡迎訊息              |
| `max-players` | 20                 | 最大玩家人數     | 根據記憶體調整             |
| `online-mode` | true               | 正版驗證       | true（正版）/ false（盜版） |
| `white-list`  | false              | 白名單模式      | 私人伺服器設 true         |
| `server-port` | 25565              | 伺服器端口      | 通常不需修改              |

### MOTD（伺服器描述）設定 [#motd伺服器描述設定]

MOTD 會顯示在 Minecraft 的伺服器列表中：

```properties
# 單行訊息
motd=歡迎來到我的伺服器！

# 雙行訊息（用 \n 換行）
motd=\u00A7b歡迎來到我的伺服器！\u00A7r\n\u00A7e正在運行 1.20.4
```

<Callout type="info" title="顏色代碼">
  `\u00A7` 是顏色代碼的 Unicode 表示：

  | 代碼        | 顏色     | 代碼        | 顏色 |
  | --------- | ------ | --------- | -- |
  | `\u00A70` | 黑色     | `\u00A78` | 深灰 |
  | `\u00A71` | 深藍     | `\u00A79` | 藍色 |
  | `\u00A72` | 深綠     | `\u00A7a` | 綠色 |
  | `\u00A73` | 深青     | `\u00A7b` | 青色 |
  | `\u00A74` | 深紅     | `\u00A7c` | 紅色 |
  | `\u00A75` | 紫色     | `\u00A7d` | 粉紅 |
  | `\u00A76` | 金色     | `\u00A7e` | 黃色 |
  | `\u00A77` | 灰色     | `\u00A7f` | 白色 |
  | `\u00A7l` | **粗體** | `\u00A7r` | 重置 |
</Callout>

### 正版/盜版設定 [#正版盜版設定]

```properties
# 正版伺服器（只允許已購買遊戲的玩家）
online-mode=true

# 盜版伺服器（允許未購買遊戲的玩家）
online-mode=false
```

<Callout type="warn" title="盜版伺服器注意">
  如果設定 `online-mode=false`，強烈建議安裝 **AuthMe** 登入插件，否則任何人都可以冒充其他玩家！
</Callout>

## 🎮 遊戲規則設定 [#-遊戲規則設定]

這些設定控制遊戲的玩法和規則。

| 設定名稱               | 預設值      | 說明      | 選項                                    |
| ------------------ | -------- | ------- | ------------------------------------- |
| `gamemode`         | survival | 預設遊戲模式  | survival/creative/adventure/spectator |
| `difficulty`       | easy     | 遊戲難度    | peaceful/easy/normal/hard             |
| `hardcore`         | false    | 極限模式    | true/false                            |
| `pvp`              | true     | 允許 PvP  | true/false                            |
| `allow-flight`     | false    | 允許飛行    | true/false                            |
| `spawn-protection` | 16       | 出生點保護範圍 | 0-999（格數）                             |

### 遊戲模式說明 [#遊戲模式說明]

| 模式          | 說明          | 適合伺服器類型    |
| ----------- | ----------- | ---------- |
| `survival`  | 生存模式，需要收集資源 | 生存服、RPG 服  |
| `creative`  | 創造模式，無限資源   | 建築服、測試服    |
| `adventure` | 冒險模式，不能破壞方塊 | RPG 服、小遊戲服 |
| `spectator` | 旁觀模式，可以穿牆   | 直播、觀戰      |

### 常見設定範例 [#常見設定範例]

```properties
# 生存伺服器
gamemode=survival
difficulty=normal
pvp=true
hardcore=false

# 創造建築伺服器
gamemode=creative
difficulty=peaceful
pvp=false

# 極限生存伺服器
gamemode=survival
difficulty=hard
hardcore=true
```

### 飛行設定說明 [#飛行設定說明]

```properties
# 預設：不允許飛行（飛行會被踢出）
allow-flight=false

# 如果安裝了飛行插件（如 EssentialsX 的 /fly），需要設定為 true
allow-flight=true
```

<Callout type="info">
  `allow-flight=false` 是為了防止作弊。如果您的伺服器允許玩家飛行（VIP 功能等），請設定為 `true`。
</Callout>

## 🌍 世界設定 [#-世界設定]

這些設定控制世界的生成和特性。

| 設定名稱                  | 預設值              | 說明      |
| --------------------- | ---------------- | ------- |
| `level-name`          | world            | 世界資料夾名稱 |
| `level-seed`          | （空白）             | 世界種子碼   |
| `level-type`          | minecraft:normal | 世界類型    |
| `generate-structures` | true             | 生成結構    |
| `spawn-monsters`      | true             | 生成怪物    |
| `spawn-animals`       | true             | 生成動物    |
| `spawn-npcs`          | true             | 生成村民    |
| `allow-nether`        | true             | 允許地獄    |

### 世界類型選項 [#世界類型選項]

```properties
# 一般世界（預設）
level-type=minecraft\:normal

# 超平坦世界（適合創造/紅石測試）
level-type=minecraft\:flat

# 放大化世界（山更高、洞更深）
level-type=minecraft\:amplified

# 大型生態域（生態域更大）
level-type=minecraft\:large_biomes
```

### 使用特定種子碼 [#使用特定種子碼]

```properties
# 使用特定種子碼生成世界
level-seed=123456789
```

<Callout type="warn" title="注意">
  `level-seed` 只在**生成新世界時**生效。如果世界已經生成，修改種子碼不會有任何效果。
</Callout>

## ⚡ 效能設定 [#-效能設定]

這些設定會影響伺服器的效能和流暢度。

| 設定名稱                  | 預設值   | 說明         | 建議值   |
| --------------------- | ----- | ---------- | ----- |
| `view-distance`       | 10    | 視野距離（區塊）   | 6-10  |
| `simulation-distance` | 10    | 實體模擬距離     | 6-10  |
| `max-tick-time`       | 60000 | 最大 Tick 時間 | 60000 |

### 視野距離建議 [#視野距離建議]

| 伺服器規模 | 玩家數     | 建議 view-distance | 建議 simulation-distance |
| ----- | ------- | ---------------- | ---------------------- |
| 小型    | 1-10 人  | 10               | 10                     |
| 中型    | 10-30 人 | 8                | 8                      |
| 大型    | 30+ 人   | 6                | 6                      |

<Callout type="warn">
  降低視野距離可以**顯著提升效能**，但玩家能看到的範圍會變小。請根據實際情況調整。
</Callout>

## 🔒 安全性設定 [#-安全性設定]

| 設定名稱                   | 預設值   | 說明      |
| ---------------------- | ----- | ------- |
| `enable-command-block` | false | 啟用指令方塊  |
| `op-permission-level`  | 4     | OP 權限等級 |
| `spawn-protection`     | 16    | 出生點保護範圍 |

### OP 權限等級說明 [#op-權限等級說明]

| 等級 | 權限                |
| -- | ----------------- |
| 1  | 繞過出生點保護           |
| 2  | 使用作弊指令、指令方塊       |
| 3  | 管理玩家（kick、ban、op） |
| 4  | 使用所有指令（stop、save） |

# 完整設定檔範例 [#完整設定檔範例]

## 一般生存伺服器 [#一般生存伺服器]

```properties
#Minecraft server properties
motd=\u00A7b我的生存伺服器\u00A7r\n\u00A7e歡迎加入！
max-players=30
online-mode=true
white-list=false

gamemode=survival
difficulty=normal
pvp=true
hardcore=false
allow-flight=false

level-name=world
generate-structures=true
spawn-monsters=true
spawn-animals=true

view-distance=10
simulation-distance=10
spawn-protection=16
```

## 創造建築伺服器 [#創造建築伺服器]

```properties
motd=\u00A7e創造建築伺服器\u00A7r\n\u00A7a自由發揮創意！
max-players=20
online-mode=true

gamemode=creative
difficulty=peaceful
pvp=false
allow-flight=true

level-type=minecraft\:flat
spawn-monsters=false
spawn-animals=false
spawn-protection=0
```

<Callout type="info">
  修改設定後需要**重新啟動伺服器**才會生效。
</Callout>


# WorldGuard 領地保護 (/docs/practice/config/worldguard)





<Callout title="什麼是 WorldGuard？">
  WorldGuard 是最強大的**區域保護插件**，可以保護特定區域不被破壞、設定各種規則（如禁止 PVP、禁止怪物生成等），是幾乎所有伺服器的必備插件！
</Callout>

# 為什麼需要 WorldGuard？ [#為什麼需要-worldguard]

| 功能            | 說明               |
| ------------- | ---------------- |
| 🏠 **保護建築**   | 防止其他玩家破壞您的建築     |
| 🌍 **保護出生點**  | 讓新手區域不被破壞        |
| ⚔️ **控制 PVP** | 設定特定區域禁止/允許 PVP  |
| 🎮 **自訂規則**   | 設定各種遊戲規則（飛行、怪物等） |

# 安裝準備 [#安裝準備]

WorldGuard 需要 **WorldEdit** 才能運作，請確保兩個插件都已安裝。

| 插件         | 下載位置                                     |
| ---------- | ---------------------------------------- |
| WorldEdit  | [官方下載](https://enginehub.org/worldedit)  |
| WorldGuard | [官方下載](https://enginehub.org/worldguard) |

# 基本操作教學 [#基本操作教學]

## 選取區域 [#選取區域]

<Steps>
  <Step>
    ### 取得選取工具 [#取得選取工具]

    輸入指令取得木斧（選取工具）：

    ```
    //wand
    ```

    !\[取得木斧]
  </Step>

  <Step>
    ### 選取第一個點 [#選取第一個點]

    手持木斧，**左鍵點擊**方塊設定第一個角落點。

    ```
    First position set to (100, 64, 200)
    ```
  </Step>

  <Step>
    ### 選取第二個點 [#選取第二個點]

    手持木斧，**右鍵點擊**方塊設定第二個角落點。

    ```
    Second position set to (150, 128, 250)
    ```

    <Callout type="info">
      兩個點會形成一個**長方體區域**，這個區域就是您要保護的範圍。
    </Callout>
  </Step>

  <Step>
    ### 確認選取範圍 [#確認選取範圍]

    輸入指令查看選取的區域大小：

    ```
    //size
    ```

    !\[選取範圍]
  </Step>
</Steps>

## 建立保護區域 [#建立保護區域]

<Steps>
  <Step>
    ### 建立區域 [#建立區域]

    選取好範圍後，使用以下指令建立保護區域：

    ```
    /rg define 區域名稱
    ```

    例如：

    ```
    /rg define spawn
    /rg define shop
    /rg define arena
    ```

    !\[建立區域]
  </Step>

  <Step>
    ### 設定區域擁有者 [#設定區域擁有者]

    ```
    /rg addowner 區域名稱 玩家名稱
    ```

    例如：

    ```
    /rg addowner myhouse Steve
    ```

    擁有者可以在區域內建築和破壞方塊。
  </Step>

  <Step>
    ### 設定區域成員 [#設定區域成員]

    ```
    /rg addmember 區域名稱 玩家名稱
    ```

    成員擁有比擁有者更少的權限，通常只能使用門、按鈕等。
  </Step>
</Steps>

# 區域旗標設定 [#區域旗標設定]

旗標（Flag）用來設定區域內的各種規則。

## 常用旗標一覽 [#常用旗標一覽]

| 旗標                  | 功能     | 允許值          |
| ------------------- | ------ | ------------ |
| `pvp`               | PVP 戰鬥 | allow / deny |
| `mob-spawning`      | 怪物生成   | allow / deny |
| `creeper-explosion` | 苦力怕爆炸  | allow / deny |
| `tnt`               | TNT 爆炸 | allow / deny |
| `fire-spread`       | 火焰蔓延   | allow / deny |
| `use`               | 使用門/按鈕 | allow / deny |
| `chest-access`      | 打開箱子   | allow / deny |
| `greeting`          | 進入區域訊息 | 訊息文字         |
| `farewell`          | 離開區域訊息 | 訊息文字         |
| `entry`             | 允許進入   | allow / deny |
| `exit`              | 允許離開   | allow / deny |

## 設定旗標指令 [#設定旗標指令]

```
/rg flag 區域名稱 旗標名稱 值
```

### 實用範例 [#實用範例]

**保護出生點（禁止破壞、PVP、爆炸）：**

```
/rg flag spawn pvp deny
/rg flag spawn mob-spawning deny
/rg flag flag spawn creeper-explosion deny
/rg flag spawn tnt deny
/rg flag spawn greeting &a歡迎來到出生點！
```

**設定 PVP 競技場：**

```
/rg flag arena pvp allow
/rg flag arena greeting &c⚔️ 進入 PVP 區域！小心！
/rg flag arena farewell &a你已離開 PVP 區域
```

**私人領地（只有成員能開箱子）：**

```
/rg flag myhouse chest-access deny
/rg flag myhouse use deny
```

!\[設定旗標]

# 區域優先順序 [#區域優先順序]

當多個區域重疊時，使用**優先順序**決定哪個區域的規則生效。

```
/rg setpriority 區域名稱 優先順序數字
```

數字越大，優先順序越高。

**範例：**

```
# 整個世界禁止 PVP
/rg flag __global__ pvp deny

# 競技場允許 PVP（優先順序較高）
/rg flag arena pvp allow
/rg setpriority arena 10
```

# 常用指令總覽 [#常用指令總覽]

| 指令                           | 功能         |
| ---------------------------- | ---------- |
| `/rg define <名稱>`            | 建立區域       |
| `/rg remove <名稱>`            | 刪除區域       |
| `/rg list`                   | 列出所有區域     |
| `/rg info <名稱>`              | 查看區域資訊     |
| `/rg addowner <區域> <玩家>`     | 添加擁有者      |
| `/rg removeowner <區域> <玩家>`  | 移除擁有者      |
| `/rg addmember <區域> <玩家>`    | 添加成員       |
| `/rg removemember <區域> <玩家>` | 移除成員       |
| `/rg flag <區域> <旗標> <值>`     | 設定旗標       |
| `/rg select <區域>`            | 重新選取已存在的區域 |
| `/rg redefine <區域>`          | 重新定義區域範圍   |

# 全域設定 [#全域設定]

`__global__` 是一個特殊區域，代表整個世界。設定全域規則可以作為預設值。

```
# 全世界禁止苦力怕爆炸
/rg flag __global__ creeper-explosion deny

# 全世界禁止火焰蔓延
/rg flag __global__ fire-spread deny
```

<Callout type="info" title="設定檔位置">
  WorldGuard 的設定檔位於 `plugins/WorldGuard/config.yml`，區域資料位於 `plugins/WorldGuard/worlds/世界名稱/regions.yml`。
</Callout>

# 常見問題 [#常見問題]

## 區域沒有生效？ [#區域沒有生效]

1. 確認區域已正確建立：`/rg list`
2. 確認選取範圍正確（Y 軸高度要足夠）
3. 檢查區域優先順序

## 如何讓所有人都能使用門？ [#如何讓所有人都能使用門]

```
/rg flag 區域名稱 use allow
```

## 如何保護整個世界？ [#如何保護整個世界]

使用 `__global__` 區域：

```
/rg flag __global__ build deny
```

然後為管理員設定繞過權限：`worldguard.region.bypass.*`


# 安裝模組 (/docs/practice/install/mod)











<Callout title="適用範圍">
  本教學適用於 Forge、NeoForge、Fabric 等模組伺服器。如果您使用 Paper/Spigot 伺服器，請參考 [安裝插件](/docs/practice/install/plugin)。
</Callout>

# 什麼是模組？ [#什麼是模組]

模組（Mod）可以從根本上修改 Minecraft 的遊戲內容，添加新的物品、方塊、生物、維度等。與插件不同，**玩家也需要安裝相同的模組**才能連線到伺服器。

## 模組能做什麼？ [#模組能做什麼]

| 功能類別       | 說明          | 常見模組                     |
| ---------- | ----------- | ------------------------ |
| **新物品/方塊** | 添加數百種新物品和方塊 | 工業、科技、魔法模組               |
| **新生物**    | 添加新的怪物和動物   | Alex's Mobs、Ice and Fire |
| **新維度**    | 添加全新的世界可探索  | 暮色森林、天堂                  |
| **遊戲機制**   | 改變或增強遊戲玩法   | 匠魂、植物魔法                  |
| **效能優化**   | 提升遊戲和伺服器效能  | Sodium、Lithium           |
| **輔助工具**   | 合成表查詢、小地圖等  | JEI、JourneyMap           |

<Callout type="warn" title="重要提醒">
  模組伺服器的玩家**必須安裝相同的模組**才能連線。這是模組伺服器與插件伺服器最大的差異。
</Callout>

# 模組載入器介紹 [#模組載入器介紹]

Minecraft 模組需要透過「模組載入器」來運行，主要有以下幾種：

| 載入器          | 說明             | 適合場景          |
| ------------ | -------------- | ------------- |
| **Forge**    | 歷史最悠久，模組最多     | 大型模組包、科技/魔法模組 |
| **NeoForge** | Forge 的分支，更現代化 | 新版本 Minecraft |
| **Fabric**   | 輕量、更新快         | 效能優化、輕量模組     |
| **Quilt**    | Fabric 的分支     | 較少使用          |

<Callout type="warn" title="不能混用！">
  ⚠️ **Forge 模組不能用在 Fabric 伺服器**，反之亦然！下載模組時請確認載入器類型。
</Callout>

# 在哪裡下載模組？ [#在哪裡下載模組]

以下是安全可靠的模組下載平台：

| 平台             | 網址                                                                                           | 特色         |
| -------------- | -------------------------------------------------------------------------------------------- | ---------- |
| **CurseForge** | [https://www.curseforge.com/minecraft/mc-mods](https://www.curseforge.com/minecraft/mc-mods) | 模組最齊全，模組包多 |
| **Modrinth**   | [https://modrinth.com/mods](https://modrinth.com/mods)                                       | 介面簡潔，下載速度快 |

<Callout type="warn" title="安全提醒">
  * ⚠️ **請勿從不明網站下載模組**，可能包含病毒
  * ⚠️ **避免下載來路不明的模組包**
  * ✅ 只從 CurseForge 和 Modrinth 下載
</Callout>

# 安裝模組教學 [#安裝模組教學]

<Steps>
  <Step>
    ### 步驟一：確認伺服器類型 [#步驟一確認伺服器類型]

    在安裝模組前，請先確認您的伺服器使用哪種模組載入器：

    1. 前往面板的「**啟動設定**」頁面
    2. 查看伺服器核心類型
    3. 記住載入器類型和版本

    | 核心名稱包含     | 模組載入器    |
    | ---------- | -------- |
    | `forge`    | Forge    |
    | `neoforge` | NeoForge |
    | `fabric`   | Fabric   |
  </Step>

  <Step>
    ### 步驟二：下載模組檔案 [#步驟二下載模組檔案]

    1. 前往 CurseForge 或 Modrinth
    2. 搜尋您想要的模組
    3. **選擇正確的版本**：
       * 選擇正確的模組載入器（Forge/Fabric）
       * 選擇正確的 Minecraft 版本
    4. 點擊下載 `.jar` 檔案

        <img alt="下載模組" src="__img0" />

    <Callout type="info" title="版本選擇範例">
      如果您的伺服器是 **Forge 1.20.1**：

      * ✅ 下載標示 `Forge` + `1.20.1` 的版本
      * ❌ 不要下載 `Fabric` 或 `1.19` 的版本
    </Callout>
  </Step>

  <Step>
    ### 步驟三：檢查依賴模組 [#步驟三檢查依賴模組]

    許多模組需要其他模組才能運作，這些稱為「依賴模組」：

    **Fabric 伺服器必裝：**

    * **Fabric API** - 幾乎所有 Fabric 模組都需要

    **常見依賴模組：**

    * Architectury API
    * Cloth Config
    * GeckoLib

        <img alt="依賴模組" src="__img1" />

    <Callout type="info">
      模組頁面通常會列出需要的依賴，請一併下載安裝。
    </Callout>
  </Step>

  <Step>
    ### 步驟四：上傳模組到伺服器 [#步驟四上傳模組到伺服器]

    1. 前往面板的「**檔案管理**」頁面
    2. 進入 `mods` 資料夾
    3. 點擊「**上傳**」按鈕
    4. 選擇所有下載的 `.jar` 檔案並上傳

        <img alt="上傳模組" src="__img2" />

    <Callout type="info">
      如需上傳大檔案，或遇到無法上傳的問題，請參考 [SFTP 上傳教學](/docs/panel/common/sftp)。
    </Callout>
  </Step>

  <Step>
    ### 步驟五：重新啟動伺服器 [#步驟五重新啟動伺服器]

    上傳完成後，重新啟動伺服器以載入模組。

    <Callout type="info">
      模組伺服器啟動較慢是正常的，請耐心等待。
    </Callout>
  </Step>

  <Step>
    ### 步驟六：客戶端安裝相同模組 [#步驟六客戶端安裝相同模組]

    玩家需要在自己的電腦上安裝相同的模組才能連線：

    **方法一：手動安裝**

    1. 安裝對應的模組載入器（Forge/Fabric）
    2. 將模組檔案放入 `.minecraft/mods` 資料夾
    3. 啟動遊戲

    **方法二：使用啟動器（推薦）**

    * 使用 **CurseForge App** 或 **Modrinth App**
    * 可以自動管理模組和依賴

    <Callout type="info">
      建議將伺服器的模組打包分享給玩家，確保版本一致。
    </Callout>
  </Step>
</Steps>

# 模組載入失敗怎麼辦？ [#模組載入失敗怎麼辦]

## 常見錯誤及解決方式 [#常見錯誤及解決方式]

| 錯誤訊息                      | 原因            | 解決方式          |
| ------------------------- | ------------- | ------------- |
| `Missing dependencies`    | 缺少依賴模組        | 下載並安裝缺少的依賴    |
| `Incompatible mod`        | 版本不相容         | 確認模組版本正確      |
| `Duplicate mod`           | 模組重複安裝        | 刪除重複的模組檔案     |
| `Mixin error`             | 模組衝突          | 移除最近安裝的模組     |
| `Mod requires Fabric API` | 缺少 Fabric API | 安裝 Fabric API |

<Callout type="info">
  如果無法自行解決，可以使用 [ChatGPT 分析錯誤](/docs/debug/gpt) 來找出問題原因。
</Callout>

# 常用模組推薦 [#常用模組推薦]

## 效能優化模組（強烈建議安裝） [#效能優化模組強烈建議安裝]

| 模組名稱            | 載入器          | 功能說明       |
| --------------- | ------------ | ---------- |
| **Lithium**     | Fabric       | 伺服器效能大幅優化  |
| **Starlight**   | Forge/Fabric | 光照計算優化     |
| **FerriteCore** | Forge/Fabric | 記憶體使用優化    |
| **Chunky**      | Forge/Fabric | 預生成區塊，減少卡頓 |

## 實用輔助模組 [#實用輔助模組]

| 模組名稱           | 載入器          | 功能說明      |
| -------------- | ------------ | --------- |
| **JEI**        | Forge        | 合成表查詢     |
| **REI**        | Fabric       | 合成表查詢     |
| **JourneyMap** | Forge/Fabric | 小地圖和大地圖   |
| **Jade**       | Forge/Fabric | 顯示方塊/實體資訊 |

## 熱門模組包推薦 [#熱門模組包推薦]

如果您想要完整的模組體驗，可以考慮使用現成的模組包：

| 模組包            | 類型  | 說明           |
| -------------- | --- | ------------ |
| All The Mods 9 | 綜合  | 包含各類模組的大型模組包 |
| Create         | 科技  | 機械自動化        |
| RLCraft        | 生存  | 高難度生存挑戰      |
| Pixelmon       | 寶可夢 | 在 MC 中抓寶可夢   |

<Callout type="info">
  模組設定通常位於 `config` 資料夾中，您可以參考 [插件設定教學](/docs/practice/config/plugin) 的 YAML 格式說明來修改。
</Callout>


# 安裝插件 (/docs/practice/install/plugin)













<Callout title="適用範圍">
  本教學適用於 Paper、Spigot、Purpur 等 Bukkit 系列伺服器。如果您使用 Forge/Fabric 伺服器，請參考 [安裝模組](/docs/practice/install/mod)。
</Callout>

# 什麼是插件？ [#什麼是插件]

插件（Plugin）是用來擴展 Minecraft 伺服器功能的程式。透過安裝插件，您可以為伺服器添加各種功能，而**玩家不需要安裝任何東西**就能使用這些功能。

## 插件能做什麼？ [#插件能做什麼]

| 功能類別     | 說明          | 常見插件                        |
| -------- | ----------- | --------------------------- |
| **基礎功能** | 傳送、設定家、經濟系統 | EssentialsX、CMI             |
| **權限管理** | 控制玩家能做什麼    | LuckPerms                   |
| **領地保護** | 保護玩家的建築不被破壞 | WorldGuard、Residence        |
| **登入系統** | 盜版伺服器的密碼保護  | AuthMe                      |
| **小遊戲**  | 床戰、空島戰爭等    | BedWars、SkyWars             |
| **聊天管理** | 聊天格式、過濾髒話   | ChatControl、Essentials Chat |
| **商店系統** | 玩家交易、商店     | ShopGUIPlus、QuickShop       |

<Callout type="info" title="新手提示">
  如果您是第一次架設伺服器，建議先安裝 **EssentialsX**（或 CMI）和 **LuckPerms**，這兩個插件能滿足大部分基礎需求。
</Callout>

# 在哪裡下載插件？ [#在哪裡下載插件]

以下是安全可靠的插件下載平台：

| 平台           | 網址                                                                         | 特色               |
| ------------ | -------------------------------------------------------------------------- | ---------------- |
| **SpigotMC** | [https://www.spigotmc.org/resources/](https://www.spigotmc.org/resources/) | 最大的插件平台，插件最齊全    |
| **Modrinth** | [https://modrinth.com/plugins](https://modrinth.com/plugins)               | 介面簡潔，下載速度快       |
| **Hangar**   | [https://hangar.papermc.io/](https://hangar.papermc.io/)                   | Paper 官方平台，品質有保證 |
| **Bukkit**   | [https://dev.bukkit.org/](https://dev.bukkit.org/)                         | 老牌平台，歷史悠久        |

<Callout type="warn" title="安全提醒">
  * ⚠️ **請勿從不明來源下載插件**，可能包含惡意程式
  * ⚠️ **避免使用破解/盜版插件**，可能有後門
  * ✅ 只從上述官方平台下載
</Callout>

# 安裝插件教學 [#安裝插件教學]

<Steps>
  <Step>
    ### 步驟一：下載插件檔案 [#步驟一下載插件檔案]

    1. 前往插件下載平台（以 SpigotMC 為例）
    2. 使用搜尋功能找到您想要的插件
    3. **確認插件支援您的伺服器版本**（非常重要！）
    4. 點擊「Download」下載 `.jar` 檔案

        <img alt="下載插件" src="__img0" />

    <Callout type="info" title="版本相容性">
      請確認插件版本與您的伺服器版本相容：

      * 1.20.4 的伺服器 → 下載支援 1.20.4 的插件
      * 有些插件標示 1.8-1.20 表示支援多個版本
    </Callout>
  </Step>

  <Step>
    ### 步驟二：上傳插件到伺服器 [#步驟二上傳插件到伺服器]

    1. 前往面板的「**檔案管理**」頁面
    2. 進入 `plugins` 資料夾（如果沒有，請先啟動一次伺服器）
    3. 點擊「**上傳**」按鈕
    4. 選擇剛才下載的 `.jar` 檔案並上傳

        <img alt="上傳插件" src="__img1" />

    <Callout type="info">
      如需上傳大檔案，或遇到無法上傳的問題，請參考 [SFTP 上傳教學](/docs/panel/common/sftp)。
    </Callout>
  </Step>

  <Step>
    ### 步驟三：重新啟動伺服器 [#步驟三重新啟動伺服器]

    上傳完成後，需要重新啟動伺服器才能載入插件：

    1. 回到「**控制台**」頁面
    2. 點擊「**重新啟動**」按鈕
    3. 等待伺服器完全啟動（看到 Done! 訊息）

        <img alt="重新啟動" src="__img2" />
  </Step>

  <Step>
    ### 步驟四：確認插件載入成功 [#步驟四確認插件載入成功]

    伺服器啟動後，在控制台輸入指令來確認：

    ```
    plugins
    ```

    或簡寫：

    ```
    pl
    ```

    查看結果：

    * 🟢 **綠色**的插件名稱 = 載入成功
    * 🔴 **紅色**的插件名稱 = 載入失敗

        <img alt="檢查插件" src="__img3" />
  </Step>
</Steps>

# 插件載入失敗怎麼辦？ [#插件載入失敗怎麼辦]

如果插件顯示為紅色或控制台出現錯誤，請按以下步驟排查：

## 常見問題排查 [#常見問題排查]

| 問題            | 症狀                        | 解決方式               |
| ------------- | ------------------------- | ------------------ |
| **版本不相容**     | 控制台顯示 unsupported version | 下載支援您伺服器版本的插件      |
| **缺少依賴插件**    | 顯示 missing dependency     | 安裝缺少的依賴插件（如 Vault） |
| **檔案損壞**      | 顯示 invalid plugin         | 重新下載插件檔案           |
| **Java 版本問題** | 顯示 class version error    | 更新 Java 版本（啟動設定）   |
| **插件衝突**      | 伺服器崩潰或異常                  | 逐一排查最近安裝的插件        |

## 如何查看錯誤訊息？ [#如何查看錯誤訊息]

1. 在控制台向上滾動，找到紅色的錯誤訊息
2. 複製錯誤訊息
3. 使用 [ChatGPT 分析錯誤](/docs/debug/gpt) 來找出問題原因

# 新手必裝插件 [#新手必裝插件]

以下是建議新手優先安裝的插件：

## 基礎必備 [#基礎必備]

| 插件名稱                      | 功能說明             | 優先級    |
| ------------------------- | ---------------- | ------ |
| **LuckPerms**             | 權限管理系統           | ⭐⭐⭐ 必裝 |
| **EssentialsX** 或 **CMI** | 基礎指令（傳送、home、經濟） | ⭐⭐⭐ 必裝 |
| **Vault**                 | 經濟 API（許多插件依賴）   | ⭐⭐⭐ 必裝 |

## 進階推薦 [#進階推薦]

| 插件名稱            | 功能說明        | 適用場景    |
| --------------- | ----------- | ------- |
| **WorldEdit**   | 地圖編輯工具      | 建築服、創造服 |
| **WorldGuard**  | 領地保護        | 生存服     |
| **AuthMe**      | 登入系統        | 盜版伺服器   |
| **CoreProtect** | 方塊日誌（查誰破壞的） | 生存服     |

## 插件下載連結 [#插件下載連結]

| 插件          | SpigotMC                                                   | Modrinth                                    |
| ----------- | ---------------------------------------------------------- | ------------------------------------------- |
| LuckPerms   | [下載](https://www.spigotmc.org/resources/luckperms.28140/)  | [下載](https://modrinth.com/plugin/luckperms) |
| EssentialsX | [下載](https://www.spigotmc.org/resources/essentialsx.9089/) | -                                           |
| Vault       | [下載](https://www.spigotmc.org/resources/vault.34315/)      | -                                           |

<Callout type="info">
  安裝完插件後，您可能需要進行設定。請參考 [插件設定教學](/docs/practice/config/plugin) 了解如何修改設定檔。
</Callout>


# 修改帳戶資訊 (/docs/store/account/edit-account)

















<Steps>
  <Step>
    登入客戶中心。
        <img alt="圖片" src="__img0" />
  </Step>

  <Step>
    點擊右上角，進入 「我的詳情」。
        <img alt="圖片" src="__img1" />
  </Step>

  <Step>
    在此更改您的「個人資料」和「帳單地址」。
        <img alt="圖片" src="__img2" />
  </Step>

  <Step>
    修改完成後勾選「確認填寫真實資料 」。
        <img alt="圖片" src="__img3" />
  </Step>

  <Step>
    選擇「儲存變更 」。
        <img alt="圖片" src="__img4" />
  </Step>
</Steps>


# 進行身分驗證 (/docs/store/account/kyc)

















## 為何要進行身分驗證？ [#為何要進行身分驗證]

因應主管機關 國家通訊傳播委員會（NCC）要求，使用超達網路科技有限公司部分產品時，必須提交雙證件以進行身分驗證。<br />
我們也鼓勵自行完成身份驗證，享有更完善的客戶服務。

## 要上傳哪些文件？ [#要上傳哪些文件]

* 臺灣個人戶 - 申請人身分證 + 健保卡（或駕照、護照等政府核發文件正反面）。
* 非臺灣客戶 - 護照內頁 + 第二證件（政府單位核發之有效證件，若無第二證件請提供帶有您姓名之實體帳單）。
* 公司戶 - 公司設立登記表（或變更登記表）+ 負責人身分證正反面。
* 法人機構 - 法人登記證明文件 + 負責人身分證影本正反面。

**證件須為政府核發之有效證件，若使用護照進行身分驗證，請確保護照有 6 個月以上之有效期。**

## 驗證步驟 [#驗證步驟]

<Steps>
  <Step>
    ### 登入客戶中心 [#登入客戶中心]

        <img alt="圖片" src="__img0" />
  </Step>

  <Step>
    ### 進入身分驗證頁面 [#進入身分驗證頁面]

        <img alt="圖片" src="__img1" />
  </Step>

  <Step>
    ### 閱讀注意事項並進入下一步驟 [#閱讀注意事項並進入下一步驟]

        <img alt="圖片" src="__img2" />
  </Step>

  <Step>
    ### 文件範例 [#文件範例]

    <Tabs items="['臺灣個人戶', '非臺灣客戶', '公司戶', '法人機構']">
      <Tab value="臺灣個人戶">
        #### 資料填寫 [#資料填寫]

        證件號碼請填入身分證字號。<br />
        文件拍攝與上傳位置起繼續往下滑。
                <img alt="圖片" src="__img3" />

        #### 文件拍攝與上傳位置 [#文件拍攝與上傳位置]

        1. 文件一：本人與**身分證正面、紙條**合照，請避免證件表面反光，需可辨識為本人。
           <img src="https://cdn.coffeehost.net/kyc/1.png" width="50%" />
        2. 文件一 - 2：**身分證正面、紙條**，請確保證件各項資訊皆清晰可見。
           <img src="https://cdn.coffeehost.net/kyc/idv-2.png" width="25%" />
        3. 文件二：**身分證背面、紙條**，請確保證各項資訊皆清晰可見。<br />
           註：若使用駕照、護照等政府核發文件有背面者，請將該第二證件背面一同放置於畫面中拍照。
           <img src="https://cdn.coffeehost.net/kyc/idv-3.png" width="25%" />
        4. 文件二 - 2：**健保卡（或駕照、護照等政府核發文件）正面**，請確保各項資訊皆清晰可見。
           <img src="https://cdn.coffeehost.net/kyc/idv-4.png" width="25%" />
      </Tab>

      <Tab value="非臺灣客戶" />

      <Tab value="公司戶" />

      <Tab value="法人機構" />
    </Tabs>
  </Step>

  <Step>
    ### 點擊「提交」後，耐心等待至多 2 個工作天 [#點擊提交後耐心等待至多-2-個工作天]
  </Step>
</Steps>


# 使用帳號餘額支付帳單 (/docs/store/account/pay-credit)

















<Steps>
  <Step>
    登入客戶中心。     <img alt="圖片" src="__img0" />
  </Step>

  <Step>
    選單 「帳務」，點擊 「我的帳單」。
        <img alt="圖片" src="__img1" />
  </Step>

  <Step>
    點擊要支付的帳單。     <img alt="圖片" src="__img2" />
  </Step>

  <Step>
    更換付款方式到 「超大咖帳戶餘額」。
        <img alt="圖片" src="__img3" />
  </Step>

  <Step>
    滑到下方，點擊 「使用餘額支付」。
        <img alt="圖片" src="__img4" />
  </Step>

  <Step>
    稍待片刻後，帳單就會支付成功了。
        <img alt="圖片" src="__img5" />
  </Step>
</Steps>


# 重設客戶中心密碼 (/docs/store/account/reset-password)



















如果您忘記了客戶中心或控制面板的登入密碼，或者出於安全考量需要更改密碼，請依照以下說明進行重設。

<Callout type="info">
  **安全建議：** 為了保障您的伺服器與個資安全，強烈建議您使用包含大小寫字母、數字及特殊符號的強密碼，並避免與其他網站使用相同的密碼組合。
</Callout>

## 密碼重設流程 [#密碼重設流程]

<Steps>
  <Step>
    **前往重設頁面**
    於登入頁面點擊「忘記?」，或點擊此 [密碼重設](https://store.coffeehost.net/password/reset) 連結
        <img alt="圖片" src="__img0" />
  </Step>

  <Step>
    **輸入電子信箱**
    輸入您的 Email 地址，隨後點擊「送出」按鈕。
        <img alt="圖片" src="__img1" />
  </Step>

  <Step>
    **檢查收件匣**
    接著，請前往您的電子信箱查看相關的 Email 信件。
        <img alt="圖片" src="__img2" />
  </Step>

  <Step>
    **點擊重設連結**
    點擊信件中的「重設您的密碼」，或點選下方提供的連結。
        <img alt="圖片" src="__img3" />
  </Step>

  <Step>
    **設定新密碼**
    輸入您欲使用的新密碼，或使用系統生成的新密碼，並再次確認密碼。
        <img alt="圖片" src="__img4" />
  </Step>

  <Step>
    **儲存變更**
    確認輸入無誤後，點擊「儲存變更」。
        <img alt="圖片" src="__img5" />
  </Step>

  <Step>
    **完成重設**
    密碼重設成功！您現在可以使用全新的密碼登入並管理您的伺服器了。
        <img alt="圖片" src="__img6" />
  </Step>
</Steps>


# 分享帳號使用權限 (/docs/store/account/share-account)



















若您希望團隊成員（例如財務管理人員、系統管理員）能協助您處理伺服器或支付帳單等相關事宜，您可以透過分享帳號權限的方式，邀請他們加入您的客戶中心。

<Callout type="warn">
  **安全性警告：** 分享帳號權限後，受邀者將能查看您的部分個人資料。請務必確認受邀者的身份，並謹慎選擇要賦予的權限，敬請特別留意。
</Callout>

## 邀請新用戶的完整步驟 [#邀請新用戶的完整步驟]

請依照以下流程，發送邀請並設定權限：

<Steps>
  <Step>
    **登入客戶中心**
    請使用您的主要帳號登入系統。
        <img alt="圖片" src="__img0" />
  </Step>

  <Step>
    **進入用戶管理**
    點擊頁面右上角，進入「用戶管理」頁面。
        <img alt="圖片" src="__img1" />
  </Step>

  <Step>
    **建立邀請**
    點擊畫面上的「邀請新用戶」按鈕。
        <img alt="圖片" src="__img2" />
  </Step>

  <Step>
    **填寫受邀者資訊**
    輸入新用戶的 Email 地址。
        <img alt="圖片" src="__img3" />
  </Step>

  <Step>
    **配置權限並發送**
    選擇欲分配給該用戶的權限（例如僅能查看帳單，或是能進入控制面板操作伺服器）。設定完成後點擊「發送邀請」。
        <img alt="圖片" src="__img4" />
  </Step>

  <Step>
    **受邀者接收信件**
    請受邀者前往其電子信箱查看邀請信件，並點擊「接受邀請」。
        <img alt="圖片" src="__img5" />
  </Step>

  <Step>
    **受邀者登入或註冊**

    * 若受邀者已於 CheapServer 註冊帳號，可立即登入。
    * 若受邀者尚未擁有帳號，則請先完成註冊程序。
      <img alt="圖片" src="__img6" />
  </Step>

  <Step>
    **切換與管理帳號**
    登入完成後，系統將自動接受邀請。未來登入時，系統會詢問欲使用的帳號，以便您進行切換與選擇。
  </Step>
</Steps>

<Callout type="info">
  **專家提示：** 定期審查您的「用戶管理」列表，移除已離職或不再需要存取權限的成員，是維持帳號與伺服器安全的重要好習慣。
</Callout>


# 查看帳號剩餘餘額 (/docs/store/account/view-credit)









<Callout title="成功加值後，不接受任何理由退款或變成等值現金。" />



<Steps>
  <Step>
    登入客戶中心。
        <img alt="圖片" src="__img0" />
  </Step>

  <Step>
    點擊右上角鈴鐺圖示，即可看到帳號剩餘餘額。
        <img alt="圖片" src="__img1" />
  </Step>
</Steps>


# 《Minecraft》 選購指南 (/docs/store/description/mc-guide)





在挑選適合您的 Minecraft 伺服器時，面對多樣的硬體配置與方案，您可能會感到無從下手。本篇選購指南將為您深入解析各項資源配置的關鍵，並提供針對不同遊戲玩法的推薦方案，幫助您打造最流暢的遊戲體驗。

<Callout type="info">
  **企業與大型專案支援**\
  若您正在籌備超大型伺服器群組，或有大量採購需求，建議直接聯繫我們的企業客服部門，以取得客製化的硬體資源配置建議與專屬優惠。
</Callout>

## 快速選購懶人包 [#快速選購懶人包]

如果您希望快速找到符合需求的方案，請參考以下我們針對常見玩法所整理的建議配置表。

<Callout type="warn">
  **網路延遲提醒**\
  若您與玩家的客群主要集中在台灣，強烈建議選擇「性能主機」及以上系列。這兩個系列提供台灣本地的抗 DDoS 網路，能將延遲降至最低。
</Callout>

<table>
  <thead>
    <tr>
      <th>
        伺服器類型
      </th>

      <th>
        人數
      </th>

      <th>
        建議記憶體大小
      </th>

      <th>
        建議系列
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td rowSpan="5">
        小型生存服 / 簡易插件服
      </td>

      <td>
        1~3
      </td>

      <td>
        4 GiB
      </td>

      <td rowSpan="5">
        [臺灣｜超值主機](https://store.coffeehost.net/store/tw-economical)
      </td>
    </tr>

    <tr>
      <td>
        4~6
      </td>

      <td>
        6 GiB
      </td>
    </tr>

    <tr>
      <td>
        7~10
      </td>

      <td>
        8 GiB
      </td>
    </tr>

    <tr>
      <td>
        11~16
      </td>

      <td>
        10 GiB
      </td>
    </tr>

    <tr>
      <td>
        17~24
      </td>

      <td>
        12 GiB
      </td>
    </tr>

    <tr>
      <td rowSpan="5">
        大型生存服 / 小型模組包
      </td>

      <td>
        1~3
      </td>

      <td>
        6 GiB
      </td>

      <td rowSpan="5">
        [臺灣｜性能主機](https://store.coffeehost.net/store/tw-performance)
      </td>
    </tr>

    <tr>
      <td>
        4~6
      </td>

      <td>
        8 GiB
      </td>
    </tr>

    <tr>
      <td>
        7~10
      </td>

      <td>
        10 GiB
      </td>
    </tr>

    <tr>
      <td>
        11~16
      </td>

      <td>
        12 GiB
      </td>
    </tr>

    <tr>
      <td>
        17~24
      </td>

      <td>
        14 GiB
      </td>
    </tr>

    <tr>
      <td rowSpan="5">
        大型模組包 / 大陸整合包
      </td>

      <td>
        1~3
      </td>

      <td>
        8 GiB
      </td>

      <td rowSpan="5">
        [臺灣｜高效主機](https://store.coffeehost.net/store/tw-supreme)
      </td>
    </tr>

    <tr>
      <td>
        4~6
      </td>

      <td>
        10 GiB
      </td>
    </tr>

    <tr>
      <td>
        7~10
      </td>

      <td>
        12 GiB
      </td>
    </tr>

    <tr>
      <td>
        11~16
      </td>

      <td>
        16 GiB
      </td>
    </tr>

    <tr>
      <td>
        17~24
      </td>

      <td>
        18 GiB
      </td>
    </tr>

    <tr>
      <td rowSpan="5">
        效能不足夠 / 需求較龐大
      </td>

      <td>
        25+
      </td>

      <td>
        20+ GiB
      </td>

      <td>
        [臺灣｜極致主機](https://store.coffeehost.net/store/tw-extreme)
      </td>
    </tr>
  </tbody>
</table>

***

## 深入解析：伺服器資源配置 [#深入解析伺服器資源配置]

伺服器的流暢度取決於硬體資源的分配，錯誤的配置不僅會導致「方塊延遲 (Block Lag)」或「橡皮筋效應 (Rubberbanding)」，甚至可能引發伺服器崩潰。以下我們為您拆解各項硬體指標：

### 1. 系列差異： [#1-系列差異]

您在客戶中心會看到五種主要的 Minecraft 主機系列：&#x2A;*TW-L (輕量)**、&#x2A;*TW-E (超值)**、&#x2A;*TW-P (性能)**、&#x2A;*TW-S (高效)** 與 &#x2A;*TW-X (極致)**。它們的核心差異在於 **CPU 的單核性能**。

Minecraft 的遊戲引擎（特別是實體運算與紅石邏輯）高度依賴單一核心的運算能力。

* **輕量主機 (TW-L)**：採用 Intel® Xeon™ Gold 6152 系列。適合對 CPU 要求不高的輕量伺服器，或作為 Proxy 代理伺服器。
* **超值主機 (TW-E)**：採用 Intel® Core™ i9-10980XE / AMD Ryzen™ 9 3950X 處理器。適合小型生存伺服器或簡易的插件伺服器，提供極具性價比的選擇。
* **性能主機 (TW-P)**：採用 Intel® Core™ i9-13900 / AMD Ryzen™ 9 5950X 處理器。單核頻率極高，能輕鬆應付大多數的大型生存與小型模組伺服器。
* **高效主機 (TW-S)**：採用 AMD Ryzen™ 9 7950X 處理器。具備頂尖的運算能力，是運行大型模組包或高負載整合包的最佳選擇。
* **極致主機 (TW-X)**：採用 AMD Ryzen™ 9 9950X 處理器。擁有現今最強大的單核性能，是極致紅石生電玩家與超大型伺服器的唯一首選。

<Callout type="info">
  **專家建議：效能與預算的平衡**\
  並非所有伺服器都需要最頂級的 CPU。例如架設 1.8 的 PvP 分流伺服器，購買高階主機反而是效能過剩；將預算投入在多台「超值主機」來分散玩家負載，會是更聰明的架構設計。
</Callout>

### 2. 記憶體 (RAM) 的迷思 [#2-記憶體-ram-的迷思]

記憶體負責暫存世界區塊與玩家數據。

* 10 人左右的原味生存，**8GB** 綽綽有餘。
* 頻繁跑圖、擁有大量紅石機器或自動分類機的伺服器，建議升級至 **16GB - 20GB**。
* **請注意**：除非您運行超過 100 款模組的超大型整合包，否則為單一 Minecraft 伺服器分配超過 **32GB** 的記憶體是**毫無意義**的。過大的記憶體反而會導致 Java 的垃圾回收 (GC) 時間過長，造成伺服器瞬間卡頓（Lag Spikes）。建議搭配優化過的 Aikar's Flags 來提升記憶體管理效率。

### 3. 儲存與備份空間 [#3-儲存與備份空間]

* **儲存空間**：建議至少保留世界檔案總大小 **1.5 至 2 倍** 的餘裕，以利於進行壓縮、打包或外掛運算。
* **備份空間**：控制面板提供本地備份功能。強烈建議您設定排程定時備份，並下載至您的個人電腦中妥善保存，以防世界損毀或遭到惡意破壞。

### 4. 網路與端口分配 [#4-網路與端口分配]

若您需要架設網頁地圖（如 Dynmap 或 BlueMap），需要加購額外的伺服器端口。針對需要無端口網域與 SSL 憑證的用戶，歡迎向客服申請 Reverse Proxy 反向代理服務。

***

## 如何測量伺服器效能？(TPS 與 MSPT) [#如何測量伺服器效能tps-與-mspt]

許多服主常反應「感覺伺服器很卡」，但效能需要以數據說話。請在遊戲內輸入 `/tps` 指令來查看伺服器健康度：

* **TPS (Ticks Per Second)**：Minecraft 正常運行的標準是每秒 20 Ticks。只要 TPS 維持在 20，代表伺服器運行順暢。低於 20 則會開始出現實體移動變慢、方塊破壞延遲等現象。
* **MSPT (Milliseconds Per Tick)**：這是衡量 CPU 效能更精確的指標。代表伺服器計算一個 Tick 花費了多少毫秒。只要 MSPT **低於 50ms**，伺服器就能維持在 20 TPS。MSPT 越低，代表 CPU 越遊刃有餘。

<Callout type="error">
  **效能排查小撇步**\
  若您的 TPS 經常低於 20，請勿盲目升級記憶體。您應該使用 `/spark profiler`（現代伺服器推薦）或 `/timings report` 來分析是哪個實體或漏斗造成了運算瓶頸。
</Callout>

***

## 網路配置與抗 DDoS 攻擊 [#網路配置與抗-ddos-攻擊]

伺服器的網路品質直接決定了玩家的連線體驗。

<Steps>
  <Step>
    ### 台灣本地基礎防禦 [#台灣本地基礎防禦]

    採用「台灣速連 (Fast Line)」系統。優點是提供台灣玩家極低的延遲，且能抵禦 L4 級別與少量 L7 級別的自動化攻擊，是多數社群伺服器的首選。
  </Step>

  <Step>
    ### 海外高防線路 [#海外高防線路]

    若您的伺服器不幸遭遇超大型 DDoS 攻擊，我們會自動將流量切換至海外的清洗中心。這能確保您的伺服器不會因此斷線，但相應地，連線延遲可能會暫時上升至 40ms 以上。
  </Step>
</Steps>

希望這份指南能協助您做出最明智的決定！若在選購時仍有任何疑慮，請隨時前往客服中心開啟客服單，我們將由專人為您評估。


# 《Minecraft》 產品說明 (/docs/store/description/minecraft)





歡迎深入了解我們的《Minecraft》伺服器產品特色與詳細說明。我們致力於提供高彈性、高穩定度的遊戲託管環境。

## 伺服器備份服務 [#伺服器備份服務]

保障資料安全是經營伺服器的首要任務。您可以加購伺服器本地備份功能。

<Callout type="info">
  **最佳實踐**：強烈建議您透過控制面板設定「排程自動備份」，例如在每天凌晨玩家最少時進行備份。這在進行重大版本更新、或是防範意外損壞（如玩家惡意破壞、地圖損壞）時，能提供最可靠的「回檔」保障。
</Callout>

* 您可以在控制面板隨時手動建立備份。
* 支援一鍵還原或直接下載備份檔案至您的個人電腦中。

## 額外端口 (Port) 加購 [#額外端口-port-加購]

每台伺服器在開通時，預設會配發一個專屬連線端口。然而，某些進階玩法或管理需求可能會需要額外的 UDP/TCP 端口。

* **適用情境**：如果您打算安裝如 Dynmap、BlueMap 等需要提供獨立網頁地圖檢視功能的插件，或者是設定 Voice Chat (語音聊天) 模組，您就需要額外的端口來支援這些服務。
* **購買方式**：請登入您的客戶中心，前往「附加服務」頁面進行選購。
* **端口管理**：您可隨時在控制面板的「端口管理」頁面中，靈活切換或指派主要連線端口，確保玩家與各項服務能順暢連入。

<Callout type="warn">
  **服務與流量規範說明**

  1. **極端攻擊處置**：若您的伺服器遭遇長時間且超大規模的毀滅性攻擊，為了保障機房內其他所有用戶的權益，我們可能必須暫時中斷該伺服器的外部連線，直至攻擊平息。
  2. **流量公平使用**：我們的遊戲伺服器皆提供「無流量上限」的優質服務。但請務必遵守公平使用原則（Fair Use Policy）；若系統偵測到有異常的大量流量轉發行為，我們保留採取必要限制措施的權利。
</Callout>


# 《幻獸帕魯》 產品說明 (/docs/store/description/palworld)





歡迎了解我們的《幻獸帕魯》(Palworld) 伺服器產品特色。我們提供專為多人遊戲打造的高效能、高穩定度託管環境。

## 伺服器備份服務 [#伺服器備份服務]

《幻獸帕魯》的存檔極為珍貴，加購伺服器本地備份功能是保障您與好友心血的最佳方式。

<Callout type="info">
  **專家建議**：強烈建議您利用控制面板設定「排程自動備份」。遊戲處於搶先體驗階段，偶爾會發生存檔異常或回溯的問題，擁有定期備份能讓您隨時輕鬆「回檔」，免除遺失資料的風險。
</Callout>

* 您可以在控制面板中手動執行備份。
* 您能隨時一鍵還原先前的狀態，或是將備份檔案下載回個人電腦中妥善保存。

## 額外端口 (Port) 加購 [#額外端口-port-加購]

每台伺服器預設皆會分配一個主要連線端口。若您有特殊的進階需求，可以申請額外的端口。

* **適用情境**：若未來遊戲或特定模組（如需要額外資料傳輸或網頁服務的 API 插件）需要額外的連線通道，即可派上用場。
* **購買方式**：請前往客戶中心的「附加服務」頁面進行選購 UDP 端口。
* **端口管理**：您可以在控制面板的「端口管理」介面，靈活調整與切換您的主要端口設定。

<Callout type="warn">
  **防護與流量注意事項**

  1. **極端攻擊處置**：若您的伺服器遭遇長時間、超大規模的惡意攻擊，為確保整體機房網路以及其他顧客的權益，我們將不得不暫時阻斷您的伺服器連線。
  2. **流量公平使用**：遊戲伺服器全面享有「無流量上限」之優惠。惟請您務必遵守公平使用原則；若系統判定存在惡意或大量轉發流量之違規情事，我們將會啟動必要的流量限制機制。
</Callout>


# 《VPS 雲端主機》 產品說明 (/docs/store/description/vps)





<Callout type="warn">
  **重要提醒**：為了確保服務的安全性與合規性，購買本產品後，必須先完成**身分驗證程序**，我們才會正式為您開通 VPS 雲端主機服務。
</Callout>

Coffee Host 所提供的雲端主機產品，是與《一零三三網路資訊有限公司》攜手合作。

雲端主機擁有百分之百的作業系統控制權（Root 權限）與極高的自由度。不論您是想要架設個人部落格、企業官方網站，或是建立專屬的應用程式後端，這台 VPS 都能完美勝任。

## 伺服器備份服務 [#伺服器備份服務]

為防範系統操作錯誤或不可預期的資料遺失，我們強烈建議您啟用伺服器本地備份功能。
您只需登入控制面板，即可輕鬆執行手動備份或設定自動備份排程，並在需要時一鍵還原您的雲端主機狀態。

## 雲端主機使用注意事項 [#雲端主機使用注意事項]

在享受高效能 VPS 服務的同時，請您務必詳閱並遵守以下規範，以維持良好的網路生態：

1. **DDoS 攻擊處置機制**：
   為了保護整體機房網路的順暢，若您的伺服器遭遇嚴重的 DDoS 攻擊，系統的安全防護機制將會自動介入，並**暫時封鎖該主機的外部連線長達 3 小時**。
2. **合作夥伴個資共用協議**：
   本 VPS 產品為我們與《[一零三三網路資訊有限公司](https://1033.tw/)》深度合作之服務。當您選購本產品並提交身分驗證文件時，我們將會把您的驗證資料同步提供予該企業進行雙重核對，敬請知悉。
3. **雙重服務條款約束**：
   使用本項雲端主機服務期間，除了必須絕對遵守 Coffee Host 的各項規範外，您也同時受到《[一零三三網路資訊有限公司](https://1033.tw/)》之[服務條款](/docs/legal/1033-tos)約束。請務必詳細閱讀以確保自身權益。

<Callout type="info">
  **Pro Tip（實用技巧）**：在部署對外開放的網頁服務時，建議您可以在 VPS 前端配置如 Cloudflare 的 CDN 與 WAF 服務，這不僅能隱藏主機的真實 IP，還能大幅降低遭受 DDoS 攻擊而導致主機被封鎖的風險。
</Callout>

## 開通流程：如何進行身分驗證？ [#開通流程如何進行身分驗證]

準備好啟用您的專屬雲端主機了嗎？請點擊下方連結開始驗證您的身分：
[立即進行身分驗證](/docs/store/account/kyc)


# 取消產品或服務 (/docs/store/services/cancel)

















如果您因為任何原因不再需要我們的服務，您可以透過客戶中心隨時提出取消申請。
請注意，當您提交取消申請時，即代表您已經詳細閱讀並完全同意我們的取消服務免責聲明。

<Callout type="error">
  **取消免責聲明與重大風險提示*&#x2A;
  若您在申請時選擇 &#x2A;*「立即取消」**，您的伺服器與相關服務將會在 **24 小時內**被系統強制終止並徹底銷毀。

  * 您的所有檔案、設定與資料將會**永久遺失且絕對無法恢復**。
  * 您已支付之所有當期款項，**恕不提供任何形式之退費**。
    請在執行此動作前，務必再三確認已妥善備份所有重要資料！
</Callout>

如果您當前的服務尚未到期，但確定下個月不打算繼續續約，我們建議您選擇&#x2A;*提前取消訂閱（等待帳單週期結束）**。這樣系統就不會在下個月產生新的帳單，也不會發送擾人的繳費通知給您。

## 申請取消服務的完整步驟 [#申請取消服務的完整步驟]

請依照以下流程來完成您的取消申請：

<Steps>
  <Step>
    **登入您的帳戶**
    請前往我們的網站並登入您的客戶中心。
        <img alt="圖片" src="__img0" />
  </Step>

  <Step>
    **選擇欲取消的產品*&#x2A;
    在首頁找到 &#x2A;*「您目前可用的產品與服務」** 區塊，點擊並選擇您確定要取消的伺服器或方案。
        <img alt="圖片" src="__img1" />
  </Step>

  <Step>
    **進入取消申請頁面*&#x2A;
    在左側的動作選單導覽列中，找到並點擊 &#x2A;*「要求撤銷」** 選項。
        <img alt="圖片" src="__img2" />
  </Step>

  <Step>
    **填寫您的取消原因**
    為了提供更好的服務品質，我們非常渴望了解您的想法！請在欄位中簡述您的取消原因或提供給我們的寶貴建議。
        <img alt="圖片" src="__img3" />
  </Step>

  <Step>
    **選擇取消類型並送出**
    請根據您的需求，選擇以下兩種取消類型之一，確認無誤後點擊送出按鈕：

    * **立即取消**：您的服務會在 24 小時內立刻被系統終止。這代表您同意提前解除合約，且了解任何剩餘天數都不會獲得退費。
    * **等待帳單週期結束**（推薦）：系統會讓您繼續使用到本期帳單的最後一天。期滿後服務將自動終止，且在此期間您不會收到任何催繳或停權通知。
      <img alt="圖片" src="__img4" />
  </Step>

  <Step>
    **確認申請結果**
    送出後，請確認頁面是否顯示已成功處理您的取消請求。
        <img alt="圖片" src="__img5" />
  </Step>
</Steps>

<Callout type="info">
  **反悔了怎麼辦？**
  如果您不小心點錯選項，或者在送出申請後改變了心意，請**立刻**（最好在 24 小時內）聯繫我們的線上客服團隊，我們將盡全力為您攔截並撤銷該申請。
</Callout>


# 提前續約服務 (/docs/store/services/renew)













為了避免服務因忘記繳費而中斷，影響到您伺服器上玩家的權益，您可以隨時選擇為您的服務進行「提前續約」。這不僅能確保伺服器穩定運作，也能讓您更彈性地規劃資金。

## 提前續約流程教學 [#提前續約流程教學]

請依照以下簡單的步驟完成您的續約作業：

<Steps>
  <Step>
    **登入客戶中心**
    請開啟瀏覽器並登入您的客戶中心首頁。
        <img alt="圖片" src="__img0" />
  </Step>

  <Step>
    **找到可續約服務*&#x2A;
    在首頁的面板中，找到 &#x2A;*「您目前可以續約的服務」*&#x2A; 區塊。確認後，點擊該區塊旁邊的 &#x2A;*「立即續約」** 按鈕。
        <img alt="圖片" src="__img1" />
  </Step>

  <Step>
    **加入購物車與結帳*&#x2A;
    勾選您欲進行續約的服務項目，將其加入購物車，接著點選頁面上的 &#x2A;*「結帳」** 按鈕以進入下一步。
        <img alt="圖片" src="__img2" />
  </Step>

  <Step>
    **確認訂單資訊**
    在結帳頁面，請仔細核對您的最終繳費金額，並選擇您習慣的付款方式。
        <img alt="圖片" src="__img3" />
  </Step>

  <Step>
    **完成付款程序**

    * **使用帳戶餘額**：如果您在客戶中心內仍有儲值餘額，您可以直接勾選使用餘額扣款，訂單將瞬間完成。
    * **使用其他支付方式**：若餘額不足或未使用餘額，系統會自動引導您前往第三方支付帳單頁面，請依畫面指示完成繳費即可。
  </Step>
</Steps>

<Callout type="info">
  **溫馨提示：提前續約不會損失天數**
  請您放心，提前續約的期間將會自動附加在您原本的到期日之後。例如，您的服務原定 12 月 31 日到期，若您在 12 月 1 日提前續約了一個月，您的新到期日將會自動展延至明年的 1 月 31 日。提早繳費能讓您高枕無憂！
</Callout>


# 升級產品選項 (/docs/store/services/upgrade-addon)















當您的伺服器社群日益壯大，原有的硬體配置（如記憶體、儲存空間或 CPU 資源）可能不再敷使用。這時，您可以透過「升級產品選項」功能，為單一伺服器增加額外的資源配置，而無需徹底更換整個服務方案。

## 升級配置操作指南 [#升級配置操作指南]

<Steps>
  <Step>
    **登入系統**
    請登入您的客戶中心。
        <img alt="圖片" src="__img0" />
  </Step>

  <Step>
    **選擇目標服務*&#x2A;
    在首頁的 &#x2A;*「您目前可用的產品與服務」** 列表中，點選您想要進行資源升級的伺服器方案。
        <img alt="圖片" src="__img1" />
  </Step>

  <Step>
    **進入選項調整頁面*&#x2A;
    在畫面左側的動作選單中，點選 &#x2A;*「升級/降級 選項」** 以進入配置管理介面。
        <img alt="圖片" src="__img2" />
  </Step>

  <Step>
    **調整您的硬體配置*&#x2A;
    在這個頁面中，您將會看到所有可供調整的加購選項（例如：端口數量或備份數量）。選擇您所需要的最新配置後，請點擊 &#x2A;*「點此繼續 >>」**。
        <img alt="圖片" src="__img3" />
  </Step>

  <Step>
    **確認金額與輸入折扣碼*&#x2A;
    系統會自動為您計算升級所需補足的差額。請仔細確認付款總金額與支付方式。若您手邊有優惠代碼，請在此頁面的專屬欄位中輸入並套用。確認無誤後，點擊 &#x2A;*「結帳」**。
        <img alt="圖片" src="__img4" />
  </Step>

  <Step>
    **完成付款**

    * **餘額扣款**：若您的帳戶內有充足的可用餘額，可直接抵扣，訂單將會立即成立。
    * **線上支付**：系統會引導您至加密的帳單頁面，請依照步驟完成刷卡或轉帳程序。
  </Step>

  <Step>
    **等待自動升級生效**
    付款成功後，您會收到一封 Email 確認信。
  </Step>
</Steps>

<Callout type="info">
  **自動化升級優勢**
  目前我們的遊戲伺服器已全面支援「自動化升級作業」。當您的繳費狀態轉為已付款時，控制面板將會在背景自動為您的伺服器配發全新的資源。
</Callout>


# 升級服務方案 (/docs/store/services/upgrade)















隨著伺服器玩家人數的成長，您可能會需要從基礎方案躍升至更高階的方案系列（例如：從注重性價比的 TW-P 系列，全面升級至擁有極致效能的 TW-X 系列）。此功能允許您無縫轉換至更高規格的服務架構。

<Callout type="warn">
  **跨系列升級的專屬服務**
  若您打算進行**跨系列**的方案轉換（例如跨越不同的 CPU 架構或不同的網路機房系列），系統介面可能無法直接處理。在這種情況下，請**直接透過工單聯絡我們的客服團隊**，我們將有專人手動為您處理資料轉移與方案升級事宜，確保您的伺服器無縫接軌。
</Callout>

## 同系列方案升級/降級流程 [#同系列方案升級降級流程]

若您是在相同系列內進行規格升降級，請遵循以下步驟：

<Steps>
  <Step>
    **登入並選擇服務**
        <img alt="圖片" src="__img0" /&#x3E;
    請先登入您的客戶中心，並於首頁的 &#x2A;*「您目前可用的產品與服務」** 區塊中，點選您想要升級或降級的伺服器。
        <img alt="圖片" src="__img1" />
  </Step>

  <Step>
    **進入升降級選單*&#x2A;
    在左側邊欄的動作選單中，點選並進入 &#x2A;*「升級/降級」** 選項。
        <img alt="圖片" src="__img2" />
  </Step>

  <Step>
    **選擇全新方案**
    在方案列表中，挑選您心儀的新方案規格。系統將會在您選擇後跳轉至下一個頁面，並為您精確計算因升降級所產生的費用差額。
        <img alt="圖片" src="__img3" />
  </Step>

  <Step>
    **確認訂單與折扣*&#x2A;
    請仔細核對系統計算出來的差額與您的預設付款方式。若您持有專屬優惠代碼，請務必於此步驟的欄位中填入以享有折扣。確認無誤後，請點擊 &#x2A;*「結帳」**。
        <img alt="圖片" src="__img4" />
  </Step>

  <Step>
    **執行付款**

    * 您可以優先使用帳戶內的可用餘額直接結帳，系統將會瞬間處理您的訂單。
    * 若無餘額，系統會引導您至電子帳單頁面，協助您順利完成後續的付款流程。
  </Step>

  <Step>
    **接收確認與生效**
    付款順利完成後，您將會收到一封系統發出的 Email 升級確認通知。
  </Step>
</Steps>

<Callout type="info">
  **零停機時間的極致體驗**
  目前針對遊戲伺服器的同系列升降級，我們已經實作了全自動化系統。這代表當您完成繳費的當下，系統就會立刻為您更新資源配額，過程中通常不需要漫長的等待，讓您的社群營運完全不受中斷！我們建議您在升級完成後進行一次伺服器重啟，以確保所有新配置皆正確載入。
</Callout>