⚠️ ? 已归档项目 — 不再维护 ? ⚠️
❗ 此插件现已归档,将不会收到任何未来的更新。 ? 开发工作已转移至一个更大、更先进的项目,该项目将包含 RegenSystem 及更多功能。
? 如果您正在使用此插件,您可以继续使用,但不保证提供任何支持或更新。
? 新项目将在未来发布——敬请期待。
RegenSystem
一款强大且灵活的地块再生系统,专为 PvP Box、生存区域或采矿区域设计。定义长方体区域,并让它们在一段时间内自动再生——只需一条命令即可实现。
✅ 版本
- ? 正在 Paper API 1.20.6+ 上积极开发
- ⚡ 兼容 Paper / Spigot / Folia,适用于 1.20.x → 1.21.x
- ⏳ 未来可能会支持旧版 Minecraft
✅ 服务器兼容性
- ✅ Paper — 完全支持并推荐使用
- ✅ Folia — 完全支持(区域安全调度器,异步安全操作)
- ✅ Spigot — 支持(针对缺失的 API 提供自动回退机制)
ℹ️ 该插件会根据服务器平台(Paper / Folia / Spigot)自动调整其行为,以确保最大的兼容性和稳定性。
? 文档
✅ 命令
| 命令 | 描述 |
|---|---|
/regen pos1 |
在当前设置区域的第一个角点。 |
/regen pos2 |
在当前设置区域的第二个角点。 |
/regen save <name> [delay] [f:flag=value]... |
保存一个新区域,可选设置再生延迟(秒)和可选标志。 |
/regen reload [zone] |
重载所有区域,如果提供了名称则重载特定区域。 |
/regen delete <name> |
删除一个区域及其存储的数据。 |
/regen snapshot <name> |
使用当前方块状态更新区域的存储数据。 |
/regen wand |
获得一把钻石斧,通过左键/右键选择 pos1/pos2。 |
/regen enable <all\name> |
全局启用再生或为特定区域启用再生。 |
/regen disable <all\name> |
全局禁用再生或为特定区域禁用再生。 |
/regen menu |
打开用于修改选项的菜单。 |
/regen help [page] |
显示帮助菜单(共3页)。 |
/regen flag |
显示所有可用标志及其描述。 |
/regen flag <zone> |
列出特定区域的所有标志及其状态。 |
/regen flag <zone> <flag> <on\off> |
为区域启用或禁用特定标志。 |
/regen lang <language> |
设置插件语言。 |
✅ 权限
| 权限 | 描述 | 默认值 |
|---|---|---|
regensystem.* |
授予上述所有权限 | OP |
regensystem.command |
使用基础 /regen 命令 |
OP |
regensystem.pos |
使用 /regen pos1/pos2 设置 pos1 和 pos2 |
OP |
regensystem.save |
通过 /regen save 保存区域 |
OP |
regensystem.reload |
通过 /regen reload 重载区域 |
OP |
regensystem.delete |
通过 /regen delete 删除区域 |
OP |
regensystem.snapshot |
通过 /regen snapshot 更新区域数据 |
OP |
regensystem.wand |
通过 /regen wand 给自己发放选择斧 |
OP |
regensystem.toggle |
通过 /regen enable/disable 启用/禁用再生 |
OP |
regensystem.menu |
通过 /regen menu 打开菜单 |
OP |
regensystem.update |
连接时接收更新消息 | OP |
regensystem.flag |
允许您通过 /regen flag 管理标志 |
OP |
regensystem.lang |
允许您通过 /regen lang 设置插件的语言 |
OP |
? 使用 regensystem.* 可快速授予对插件的完整访问权限。
? 依赖项
- ✅ PlaceholderAPI (软依赖,可选)
要启用占位符,只需安装 PlaceholderAPI 即可——插件会自动检测到它。
✅ 占位符(通过 PlaceholderAPI)
如果已安装 PlaceholderAPI,你可以使用以下占位符:
| 占位符 | 描述 |
|---|---|
%regen_zone_count% |
定义的区域总数 |
%regen_regen_enabled% |
全局再生状态(enabled 或 disabled) |
%regen_enabled_<zone>% |
特定区域的再生是否启用 |
%regen_delay_<zone>% |
特定区域的再生延迟(秒) |
%regen_exists_<zone>% |
如果区域存在则返回 "true" |
%regen_block_count_<zone>% |
区域内原始方块的数量 |
%regen_corner1_<zone>% |
区域第一个角的坐标 |
%regen_corner2_<zone>% |
区域第二个角的坐标 |
%regen_timer_<zone>% |
下次再生前的剩余时间(分:秒) |
%regen_name_<zone>% |
区域的官方名称 |
⚠️ 如果存在 PlaceholderAPI,占位符将自动注册。无需额外配置。
✅ bStats
RegenSystem 使用 bStats 收集服务器数量、版本等基本统计数据。这有助于开发者随着时间的推移改进插件。
✅ 文件结构
plugins/
└── RegenSystem/
├── config.yml # 插件消息与前缀(请勿修改版本号!)
├── zone.yml # 区域定义:位置、延迟、启用标志
├── version.cache # 不要触碰此文件
└── zone.db # ? 方块数据存储(SQLite,由插件自动管理)
✅ zone.yml
此文件包含你区域的定义:它们的位置、延迟和状态。
global:
regen-enabled: true # 全局启用或禁用再生功能
zones:
zone1: # 替换为你自己的区域名称
pos1: world,100,64,100 # 长方体的第一个角 (x, y, z)
pos2: world,110,70,110 # 长方体的第二个角 (x, y, z)
regenDelay: 60 # 延迟时间(秒)
enabled: true # 如果为 false,该区域不会再生
flags: # 区域特定的标志
BLOCK_BREAK: true
ITEM_DROP: true
MOB_SPAWN: true
PVP: true
BLOCK_PLACE: true
MOB_DAMAGE: true
EXPLOSION: true
ITEM_PICKUP: true
✅ config.yml
⚠️ 请勿编辑 version 字段——它用于内部更新检测。
version: 3 # ⚠️ 请勿修改!
debug: false # 在日志中显示更多信息
prefix: "&6[RegenSystem] &r" # 插件消息中使用的前缀
updates:
check-interval: 12 # 检查更新的间隔(小时)
notify-admins: true # 是否通知管理员
✅ zone.db (SQLite)
存储每个区域的方块快照——快速、优化且安全。 请勿手动编辑——由插件自动管理。
? 安装步骤
-
将
RegenSystem-VERSION.jar放入你的plugins/文件夹中。 -
(可选)安装 PlaceholderAPI 以支持占位符功能。
-
启动你的服务器。
-
使用
/regen wand定义区域,并使用/regen save <name>进行激活。
⚠️ ? ARCHIVED PROJECT — NO LONGER MAINTAINED ? ⚠️
❗ This plugin is now archived and will NOT receive any future updates. ? Development has moved to a larger, more advanced project that will include RegenSystem and more features.
? If you are using this plugin, you can continue to do so, but no support or updates are guaranteed.
? A new project will be released in the future — stay tuned.
RegenSystem
A powerful, flexible block regeneration system designed for PvP Box, survival zones, or mining zones. Define cuboid areas and let them regenerate automatically over time – all with a single command.
✅ Versions
- ? Actively developed on Paper API 1.20.6+
- ⚡ Compatible with Paper / Spigot / Folia from 1.20.x → 1.21.x
- ⏳ Support for older Minecraft versions may arrive in the future
✅ Server Compatibility
- ✅ Paper — Fully supported and recommended
- ✅ Folia — Fully supported (region-safe scheduler, async-safe operations)
- ✅ Spigot — Supported (automatic fallbacks for missing APIs)
ℹ️ The plugin automatically adapts its behavior depending on the server platform
(Paper / Folia / Spigot) to ensure maximum compatibility and stability.
? Documentation
✅ Commands
| Command | Description |
|---|---|
/regen pos1 |
Set the first corner of the zone at your current location. |
/regen pos2 |
Set the second corner of the zone at your current location. |
/regen save <name> [delay] [f:flag=value]... |
Save a new zone with an optional regen delay (seconds) and optional flags. |
/regen reload [zone] |
Reload all zones, or a specific one if a name is provided. |
/regen delete <name> |
Delete a zone and its stored data. |
/regen snapshot <name> |
Update the stored state of a zone with the current blocks. |
/regen wand |
Receive a diamond axe to select pos1/pos2 with left/right click. |
/regen enable <all\name> |
Enable regen globally or for a specific zone. |
/regen disable <all\name> |
Disable regen globally or for a specific zone. |
/regen menu |
Opens the menu to modify options. |
/regen help [page] |
Show the help menu (3 pages available). |
/regen flag |
Show all available flags and their descriptions. |
/regen flag <zone> |
List all flags of a specific zone with their status. |
/regen flag <zone> <flag> <on\off> |
Enable or disable a specific flag for a zone. |
/regen lang <language> |
Set the plugin language. |
✅ Permissions
| Permission | Description | Default |
|---|---|---|
regensystem.* |
Grants all permissions above | OP |
regensystem.command |
Use the base /regen command |
OP |
regensystem.pos |
Set pos1 and pos2 using /regen pos1/pos2 |
OP |
regensystem.save |
Save zones via /regen save |
OP |
regensystem.reload |
Reload zones via /regen reload |
OP |
regensystem.delete |
Delete zones via /regen delete |
OP |
regensystem.snapshot |
Update zone data with /regen snapshot |
OP |
regensystem.wand |
Give yourself the selection axe via /regen wand |
OP |
regensystem.toggle |
Enable/disable regen with /regen enable/disable |
OP |
regensystem.menu |
Open menu via /regen menu |
OP |
regensystem.update |
Receive an update message on connection | OP |
regensystem.flag |
Allows you to manage flags with /regen flag |
OP |
regensystem.lang |
Allows you to set the language of the plugin with /regen lang |
OP |
? Use regensystem.* to quickly give full access to the plugin.
? Dependencies
- ✅ PlaceholderAPI (soft-depend, optional)
To enable placeholders, simply install PlaceholderAPI – the plugin will auto-detect it.
✅ Placeholders (via PlaceholderAPI)
If PlaceholderAPI is installed, you can use the following placeholders :
| Placeholder | Description |
|---|---|
%regen_zone_count% |
Total number of zones defined |
%regen_regen_enabled% |
Global regen status (enabled or disabled) |
%regen_enabled_<zone>% |
If regen is enabled for a specific zone |
%regen_delay_<zone>% |
Regen delay (in seconds) for a specific zone |
%regen_exists_<zone>% |
Returns "true" if the zone exists |
%regen_block_count_<zone>% |
Number of original blocks in zone |
%regen_corner1_<zone>% |
Coordinates of the first corner of the zone |
%regen_corner2_<zone>% |
Coordinates of the second corner of the zone |
%regen_timer_<zone>% |
Time remaining before next regeneration (mm:ss) |
%regen_name_<zone>% |
Official zone name |
⚠️ Placeholders are auto-registered if PlaceholderAPI is present. No extra config needed.
✅ bStats
RegenSystem uses bStats to collect basic stats like server count and version. This helps the developer improve the plugin over time.
✅ File Structure
plugins/
└── RegenSystem/
├── config.yml # Plugin messages & prefix (do NOT edit version !)
├── zone.yml # Zones definition : positions, delays, enabled flags
├── version.cache # Don't touch this file
└── zone.db # ? Block data storage (SQLite, auto-managed)
✅ zone.yml
This file contains the definitions for your zones : their position, delay, and status.
global:
regen-enabled: true # Enable or disable regeneration globally
zones:
zone1: # Replace with your own zone names
pos1: world,100,64,100 # First corner of the cuboid (x, y, z)
pos2: world,110,70,110 # Second corner of the cuboid (x, y, z)
regenDelay: 60 # Delay in seconds
enabled: true # If false, the zone won't regenerate
flags: # Zone-specific flags
BLOCK_BREAK: true
ITEM_DROP: true
MOB_SPAWN: true
PVP: true
BLOCK_PLACE: true
MOB_DAMAGE: true
EXPLOSION: true
ITEM_PICKUP: true
✅ config.yml
⚠️ Do not edit the version field – it’s used internally for updates.
version: 3 # ⚠️ Do not modify!
debug: false # For more information in the logs
prefix: "&6[RegenSystem] &r" # Prefix used in plugin messages
updates:
check-interval: 12 # In hours
notify-admins: true # To notify the admins
✅ zone.db (SQLite)
Stores block snapshots for each zone – fast, optimized, and safe. Do not edit manually – managed automatically by the plugin.
? Installation
-
Drop
RegenSystem-VERSION.jarinto yourplugins/folder. -
(Optional) Install PlaceholderAPI for placeholder support.
-
Start your server.
-
Use
/regen wandto define zones and/regen save <name>to activate.
下载 RegenSystem
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 RegenSystem
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 RegenSystem
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 RegenSystem
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 RegenSystem
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 RegenSystem
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 RegenSystem
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 RegenSystem
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 RegenSystem
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 RegenSystem
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
[v2.0.3] – 2026-01-20
? 亮点
本次发布引入了全新的公共 API 架构,并为外部插件奠定了稳定的基础。
⚠️ 此版本包含对插件开发者的破坏性变更,
但对服务器管理员和玩家保持完全向后兼容。
这是未来插件开发的推荐基础版本。
? API(公共且稳定)
✅ 新增
- 引入了完全分离的 API 模块 (
regensystem-api) - 添加了官方 API 入口点:
RegenSystemAPI
- 添加了明确的 API 版本控制:
API_VERSIONAPI_MAJOR,API_MINOR,API_PATCH
- 引入了新的核心 API 契约:
ZoneManagerZoneZoneFlagRegenResult
? 事件 API
所有区域生命周期事件现在均已正式公开并记录在案:
ZoneCreateEvent(可取消)ZoneDeleteEvent(可取消)ZoneReloadEvent(可取消)ZonePreRegenEvent(可取消)ZonePostRegenEvent(不可取消)ZoneFlagChangeEvent(可取消)
?️ API 稳定性与安全性
新增
- 公共 API 与内部实现之间的清晰分离
- 在非公共方法上使用
@ApiStatus.Internal - 在 API 事件上使用
@ApiStatus.NonExtendable - 严格的 API 边界(禁止访问核心代码)
保证
- API 在同一主版本号内保持稳定
- 无需反射或不安全的钩子
- 安全的事件驱动扩展模型
❗ 破坏性变更(插件开发者)
⚠️ 是的 – API 存在破坏性变更
- API 全面重构
- 旧版 API 契约不兼容
- 针对
< 2.0.3版本的插件必须更新
所有外部插件均需进行迁移。
✅ 无破坏性变更(服务器管理员)
- 现有区域得以保留
- 配置文件未更改
- 命令和权限未更改
- 数据库格式未更改
服务器管理员无需采取任何行动。
? 兼容性
- Minecraft: 1.20.x → 1.21.x
- 平台:
- Paper ✅
- Folia ✅
- Spigot ✅
- Java: 21+
? 实验性 API
- 本次发布未暴露任何实验性 API
- 未来的实验性 API 将位于:
fr.darklash.regensystem.api.experimental
? 依赖 (JitPack)
compileOnly("com.github.DarkLashDev:RegenSystem:v2.0.3")
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