- 版权类型
- 原创
- 插件中文名称
- 矿精
- 插件英文名称
- OreSpirit
- 原帖地址
- #
- 支持的核心（服务端）
- Spigot
- Paper
- 语言支持
- 中文（简体）
- 适配版本（Java）
- 最新版本
- 26.x
- 1.21
- 1.20
- 1.18
- 1.17
- 1.16
OreSpirit | 矿精
轻量级反矿透辅助插件 · 天然矿石挖掘全服播报
插件介绍
在原版生存服务器中，矿透（X-Ray）一直是影响游戏公平性的问题之一。传统的反矿透方案通常通过隐藏矿石、混淆区块数据或检测玩家行为来减少作弊。OreSpirit（矿精）提供了一种更简单、轻量的辅助监督方式：让稀有矿石的挖掘行为公开透明。
当玩家挖掘钻石、绿宝石、远古残骸等指定矿石时，插件会自动向全服发送消息。其他玩家能够实时看到稀有矿石的获取情况，如果某位玩家在短时间内频繁挖掘大量稀有矿石，其异常行为便更容易引起关注。
为避免人为制造虚假记录，OreSpirit 还会追踪玩家放置的矿石，防止通过反复放置和挖掘触发公告。
整个过程不需要修改世界生成、不需要拦截区块数据，也不需要额外数据库，尽可能保持 Minecraft 原版生存体验。
OreSpirit 不会自动认定作弊或处罚玩家，而是通过公开播报提供监督线索。
核心功能
1. 反矿透辅助监督
将指定稀有矿石的挖掘行为公开广播，让全服玩家都能及时了解矿石获取情况。- 提高异常挖矿行为的可见度
- 对使用矿透作弊形成一定威慑
- 不修改矿石分布和世界生成
- 不干扰正常玩家的挖矿操作
- 不会自动封禁或处罚玩家
2. 天然矿石识别与过滤
插件会记录玩家放置的方块，避免人为重复触发公告。- 挖掘未被标记的监测矿石时触发播报
- 玩家放置后再挖掘不会播报
- 处理活塞移动、爆炸及部分方块变化事件
- 记录在服务器重启后仍然保留
3. 实时全服播报
默认效果：[矿精] Steve 挖到了 深层钻石矿
广播内容可以自由修改，支持玩家名称、方块名称、世界名称、坐标等变量。
4. 自定义监测方块
服务器管理员可以自由选择需要监测的矿石。默认包含：
- 钻石矿 / 深层钻石矿
- 绿宝石矿 / 深层绿宝石矿
- 远古残骸
5. 轻量级运行与原生存储
OreSpirit 采用事件驱动方式工作，仅在相关方块事件发生时进行处理。- 无需 SQLite 或 MySQL
- 无需扫描现有世界
- 无需周期性全图检测
- 无需其他插件作为前置依赖
- 使用 Chunk PDC 保存方块标记
- 默认仅追踪配置中需要监测的方块
指令说明
主命令：/orespirit| 指令 | 功能 |
|---|---|
/orespirit | 查看插件命令帮助 |
/orespirit reload | 重新加载配置文件 |
/orespirit status | 查看插件版本、监测数量、追踪模式及播报状态 |
/orespirit check | 检查准星对准的方块是否具有非天然标记 |
[B]/orespirit check[/B] 使用方法：管理员在游戏中对准 8 格以内的方块，执行命令即可查看其 ID、坐标及记录状态。
- 已记录为非天然：挖掘时不会播报
- 无放置记录：属于监测列表时，挖掘将触发播报
兼容旧命令别名：
/oreannounce、/orealert。
权限节点
| 权限 | 说明 | 默认 |
|---|---|---|
orespirit.admin | 使用全部管理指令 | OP |
naturalorebroadcast.admin | 旧版管理权限兼容 | 不默认授予 |
配置说明
配置文件路径：plugins/OreSpirit/config.yml默认配置：
代码：
blocks:
minecraft:diamond_ore: '钻石矿'
minecraft:deepslate_diamond_ore: '深层钻石矿'
minecraft:emerald_ore: '绿宝石矿'
minecraft:deepslate_emerald_ore: '深层绿宝石矿'
minecraft:ancient_debris: '远古残骸'
tracking:
mode: listed
broadcast:
enabled: true
message: '&6[矿精] &e%player% &f挖到了 &d%block%'
admin-prefix: '&6[矿精] &f'
allow-legacy-ids: true自定义监测矿石
在blocks 下添加方块 ID 和对应的显示名称：
代码：
minecraft:gold_ore: '金矿石'
minecraft:deepslate_gold_ore: '深层金矿石'/orespirit reload 生效。方块追踪模式
tracking.mode 支持两种模式：listed：仅追踪监测列表中的方块。默认推荐，资源占用较低。all：记录所有玩家放置的普通方块。适合频繁更改监测列表的服务器，但会增加区块数据占用。
自定义公告
通过broadcast.message 修改播报文本，支持 & 颜色代码。| 变量 | 说明 |
|---|---|
%player% | 玩家名称 |
%block% | 自定义方块名称 |
%id% | 方块 ID |
%world% | 所在世界 |
%x% | X 坐标 |
%y% | Y 坐标 |
%z% | Z 坐标 |
broadcast.enabled：是否启用全服播报。admin-prefix：管理员提示消息前缀。allow-legacy-ids：是否允许使用不带命名空间的旧式方块 ID。
安装方法
- 将
OreSpirit-1.0.0.jar放入服务器的plugins文件夹。 - 重启服务器，自动生成配置文件。
- 按需编辑
plugins/OreSpirit/config.yml。 - 执行
/orespirit reload加载配置。 - 执行
/orespirit status查看运行状态。
兼容性
| 项目 | 说明 |
|---|---|
| 插件版本 | 1.0.0 |
| Minecraft | 目标兼容 1.16.5—26.3 |
| 服务端 | Bukkit / Spigot / Paper |
| 存储方式 | Chunk PDC |
| 前置依赖 | 无 |
| Folia | 暂不保证兼容 |
使用须知
关于反矿透效果OreSpirit 是反矿透辅助监督插件，而非直接检测 X-Ray 客户端的反作弊系统。
插件目前不提供自动频率统计、作弊评分、异常警报或自动处罚。全服播报仅用于向在线玩家展示挖掘行为，不能单凭挖矿次数认定玩家作弊。
正常玩家使用高效率挖矿方式，也可能在短时间内获得大量矿石。建议管理员结合其他证据综合判断。
关于天然矿石识别
插件通过记录方块放置和变化来区分矿石，并不能直接验证某个方块是否由世界生成器创建。
安装插件之前放置的矿石，以及部分通过命令、WorldEdit 或其他插件直接修改的方块，可能无法正确识别。
关于模组支持
支持配置服务器 Bukkit API 能识别的方块 ID，但不保证兼容所有 Forge、Fabric 或混合服务端的模组方块。
更新日志
v1.0.0 — 首次发布
- 实现天然矿石挖掘全服播报
- 实现玩家放置矿石过滤
- 支持自定义监测方块及显示名称
- 支持自定义公告文字和变量
- 采用 Chunk PDC 持久化保存
- 支持配置热重载
- 提供方块追踪状态检查指令
- 支持部分方块移动及变化事件的标记同步
- 保留旧版数据及部分配置兼容
OreSpirit · 矿精
让稀有矿石的获取更加透明，让公平生存多一份保障。
