ashop

### ashop v1.9.0 正式版發布 彙整 1.9.0 測試版期間之所有功能驗證與錯誤修復，正式釋出穩定版生產環境： #### 原生支援 Paper 26.3「荒野之境」與 Java 25 - 完整原生相容 Minecraft 26.3 / Paper 26.3（`api-version: '26.3'`）與 Java 25 運行環境。 - 納入 26.3 全新方塊與物品分類：白楊木全系列（原木、木板、門欄等）、16 色羊毛與混凝土階梯/半磚、16 色家具坐墊（`decorations/cushions`）、單次使用露營草蓆（`blocks/functional`）與斑駁森林植被。 - 擴充生存基準定價模型與繁簡中英語系支援。 #### 現代化非同步聊天監聽器 - 徹底拔除舊式 Bukkit Conversation API。 - 重構為 Paper 原生 `AsyncChatEvent` 與 Adventure Component 體系，具備最低優先權攔截防公頻洩漏、UUID 精確單次觸發與 60 秒超時自動防呆。 #### 物品分類體系精確化與邊界修復 - **烈性硫磺**：花盆判定改為精確後綴比對，解決關鍵字劫持，正確歸入地形方塊 (`blocks/natural/terrain`)。 - **界符盒**：移除硬編碼，原色及 16 色塗色界符盒全數回歸功能性方塊 (`blocks/functional`)。 - **蜘蛛眼與腐肉**：排除可食用性誤分，蜘蛛眼歸入鍊金釀造 (`misc/brewing`)，腐肉歸入材料 (`misc/materials`)。 - **工作台與自動合成機**：竹筏改為精確比對，工作台回歸功能性方塊 (`blocks/functional`)，自動合成機回歸紅石 (`redstone`)。 - **塗蠟銅製品**：工具斧頭改為精準後綴比對，36 種塗蠟銅方塊全數回歸銅類建材 (`blocks/building/copper`)。 - **木碗**：精確化弓武器比對，避免木碗落入作戰武器。 - **露營草蓆**：粗礦比對改為嚴格前綴匹配，解決 `STRAW_BED` 誤入礦產分類問題。 - 100% 通過單元測試與防回歸斷言驗證。

https://github.com/Avery11111101/ashop

