FinderTools
Managing a Minecraft server often means needing to locate specific blocks or entities across vast worlds without grinding the server to a halt. FinderTools is the answer — a high-performance asynchronous scanning add-on built for Paper servers that delivers precise results while keeping your TPS rock-solid. Whether you're hunting for diamond ore, tracking down stray villagers, or auditing region files, FinderTools handles the heavy lifting in the background so your players never notice a thing.
What Makes FinderTools Stand Out
Unlike traditional scanning methods that freeze the main server thread, FinderTools uses advanced async multi-threading to process chunks in parallel. This means you can scan entire worlds, specific regions, or only loaded chunks without causing lag spikes. The plugin monitors memory usage in real time, automatically triggering garbage collection when needed, and writes progress updates every 10% so you always know how far along a scan is. Once complete, a detailed YAML report lands in your output directory with exact coordinates, chunk data, and timing statistics.
Compatibility and Requirements
FinderTools is developed for Minecraft 1.20.1 Paper servers and requires Java 8 or higher. It integrates seamlessly with the Paper API to leverage optimized chunk handling and asynchronous scheduling. While it's tailored for Paper, the plugin's architecture makes it a reliable choice for any server running a compatible fork. Always ensure your server meets the minimum Java version to avoid runtime issues.
How to Install FinderTools
Getting FinderTools up and running is straightforward. First, download FinderTools from your preferred source — the plugin is distributed as a standard JAR file. Place that JAR into your server's plugins folder, then restart the server or run a reload command. On first launch, FinderTools automatically creates its configuration file and report directories, so you can start scanning immediately. If you're using the foxygame.net launcher, adding FinderTools is even simpler: just browse the built-in add-on catalog, click install, and the launcher handles version compatibility and updates for you, ensuring FinderTools stays current without manual downloads.
Basic Configuration
After installation, you'll find the config at plugins/FinderTools/config.yml. Here you can adjust thread counts, scan intervals, memory thresholds, and report settings. The defaults work well for most servers, but if you're running a large world or have limited resources, tweaking these values can optimize performance. For example, lowering threading.max-threads reduces CPU load, while increasing scan.chunk-interval gives the server more breathing room between chunk scans.
Powerful Commands at Your Fingertips
FinderTools uses a clean command structure that's easy to remember. The core command is /findertools find <block|entity> <id> <world> [options]. You can scan for any block or entity by its Minecraft ID, target a specific world, and even limit the search to loaded chunks or a particular region file. For example, /findertools find block diamond_ore world scans the entire default world for diamond ore, while /findertools find entity villager world{region='0,0'} narrows the search to the region containing chunk 0,0. Task control commands like /findertools stop, /findertools pause, and /findertools resume give you full control over long-running scans.
Permission Management
FinderTools includes a complete permission system to keep scanning secure. The base node findertools.command grants access to all commands, while sub-nodes like findertools.command.find and findertools.command.state let you delegate specific abilities to moderators or trusted players. All permissions default to operator-only, so you won't accidentally expose powerful scanning tools to regular users.
Real-Time Progress and Detailed Reports
During a scan, FinderTools outputs progress every 10% to both the console and the player who initiated the command, so you're never left wondering if the task is still running. Once complete, a YAML report is saved with a unique filename containing the date and a random ID. The report includes the scan parameters, total results, chunks processed, duration, and a full list of every found block or entity with its exact coordinates and chunk location. This makes it easy to share findings or import data into external tools.
Performance Tuning for Large Worlds
FinderTools is designed to be gentle on your server, but you can fine-tune it further. If scans feel slow, increase the maximum thread count or reduce the chunk interval. If you notice TPS drops, do the opposite—lower threads, raise intervals, and decrease the per-thread usage cap. The plugin's smart memory management also writes reports incrementally to free up RAM, and you can adjust the write interval to balance memory usage against I/O load. For servers with massive worlds, these tweaks make the difference between a scan that takes minutes versus one that impacts gameplay.
Download FinderTools for Minecraft
Ready to streamline your world scanning? Download FinderTools today and add it to your Paper 1.20.1 server. The plugin is lightweight, easy to configure, and built to handle everything from quick entity checks to full-world block audits. With its async engine and detailed reporting, you'll spend less time waiting and more time playing. Whether you're an admin troubleshooting griefing or a developer analyzing world data, FinderTools for Minecraft is the tool you've been missing.
How to Install and Get Started
After you download FinderTools, installation takes just a few steps. Drop the JAR into your plugins folder, restart, and you're ready to run your first scan. The default settings work out of the box, but you can dive into the config to customize thread pools, memory limits, and output formats. If you ever need to reload the configuration without restarting the server, simply use /findertools reload. For those who manage multiple servers, the foxygame.net launcher offers a one-click install option that automatically keeps FinderTools updated, so you never have to worry about version mismatches or manual file transfers.
Why Async Scanning Matters
Traditional synchronous scanning locks the main server thread, causing noticeable lag or even timeouts. FinderTools avoids this entirely by offloading chunk reading and entity queries to a dedicated thread pool. The plugin also intelligently skips unloaded chunks unless you explicitly request them, saving both time and memory. This async-first design means you can run scans during peak player hours without anyone complaining about block lag or delayed ticks.
Final Thoughts
FinderTools redefines what world scanning can be on a Minecraft server. Its combination of async processing, real-time feedback, and exhaustive YAML reports makes it indispensable for server admins who need accurate data without compromise. From locating rare ores to auditing entity counts, FinderTools delivers speed, precision, and stability. Give it a try on your Paper 1.20.1 server and experience the difference a truly asynchronous scanner can make.