- 版权类型
- 原创
- 插件中文名称
- 矿精
- 插件英文名称
- OreSpirit
- 原帖地址
- #
- 支持的核心（服务端）
- Spigot
- Paper
- 语言支持
- 中文（简体）
- 适配版本（Java）
- 最新版本
- 26.x
- 1.21
- 1.20
- 1.19
- 1.18
- 1.17
- 1.16
OreSpirit | 矿精
轻量级 Minecraft 天然矿石挖掘播报插件让每一次珍稀矿石的发现，都能被全服玩家见证！
OreSpirit（矿精）是一款专为原版生存服务器设计的轻量级矿石发现播报插件。当玩家挖掘指定矿石时，插件会向全服发送公告，同时自动记录玩家放置的方块，避免通过反复放置、挖掘矿石刷屏。
插件使用 Minecraft 原生区块持久化数据（PDC）保存记录，无需数据库、无需额外依赖、无需扫描世界，适合希望保持原版游戏体验的生存服务器。
主要功能
天然矿石发现播报玩家挖掘配置列表中的矿石时，自动向全服广播发现消息。默认支持钻石矿、深层钻石矿、绿宝石矿、深层绿宝石矿与远古残骸。
玩家放置矿石过滤自动记录玩家放置的矿石位置。玩家放置后再次挖掘不会触发播报，避免利用重复放置矿石刷屏。
超轻量运行采用 Bukkit 原生事件监听，无需后台扫描、定时检测或独立数据库。数据直接保存在对应区块中，服务器重启后仍然保留。
自定义监测方块支持通过配置文件自由添加或删除监测方块，不限于矿石。理论上支持当前服务器 Bukkit API 能识别的任意方块类型。
自定义播报内容支持自定义文字、颜色、方块显示名称及消息变量。默认不公开矿石所在坐标，避免泄露玩家的挖矿地点。
管理与调试提供配置热重载、运行状态查询及方块放置记录检查命令，方便服务器管理员管理。
播报效果
默认公告：[矿精] Steve 挖到了 深层钻石矿
只有配置中的方块，且未被记录为玩家放置时，才会触发上述公告。
管理员也可以通过配置文件自定义消息内容，包括玩家名、矿石名称、世界和坐标等信息。
插件命令
主命令：/orespirit| 命令 | 功能说明 |
|---|---|
/orespirit | 显示插件命令帮助 |
/orespirit reload | 重新读取配置文件，无需重启服务器 |
/orespirit status | 查看插件版本、监测方块数量、追踪模式及播报状态 |
/orespirit check | 检查准星对准的方块是否存在玩家放置记录 |
管理员在游戏内对准距离不超过 8 格的方块，输入
/orespirit check，即可查看方块 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配置项说明
[B]blocks[/B] — 监测方块列表使用方块 ID 作为键，后面的文字为游戏内显示的自定义名称。可以自由增加和删除方块。
例如，可以添加：
代码：
minecraft:gold_ore: '金矿石'
minecraft:deepslate_gold_ore: '深层金矿石'
minecraft:nether_gold_ore: '下界金矿石'[B]tracking.mode[/B] — 放置记录模式支持两种模式：
listed：仅追踪配置列表中的方块，默认模式，推荐大多数服务器使用。all：追踪所有玩家放置的普通方块，适合经常更改监测列表的服务器，但会增加区块数据占用。
[B]broadcast.enabled[/B] — 启用播报设为
true 开启，设为 false 关闭。关闭播报不等于关闭方块放置记录。[B]broadcast.message[/B] — 播报内容可以使用
& 颜色代码以及以下变量：| 变量 | 内容 |
|---|---|
%player% | 玩家名称 |
%block% | 配置中的方块显示名称 |
%id% | 方块 ID |
%world% | 所在世界名称 |
%x% | 方块 X 坐标 |
%y% | 方块 Y 坐标 |
%z% | 方块 Z 坐标 |
[B]admin-prefix[/B] — 管理消息前缀用于设置插件向管理员输出的提示消息前缀。
[B]allow-legacy-ids[/B] — 旧格式方块 ID 兼容控制是否允许配置中使用不含命名空间的方块 ID。建议新配置优先使用完整的
minecraft:方块ID 格式。修改完成后执行
/orespirit reload 即可生效。
安装方法
- 下载
OreSpirit-1.0.0.jar。 - 将 JAR 文件放入服务器的
plugins文件夹。 - 启动或重启服务器。
- 根据需要修改
plugins/OreSpirit/config.yml。 - 使用
/orespirit reload重新加载配置。
/orespirit status 查看插件是否正常运行。无需安装 PlaceholderAPI、Vault 或其他前置插件。
版本与环境
- 插件版本： 1.0.0
- 服务端： Bukkit / Spigot / Paper
- 目标兼容范围： Minecraft 1.16.5—26.3
- 运行依赖： 无
- 数据存储： Chunk PDC
- 数据库： 不需要
- Folia： 暂未提供兼容性保证
注意事项
1. 关于天然矿石判断插件并非根据世界种子重新计算矿石生成位置，而是记录玩家放置和部分非自然生成的方块变化。
因此，只有在插件运行期间能够正确追踪的方块变化，才能用于可靠过滤。插件安装前已经放置的矿石无法自动追溯。
2. 关于其他插件修改方块
使用
/setblock、/fill、WorldEdit 或其他插件直接修改方块时，部分操作可能不会触发常规 Bukkit 放置事件，因此不能保证所有非天然方块都被识别。3. 关于模组方块
配置支持 Bukkit API 可识别的方块 ID，但普通 Paper 服务端无法直接加载 Forge/Fabric 模组方块。混合核心中的模组方块支持情况取决于服务端实现。
4. 关于配置变更
默认
listed 模式只记录当时监测列表中的方块。如果后来新增监测方块，插件无法追溯此前对这些方块的放置操作。5. 关于服务器性能
建议普通生存服务器保持默认
listed 模式。此模式无需扫描既有地图，也不会为所有自然生成方块建立记录，尽可能减少资源消耗。
更新记录
v1.0.0 — 首次正式发布- 实现矿石挖掘全服播报
- 实现玩家放置矿石过滤
- 使用区块 PDC 持久化记录
- 支持自定义监测方块和播报内容
- 支持活塞移动、爆炸及部分方块变化事件的标记同步
- 提供配置重载、状态查询与方块检测命令
- 兼容早期 NaturalOreBroadcast 数据及部分旧版配置
OreSpirit · 矿精
轻量、简洁，让珍贵的矿石发现更有仪式感。