#### 📌 變更摘要 (Summary) 本 PR 涵蓋了從 Commit `747afb1` 到最新 Head（共 6 個 Commit）的核心功能新增與重要 Bug 修復。重點包括： 1. **Discord 商店含冒號商品購買修復**（附魔書/藥水短 Key Hash 防護） 2. **Discord 每日 / 每週 / 每月商店營運報表與自動推播**（支援 Bot 互動選單與 Webhook） 3. **物品交易趨勢與熱度智慧分析**（熱度分數、動態漲跌幅與自動分析評語） 4. **PlugManX / JDA 熱重載同步安全關閉**（修復 `zip file closed` 異常） 5. **基岩版 (Bedrock) PDC 標籤注入與 GUI 離線帶走防呆攔截** --- #### 🔥 主要變更亮點 (Key Highlights) 1. 🐛 **修復 Discord 含冒號商品標籤點擊失敗 Bug (`v1.7.0 Fix`)** - 針對 `catalogKey` 包含冒號（例如附魔書 `enchanted_book:ench:minecraft:luck_of_the_sea:3` 或藥水）的商品，實作短 Key Hash 對照表與倒數索引冒號安全解析演算法。 - 完全解決 Discord 按鈕點擊時解析錯位導致「該商品目前未開放購買」的問題，並向下相容舊版按鈕。 2. 📊 **Discord 每日 / 每週 / 每月商店營運報表系統 (`v1.8.0`)** - 建立非同步 `ReportService` 與 `transactions.yml` 交易紀錄機制。 - 新增 `DiscordReportScheduler` 排程器，支援手動指令（遊戲內 `/shop report` 與 Discord `/report`）以及定期自動推播至 Discord 頻道/Webhook。 - Bot 發送管道具備永久互動按鈕 (`📅 每日` / `📆 每週` / `📊 每月` / `🔄 重新整理`) 與下拉選單（包含熱門商品 Top 10、熱門玩家榜、明細等）。 - 新增 `discord-report.timezone` 設定，支援自訂或自動解析主機系統時區。 3. 📈 **物品交易趨勢與熱度智慧分析 (Analytics)** - 自動計算物品熱度指數 (0~100)、買賣比例與動態物價漲跌倍率。 - 自動生成分類標籤（`🔥 搶手爆款物資` / `📈 需求持續上升` / `⚖️ 供需穩定平衡` / `📥 玩家大量拋售`）與人性化智慧分析短評。 4. ⚡ **PlugManX / JDA 熱重載穩定度優化 (Stability)** - 改用 `standaloneJda.shutdownNow()` 搭配 3 秒 `awaitShutdown`，確保 PlugManX 在關閉 ClassLoader 前完整釋放 JDA 背景執行緒，消除 `IllegalStateException: zip file closed` 錯誤。 5. 🛡️ **基岩版 (Bedrock / Geyser / Floodgate) 防呆與 PDC 標籤機制 (`v1.7.1`)** - 為所有商店 GUI 物品注入 `ashop:gui_item` PersistentDataContainer (PDC) 標籤。 - 當介面關閉、玩家離線或重新登入時，自動抹除游標與背包內殘留的 GUI 展示方塊。 - 監聽放置方塊與丟棄物品事件進行防呆攔截；並於 `config.yml` 新增 `bedrock.block-gui` 控制開關。 --- - `747afb1` [Discord商店] 修復點擊含冒號商品標籤 (如附魔書/藥水) 導致購買失敗問題 - `8cd1ec7` [營運報表] 新增 Discord 每日/每週/每月商店營運報表與自動推播功能 - `4043e2e` [營運報表] 調整語意為玩家交易與系統商店服務數據統計 - `14a5e01` [營運報表] 新增物品交易趨勢、熱度分數與自動智慧分析短評 - `e4c667e` [Discord] 修復 PlugManX 熱重載時 JDA 非同步關閉導致的 zip file closed 異常 - `8851c96` [基岩版相容] 新增 PDC 標籤與基岩版 GUI 離線帶走防呆機制 --- #### ⚙️ 設定檔與多語系異動 (Config & Locale Changes) - **`config.yml`** - 新增 `discord-report` 完整設定區塊（包含 `channel-id`, `webhook-url`, `timezone`, `auto-push`）。 - 新增 `bedrock.block-gui` 設定項（預設 `false`）。 - **`zh_tw.properties` / `en_us.properties` / `_template.properties`** - 新增 `msg.cmd.bedrock-blocked` 基岩版阻擋提示訊息。 - **`CHANGELOG.md` & `README.AI.md`** - 已同步更新 v1.7.1 與 v1.8.0 異動日誌與歷史軌跡。

### 1. ⚙️ 原生 Paper 26.2 支援與 Fat-Jar 依賴封裝 - **核心升級**：`plugin.yml` api-version 調整為原生 `26.2`。 - **Fat-Jar 內建 JDA 依賴**：`ashop-1.7.0.jar` 內建完整 JDA (Java Discord API) 類別庫。即使伺服器未安裝 DiscordSRV 亦能 100% 穩定載入，徹底消除 `NoClassDefFoundError` 導致插件停用的隱患。 - **現代化建置**：全專案改用系統原創 Gradle 進行建置，移除過時包裹器腳本。 ### 2. 📈 商品物價自動回歸基準值機制 (Auto-Reversion Pricing) - **自動平衡經濟**：當物品浮動價格偏離基準價時（例如玩家大量購買觸發漲價，或大量出售觸發跌價），排程系統會依設定之「漲幅 / 跌幅」慢慢向基準值靠攏回歸。 - **可獨立調整與紀錄**：支援設定回歸時間週期（如每 1 小時），物價微調時會在控制台印出回歸日誌。 - **管理員 GUI 面板**：可直接在遊戲內星號 GUI 輕鬆編輯開關、檢查週期、漲幅與跌幅。 ### 3. 💬 Discord 線上商店預覽與購買面板 (`/商店` / `/shop`) - **跨平台線上商店**：玩家可直接在 Discord 上透過斜線指令瀏覽 12 大分類、即時動態物價與漲跌趨勢。 - **帳號繫結與防呆交割**：整合 DiscordSRV 驗證玩家繫結，選取數量後點擊 `🛒 確定購買` 直接送貨至遊戲內背包，具備金錢與背包空間不足防呆攔截。 - **全自動繁中物品解析**：全自動解析附魔書與藥水等級（例如：`附魔書 (保護 IV)`、`藥水 (迅捷 II)`），並附帶跨分類關鍵字彈窗搜尋功能 (`🔍 搜尋商品`)。 ### 4. 📦 收購箱一鍵填入與全可收購物品總覽 - **一鍵收購**：`/shop sell` 收購箱角落新增漏斗圖示，一鍵自動將背包中可被系統收購的物品填入收購箱。 - **可收購總覽**：新增 `/shop sellable` 指令與書本圖示，方便玩家隨時查詢當前伺服器開放收購的所有商品與即時單價。 ### 5. 🔒 交易模式 (TradeMode) 多層級繼承與控制 - **彈性控制**：支援物品/分類設定為 `雙向買賣 (BOTH)`、`只賣不收 (BUY_ONLY)`、`只收不賣 (SELL_ONLY)` 及 `禁用交易 (DISABLED)`。 - **展示功能**：設為禁用交易之商品仍可在 GUI 供玩家瀏覽。

