FinderTools

插件

· 作者 NSrank

一款专为 Minecraft 1.20.1 Paper 服务器设计的高性能异步世界扫描插件,支持精确的方块和实体检测。

0 本站下载 0 关注 更新于 1 年前

最新 1.3 · 1.20.6 · Paper / Purpur

一键开服(送7天)

FinderTools - 高性能异步世界扫描工具

FinderTools 是一款专为 Minecraft 1.20.1 Paper 服务器设计的高性能异步世界扫描插件,支持精确的方块和实体检测。

注意:本插件由 AI 辅助开发

功能特性

  • ? 异步多线程扫描 - 高效扫描方块和实体,不影响服务器性能
  • ? 灵活的扫描范围 - 支持整个世界的、特定区域文件的、已加载/未加载区块的扫描
  • ? 智能内存管理 - 自动内存监控、垃圾回收和优化
  • ? 实时进度监控 - 每 10% 输出一次进度,支持控制台和玩家消息
  • ? 详细的报告生成 - 自动生成 YAML 格式的扫描报告,包含完整统计信息
  • ⚙️ 高度可配置 - 可配置线程数、扫描间隔、内存阈值等
  • ? 权限管理 - 完整的权限节点控制,确保使用安全
  • ⏯️ 任务控制 - 支持停止、暂停和恢复扫描任务,实现灵活的过程管理

依赖要求

  • Minecraft 1.20.1
  • Paper Server
  • Java 8 或更高版本

安装步骤

  1. 下载 FinderTools-1.0-SNAPSHOT.jar 文件
  2. 将文件放入服务器的 plugins 文件夹中
  3. 重启服务器或使用 /reload 命令
  4. 插件将自动创建配置文件和报告目录

命令

基本命令格式

/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 - 让世界扫描变得简单高效!

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源