ShopTools

# ShopTools (English) **Note**: This plugin is developed by AI. A powerful Minecraft shop query plugin that provides comprehensive shop information management and intelligent search capabilities for QuickShop-Reremake. ## Features - **Automatic Data Sync**: Automatically reads shop data from QuickShop on server startup - **Intelligent Sorting**: Supports multiple sorting methods (item ID, price, owner, etc.) - **Cache Optimization**: Efficient data caching mechanism for improved query performance - **Chinese Localization**: Complete Chinese interface and message support ## Commands ### Player Commands - `/shoptools search <item_id> ` or `/st search <item_id> ` - Search all shops for specified items (smart distance display, sorted by distance) - `/shoptools near ` or `/st near ` - View all shops within 200 blocks (sorted by distance) - `/shoptools help` or `/st help` - Show help information ### Admin Commands - `/shoptools page <page>` or `/st page <page>` - Paginated display of all shops (10 per page, sorted by item ID alphabetically) - `/shoptools list <item_id> ` or `/st list <item_id> ` - Show shops for specified items (supports pagination, sorted by price ascending) - `/shoptools who <player_name/uuid> ` or `/st who <player_name/uuid> ` - Smart player shop search (supports fuzzy matching, UUID search, pagination) - `/shoptools reload` or `/st reload` - Reload configuration and data ## Permissions - `shoptools.use` - Allow use of basic commands (default: requires manual authorization) - `shoptools.admin` - Allow use of admin commands (default: operators) ## Installation ### Requirements - Minecraft 1.20.1+ - Paper/Spigot server - QuickShop-Reremake plugin ### Installation Steps 1. Download the latest `ShopTools-1.0-SNAPSHOT.jar` 2. Place it in the server's `plugins` folder 3. Restart the server 4. The plugin will automatically create configuration files and sync shop data ## Configuration The plugin automatically creates `plugins/ShopTools/config.yml` with the following structure: ```yaml # Data sync settings data-sync: auto-sync-on-startup: true sync-interval-minutes: 30 # Command cooldown settings cooldown: # Player command cooldown time (seconds) player-commands: 3 # Whether admins bypass cooldown restrictions admin-bypass: true # Message settings messages: # Player commands help-search: "&e/shoptools search <item_id> &7- Search all shops for specified items (sorted by distance)" help-near: "&e/shoptools near &7- View all shops within 200 blocks" # Admin commands help-page: "&e/shoptools page <page> &7- Paginated display of all shops &c(Admin)" help-list: "&e/shoptools list <item_id> &7- Show shops for specified items &c(Admin)" help-who: "&e/shoptools who <player_name/uuid> &7- Show specified player's shops &c(Admin)" help-reload: "&e/shoptools reload &7- Reload configuration and data &c(Admin)" ``` ## Key Features ### Smart Distance Display - **0-200 blocks**: Shows precise distance (e.g., "15.3m", "89.7m") - **Over 200 blocks**: Shows "200m+" - **Other worlds**: Shows "otherworld" ### Intelligent Search - **Fuzzy matching**: Input "DIA" matches "DIAMOND" - **UUID support**: Search players by UUID - **Multi-result handling**: Smart suggestions when multiple matches found ### Pagination System - **Smart pagination**: ≤10 items show directly, >10 items auto-paginate - **Navigation hints**: Clear previous/next page commands - **Performance optimization**: Avoid displaying large amounts of data at once ### Business Protection - **Privacy protection**: Hide server-wide price information to prevent price wars - **Distance priority**: Encourage local trading, maintain geographical economic balance - **Permission separation**: Players use nearby search, admins use server-wide queries ## Version History ### v1.2.0 (2025-07-29) 🎯 Direction Indicators & Stability Enhancement **🧭 Direction Indicator System**: - ✨ **Smart Direction Display**: Added direction indicators (E, W, S, N, etc.) for all relative position queries - 📍 **Precise Direction Calculation**: 8-direction calculation system based on coordinate differences (N, NE, E, SE, S, SW, W, NW) - 🎯 **Distance Format Optimization**: Display format as "Direction Distance", e.g., "E 15.3m", "W 25.7m" - 🌐 **Cross-world Support**: Different worlds display "otherworld", avoiding invalid direction calculations **🔧 Stability Fixes**: - 🛠️ **Octree Boundary Fix**: Resolved boundary calculation errors during spatial subdivision (minY > maxY issue) - 🔒 **Safe Subdivision Algorithm**: Enhanced handling of extremely small ranges and edge cases - ⚡ **Performance Guarantee**: Ensure stable operation of spatial indexing at all data scales - 🛡️ **Exception Handling**: Comprehensive error recovery mechanisms, prevent crashes from subdivision failures **📈 Feature Coverage**: - ✅ `/shoptools search` - Shop search now displays direction a