Paper 全域設定

了解並修改 paper-global.yml，啟用 Minecraft 原版特性如 TNT 複製、鐵軌複製等生電機制

什麼是 Paper 設定檔？

Paper 伺服器有自己的設定檔，可以控制許多 Minecraft 原版特性的開關。Paper 為了優化效能，預設關閉了一些原版特性，但您可以手動開啟它們。

適用範圍

此教學適用於 Paper、Purpur、Pufferfish 等基於 Paper 的伺服器核心。如果您使用 Spigot，請參考 spigot.yml。

設定檔位置

Paper 伺服器有兩個主要設定檔，位於 config 資料夾中：

設定檔	用途
`config/paper-global.yml`	全域設定 - 適用於整個伺服器
`config/paper-world-defaults.yml`	世界設定 - 適用於所有世界的預設值

如果找不到 config 資料夾，請先啟動一次伺服器，它會自動生成。

修改設定檔

步驟一：關閉伺服器

建議先關閉伺服器，以確保設定正確儲存。

步驟二：開啟設定檔

前往面板的「檔案管理」頁面
進入 config 資料夾
點擊要編輯的設定檔

開啟設定檔

步驟三：修改設定

找到對應的設定項目，修改其值。

修改設定

步驟四：儲存並重啟

儲存設定檔後，重新啟動伺服器。

部分設定可用 /paper reload 重新載入，但建議重啟伺服器確保生效。

🔧 生電特性設定

Paper 為了優化效能，預設關閉了一些原版特性。如果您是生電玩家或想要還原原版行為，可以開啟這些設定。

什麼是生電？

生電（生存電路）是指在 Minecraft 生存模式下，使用紅石電路製作自動化農場、複製機等機器的玩法。許多生電機制依賴 Minecraft 的特殊行為（bug），Paper 預設會修復這些行為。

🧨 TNT 複製（活塞複製 TNT）

用途： 無限複製 TNT，用於 TNT 複製機、炸石機等

原理： 利用活塞推動 TNT 時的特性，讓一個 TNT 變成兩個

設定位置： config/paper-world-defaults.yml

entities:
  spawning:
    duplicate-uuid:
      mode: SAFE_REGEN    # ← 預設值

啟用方式： 將 mode 改為 NOTHING

entities:
  spawning:
    duplicate-uuid:
      mode: NOTHING       # ← 允許 TNT 複製

mode 值	效果
`SAFE_REGEN`	預設，會阻止 TNT 複製
`NOTHING`	允許 TNT 複製
`DELETE`	刪除重複的實體
`WARN`	只顯示警告

🛤️ 鐵軌複製 / 地毯複製

用途： 無限複製鐵軌、地毯等物品

原理： 利用活塞推動物品時的特性複製物品

設定位置： config/paper-world-defaults.yml

blocks:
  pistons:
    block-destroy-duplication: true   # ← 預設值（阻止複製）

啟用方式： 將值改為 false

blocks:
  pistons:
    block-destroy-duplication: false  # ← 允許鐵軌/地毯複製

⏬ 沙子複製（重力方塊複製）

用途： 無限複製沙子、礫石、混凝土粉末等重力方塊

原理： 利用重力方塊下落時的特性

設定位置： config/paper-world-defaults.yml

blocks:
  falling-block:
    gravity-duplication-bug: false   # ← 預設值（阻止複製）

啟用方式： 將值改為 true

blocks:
  falling-block:
    gravity-duplication-bug: true    # ← 允許沙子複製

🪨 床岩破壞

用途： 允許玩家使用活塞機器破壞床岩

設定位置： config/paper-world-defaults.yml

blocks:
  pistons:
    allow-headless-pistons: false     # ← 預設值
    allow-piston-duplication: false   # ← 預設值

啟用方式： 將兩個值都改為 true

blocks:
  pistons:
    allow-headless-pistons: true      # ← 允許無頭活塞
    allow-piston-duplication: true    # ← 允許活塞複製

📋 完整生電設定範例

如果您想一次啟用所有生電特性，請按照以下設定：

config/paper-world-defaults.yml

entities:
  spawning:
    duplicate-uuid:
      mode: NOTHING                    # 允許 TNT 複製
 
blocks:
  pistons:
    block-destroy-duplication: false   # 允許鐵軌/地毯複製
    allow-headless-pistons: true       # 允許無頭活塞
    allow-piston-duplication: true     # 允許活塞複製
  falling-block:
    gravity-duplication-bug: true      # 允許沙子複製

效能警告

⚠️ 啟用這些特性可能會影響伺服器效能，特別是：

大量使用 TNT 複製機
大型自動化農場
多人同時使用複製機

請根據伺服器的實際情況決定是否啟用。

⚡ 效能優化設定

Paper 提供許多效能優化選項，以下是常用的設定：

區塊系統設定

設定位置： config/paper-global.yml

chunk-system:
  gen-parallelism: default    # 區塊生成並行度
  io-threads: -1              # IO 執行緒數（-1 = 自動）
  worker-threads: -1          # 工作執行緒數（-1 = 自動）

預設的 -1 表示自動偵測，通常不需要修改。

反作弊設定

設定位置： config/paper-world-defaults.yml

anticheat:
  anti-xray:
    enabled: false            # 反透視（效能消耗較大）

設定	效果
`enabled: true`	啟用反透視，礦物會被假方塊遮蓋
`enabled: false`	關閉反透視，效能較好

📝 訊息自訂

您可以自訂 Paper 的系統訊息：

設定位置： config/paper-global.yml

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 的設定檔結構可能會隨版本更新而變化，建議查閱官方文件以獲取最新資訊。

Paper 全域設定

目錄