# FinderTools – High-Performance Async World Scanning Tool<\/p>\n
FinderTools is a high-performance asynchronous world scanning plugin designed specifically for Minecraft 1.20.1 Paper servers, supporting precise block and entity detection.
\n> **Note**: This plugin is developed with AI assistance<\/p>\n
## Features<\/p>\n
– \ud83d\udd0d **Async Multi-threaded Scanning** – Efficient block and entity scanning without server performance impact
\n– \ud83c\udf0d **Flexible Scan Range** – Support for entire world, specific region files, loaded\/unloaded chunks
\n– \ud83d\udcca **Smart Memory Management** – Automatic memory monitoring, garbage collection and optimization
\n– \ud83d\udcc8 **Real-time Progress Monitoring** – Progress output every 10%, supports console and player messages
\n– \ud83d\udcc4 **Detailed Report Generation** – Automatic YAML format scan reports with complete statistics
\n– \u2699\ufe0f **Highly Configurable** – Configurable thread count, scan intervals, memory thresholds and more
\n– \ud83d\udd12 **Permission Management** – Complete permission node control for secure usage
\n– \u23ef\ufe0f **Task Control** – Support for stopping, pausing, and resuming scan tasks with flexible process management<\/p>\n
## Requirements<\/p>\n
– Minecraft 1.20.1
\n– Paper Server
\n– Java 8 or higher<\/p>\n
## Installation<\/p>\n
1. Download the `FinderTools-1.0-SNAPSHOT.jar` file
\n2. Place the file in your server’s `plugins` folder
\n3. Restart the server or use the `\/reload` command
\n4. The plugin will automatically create configuration files and report directories<\/p>\n
## Commands<\/p>\n
### Basic Command Format ### Command Examples<\/p>\n #### Block Scanning # Scan for stone in loaded chunks only # Scan for gold ore in a specific region #### Entity Scanning # Scan for zombies in loaded chunks # Scan for cows in a specific region #### Task Control Commands # Pause current scan task # Resume paused scan task # Check current scan status #### Other Commands # Show help information ## Permissions<\/p>\n | Permission Node | Description | Default | ## Configuration<\/p>\n Configuration file location: `plugins\/FinderTools\/config.yml`<\/p>\n ### Scan Configuration ### Thread Configuration ### Memory Management ### Report Configuration ### Progress Output ## Report Format<\/p>\n After scanning completion, the plugin generates report files in the format `report_YYYYMMDD_8-digit-random-ID.yml`.<\/p>\n ### Report Example parameters: statistics: results: ## Performance Optimization<\/p>\n ### Memory Optimization ### Thread Optimization ### Scan Optimization ## Troubleshooting<\/p>\n ### Common Issues<\/p>\n **Q: Scanning is very slow?** **Q: Server experiencing lag?** **Q: High memory usage?** **Q: Cannot find report files?** ## Development Information<\/p>\n – **Author**: NSrank & Augment ## Support<\/p>\n If you encounter issues or have feature suggestions during usage, please contact the plugin author.<\/p>\n ## License<\/p>\n This project is licensed under the MIT License – see the [LICENSE](LICENSE) file for details<\/p>\n —<\/p>\n **FinderTools** – Making world scanning simple and efficient!<\/p>\n","protected":false},"excerpt":{"rendered":" A high-performance asynchronous world scanning plugin designed specifically for Minecraft 1.20.1 Paper servers, supporting precise block and entity detection.<\/p>\n","protected":false},"featured_media":70148,"template":"","meta":{"_minecraft_slug":"findertools","_minecraft_project_id":"6QeMh40X","_minecraft_author":"NSrank","_minecraft_license":"MIT","_minecraft_downloads":136,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"findertools.zip","_minecraft_size_bytes":279685,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-15T18:51:39.718265Z","_minecraft_date_created":"2025-10-12T07:09:16.688389Z","_minecraft_date_modified":"2025-10-14T09:22:06.954759Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/findertools","_minecraft_icon_attachment_id":70148,"_minecraft_imported_at":"2026-06-03T23:48:09+00:00","_minecraft_import_hash":"b8faf0f6933a2f532e53bc8cd2aa306f","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,90,127,128,129,92],"mod_loader":[132,133,134],"minecraft_version":[59,36,60,93,94,101,102],"class_list":["post-70147","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","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":"\n
\n“`
\n\/findertools find
\n“`<\/p>\n
\n“`bash
\n# Scan for diamond ore in the entire world
\n\/findertools find block diamond_ore world<\/p>\n
\n\/findertools find block stone world{type=’enabled’}<\/p>\n
\n\/findertools find block gold_ore world{region=’0,0′}
\n“`<\/p>\n
\n“`bash
\n# Scan for villagers in the entire world
\n\/findertools find entity villager world<\/p>\n
\n\/findertools find entity zombie world{type=’enabled’}<\/p>\n
\n\/findertools find entity cow world{region=’-1,2′}
\n“`<\/p>\n
\n“`bash
\n# Stop current scan task
\n\/findertools stop<\/p>\n
\n\/findertools pause<\/p>\n
\n\/findertools start
\n\/findertools resume<\/p>\n
\n\/findertools status
\n“`<\/p>\n
\n“`bash
\n# Reload configuration file
\n\/findertools reload<\/p>\n
\n\/findertools help
\n“`<\/p>\n
\n|—————-|————-|———|
\n| `findertools.command` | Basic command usage permission | op |
\n| `findertools.command.find` | Find command usage permission | op |
\n| `findertools.command.reload` | Configuration reload permission | op |
\n| `findertools.command.state` | Scan task control permission | op |<\/p>\n
\n“`yaml
\nscan:
\n chunk-interval: 1 # Chunk scanning interval (ticks)
\n write-interval: 10 # Chunk count interval for report writing
\n debug: false # Enable debug output
\n“`<\/p>\n
\n“`yaml
\nthreading:
\n max-threads: 4 # Maximum thread count
\n max-thread-usage: 0.8 # Maximum usage per thread
\n check-interval: 100 # Thread check interval (milliseconds)
\n“`<\/p>\n
\n“`yaml
\nmemory:
\n max-memory-mb: 512 # Memory usage threshold (MB)
\n gc-threshold: 0.9 # Forced garbage collection threshold
\n“`<\/p>\n
\n“`yaml
\nreport:
\n output-directory: “plugins\/FinderTools\/reports” # Report save directory
\n format: “yml” # Report file format
\n detailed: true # Include detailed information
\n“`<\/p>\n
\n“`yaml
\nprogress:
\n output-interval: 10 # Progress output interval (percentage)
\n console-output: true # Output progress to console
\n player-output: true # Send progress messages to executor
\n“`<\/p>\n
\n“`yaml
\nreport:
\n info:
\n generated_at: “2024-01-01 12:00:00”
\n plugin_version: “1.0-SNAPSHOT”
\n request_id: “12345678-1234-1234-1234-123456789abc”<\/p>\n
\n scan_type: “block”
\n target_id: “diamond_ore”
\n world: “world”
\n loaded_only: false<\/p>\n
\n total_results: 156
\n total_chunks_processed: 1000
\n chunks_with_results: 45
\n scan_duration_ms: 30000
\n scan_duration_readable: “30 seconds”
\n completed_at: “2024-01-01 12:00:30”<\/p>\n
\n – world: “world”
\n location: “123,45,678”
\n chunk: “7,42”
\n type: “block”
\n target: “diamond_ore”
\n“`<\/p>\n
\n– Automatic memory monitoring and garbage collection
\n– Periodic report writing to release memory
\n– Smart adjustment of write intervals<\/p>\n
\n– Configurable thread pool size
\n– Thread usage monitoring
\n– Priority adjustment to avoid server performance impact<\/p>\n
\n– Asynchronous chunk loading and unloading
\n– Smart chunk state detection
\n– Configurable scan intervals<\/p>\n
\nA: Increase the `threading.max-threads` value or decrease the `scan.chunk-interval` value.<\/p>\n
\nA: Reduce thread count, increase scan intervals, or lower the `threading.max-thread-usage` value.<\/p>\n
\nA: Decrease the `scan.write-interval` value to make the plugin write reports more frequently and release memory.<\/p>\n
\nA: Check the `report.output-directory` configuration and ensure the directory exists with write permissions.<\/p>\n
\n– **Version**: 1.1-SNAPSHOT
\n– **License**: MIT
\n– **Source Code**: Please contact the author for source code<\/p>\n