KeyAllZ

插件

· 作者 zentaristudio

一个关键插件,通过定时奖励让玩家保持参与感

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

最新 3.3.2 · 1.21.11 · Folia / Paper

一键开服(送7天)

KeyAllZ – 自动密钥分发

通过灵活的计时器、命令和完全可自定义的效果,自动化全服奖励。


功能

  • 创建多种类型的 KeyAll,如投票密钥、捐赠者密钥、活动奖励或任何自定义奖励
  • 运行定时事件,为所有在线玩家执行命令
  • 使用固定或随机间隔,实现一致或动态的奖励发放
  • 针对每个玩家或从控制台全局执行命令
  • 完全自定义聊天消息、动作栏、标题、音效和粒子效果
  • 内置重复提醒功能,通知玩家
  • 支持 PlaceholderAPI 集成,提供实时倒计时占位符
  • 可选 Redis 支持,用于多服务器同步计时器
  • 经过优化且轻量级,对性能影响极小,即使在大型网络中也能保持高效

推荐依赖项

PlaceholderAPI

PlaceholderAPI 是倒计时和时间相关占位符所必需的。

文档可在 Wiki 上查看:


安装

  1. 下载 KeyAllZ.jar (v3.x.x)
  2. 将 jar 文件放入 /plugins 目录
  3. 重启服务器
  4. 根据需要编辑 config.yml
  5. 运行 /keyallz reload 以应用更改

Redis(可选的多服务器支持)

KeyAllZ 可以使用 Redis 在多个服务器之间同步计时器。

启用后:

  • 计时器在整个服务器网络中保持同步
  • 玩家无法通过切换服务器多次领取奖励
  • 每个服务器独立处理其在线玩家,避免重复
  • 重启或服务器故障后,计时器会自动恢复

配置

redis:
  enabled: false
  host: "localhost"
  port: 6379
  password: ""
  database: 0
  # 所有 Redis 键的前缀。如果与其他插件共享 Redis,请修改此项。
  key-prefix: "keyallz"
  # 此服务器在集群中的唯一 ID。留空则自动生成。
  server-id: ""

将 enabled 设置为 true 并配置您的 Redis 连接。

所有服务器必须使用:

  • 相同的 Redis 连接
  • 相同的 KeyAll 定义名称

奖励可以因服务器而异。


配置示例

keyalls:
  example:
    title: "<green>您获得了 KeyAll 奖励!"
    actionbar: "<yellow>享受您的免费密钥!"
    chat: "<gray>[KeyAll] <aqua>恭喜 %player%,您获得了奖励!"
    sound: "minecraft:entity.player.levelup"
    sound-volume: 1.0
    sound-pitch: 1.0

    player-commands:
      - "warp crates"
      - "say I just got a key!"

    console-commands:
      - "PLAYER: crate key give %player% test 1"

    permission: "keyall.receive.example"

    reminders:
      enabled: true
      interval: 600
      message: "<yellow>别忘了领取您的 KeyAll!剩余时间:%remaining-time%"

PlaceholderAPI 占位符

  • %keyallz_timer_<name>% 显示完整的剩余时间(例如:1d 2h 10m 5s)
  • %keyallz_days_<name>% 显示剩余天数
  • %keyallz_hours_<name>% 显示剩余小时数
  • %keyallz_minutes_<name>% 显示剩余分钟数
  • %keyallz_secs_<name>% 或 %keyallz_seconds_<name>% 显示剩余秒数
  • %keyallz_time_short_<name>% 以 HH:mm:ss 格式显示时间
  • %keyallz_remaining_<name>% 显示简化的剩余时间,如 10m 30s

命令

  • /keyallz start <definition> <seconds> [loop] 启动计时器,并可选择启用循环
  • /keyallz stop <definition> 停止正在运行的计时器
  • /keyallz loop <definition> <true|false> 启用或禁用循环
  • /keyallz remind <definition> <intervalSeconds> 设置重复提醒间隔
  • /keyallz list 显示所有活跃计时器及其剩余时间
  • /keyallz reload 重新加载配置并停止所有计时器

使用示例

  • /keyallz start votekey 300 true 启动 votekey 计时器,持续 5 分钟并循环
  • /keyallz stop votekey 停止 votekey 计时器
  • /keyallz loop donorkey false 禁用 donorkey 的循环功能
  • /keyallz remind example 30 每 30 秒发送一次提醒
  • /keyallz list 显示所有活跃计时器
  • /keyallz reload 重新加载插件配置

注意事项

  • 带有 PLAYER: 前缀的控制台命令会为每个在线玩家单独执行
  • 计时器结束时,玩家命令和控制台命令都会执行
  • 循环计时器在完成时会自动重新启动
  • 提醒会按配置的间隔通知玩家
  • 使用 /keyallz list 监控正在运行的计时器

权限

  • keyallz.admin 授予对所有 KeyAllZ 命令的访问权限

支持与反馈

加入 Discord 服务器获取支持和更新:

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源