ВЕРСИИ (11)

### AFly v1.6.0 正式穩定版發布 #### 🌟 核心更新重點 - **Minecraft 26.1 - 26.3 全系列向下相容**：宣告 api-version: 26.1，消除 Unsupported API version 報錯，支援 Paper 26.1、26.2、26.3 及其分支（如 Purpur），運行於 Java 25 執行期。 - **Residence 6.x 系列 API 適配**：多策略動態反射技術，支援 Residence 6.0.3.3+ 及舊版領地插件。 - **垂直投影方柱判斷選項**：在 config.yml 提供 vertical-column-check 開關（預設關閉），可自訂領地上空飛行是否算作領地內。 - **雙軌 GitHub 自動更新系統**：支援正式版與測試版雙軌切換（/afly update、/afly version），支援安全熱替換與管理員進服提醒。 - **現代化 Paper API 架構**：全面改用 Paper GlobalRegionScheduler 多分區排程，徹底移除已廢棄之舊式 BukkitRunnable。 - **伺服器端方塊碰撞檢測**：全面改用伺服器端邊界盒碰撞判定（isPlayerOnGround），取代已廢棄且易作弊的客戶端狀態。 - **MiniMessage 富文本與相容**：支援現代 Adventure MiniMessage 標籤與傳統 & 色碼雙向相容。 - **設定檔自動升級**：版本更新時自動補齊缺少的新設定鍵，完整保留服主既有設定。

## AFly v1.6.0-beta3 ### 🛠️ 相容性修復與調整 - **MC 26.x 全系列向下相容修正**： - 將 plugin.yml 的 api-version 由 26.3 調回 26.1，徹底解決 26.1 / 26.2 伺服器因核心版本判定過低而拋出 Unsupported API version / [PlugMan] That file is not a valid plugin. 的載入失敗問題。 - 支援 Paper 26.1、26.2、26.3 全版本平滑相容與載入。 - **維持 Java 25 現代化執行期優化**： - 完整支援 Java 25 執行期環境，保留伺服器端實體碰撞判定與 Paper 現代多分區排程（GlobalRegionScheduler）。

## AFly v1.6.0-beta2 ### 🌟 新增功能 - **雙軌 GitHub Releases 自動更新機制**（正式穩定版 🌟 / 搶先測試版 🧪） - 新增 UpdateService 與 UpdateListener。 - 具備 3 分鐘快取與防重入鎖，避免 API 速率限制。 - 支援 SemVer 語意化版本比對與 Release Notes 彩色排版。 - 支援串流下載與安全熱替換（Windows JVM 鎖定防護）。 - **指令系統擴充**： - /afly update [check|download [release|beta]]（管理員） - /afly version / /afly ver（查看線上更新日誌） - 支援 Tab 自動補全。 - **管理員進服更新推播**（延遲 40 ticks 提醒）。 - **雙語設定檔與語言檔同步擴充**。 ### ✨ v1.6.0-beta1 更新重點 - **適配 Minecraft / Paper 26.3 (Java 25)**： - Paper API 依賴升至 `26.3.build.140-beta`，外掛 `api-version` 更新為 '26.3'。 - **摒棄舊版 Bukkit 排程器**： - `ChargeTask` 改為實作 `Runnable`，全面導入 Paper 現代多執行緒 `GlobalRegionScheduler` / `ScheduledTask` 排程架構。 - **消除 `Player#isOnGround()` 廢棄警告**： - 改用伺服器端邊界盒（BoundingBox）與不可穿透方塊檢測（`isPlayerOnGround`），杜絕客戶端偽造回報。 - **富文本 Adventure MiniMessage 支援**： - 原生支援 Hex RGB、漸層色與懸停/點擊事件，並同時向後相容傳統 `&` 色碼。 - **現代化日誌與檔案 I/O**： - 日誌輸出全面升級為原生 `ComponentLogger`。 - 採用 Java 25 NIO `Files.readString` / `Files.writeString` 與 `Path` 處理設定與資料持久化。

[管理員指令] 新增查詢玩家飛行狀態與管理員通知切換功能，並更新版本至 1.5.1

### v1.5.0 - **MC 26.1.2 / 26.2 support**: upgraded Paper API to `26.1.2.build.72-stable`, `api-version` bumped to `26.1`. - Now picks up Residence's `getOwnerUUID()` when available (correct after player name changes); falls back to name comparison for older Residence builds. - Owner notifications resolve the recipient by UUID via `Server#getPlayer(UUID)`. - Player session state is now fully cleaned up on quit. ### v1.5.0 - **支援 MC 26.1.2 / 26.2**：paper-api 升至 `26.1.2.build.72-stable`，`api-version` 改為 `26.1`。 - 偵測到 Residence 新版時改用 `getOwnerUUID()` 比對擁有者（玩家改名後仍正確），舊版自動退回名稱比對。 - 通知地主改用 `Server#getPlayer(UUID)`，不再依賴可能失效的玩家名稱。 - 玩家離線時完整清理本插件記憶體中的飛行暫存狀態。

### v1.4.1 **English** - Smarter fall damage: system-caused drops (no-fly zone, out of money, region boundary) no longer hurt the player, but a player who has flight on and *chooses* to fall without flying still takes normal fall damage. **繁體中文** - 更聰明的摔落傷害：系統造成的墜落（禁飛區、沒錢、領地邊界）不再扣血；但若玩家開著飛行卻「自願往下跳、沒起飛」，仍照常受到摔落傷害。

### v1.4.0 **English** - Seamless cross-boundary flight (`keep-flying-across-regions`, default on): crossing residence ↔ wilderness no longer drops you — you keep flying and just see the new rate. When off, you drop at boundaries with a hint to `/afly on` again. - Blocked in a no-fly zone? Flight auto-resumes when you return to an allowed area. **繁體中文** - 無縫跨界飛行（`keep-flying-across-regions`，預設開）：跨越領地 ↔ 荒野邊界不再被放下，會繼續飛行、只跳出新費率提示。關閉時則會在邊界掉下並提示用 `/afly on` 重飛。 - 被禁飛區擋下後，回到可飛區會自動恢復飛行。

### v1.3.2 **English** - Configurable flight locations (`flight-allowed` in `config.yml`): restrict paid flight by world list, and toggle it inside / outside residences. Flying into a disallowed spot drops the player safely with a notice. - Listed two authors. **繁體中文** - 可設定的飛行地點（`config.yml` 的 `flight-allowed`）：可用世界清單限制付費飛行，並分別開關「領地內 / 領地外」。飛到不允許的地方會把玩家安全放下並提示。 - 列出兩位作者。

更新版本至 v1.3.1：在 config.yml 和 config_zh_TW.yml 中新增專案 GitHub 連結，更新日誌。

New AFly to v1.3.0: Adjusted the billing logic for paid flights, added rules for charging other players' territories, and updated related documentation and language files. I'm currently running at version 1.21.10 更新 AFly 至 v1.3.0：調整付費飛行計費邏輯，新增對別人領地的收費規則，並更新相關文檔與語言檔案

- Skript 版在使用者超新環境（Paper 1.21.10 / Java 25 / Skript 2.15.2）反覆踩坑： - skript-placeholders 熱載入 `zip file closed`、該 addon 一直載不起來。 - skript-reflect 對 Residence 的 `getResidenceManager()` 在其版本是「實例方法」非靜態。 - 使用者決定直接改寫成**原生 Java 插件**，要求：**獨立 config 檔** + **語言設定檔**，作者署名 **avery11111102**。 - 原生插件移除了 Skript / skript-reflect / PlaceholderAPI 全部依賴，最穩定。