V AFKZone

插件

· 作者 ReakZ

V-AfkZone - 集成 WorldGuard 的挂机区域追踪器,支持可配置奖励。

0 本站下载 0 关注 更新于 7 个月前

最新 1.0.0 · 26.1.2 · Bukkit / Paper

一键开服(送7天)

?️ V-AfkZone

Paper 服务器的定时挂机奖励

适用于 Paper 1.21.1+ 服务器的简易垂直移动方案


✨ 功能特性

  • ? WorldGuard 集成 — 使用现有的 WorldGuard 区域创建挂机区
  • ? 全图挂机 — 基于权限的奖励机制,可在指定区域外生效
  • ⏱️ 灵活计时器 — 可按区域或配置文件自定义奖励间隔
  • ? 视觉反馈 — 支持 Boss 栏、动作栏、标题和聊天消息
  • ?️ 管理 GUI — 通过 /afkzone 命令进行游戏内管理
  • ? PlaceholderAPI — 完整扩展支持,提供 13+ 个占位符
  • ? 自定义事件 — 提供可取消事件的开发者 API
  • ? 自动迁移 — 从旧版配置无缝升级
  • ⚡ 零延迟 — 优化的调度器与可配置的间隔时间
  • ? 受保护区域 — 通过区域优先级系统防止重复获得奖励

? 安装指南

  1. 下载 最新的 V-AfkZone-1.0.0.jar
  2. 放置 jar 文件到服务器的 plugins/ 文件夹中
  3. 确保 已安装 WorldGuard 和 WorldEdit
  4. 启动 服务器以生成默认配置文件
  5. 配置 plugins/V-AfkZone/area/ 中的区域
  6. 重载 插件,执行 /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% 活跃会话数量

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源