ClearDrop-1.0.1

ClearDrop Plugin - 更新日誌 / Changelog

版本 1.0.1 (2025-08-07)

🎉 重大功能更新 / Major Feature Updates

🔄 商店分頁系統 / Shop Pagination System

• 新增分頁導航 / Added Pagination Navigation
  • 添加了「上一頁」和「下一頁」按鈕，使用箭頭材質 / Added "Previous" and "Next" page buttons with arrow materials
  • 商店標題現在顯示當前頁面信息（例如："掉落物商店 - 第1頁"）/ Shop title now displays current page info (e.g., "Drop Shop - Page 1")
  • 每頁顯示45個不同物品，保留最後一行給控制按鈕 / Each page displays 45 different items, reserving the last row for control buttons
  • 智能按鈕顯示：只在有可用頁面時顯示導航按鈕 / Smart button display: navigation buttons only appear when pages are available
  • 系統會記住每個玩家當前瀏覽的頁面 / System remembers each player's current page

💾 無限量物品存儲系統 / Unlimited Item Storage System

• 突破Minecraft堆疊限制 / Breaking Minecraft Stack Limits
  • 使用新的 itemCounts 映射存儲 Long 類型數量，支持超過64個物品 / Uses new itemCounts mapping to store Long type quantities, supporting more than 64 items
  • ItemStack只存儲1個作為模板，實際數量單獨記錄 / ItemStack stores only 1 as template, actual quantities recorded separately
  • 保證所有物品都會被記錄，不會因數量限制而丟失 / Guarantees all items are recorded without loss due to quantity limits
  • 防止插件因數量問題崩潰 / Prevents plugin crashes due to quantity issues

🎨 用戶界面改進 / User Interface Improvements

• 重新設計的控制按鈕布局 / Redesigned Control Button Layout

  • 位置45：上一頁按鈕 / Slot 45: Previous page button
  • 位置46：刷新按鈕 / Slot 46: Refresh button
  • 位置49：信息按鈕（顯示頁面和數量信息）/ Slot 49: Info button (displays page and quantity info)
  • 位置52：清空商店按鈕（管理員專用）/ Slot 52: Clear shop button (admin only)
  • 位置53：下一頁按鈕 / Slot 53: Next page button

• 大數字格式化顯示 / Large Number Formatting

  • 自動將大數字格式化為易讀形式 / Automatically formats large numbers for readability
  • 例如：1,500 → 1.5K，2,300,000 → 2.3M，1,200,000,000 → 1.2B / Examples: 1,500 → 1.5K, 2,300,000 → 2.3M, 1,200,000,000 → 1.2B

🔧 技術改進 / Technical Improvements

📊 數據結構優化 / Data Structure Optimization

• 添加 Map<Player, Integer> playerPages 來跟踪玩家頁面狀態 / Added Map<Player, Integer> playerPages to track player page states
• 添加 Map<String, Long> itemCounts 來存儲大數量 / Added Map<String, Long> itemCounts to store large quantities
• 優化了物品ID生成和匹配邏輯 / Optimized item ID generation and matching logic

🛡️ 穩定性增強 / Stability Enhancements

• 改進了錯誤處理和邊界檢查 / Improved error handling and boundary checks
• 更新了購買邏輯以使用新的數量系統 / Updated purchase logic to use new quantity system
• 保持了向後兼容性，舊API方法仍然可用 / Maintained backward compatibility, old API methods still available

🔄 方法更新 / Method Updates

• addItemsToShop(): 更新為使用新的存儲系統 / Updated to use new storage system
• openShop(): 添加分頁參數支持 / Added pagination parameter support
• purchaseItem(): 更新為使用 itemCounts 而非 ItemStack 數量 / Updated to use itemCounts instead of ItemStack amounts
• getItemAmount(): 重寫以支持大數量計算 / Rewritten to support large quantity calculations
• 新增 formatLargeNumber(): 格式化大數字顯示 / Added formatLargeNumber(): formats large number display
• 新增 getPlayerPage(): 獲取玩家當前頁面 / Added getPlayerPage(): gets player's current page

🎯 用戶體驗改進 / User Experience Improvements

📱 交互優化 / Interaction Optimization

• 分頁按鈕點擊響應更加流暢 / Smoother pagination button click responses
• 刷新商店時保持當前頁面位置 / Maintains current page position when refreshing shop
• 清空商店後自動返回第一頁 / Automatically returns to first page after clearing shop
• 改進的庫存不足提示信息 / Improved insufficient stock notification messages

📈 性能優化 / Performance Optimization

• 優化了大量物品的顯示性能 / Optimized display performance for large quantities of items
• 減少了不必要的數據計算 / Reduced unnecessary data calculations
• 改進了內存使用效率 / Improved memory usage efficiency

🐛 修復的問題 / Fixed Issues

1. ItemStack序列化錯誤 / ItemStack Serialization Error

   • 修復了物品數量超過99時的序列化錯誤 / Fixed serialization error when item quantity exceeds 99
   • 解決了 "Value must be within range [1;99]: 6016" 錯誤 / Resolved "Value must be within range [1;99]: 6016" error

2. 數量累積問題 / Quantity Accumulation Issues

   • 修復了物品數量無限累積導致的崩潰 / Fixed crashes caused by unlimited quantity accumulation
   • 添加了適當的數量邊界檢查 / Added proper quantity boundary checks

3. 分頁導航問題 / Pagination Navigation Issues

   • 確保分頁按鈕只在適當時候顯示 / Ensures pagination buttons only show when appropriate
   • 修復了頁面計算錯誤 / Fixed page calculation errors

📋 兼容性說明 / Compatibility Notes

• ✅ 完全向後兼容現有配置文件 / Fully backward compatible with existing config files
• ✅ 保留所有舊版API方法 / Retains all legacy API methods
• ✅ 支持現有的商店數據格式 / Supports existing shop data formats
• ✅ 無需重新配置即可使用新功能 / New features work without reconfiguration

🚀 下一步計劃 / Future Plans

• 🔍 搜索和過濾功能 / Search and filter functionality
• 💰 經濟系統深度整合 / Deep economy system integration
• 📊 詳細的統計和分析 / Detailed statistics and analytics
• 🎨 自定義UI主題 / Custom UI themes

---

安裝說明 / Installation Instructions:

1. 停止服務器 / Stop the server
2. 替換舊的JAR文件為 ClearDrop-1.0.0.jar / Replace old JAR with ClearDrop-1.0.1.jar
3. 重啟服務器 / Restart the server
4. 享受新功能！/ Enjoy the new features!

注意事項 / Important Notes:

• 建議在更新前備份服務器數據 / Recommend backing up server data before updating
• 新版本完全兼容舊數據，無需額外配置 / New version is fully compatible with old data, no additional configuration needed
• 如遇問題請查看服務器日誌獲取詳細信息 / Check server logs for detailed information if issues occur

---

開發者:blockeric10145,Gemini-2.5
版本: ClearDrop-1.0.1
發布日期: 2025年8月7日
Minecraft版本支持: 1.21+

ClearDrop

支援1.21-1.21.8