FinderTools - 高性能异步世界扫描工具
FinderTools 是一款专为 Minecraft 1.20.1 Paper 服务器设计的高性能异步世界扫描插件,支持精确的方块和实体检测。
注意:本插件由 AI 辅助开发
功能特性
- ? 异步多线程扫描 - 高效扫描方块和实体,不影响服务器性能
- ? 灵活的扫描范围 - 支持整个世界的、特定区域文件的、已加载/未加载区块的扫描
- ? 智能内存管理 - 自动内存监控、垃圾回收和优化
- ? 实时进度监控 - 每 10% 输出一次进度,支持控制台和玩家消息
- ? 详细的报告生成 - 自动生成 YAML 格式的扫描报告,包含完整统计信息
- ⚙️ 高度可配置 - 可配置线程数、扫描间隔、内存阈值等
- ? 权限管理 - 完整的权限节点控制,确保使用安全
- ⏯️ 任务控制 - 支持停止、暂停和恢复扫描任务,实现灵活的过程管理
依赖要求
- Minecraft 1.20.1
- Paper Server
- Java 8 或更高版本
安装步骤
- 下载
FinderTools-1.0-SNAPSHOT.jar 文件
- 将文件放入服务器的
plugins 文件夹中
- 重启服务器或使用
/reload 命令
- 插件将自动创建配置文件和报告目录
命令
基本命令格式
/findertools find <block|entity> <id> <world> [options]
命令示例
方块扫描
# 在整个世界中扫描钻石矿石
/findertools find block diamond_ore world
# 仅在已加载区块中扫描石头
/findertools find block stone world{type='enabled'}
# 在特定区域中扫描金矿石
/findertools find block gold_ore world{region='0,0'}
实体扫描
# 在整个世界中扫描村民
/findertools find entity villager world
# 在已加载区块中扫描僵尸
/findertools find entity zombie world{type='enabled'}
# 在特定区域中扫描牛
/findertools find entity cow world{region='-1,2'}
任务控制命令
# 停止当前扫描任务
/findertools stop
# 暂停当前扫描任务
/findertools pause
# 恢复暂停的扫描任务
/findertools start
/findertools resume
# 检查当前扫描状态
/findertools status
其他命令
# 重载配置文件
/findertools reload
# 显示帮助信息
/findertools help
权限
| 权限节点 |
描述 |
默认值 |
findertools.command |
基本命令使用权限 |
op |
findertools.command.find |
查找命令使用权限 |
op |
findertools.command.reload |
配置重载权限 |
op |
findertools.command.state |
扫描任务控制权限 |
op |
配置
配置文件位置:plugins/FinderTools/config.yml
扫描配置
scan:
chunk-interval: 1 # 区块扫描间隔(刻)
write-interval: 10 # 写入报告的区块数量间隔
debug: false # 启用调试输出
线程配置
threading:
max-threads: 4 # 最大线程数
max-thread-usage: 0.8 # 每个线程的最大使用率
check-interval: 100 # 线程检查间隔(毫秒)
内存管理
memory:
max-memory-mb: 512 # 内存使用阈值(MB)
gc-threshold: 0.9 # 强制垃圾回收阈值
报告配置
report:
output-directory: "plugins/FinderTools/reports" # 报告保存目录
format: "yml" # 报告文件格式
detailed: true # 包含详细信息
进度输出
progress:
output-interval: 10 # 进度输出间隔(百分比)
console-output: true # 向控制台输出进度
player-output: true # 向执行者发送进度消息
报告格式
扫描完成后,插件会生成格式为 report_YYYYMMDD_8位随机ID.yml 的报告文件。
报告示例
report:
info:
generated_at: "2024-01-01 12:00:00"
plugin_version: "1.0-SNAPSHOT"
request_id: "12345678-1234-1234-1234-123456789abc"
parameters:
scan_type: "block"
target_id: "diamond_ore"
world: "world"
loaded_only: false
statistics:
total_results: 156
total_chunks_processed: 1000
chunks_with_results: 45
scan_duration_ms: 30000
scan_duration_readable: "30 seconds"
completed_at: "2024-01-01 12:00:30"
results:
- world: "world"
location: "123,45,678"
chunk: "7,42"
type: "block"
target: "diamond_ore"
性能优化
内存优化
- 自动内存监控和垃圾回收
- 定期写入报告以释放内存
- 智能调整写入间隔
线程优化
- 可配置的线程池大小
- 线程使用监控
- 优先级调整以避免影响服务器性能
扫描优化
- 异步区块加载和卸载
- 智能区块状态检测
- 可配置的扫描间隔
故障排除
常见问题
问:扫描速度非常慢?
答:增加 threading.max-threads 的值或减小 scan.chunk-interval 的值。
问:服务器出现卡顿?
答:减少线程数,增加扫描间隔,或降低 threading.max-thread-usage 的值。
问:内存占用过高?
答:减小 scan.write-interval 的值,使插件更频繁地写入报告并释放内存。
问:找不到报告文件?
答:检查 report.output-directory 配置,并确保该目录存在且具有写入权限。
开发信息
- 作者: NSrank & Augment
- 版本: 1.1-SNAPSHOT
- 许可证: MIT
- 源代码: 请联系作者获取源代码
支持
如果您在使用过程中遇到问题或有功能建议,请联系插件作者。
许可证
本项目采用 MIT 许可证 - 详见 LICENSE 文件
FinderTools - 让世界扫描变得简单高效!
FinderTools - High-Performance Async World Scanning Tool
FinderTools is a high-performance asynchronous world scanning plugin designed specifically for Minecraft 1.20.1 Paper servers, supporting precise block and entity detection.
Note: This plugin is developed with AI assistance
Features
- ? Async Multi-threaded Scanning - Efficient block and entity scanning without server performance impact
- ? Flexible Scan Range - Support for entire world, specific region files, loaded/unloaded chunks
- ? Smart Memory Management - Automatic memory monitoring, garbage collection and optimization
- ? Real-time Progress Monitoring - Progress output every 10%, supports console and player messages
- ? Detailed Report Generation - Automatic YAML format scan reports with complete statistics
- ⚙️ Highly Configurable - Configurable thread count, scan intervals, memory thresholds and more
- ? Permission Management - Complete permission node control for secure usage
- ⏯️ Task Control - Support for stopping, pausing, and resuming scan tasks with flexible process management
Requirements
- Minecraft 1.20.1
- Paper Server
- Java 8 or higher
Installation
- Download the
FinderTools-1.0-SNAPSHOT.jar file
- Place the file in your server's
plugins folder
- Restart the server or use the
/reload command
- The plugin will automatically create configuration files and report directories
Commands
Basic Command Format
/findertools find <block|entity> <id> <world> [options]
Command Examples
Block Scanning
# Scan for diamond ore in the entire world
/findertools find block diamond_ore world
# Scan for stone in loaded chunks only
/findertools find block stone world{type='enabled'}
# Scan for gold ore in a specific region
/findertools find block gold_ore world{region='0,0'}
Entity Scanning
# Scan for villagers in the entire world
/findertools find entity villager world
# Scan for zombies in loaded chunks
/findertools find entity zombie world{type='enabled'}
# Scan for cows in a specific region
/findertools find entity cow world{region='-1,2'}
Task Control Commands
# Stop current scan task
/findertools stop
# Pause current scan task
/findertools pause
# Resume paused scan task
/findertools start
/findertools resume
# Check current scan status
/findertools status
Other Commands
# Reload configuration file
/findertools reload
# Show help information
/findertools help
Permissions
| Permission Node |
Description |
Default |
findertools.command |
Basic command usage permission |
op |
findertools.command.find |
Find command usage permission |
op |
findertools.command.reload |
Configuration reload permission |
op |
findertools.command.state |
Scan task control permission |
op |
Configuration
Configuration file location: plugins/FinderTools/config.yml
Scan Configuration
scan:
chunk-interval: 1 # Chunk scanning interval (ticks)
write-interval: 10 # Chunk count interval for report writing
debug: false # Enable debug output
Thread Configuration
threading:
max-threads: 4 # Maximum thread count
max-thread-usage: 0.8 # Maximum usage per thread
check-interval: 100 # Thread check interval (milliseconds)
Memory Management
memory:
max-memory-mb: 512 # Memory usage threshold (MB)
gc-threshold: 0.9 # Forced garbage collection threshold
Report Configuration
report:
output-directory: "plugins/FinderTools/reports" # Report save directory
format: "yml" # Report file format
detailed: true # Include detailed information
Progress Output
progress:
output-interval: 10 # Progress output interval (percentage)
console-output: true # Output progress to console
player-output: true # Send progress messages to executor
Report Format
After scanning completion, the plugin generates report files in the format report_YYYYMMDD_8-digit-random-ID.yml.
Report Example
report:
info:
generated_at: "2024-01-01 12:00:00"
plugin_version: "1.0-SNAPSHOT"
request_id: "12345678-1234-1234-1234-123456789abc"
parameters:
scan_type: "block"
target_id: "diamond_ore"
world: "world"
loaded_only: false
statistics:
total_results: 156
total_chunks_processed: 1000
chunks_with_results: 45
scan_duration_ms: 30000
scan_duration_readable: "30 seconds"
completed_at: "2024-01-01 12:00:30"
results:
- world: "world"
location: "123,45,678"
chunk: "7,42"
type: "block"
target: "diamond_ore"
Performance Optimization
Memory Optimization
- Automatic memory monitoring and garbage collection
- Periodic report writing to release memory
- Smart adjustment of write intervals
Thread Optimization
- Configurable thread pool size
- Thread usage monitoring
- Priority adjustment to avoid server performance impact
Scan Optimization
- Asynchronous chunk loading and unloading
- Smart chunk state detection
- Configurable scan intervals
Troubleshooting
Common Issues
Q: Scanning is very slow?
A: Increase the threading.max-threads value or decrease the scan.chunk-interval value.
Q: Server experiencing lag?
A: Reduce thread count, increase scan intervals, or lower the threading.max-thread-usage value.
Q: High memory usage?
A: Decrease the scan.write-interval value to make the plugin write reports more frequently and release memory.
Q: Cannot find report files?
A: Check the report.output-directory configuration and ensure the directory exists with write permissions.
Development Information
- Author: NSrank & Augment
- Version: 1.1-SNAPSHOT
- License: MIT
- Source Code: Please contact the author for source code
Support
If you encounter issues or have feature suggestions during usage, please contact the plugin author.
License
This project is licensed under the MIT License - see the LICENSE file for details
FinderTools - Making world scanning simple and efficient!
评论 0
登录后参与评分
还没有评论,来抢沙发吧