矿石探测器

矿石探测器

一个服务端 Minecraft Fabric 模组,用于检测并记录矿石开采活动,支持权限管理

管理

OreDetector - Minecraft Fabric 模组

一个用于 Minecraft 1.21.1 的服务端 Minecraft Fabric 模组,可检测并记录矿石开采活动,并支持权限系统。

功能特性

⛏️ 矿脉检测

  • 将相连的矿石方块归组为矿脉
  • 每条矿脉只发送一次通知(而非每个方块)
  • 开采大型矿床时防止刷屏

🔐 权限系统

  • 集成 LuckPerms(可选)
  • 两个权限节点:
    • oredetector.detectionmessages - 接收实时开采通知
    • oredetector.orelog - 访问矿石日志命令
  • 若 LuckPerms 不可用,则回退到管理员权限

📊 实时通知

  • 玩家发现矿脉时立即通知
  • 显示玩家名称、矿石数量、矿石类型和坐标
  • 消息包含维度信息

📋 矿石记录与历史

  • 持久化记录所有开采活动
  • 命令:/orelog [小时数](默认:24 小时)
  • 可搜索的历史记录,带时间戳
  • 自动清理,内存高效

命令

/orelog [小时数]

查看指定时间段内的矿石开采历史。

示例:

  • /orelog - 显示最近 24 小时
  • /orelog 6 - 显示最近 6 小时
  • /orelog 168 - 显示最近一周(最大值)

输出包含:

  • 开采事件的时间戳
  • 玩家名称
  • 矿脉中的矿石数量
  • 矿石类型
  • 精确坐标
  • 维度

权限

权限 描述 默认
oredetector.detectionmessages 接收实时矿石开采通知 管理员
oredetector.orelog 访问 /orelog 命令 管理员

安装

  1. 下载最新版本
  2. 将 .jar 文件放入服务器的 mods 文件夹
  3. 如果尚未安装 Fabric Loader,请先安装
  4. (可选)安装 LuckPerms 以实现高级权限管理
  5. 重启服务器

配置

目前,该模组开箱即用,无需任何配置。

技术细节

  • 模组加载器: Fabric
  • 依赖项: Fabric API
  • 可选依赖项: LuckPerms
  • 仅服务端: 是

使用示例

当玩家开采一条钻石矿脉时:

[OreDetector] HelluPeptic mined 8 diamond ore in Overworld at 123, -45, 678

使用日志命令:

/orelog 2
=== Ore Log - Last 2 Hours ====
Found 3 mining events:
[Jan 03 14:32:15] HelluPeptic mined 8x diamond at 123, -45, 678 (Overworld)
[Jan 03 13:45:22] HelluPeptic mined 12x iron at 234, 56, 789 (Overworld)  
[Jan 03 13:12:08] GoodbyePeptic mined 4x gold at -45, 32, -123 (Nether)