原创 付费 娱乐 虚空挖矿活动系统 0.1

插件介绍

虚空挖矿活动系统是一款为Minecraft服务器设计的定时活动插件，为玩家提供了一种全新的挖矿体验。插件创建了特殊的"虚空矿机"，玩家需要合作激活这些矿机以生成各种矿物。同时，玩家还需要防御虚空掠夺者的入侵，保护自己辛苦挖掘的矿物资源。这款插件为服务器增添了丰富的互动内容和团队合作机会。



主要功能

- 定时活动：每日固定时间自动开启，持续指定时长

- 虚空矿机：特殊的矿物生成装置，需要玩家合作激活

- 能量系统：矿机拥有有限能量，随时间消耗，最终耗尽

- 矿物生成：激活的矿机会定期生成各种矿物，包括稀有矿物

- 虚空掠夺者：会定期出现并尝试偷取玩家的矿物

- 粒子效果：矿机工作时会显示特殊粒子效果

- 数据统计：支持PlaceholderAPI，提供丰富的数据变量

- 自动重置：活动开始时可选择重置能量耗尽的矿机



命令列表

| 命令 | 描述 | 权限 |

|------|------|------|

| `/xkkj 获取` | 获取一个虚空矿机物品 | huodongvoidmining.admin |

| `/xkkj 启动` | 手动启动虚空挖矿活动 | huodongvoidmining.admin |

| `/xkkj 停止` | 手动停止虚空挖矿活动 | huodongvoidmining.admin |

| `/xkkj 状态` | 查看当前活动状态和矿机信息 | huodongvoidmining.admin |

| `/xkkj 重载` | 重新加载插件配置 | huodongvoidmining.admin |

| `/xkkj 变量` | 查看所有可用的PlaceholderAPI变量 | huodongvoidmining.admin |



权限节点

| 权限 | 描述 | 默认 |

|------|------|------|

| `huodongvoidmining.admin` | 允许使用所有管理命令 | op |



PlaceholderAPI 占位符

插件提供了丰富的PlaceholderAPI变量，可以在任何支持PAPI的插件中使用：



活动状态相关变量:

- `%voidmining_activity_running%` - 活动是否正在运行（返回"是"或"否"）

- `%voidmining_activity_time_remaining%` - 活动剩余时间（格式：x小时y分钟）

- `%voidmining_activity_time_next%` - 下次活动开始时间（格式：yyyy-MM-dd HH:mm）



矿机相关变量:

- `%voidmining_machines_count%` - 矿机总数量

- `%voidmining_machines_active_count%` - 激活的矿机数量

- `%voidmining_machines_working_count%` - 正在工作的矿机数量

- `%voidmining_machine_initial_energy%` - 矿机初始能量

- `%voidmining_machine_energy_consumption%` - 矿机每秒能量消耗

- `%voidmining_machine_ore_generation%` - 矿机每秒矿物生成



玩家附近矿机变量:

- `%voidmining_nearest_machine_distance%` - 最近矿机距离

- `%voidmining_nearest_machine_energy%` - 最近矿机能量

- `%voidmining_nearest_machine_energy_percent%` - 最近矿机能量百分比

- `%voidmining_nearest_machine_active%` - 最近矿机是否激活

- `%voidmining_nearest_machine_working%` - 最近矿机是否正在工作

- `%voidmining_nearest_machine_depleted%` - 最近矿机是否能量耗尽



活动流程



活动开启

1. 每日14:00自动开启活动(可在配置中修改)

2. 活动持续120分钟(可配置)

3. 全服发送消息提示活动开始

4. 所有矿机被激活，能量耗尽的矿机可选择重置



矿机工作

1. 玩家需要在矿机10格范围内保持至少3名玩家(可配置)

2. 满足条件的矿机会开始工作，显示粒子效果

3. 工作中的矿机每秒消耗10点能量(可配置)

4. 矿机每秒生成10个矿物(可配置)，散落在周围3格范围内

5. 生成的矿物会短暂发光，10秒后消失(可配置)



虚空掠夺者

1. 活动期间每60秒(可配置)会生成10个虚空掠夺者

2. 掠夺者会尝试偷取玩家附近的矿物

3. 玩家需要击退掠夺者保护矿物



活动结束

1. 活动时间结束或手动停止时，所有矿机停止工作

2. 能量耗尽的矿机会保持耗尽状态，直到下次活动开始时重置



配置文件

插件提供了详细的配置选项，主要包括：



活动设置

- 开始时间和持续时间

- 是否重置能量耗尽的矿机

- 重置矿机的能量阈值



矿机设置

- 初始能量值

- 能量消耗速率

- 矿物生成速率

- 激活所需的玩家数量

- 粒子效果参数

- 矿物散落范围和发光时间



虚空掠夺者设置

- 生成间隔和数量

- 生成范围和偷取范围

- 偷取速率



矿物列表及权重

- 可自定义生成的矿物类型

- 调整各类矿物的生成权重



依赖插件

- 必需: Paper 1.20.1

- 可选: PlaceholderAPI (用于显示数据占位符)



技术信息

- 支持版本: 1.20.1+

- API版本: 1.20

- 使用Java 17开发



使用方法

1. 管理员使用 `/xkkj 获取` 获取矿机物品

2. 在适当位置放置矿机

3. 等待每日活动自动开始，或使用 `/xkkj 启动` 手动开始

4. 组织玩家在矿机周围合作激活矿机

5. 收集生成的矿物并防御虚空掠夺者的入侵

6. 活动结束后，矿机会自动停止工作



---

感谢您选择虚空挖矿活动系统插件！如有任何问题或建议，请随时联系我们。