新增角落一鍵放入可收購物品與查看可收購商品清單

🚀 本次完整更新總結： 交易模式 (TradeMode)： 支援 買賣皆可 (BOTH)、只賣不收 (BUY_ONLY)、只收不賣 (SELL_ONLY)、禁用交易 (DISABLED) 4 種狀態。 禁用交易的商品與分類在 GUI 中依舊清晰呈現，並顯示醒目的禁用 Lore。 收購箱 /shop sell 嚴格阻擋不收購的商品並自動歸還。 管理員選單與獨立刪除： 支援使用 滑鼠滾輪中鍵 點擊任何商品或分類直接跳轉至獨立管理員編輯 GUI。 獨立的「刪除商品」與「刪除分類/目錄」按鈕。 舊設定檔自動相容升級： 啟動與載入時自動將舊版缺失 trade-mode 屬性的 items.yml 順暢升級，無需手動改檔。 子分類獨立覆蓋與父分類重置級聯： 子分類（如 食物/生食）可獨立調整為與父分類不同的交易模式，完全生效。 父分類若有子項目單獨設定時顯示 ⚠️ 提示：下轄包含混合/自訂交易模式。 管理員再次調整父分類時，會自動進行 級聯重置 (Cascade)，將所有子分類與商品強制同步為父分類的新模式。

修復訊息沒攔截

discord連線訊息 測試方塊生存獲得過濾 搜尋

## [1.6.6] - 2026-07-11 ### Added / 新增 - **Price cap indicators** — GUI and `/shop price` show `已達上限` / `已達下限` when min/max multiplier is hit **漲跌停提示** — 觸及價格上下限時，GUI 與 `/shop price` 顯示「已達上限／下限」 - **Sell price trend** — sell panel and `/shop price` show buyback trend (e.g. `↓-12%`) **收購價趨勢** — 收購面板與查價指令顯示收購價漲跌幅 - **Dual market counters** in `market-data.yml`: `buys`/`sells` (effective) and `total-buys`/`total-sells` (all trades) **雙軌市場統計** — 有效計價次數與全部交易次數分開記錄 ### Changed / 變更 - **Effective buy/sell at cap** — purchases while at max cap (or sales at min cap) no longer inflate effective counters; restoring base price only requires selling the effective amount that caused the cap (1:1 by default) **漲停有效計次** — 漲停後多買、跌停後多賣不計入有效次數；賣出漲停前的有效數量即可恢復原價 - Default `per-sell-decrease` changed to `2.0` (matches `per-buy-increase` for 1:1 recovery) 預設 `per-sell-decrease` 改為 `2.0`，與 `per-buy-increase` 對齊（1:1 恢復） --- ## [1.6.5] - 2026-07-11 ### Changed / 變更 - **Survival-based pricing** — prices derived from obtain method, crafting cost, and loot rarity **生存定價** — 依取得方式、配方成本、戰利品稀有度計算基準價 - Calibrated anchors: Diorite 9/6, Diamond Pickaxe 1000/700, Mace 180000/120000, Elytra 130000/9500 校準基準：閃長岩、鑽石鎬、重錘、鞘翅 - Default `sell-ratio` changed to 2/3 (0.667); Elytra uses per-item sell-ratio override 預設收購比例改為 2/3；鞘翅另設低收購比例 - Admin: `/ashop resync-prices` recalculates existing `shop/` prices without wiping categories 管理員可用 `/ashop resync-prices` 重算現有商品價格 ---

[ashop] help 教學、首次自動載入、生存過濾與快捷購買（v1.6.4） 新增 /ashop help 完整教學與 ashop 指令別名；首次安裝 shop/ 為空時自動建立預設商店。 預設商店改為僅含生存可取得物品；搜尋結果頁修復 Shift+右鍵管理員編輯。 商品列表改為左鍵買 1、Shift+左鍵買一組、右鍵開數量選擇、Shift+右鍵管理員編輯。