CannonRTP（WorldCannon）
CannonRTP 是一個適用於 Minecraft 伺服器的多重大砲隨機傳送插件。「WorldCannon」是較舊的／wiki 區段名稱；插件在 Bukkit 中註冊為 CannonRTP，發佈檔案為 CannonRTP.jar，這也是玩家與管理員實際看到的名稱。
關鍵命名細節：
- 插件名稱：
CannonRTP - 根指令：
/cannonrtp - 別名：
/crtp、/wc - 權限：
cannonrtp.admin、cannonrtp.use - 設定資料夾：
plugins/CannonRTP/
功能說明
CannonRTP 是一套多重大砲隨機降落系統，而非單一固定的發射器。每一個設定好的大砲可以在世界中放置一處或多處，而每個放置點都會偵測走入其觸發半徑內的玩家。
每一座大砲可以：
- 透過
/wc create與/wc place多次放置 —— 一份大砲設定可驅動所有放置點 - 偵測進入該大砲觸發半徑內的玩家（預設 1.75 格）
- 在指定的目標世界中預先載入並維持一條安全降落點佇列（支援跨世界目標）
- 拒絕不安全的地形、被阻擋的空間、受保護的領地，以及超出世界邊界的位置
- 可選擇性地要求額外的個別大砲權限
- 透過五個階段的電影式序列發射玩家
- 顯示 FreeMinecraftModels 3D 動態大砲模型（個別大砲的
customModel，或透過全域優先順序清單）；若未安裝 FMM，則回退至顏色變化的軌道粒子 - 在大砲上方顯示一個面向玩家的浮動狀態標籤（Ready / Charging / Maintaining / Exhausted / Disabled）
發射流程
使用前，請生成或探索目標世界設定的搜尋區域。CannonRTP只載入現有區塊，不生成地形；未探索的搜尋半徑可能無法提供任何目的地。
發射序列由五階段的狀態機驅動（SEARCHING -> FIRING -> TELEPORTING -> DROPPING -> LANDING）。當玩家走入符合條件的大砲觸發半徑時：
- CannonRTP 檢查
cannonrtp.use。 - 檢查該大砲可選的
requiredPermission。 - 檢查每位玩家的發射冷卻（
runtime.launchCooldownSeconds，預設 30 秒）。此限制適用於所有大砲，且不會消耗佇列中的目的地。 - 確認該大砲的佇列中至少有一個預先載入的降落點。（已停用的大砲、位於未載入世界中的大砲，以及位於未載入區塊中的大砲永遠不會走到這一步——它們被完全排除在 tick 迴圈之外，因此根本無法被觸發。）
- 從該大砲佇列中消耗一個預先載入的安全降落點。
- 觸發
CannonRTPLaunchEvent（可取消）。若有監聽器取消此事件，目的地會被歸還至佇列，且不會開始計算冷卻。 - Searching 階段（預設 42 ticks，可透過
launchWarmupTicks設定）：玩家獲得漂浮效果，若啟用了自訂模型，則大砲會播放其fire動畫，標題／副標題上會閃過隨機座標預覽。在模型啟用期間，玩家會獲得隱形效果，使動畫呈現更清晰。 - Firing 階段（預設 45 ticks，透過
verticalBoostTicks設定）：漂浮／隱形效果被移除，播放升空音效，生成火焰＋煙霧＋爆炸效果，並在每個 tick 套用verticalBoostVelocity。真正的目的地座標被揭示。 - Teleporting 階段（單一 tick）：佇列中的目的地會被重新驗證（地形柱、保護插件整合、API 監聽器）。若仍通過驗證，玩家會被傳送至該處正上方恰好 50 格處，並套用緩降效果。空投高度永遠不會被夾限——降落驗證器已經保證抵達方塊位於世界最大高度之下，而不再通過驗證的目的地會取消該次發射並改為救回玩家。
- Dropping 階段：玩家伴隨著煙霧軌跡緩慢下降（
LARGE_SMOKE+CAMPFIRE_SIGNAL_SMOKE）。 - Landing 階段：玩家一觸地即進入此階段。緩降效果被移除，播放衝擊效果（雲霧衝擊波、火焰環、塵土轉場），並觸發
CannonRTPLandingEvent。若下降過程反而超出其最大時長（slowFallingSecondsx 20 ticks），CannonRTP 會救回玩家，且不會發出降落事件。
降落安全規則
在某個位置被接受加入預載佇列之前，目前的程式碼會依序檢查：
- 目標世界已載入（在未載入期間，大砲會停止預載並回報
Target world <name> is not loaded.） - 搜尋中心可解析——優先為設定的
searchCenter，其次是大砲本身位於目標世界中時的所在位置，再其次是目標世界的出生點 - 候選位置位於世界邊界內
- 候選區塊已載入（按需載入，不會產生新地形）
- 候選位置所在欄位中存在最高的非空氣方塊
- 降落點正下方的表層方塊為固體且非液體
- 該表層方塊不在設定的不安全地面材質清單中，也不是地獄的基岩天花板
- 降落點位於世界最低高度或以上，且其上方 51 格處的抵達方塊仍低於世界最大高度
- 整條 52 格的空投柱（自降落點向上至抵達處的頭部方塊）的每一個方塊都是空氣或可通過
- 該柱中沒有任何方塊屬於設定的不安全身體材質清單
- 所有啟用的保護插件整合允許該位置
- 任何
CannonRTPLocationValidationEvent監聽器未否決該候選位置
在地獄中，CannonRTP 會拒絕基岩天花板，並向下掃描尋找完整空投柱皆安全的外露洞窟地面。這讓地獄目標成為可能，而不會把玩家丟在天花板之上或穿過實心地形。
搜尋嘗試在全域上每 tick 限速一次（每秒 20 次），透過輪流方式公平地在所有啟用中的大砲之間分配。每座大砲擁有自己的逾時計數器（searchTimeoutAttempts，預設 100，最低 10）。
大砲狀態
每座大砲都有透過 /wc status 或 /wc list 可見的內部狀態：
| 顯示 | 內部狀態 | 含義 |
|---|---|---|
| Disabled | -- | 大砲在其設定中被明確停用 |
| Charging | SEARCHING（佇列為空） | 仍在預載第一批安全位置 |
| Maintaining | SEARCHING（佇列非空） | 已有部分位置，但仍在補充已消耗的名額 |
| Ready | READY | 擁有足夠的預載位置（>= chargedLocationsPerCannon）以發射玩家 |
| Exhausted | EXHAUSTED | 已用盡 searchTimeoutAttempts 仍未填滿儲備 |
內部搜尋狀態恰好只有三個值（READY、SEARCHING、EXHAUSTED）；Disabled 是在查詢搜尋狀態之前就決定的，而 Charging / Maintaining 則是 SEARCHING 的兩種呈現方式。Ready 優先於 Exhausted——仍持有充能儲備的大砲即使最近一次搜尋視窗逾時，仍會顯示為 Ready。
並不存在獨立的「設定無效」狀態。當大砲的 targetWorld 無法解析時，該大砲會保留目前的搜尋狀態標籤，而 /wc status 的 $reason 欄位會變成 Target world <name> is not loaded.（messages.yml 中存在 statusLabels.invalid 訊息鍵，但目前的版本沒有任何地方會渲染它。）
只要大砲佇列中有至少一個目的地，即可發射玩家。chargedLocationsPerCannon 門檻只會影響視覺上的 READY 標籤。
執行環境需求
- Minecraft：
plugin.yml宣告api-version: 1.21.4；目前的原始碼樹是針對 Spigot26.2-R0.1-SNAPSHOTAPI 建置的 - Java：
21 - 建議的伺服器軟體：Paper 或現行相容的分支
- MagmaCore：
2.2.0或更新版本（共用程式庫，已遮蔽進插件內） - 可選依賴：FreeMinecraftModels（用於 3D 動態大砲模型）
韌性
CannonRTP 會在世界與區塊生命週期事件中保持其視覺與佇列一致：
- 當大砲所在的區塊卸載時，其標籤與模型會被移除；在區塊重新載入時會重新生成
- 當大砲所在的世界卸載時，大砲會被暫停；若世界再次載入則會喚醒
- 當 FreeMinecraftModels 於執行期間被啟用或停用時，模型快取會被清除，視覺會於下一個 tick 重新整理
- 在空投傳送之前，佇列中的目的地會再次針對地形、保護插件整合與 API 監聽器進行檢查；若它已變得不安全，該次發射會救回玩家，而不會採用過時的座標
- 發射後的清理只會移除 CannonRTP 仍然擁有的漂浮、隱形與緩降效果，並會還原它暫時取代掉的較舊效果，而不會刪除其他插件較新的狀態
- 若某次發射因目的地世界被卸載而無法繼續，CannonRTP 會將玩家救回大砲座位或其他已載入世界的出生點；若沒有安全的救援世界可用，則會保留緩降效果