🔎 FindBlock

Lost your base? Forgot where you found a rare block? FindBlock helps you search for blocks in your Minecraft world!

FindBlock is a block-searching plugin for Paper servers, designed to help players locate specific blocks using simple commands. Check my Video

✨ Features

• 🔍 Nearby Search — Find blocks within a specified radius.
• 🌍 Full-World Search — Search saved chunks across your world.
• 📊 Progress Tracking — Track the progress of long searches.
• ⏹️ Search Cancellation — Stop an active search.
• ⚙️ Configurable Settings — Customize supported plugin settings.
• 📍 Coordinates — Find the locations of matching blocks.
• 🔐 Permissions — Control access to commands.
• 📜 Search History — Review recent search results.
• 🔄 Resume Search — Continue a saved search, if supported by your installed version.

⌨️ Commands

Command	Description
/findblock	Display the help menu
/findblock help	Show command help
/findblock <block> [radius]	Search for a nearby block
/findblock chest,barrel 128	Search for multiple block types
/findblock world <block>	Search saved chunks in the current world
/findblock resume	Resume a saved search
/findblock cancel	Cancel your active search
/findblock history	View recent search results
/findblock tp	Teleport to your latest result
/findblock admin reload	Reload plugin configuration
/findblock admin cancel <player>	Cancel another player's search

📌 Usage Examples

Find diamond ore within 128 blocks

/findblock diamond_ore 128

Find stripped cherry logs

/findblock stripped_cherry_log

Search for chests and barrels within 128 blocks

/findblock chest,barrel 128

Search saved chunks across the current world

/findblock world stripped_cherry_log

Resume a saved search

/findblock resume

🔐 Permissions

Permission	Purpose
findblock.use	Basic search commands
findblock.world	Full-world search access
findblock.tp	Teleport to search results
findblock.admin	Administrative commands

Permission requirements may depend on the command and your server's permission configuration.

🛠️ Requirements

• Minecraft: 1.21.11
• Server software: Paper
• Java: 21

📥 Installation

1. Download the FindBlock .jar file from the Versions section.
2. Place the file in your server's plugins folder.
3. Restart your Paper server.
4. Run /findblock help to view available commands.

💻 Source Code & Bug Reports

FindBlock is open source.

GitHub: https://github.com/NOTeVidipt/FindBlock

Found a bug or have a feature idea? Open an issue on GitHub.

⚠️ Important Notes

• Full-world searches may take a long time on large worlds.
• Search performance depends on world size and server hardware.
• Full-world searches operate on saved chunks; they may not find blocks in chunks that have never been saved.
• Back up your world before testing a new plugin.
• Some commands or features may require additional permissions.

Find blocks. Recover locations. Explore smarter!