{"id":138827,"date":"2026-06-08T08:13:49","date_gmt":"2026-06-08T05:13:49","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/shoptools\/"},"modified":"2026-06-08T08:13:49","modified_gmt":"2026-06-08T05:13:49","slug":"shoptools","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/shoptools\/","title":{"rendered":"ShopTools"},"content":{"rendered":"

# ShopTools (English)<\/p>\n

**Note**: This plugin is developed by AI.<\/p>\n

A powerful Minecraft shop query plugin that provides comprehensive shop information management and intelligent search capabilities for QuickShop-Reremake.<\/p>\n

## Features<\/p>\n

– **Automatic Data Sync**: Automatically reads shop data from QuickShop on server startup
\n– **Intelligent Sorting**: Supports multiple sorting methods (item ID, price, owner, etc.)
\n– **Cache Optimization**: Efficient data caching mechanism for improved query performance
\n– **Chinese Localization**: Complete Chinese interface and message support<\/p>\n

## Commands<\/p>\n

### Player Commands
\n– `\/shoptools search [page]` or `\/st search [page]` – Search all shops for specified items (smart distance display, sorted by distance)
\n– `\/shoptools near [page]` or `\/st near [page]` – View all shops within 200 blocks (sorted by distance)
\n– `\/shoptools help` or `\/st help` – Show help information<\/p>\n

### Admin Commands
\n– `\/shoptools page ` or `\/st page ` – Paginated display of all shops (10 per page, sorted by item ID alphabetically)
\n– `\/shoptools list [page]` or `\/st list [page]` – Show shops for specified items (supports pagination, sorted by price ascending)
\n– `\/shoptools who [page]` or `\/st who [page]` – Smart player shop search (supports fuzzy matching, UUID search, pagination)
\n– `\/shoptools reload` or `\/st reload` – Reload configuration and data<\/p>\n

## Permissions<\/p>\n

– `shoptools.use` – Allow use of basic commands (default: requires manual authorization)
\n– `shoptools.admin` – Allow use of admin commands (default: operators)<\/p>\n

## Installation<\/p>\n

### Requirements
\n– Minecraft 1.20.1+
\n– Paper\/Spigot server
\n– QuickShop-Reremake plugin<\/p>\n

### Installation Steps
\n1. Download the latest `ShopTools-1.0-SNAPSHOT.jar`
\n2. Place it in the server’s `plugins` folder
\n3. Restart the server
\n4. The plugin will automatically create configuration files and sync shop data<\/p>\n

## Configuration<\/p>\n

The plugin automatically creates `plugins\/ShopTools\/config.yml` with the following structure:<\/p>\n

“`yaml
\n# Data sync settings
\ndata-sync:
\n auto-sync-on-startup: true
\n sync-interval-minutes: 30<\/p>\n

# Command cooldown settings
\ncooldown:
\n # Player command cooldown time (seconds)
\n player-commands: 3
\n # Whether admins bypass cooldown restrictions
\n admin-bypass: true<\/p>\n

# Message settings
\nmessages:
\n # Player commands
\n help-search: “&e\/shoptools search [page] &7- Search all shops for specified items (sorted by distance)”
\n help-near: “&e\/shoptools near [page] &7- View all shops within 200 blocks”<\/p>\n

# Admin commands
\n help-page: “&e\/shoptools page &7- Paginated display of all shops &c(Admin)”
\n help-list: “&e\/shoptools list [page] &7- Show shops for specified items &c(Admin)”
\n help-who: “&e\/shoptools who [page] &7- Show specified player’s shops &c(Admin)”
\n help-reload: “&e\/shoptools reload &7- Reload configuration and data &c(Admin)”
\n“`<\/p>\n

## Key Features<\/p>\n

### Smart Distance Display
\n– **0-200 blocks**: Shows precise distance (e.g., “15.3m”, “89.7m”)
\n– **Over 200 blocks**: Shows “200m+”
\n– **Other worlds**: Shows “otherworld”<\/p>\n

### Intelligent Search
\n– **Fuzzy matching**: Input “DIA” matches “DIAMOND”
\n– **UUID support**: Search players by UUID
\n– **Multi-result handling**: Smart suggestions when multiple matches found<\/p>\n

### Pagination System
\n– **Smart pagination**: \u226410 items show directly, >10 items auto-paginate
\n– **Navigation hints**: Clear previous\/next page commands
\n– **Performance optimization**: Avoid displaying large amounts of data at once<\/p>\n

### Business Protection
\n– **Privacy protection**: Hide server-wide price information to prevent price wars
\n– **Distance priority**: Encourage local trading, maintain geographical economic balance
\n– **Permission separation**: Players use nearby search, admins use server-wide queries<\/p>\n

## Version History<\/p>\n

### v1.2.0 (2025-07-29) \ud83c\udfaf Direction Indicators & Stability Enhancement<\/p>\n

**\ud83e\udded Direction Indicator System**:
\n– \u2728 **Smart Direction Display**: Added direction indicators (E, W, S, N, etc.) for all relative position queries
\n– \ud83d\udccd **Precise Direction Calculation**: 8-direction calculation system based on coordinate differences (N, NE, E, SE, S, SW, W, NW)
\n– \ud83c\udfaf **Distance Format Optimization**: Display format as “Direction Distance”, e.g., “E 15.3m”, “W 25.7m”
\n– \ud83c\udf10 **Cross-world Support**: Different worlds display “otherworld”, avoiding invalid direction calculations<\/p>\n

**\ud83d\udd27 Stability Fixes**:
\n– \ud83d\udee0\ufe0f **Octree Boundary Fix**: Resolved boundary calculation errors during spatial subdivision (minY > maxY issue)
\n– \ud83d\udd12 **Safe Subdivision Algorithm**: Enhanced handling of extremely small ranges and edge cases
\n– \u26a1 **Performance Guarantee**: Ensure stable operation of spatial indexing at all data scales
\n– \ud83d\udee1\ufe0f **Exception Handling**: Comprehensive error recovery mechanisms, prevent crashes from subdivision failures<\/p>\n

**\ud83d\udcc8 Feature Coverage**:
\n– \u2705 `\/shoptools search` – Shop search now displays direction and distance
\n– \u2705 `\/shoptools near` – Nearby shop queries include direction information
\n– \u2705 `\/shoptools locate` – Location point queries show precise directions
\n– \u2705 Unified distance display format across all features, improved user experience<\/p>\n

### v1.1.0 (2025-07-24)
\n– \ud83d\udd27 Enhanced permission system: `shoptools.use` permission default changed to false, requires manual authorization
\n– \u2728 Command cooldown mechanism: Added 3-second cooldown for `\/st search` and `\/st near` commands
\n– \u2728 Admin bypass: Users with `shoptools.admin` permission are not subject to cooldown restrictions
\n– \ud83d\udd27 Performance protection: Prevent server lag from frequent player requests
\n– \ud83d\udd27 Configuration optimization: Added cooldown configuration node, supports custom cooldown time
\n– \ud83d\udc1b Fixed command registration: Removed permission fields from plugin.yml, resolved double permission check issue
\n– \ud83d\udc1b Fixed permission inheritance: Admin permissions now correctly include basic permissions, supports permission hierarchy<\/p>\n

### v1.0.9 (2025-07-24)
\n– \u2728 Enhanced `\/st search` feature: Extended search range to all server shops
\n– \u2728 Smart distance display: 0-200 blocks show precise distance, >200 blocks show “200m+”, other worlds show “otherworld”
\n– \u2728 Optimized sorting algorithm: Same-world shops sorted by distance, other-world shops placed last
\n– \ud83d\udd27 Business balance: Maintain distance information ambiguity, protect business competition balance
\n– \ud83d\udd27 Cross-world support: Players can discover shops in other worlds, encourage exploration<\/p>\n

### v1.0.8 (2025-07-24)
\n– \u2728 Permission system restructure: Separate admin and player functions, protect business information privacy
\n– \u2728 New `\/st search` command: Search shops within 200 blocks for specified items, sorted by distance
\n– \u2728 New `\/st near` command: View all shops within 200 blocks, sorted by distance
\n– \ud83d\udd27 Distance display: Price position shows distance between player and shop (e.g., “15.3m”)
\n– \ud83d\udd27 Business protection: Hide server-wide price information, prevent business wars, maintain game balance
\n– \ud83d\udd27 Smart permissions: Players use nearby search, admins use server-wide queries<\/p>\n

### v1.0.7 (2025-07-24)
\n– \u2728 Comprehensive pagination support: Added pagination for `\/st list` and `\/st who` commands
\n– \u2728 Smart pagination logic: \u226410 shops show directly, >10 shops auto-paginate
\n– \u2728 Enhanced Tab completion: Support smart completion for item and player page numbers
\n– \ud83d\udd27 Optimized large data display: Avoid performance issues from displaying large amounts of shops at once
\n– \ud83d\udd27 Improved user experience: Default to page 1, provide clear navigation hints<\/p>\n

### v1.0.6 (2025-07-24)
\n– \u2728 Smart player search system: Support UUID search, fuzzy matching, multi-result handling
\n– \u2728 Similarity algorithm: Provide smart suggestions when no matches found (edit distance algorithm)
\n– \u2728 Multi-result display: Show selection list when multiple players match, sorted by shop count
\n– \ud83d\udd27 Enhanced `\/st who` command: Support partial player names, complete UUIDs, smart hints
\n– \ud83d\udd27 Performance optimization: Player information caching, avoid repeated queries<\/p>\n

### v1.0.5 (2025-07-24)
\n– \u2728 Implemented pagination system: Avoid displaying large amounts of shop information at once, 10 shops per page
\n– \u2728 UUID to player name conversion: Smart retrieval of real player names, improve readability
\n– \u2728 Added shop status display: [Selling]\/[Buying]\/[Both] status indicators
\n– \ud83d\udd27 Command restructure: Removed `\/st list` show all shops, changed to `\/st page `
\n– \ud83d\udd27 Enhanced Tab completion: Support page number completion and smart command hints
\n– \ud83d\udd27 Optimized user experience: Added navigation hints and error guidance<\/p>\n

### v1.0.4 (2025-07-24)
\n– \ud83d\udd27 Fixed Java module system serialization issues: Resolved Optional field access restrictions
\n– \ud83d\udd27 Implemented simplified Data Transfer Object (DTO) strategy, avoid complex object serialization
\n– \ud83d\udd27 Optimized JSON format, provide better cross-version compatibility
\n– \ud83d\udd27 Successfully support complete serialization and storage of 6000+ shop data<\/p>\n

### v1.0.3 (2025-07-24)
\n– \ud83d\udd27 Fixed thread safety issues: Ensure all QuickShop API calls execute on main thread
\n– \ud83d\udd27 Improved data sync mechanism, avoid “Illegal Access” errors
\n– \ud83d\udd27 Optimized performance, support handling large amounts of shop data (6000+ shops)<\/p>\n

### v1.0.2 (2025-07-24)
\n– \ud83d\udd27 Fixed Gson serialization issues: Properly implemented Location and ItemStack type adapters
\n– \ud83d\udd27 Improved JSON data format, provide better readability and compatibility
\n– \ud83d\udd27 Enhanced error handling, avoid crashes from serialization failures<\/p>\n

### v1.0.1 (2025-07-24)
\n– \ud83d\udd27 Fixed plugin startup order issues: Ensure QuickShop fully starts before initialization
\n– \ud83d\udd27 Added delayed initialization mechanism, avoid API call failures
\n– \ud83d\udd27 Improved error handling and user prompts
\n– \ud83d\udd27 Added retry mechanism, improve initialization success rate<\/p>\n

### v1.0 (2025-07-24)
\n– \ud83c\udf89 Initial release
\n– \u2728 Basic shop listing functionality
\n– \u2728 QuickShop-Reremake integration
\n– \u2728 Automatic data synchronization
\n– \u2728 Chinese localization support<\/p>\n

## Technical Support<\/p>\n

If you encounter issues or have feature suggestions, please:<\/p>\n

1. Check console logs for detailed error information
\n2. Confirm QuickShop-Reremake plugin is running properly
\n3. Verify permission configuration is correct
\n4. Report issues on GitHub Issues<\/p>\n

## Compatibility<\/p>\n

– \u2705 QuickShop-Reremake 5.x
\n– \u2705 Paper 1.20.1+
\n– \u2705 Spigot 1.20.1+
\n– \u26a0\ufe0f Other QuickShop forks may require adaptation<\/p>\n

—<\/p>\n

**Note**: This plugin requires QuickShop-Reremake plugin to function properly. Please ensure QuickShop-Reremake is correctly installed and configured before installing this plugin.<\/p>\n

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!<\/p>\n","protected":false},"excerpt":{"rendered":"

A powerful Minecraft shop query plugin that provides comprehensive shop information management and intelligent search capabilities for QuickShop-Reremake.<\/p>\n","protected":false},"featured_media":138828,"template":"","meta":{"_minecraft_slug":"shoptools","_minecraft_project_id":"7SrEX5Ff","_minecraft_author":"NSrank","_minecraft_license":"MIT","_minecraft_downloads":84,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"shoptools.zip","_minecraft_size_bytes":532312,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-15T20:05:10.525139Z","_minecraft_date_created":"2025-11-06T11:00:10.048143Z","_minecraft_date_modified":"2026-03-08T10:50:35.394138Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/shoptools","_minecraft_icon_attachment_id":138828,"_minecraft_imported_at":"2026-06-08T05:13:50+00:00","_minecraft_import_hash":"bf5f316f8a6962bfc4f448498adf40f7","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[127,128,129],"mod_loader":[132,133,134],"minecraft_version":[59,36,60,93,94,101,102],"class_list":["post-138827","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6"],"yoast_head":"\nShopTools - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/shoptools\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"ShopTools - Minecraft\" \/>\n<meta property=\"og:description\" content=\"A powerful Minecraft shop query plugin that provides comprehensive shop information management and intelligent search capabilities for QuickShop-Reremake.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/shoptools\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"7 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/shoptools\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/shoptools\\\/\",\"name\":\"ShopTools - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/shoptools\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/shoptools\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/shoptools-icon-a2b2b002a216c5a256cd6007c5b9fda8ba7a00d9.png\",\"datePublished\":\"2026-06-08T05:13:49+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/shoptools\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/shoptools\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/shoptools\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/shoptools-icon-a2b2b002a216c5a256cd6007c5b9fda8ba7a00d9.png\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/shoptools-icon-a2b2b002a216c5a256cd6007c5b9fda8ba7a00d9.png\",\"width\":128,\"height\":128},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/shoptools\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"ShopTools\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"ShopTools - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/shoptools\/","og_locale":"en_US","og_type":"article","og_title":"ShopTools - Minecraft","og_description":"A powerful Minecraft shop query plugin that provides comprehensive shop information management and intelligent search capabilities for QuickShop-Reremake.","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/shoptools\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"7 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/shoptools\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/shoptools\/","name":"ShopTools - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/shoptools\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/shoptools\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/shoptools-icon-a2b2b002a216c5a256cd6007c5b9fda8ba7a00d9.png","datePublished":"2026-06-08T05:13:49+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/shoptools\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/shoptools\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/shoptools\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/shoptools-icon-a2b2b002a216c5a256cd6007c5b9fda8ba7a00d9.png","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/shoptools-icon-a2b2b002a216c5a256cd6007c5b9fda8ba7a00d9.png","width":128,"height":128},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/shoptools\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"ShopTools"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/138827","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/138828"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=138827"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=138827"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=138827"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=138827"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}