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> [page] or /st search <item_id> [page] - Search all shops for specified items (smart distance display, sorted by distance)
/shoptools near [page] or /st near [page] - 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> [page] or /st list <item_id> [page] - Show shops for specified items (supports pagination, sorted by price ascending)
/shoptools who <player_name/uuid> [page] or /st who <player_name/uuid> [page] - 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

Download the latest ShopTools-1.0-SNAPSHOT.jar
Place it in the server's plugins folder
Restart the server
The plugin will automatically create configuration files and sync shop data

Configuration

The plugin automatically creates plugins/ShopTools/config.yml with the following structure:

# 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> [page] &7- Search all shops for specified items (sorted by distance)"
  help-near: "&e/shoptools near [page] &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> [page] &7- Show shops for specified items &c(Admin)"
  help-who: "&e/shoptools who <player_name/uuid> [page] &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 and distance
✅ /shoptools near - Nearby shop queries include direction information
✅ /shoptools locate - Location point queries show precise directions
✅ Unified distance display format across all features, improved user experience

v1.1.0 (2025-07-24)

🔧 Enhanced permission system: shoptools.use permission default changed to false, requires manual authorization
✨ Command cooldown mechanism: Added 3-second cooldown for /st search and /st near commands
✨ Admin bypass: Users with shoptools.admin permission are not subject to cooldown restrictions
🔧 Performance protection: Prevent server lag from frequent player requests
🔧 Configuration optimization: Added cooldown configuration node, supports custom cooldown time
🐛 Fixed command registration: Removed permission fields from plugin.yml, resolved double permission check issue
🐛 Fixed permission inheritance: Admin permissions now correctly include basic permissions, supports permission hierarchy

v1.0.9 (2025-07-24)

✨ Enhanced /st search feature: Extended search range to all server shops
✨ Smart distance display: 0-200 blocks show precise distance, >200 blocks show "200m+", other worlds show "otherworld"
✨ Optimized sorting algorithm: Same-world shops sorted by distance, other-world shops placed last
🔧 Business balance: Maintain distance information ambiguity, protect business competition balance
🔧 Cross-world support: Players can discover shops in other worlds, encourage exploration

v1.0.8 (2025-07-24)

✨ Permission system restructure: Separate admin and player functions, protect business information privacy
✨ New /st search command: Search shops within 200 blocks for specified items, sorted by distance
✨ New /st near command: View all shops within 200 blocks, sorted by distance
🔧 Distance display: Price position shows distance between player and shop (e.g., "15.3m")
🔧 Business protection: Hide server-wide price information, prevent business wars, maintain game balance
🔧 Smart permissions: Players use nearby search, admins use server-wide queries

v1.0.7 (2025-07-24)

✨ Comprehensive pagination support: Added pagination for /st list and /st who commands
✨ Smart pagination logic: ≤10 shops show directly, >10 shops auto-paginate
✨ Enhanced Tab completion: Support smart completion for item and player page numbers
🔧 Optimized large data display: Avoid performance issues from displaying large amounts of shops at once
🔧 Improved user experience: Default to page 1, provide clear navigation hints

v1.0.6 (2025-07-24)

✨ Smart player search system: Support UUID search, fuzzy matching, multi-result handling
✨ Similarity algorithm: Provide smart suggestions when no matches found (edit distance algorithm)
✨ Multi-result display: Show selection list when multiple players match, sorted by shop count
🔧 Enhanced /st who command: Support partial player names, complete UUIDs, smart hints
🔧 Performance optimization: Player information caching, avoid repeated queries

v1.0.5 (2025-07-24)

✨ Implemented pagination system: Avoid displaying large amounts of shop information at once, 10 shops per page
✨ UUID to player name conversion: Smart retrieval of real player names, improve readability
✨ Added shop status display: [Selling]/[Buying]/[Both] status indicators
🔧 Command restructure: Removed /st list show all shops, changed to /st page <page>
🔧 Enhanced Tab completion: Support page number completion and smart command hints
🔧 Optimized user experience: Added navigation hints and error guidance

v1.0.4 (2025-07-24)

🔧 Fixed Java module system serialization issues: Resolved Optional field access restrictions
🔧 Implemented simplified Data Transfer Object (DTO) strategy, avoid complex object serialization
🔧 Optimized JSON format, provide better cross-version compatibility
🔧 Successfully support complete serialization and storage of 6000+ shop data

v1.0.3 (2025-07-24)

🔧 Fixed thread safety issues: Ensure all QuickShop API calls execute on main thread
🔧 Improved data sync mechanism, avoid "Illegal Access" errors
🔧 Optimized performance, support handling large amounts of shop data (6000+ shops)

v1.0.2 (2025-07-24)

🔧 Fixed Gson serialization issues: Properly implemented Location and ItemStack type adapters
🔧 Improved JSON data format, provide better readability and compatibility
🔧 Enhanced error handling, avoid crashes from serialization failures

v1.0.1 (2025-07-24)

🔧 Fixed plugin startup order issues: Ensure QuickShop fully starts before initialization
🔧 Added delayed initialization mechanism, avoid API call failures
🔧 Improved error handling and user prompts
🔧 Added retry mechanism, improve initialization success rate

v1.0 (2025-07-24)

🎉 Initial release
✨ Basic shop listing functionality
✨ QuickShop-Reremake integration
✨ Automatic data synchronization
✨ Chinese localization support

Technical Support

If you encounter issues or have feature suggestions, please:

Check console logs for detailed error information
Confirm QuickShop-Reremake plugin is running properly
Verify permission configuration is correct
Report issues on GitHub Issues

Compatibility

✅ QuickShop-Reremake 5.x
✅ Paper 1.20.1+
✅ Spigot 1.20.1+
⚠️ Other QuickShop forks may require adaptation

Note: This plugin requires QuickShop-Reremake plugin to function properly. Please ensure QuickShop-Reremake is correctly installed and configured before installing this plugin.

This plugin perfectly solves the pain points of shop information queries on large servers, providing powerful and easy-to-use shop management tools for both players and administrators!