BlockRegen - 矿石再生插件

💡简介

BlockRegen 是一款为 Minecraft 服务器设计的插件，它能为自定义矿场或农场创建可再生的矿石节点，灵感来源于大型多人在线角色扮演游戏（MMORPG）和 Hypixel Skyblock 中的采矿体验。通过细致的配置，你可以让特定区域的方块在被破坏后自动再生，并支持丰富的自定义奖励。

🎮核心特性

• 广泛的方块支持：原生支持 Oraxen、Nexo、ItemsAdder 和 MMOItems 的自定义方块，也支持任何音符盒或蘑菇柄的方块状态，方便手工资源包使用。
• 自定义工具支持：允许使用来自上述插件的物品作为采集工具。
• 农作物处理：支持甘蔗、仙人掌等多方块结构的农作物。
• 附魔兼容性：可与其他附魔插件良好兼容。
• 详尽的配置选项：提供全面的再生机制与奖励配置。
• 分区配置：可为不同区域设置独立的规则。
• 自定义头颅与方块数据：支持使用自定义头颅纹理及其他方块数据。
• 纯文件配置：无需图形界面，完全通过 YAML 配置文件进行设置，满足技术型管理员的需求。

🔧配置与支持

维基与文档

如需了解详细的配置方法，请查阅插件维基

https://github.com/Wertik/BlockRegen/wiki

问题与建议

如果您在使用中遇到任何问题或有功能建议，欢迎通过 Discord 联系我们！

> 开发者寄语：希望这款插件能引起您的兴趣。虽然我不会后空翻来增加“哇”的因素，但我可以提供全力支持！请不要犹豫，随时向我们寻求帮助！ ~Aurorion

介绍

BlockRegen 是一款功能强大的方块自动再生插件，允许服务器管理员为特定方块设置自定义的再生规则。无论是保护重要的建筑结构，还是为特定区域（如资源世界、PvP竞技场）创建可再生的资源点，它都能提供灵活的配置选项。插件由 Aurorion 创建，并由 Wertik 开发维护。

💡功能特性

• 自定义再生规则：可为任何方块类型设置再生时间、掉落物、音效和粒子效果。
• 区域保护：支持与 WorldGuard 等区域插件集成，仅在指定区域内再生方块。
• 多世界支持：可为不同的世界配置独立的再生规则。
• 事件触发：可配置方块在破坏、爆炸、活塞推动等事件后再生。
• 权限控制：通过权限节点精细控制谁可以破坏或免于再生规则。
• 数据存储：使用 SQLite 或 MySQL 可靠地存储方块数据，重启服务器后数据不丢失。
• API 支持：为其他插件开发者提供 API，以便进行深度集成。

🎮命令与权限

主要命令

• /blockregen 或 /br - 显示插件帮助信息。
• /br reload - 重载插件配置文件。
• 权限：blockregen.reload
• /br list - 列出所有已配置的再生规则。
• 权限：blockregen.list
• /br info <规则名> - 查看特定规则的详细信息。
• 权限：blockregen.info
• /br check <规则名> - 检查你当前位置的方块是否匹配指定规则。
• 权限：blockregen.check
• /br bypass - 切换“绕过再生”模式，在此模式下破坏的方块将不会再生。
• 权限：blockregen.bypass

权限节点

• blockregen.* - 授予所有插件权限。
• blockregen.bypass - 允许玩家绕过所有再生规则。
• blockregen.notify - 当玩家破坏一个将再生的方块时收到通知。

🔧配置指南

基本配置

配置文件位于 plugins/BlockRegen/config.yml。主要配置项包括：

• storage：选择数据存储方式 (sqlite 或 mysql)。
• default-region-only：设置为 true 时，再生仅在世界保护区域（如 WorldGuard 区域）内生效。
• worlds：一个列表，指定插件生效的世界。留空则对所有世界生效。
• debug：启用调试模式，在控制台输出详细信息。

创建再生规则

规则在 plugins/BlockRegen/rules/ 目录下的 YAML 文件中定义。每个文件代表一个规则。

一个简单的石头再生规则示例 (stone_rule.yml)：

rule-name: stone_rule
material: STONE
regenerate-after: 30 # 再生等待时间（秒）
restore-explosion: true # 爆炸后是否再生
restore-piston: false # 被活塞推动后是否再生
drop-items: true # 再生时是否掉落物品（如原版破坏石头掉落圆石）
silktouch-drop: true # 使用精准采集工具破坏时，是否掉落方块本身
play-sound: BLOCK_STONE_BREAK # 再生时播放的音效
particle-effect: BLOCK_CRACK # 再生时显示的粒子效果
particle-data: STONE # 粒子效果数据
region-only: true # 是否仅在 WorldGuard 区域内生效
whitelist-regions: [spawn, arena] # 仅在这些特定区域内生效（需要 region-only 为 true）
blacklist-regions: [mine] # 在这些区域内不生效

✨安装与依赖

前置需求

• Spigot、Paper 或任何基于 Spigot 的服务器核心（推荐最新稳定版）。
• Java 8 或更高版本。

可选依赖

• WorldGuard：用于实现基于区域的再生限制。
• Vault：如需与经济插件集成（例如对破坏再生方块收费）。

安装步骤

• 将下载的 BlockRegen.jar 文件放入服务器的 plugins 文件夹。
• 重启服务器。
• 根据需求编辑 config.yml 和 rules/ 目录下的规则文件。
• 使用 /br reload 命令应用更改。

❓常见问题

• Q: 方块没有再生？
• A: 检查规则配置中的 regenerate-after 时间。确认方块破坏事件被正确监听（例如，检查是否有其他插件取消了事件）。确认该区域是否满足 region-only 和区域白名单/黑名单的设置。

• Q: 如何让某个世界的草方块 10 秒后再生？
• A: 在 rules 文件夹创建新文件，例如 grass.yml。设置 material: GRASS_BLOCK 和 regenerate-after: 10。确保在 config.yml 的 worlds 列表中包含了该世界，或留空以应用于所有世界。

• Q: 如何让拥有特定权限的玩家破坏的方块不再生？
• A: 授予该玩家 blockregen.bypass 权限。或者，在破坏时让他们执行 /br bypass 命令进入绕过模式。

• Q: 支持 Minecraft 1.20.x 吗？
• A: 请查看官方页面或下载页面的更新日志，确认插件版本是否支持你的服务器版本。通常，插件会持续更新以支持最新版本。

⭐链接与支持

• 源码与 Wiki：https://github.com/Wertik/BlockRegen
• 问题反馈：请在 GitHub 仓库的 Issues 页面提交问题。
• 下载：可在 SpigotMC 等主流插件平台找到下载链接。