?️ V-AfkZone
Paper 服务器的定时挂机奖励
适用于 Paper 1.21.1+ 服务器的简易垂直移动方案
✨ 功能特性
- ? WorldGuard 集成 — 使用现有的 WorldGuard 区域创建挂机区
- ? 全图挂机 — 基于权限的奖励机制,可在指定区域外生效
- ⏱️ 灵活计时器 — 可按区域或配置文件自定义奖励间隔
- ? 视觉反馈 — 支持 Boss 栏、动作栏、标题和聊天消息
- ?️ 管理 GUI — 通过
/afkzone命令进行游戏内管理 - ? PlaceholderAPI — 完整扩展支持,提供 13+ 个占位符
- ? 自定义事件 — 提供可取消事件的开发者 API
- ? 自动迁移 — 从旧版配置无缝升级
- ⚡ 零延迟 — 优化的调度器与可配置的间隔时间
- ? 受保护区域 — 通过区域优先级系统防止重复获得奖励
? 安装指南
- 下载 最新的
V-AfkZone-1.0.0.jar - 放置 jar 文件到服务器的
plugins/文件夹中 - 确保 已安装 WorldGuard 和 WorldEdit
- 启动 服务器以生成默认配置文件
- 配置
plugins/V-AfkZone/area/中的区域 - 重载 插件,执行
/afkzone reload或重启服务器
? 快速上手
创建第一个挂机区
# 1. 首先创建一个 WorldGuard 区域
/region define spawn_afk
# 2. 创建区域配置
/afkzone create zone spawn_afk
# 3. 编辑 plugins/V-AfkZone/area/spawn_afk.yml
启用全图挂机
# 1. 创建配置文件
/afkzone create everywhere afk
# 2. 授予玩家权限
/lp user <player> permission set vafkzone.everywhere.use true
# 3. 重载插件
/afkzone reload
⌨️ 命令列表
| 命令 | 权限 | 描述 |
|---|---|---|
/afkzone |
vafkzone.admin |
打开管理 GUI |
/afkzone menu |
vafkzone.admin |
打开主菜单 GUI |
/afkzone reload |
vafkzone.admin |
重载所有配置 |
/afkzone info |
vafkzone.info |
显示您当前的活跃会话 |
/afkzone sessions |
vafkzone.admin |
显示所有活跃会话 |
/afkzone sessions <player> |
vafkzone.admin |
显示玩家的会话 |
/afkzone create zone <name> |
vafkzone.admin |
创建区域配置 |
/afkzone create everywhere <name> |
vafkzone.admin |
创建全图配置文件 |
/afkzone edit <name> |
vafkzone.admin |
打开编辑器(自动检测类型) |
/afkzone edit zone <name> |
vafkzone.admin |
打开区域编辑器 |
/afkzone edit everywhere <name> |
vafkzone.admin |
打开配置文件编辑器 |
/afkzone delete <name> |
vafkzone.admin |
删除区域/配置文件 |
/afkzone delete zone <name> |
vafkzone.admin |
删除区域 |
/afkzone delete everywhere <name> |
vafkzone.admin |
删除配置文件 |
/afkzone setup <name> |
vafkzone.admin |
创建区域的快捷方式 |
/afkzone everywhere <name> |
vafkzone.admin |
创建全图配置的快捷方式 |
? 权限说明
| 权限节点 | 默认值 | 描述 |
|---|---|---|
vafkzone.admin |
op |
完全管理访问权限 |
vafkzone.info |
true |
查看自己的挂机信息 |
vafkzone.use |
true |
使用挂机区域 |
vafkzone.everywhere.use |
false |
使用默认的全图配置文件 |
? 提示: 自定义的全图配置文件可以使用任何权限节点(例如
vafkzone.everywhere.vip)
⚙️ 配置说明
区域配置 (area/spawn_afk.yml)
### 区域标识
zoneName: spawn_afk
worldGuardRegion: spawn_afk
worldName: world
### 奖励设置
requiredSeconds: 60
enabled: true
### 视觉反馈
show-bossbar: true
show-actionbar: true
show-reward-received-message: true
### 音效
sound: false
sound-type: level_up
### 防护 - 在此区域内禁用全图挂机
disable-afk-everywhere: false
### 当触发奖励时以控制台身份执行的命令
rewardCommands:
- give %player% diamond 1
- broadcast %player% earned a reward from AFK zone spawn_afk!
全图配置文件 (everywhere/afk.yml)
enabled: true
permission: vafkzone.everywhere.use
priority: 0
### 移动检测
walking: true
idle-threshold-seconds: 60
### 奖励设置
requiredSeconds: 60
### 视觉反馈
show-bossbar: true
show-actionbar: true
show-reward-received-message: true
### 音效
sound: false
sound-type: level_up
### 命令
rewardCommands:
- give %player% diamond 1
- broadcast %player% earned a reward from AFK Everywhere!
全局配置 (config.yml)
settings:
check-interval-seconds: 1 # 调度器检查频率
show-bossbar: true # 总 Boss 栏开关
notify-admin-on-reward: false # 向在线管理员记录日志
debug: false # 额外的控制台日志输出
messages:
### 支持 MiniMessage 格式
prefix: "<gradient:#3b82f6:#8b5cf6>[V-AfkZone]</gradient> "
? PlaceholderAPI 支持
当安装 PlaceholderAPI 时,vafkzone 扩展将自动注册:
| 占位符 | 描述 |
|---|---|
%vafkzone_in_zone% |
是否在任意区域内 (true/false) |
%vafkzone_zone_name% |
当前区域名称 |
%vafkzone_zone_names% |
所有活动区域名称 |
%vafkzone_next_reward% |
距离下一次奖励的秒数 |
%vafkzone_rewards_total% |
获得的奖励总数 |
%vafkzone_time_in_zone% |
在当前区域内的停留秒数 |
%vafkzone_required_seconds% |
该区域所需的秒数 |
%vafkzone_in_everywhere% |
是否在全图模式下 (true/false) |
%vafkzone_everywhere_name% |
活动的配置文件名称 |
%vafkzone_everywhere_next_reward% |
距离全图奖励的秒数 |
%vafkzone_everywhere_rewards_total% |
全图奖励总数 |
%vafkzone_any_active% |
是否有任何挂机状态激活 (true/false) |
%vafkzone_active_count% |
活跃会话数量 |
你是这个资源的作者?登录后可认领此资源。
相似资源
数据包事件PacketEvents
retrooper
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
前置科技
27
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
ProAuthMeLogin
3623813757
通过对话框或铁砧界面帮助你的 Anthme
实用
16
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
Vivecraft Spigot Extension
fayer3
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
前置实用
12
旅行地图
mysticdrew
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
冒险实用
12
评论 0
登录后参与评分
还没有评论,来抢沙发吧