KeyAllZ - Folia supported - KeyAllZ 全服发钥匙插件（支持 Folia）

KeyAllZ 是一款可自动发放全服奖励的插件，让服务器奖励活动更有趣、更省心，并支持高度自定义。

⭐插件简介

KeyAllZ – Automated Key Distribution v3.0.0

作者：Infnox @ Zentari

让全服奖励发放变得有趣且自动化，并提供灵活的自定义能力。

✨功能特性

• 多种 KeyAll 类型：可创建投票钥匙、赞助者钥匙、活动奖励，或任意自定义 KeyAll。
• 定时事件：自动为所有在线玩家执行命令。
• 固定或随机间隔：支持稳定计时或随机奖励间隔。
• 玩家命令与控制台命令：可使用 PLAYER: 为每位玩家分别执行命令，或由控制台全局执行。
• 消息、标题与粒子效果：可自定义聊天消息、actionbar、title、声音和粒子效果。
• 提醒功能：自动向玩家重复发送提醒。
• PlaceholderAPI 支持：支持带计时器的动态占位符。
• 轻量且高效：对性能影响极小。

🎮推荐依赖

• PlaceholderAPI
• 用于倒计时占位符功能，属必需依赖。

🔧文档

• 你也可以查看 WIKI 获取更完善的文档说明。

💡安装方法

• 下载 KeyAllZ.jar v3.0.0
• 将其放入 /plugins
• 重启服务器
• 配置 config.yml
• 使用 /keyallz reload 应用更改

⭐Redis

可选的多服支持

KeyAllZ 可通过 Redis 在多台服务器之间同步计时器。

启用后

• 计时器会在整个服务器网络中保持同步
• 玩家无法通过切换服务器重复领取奖励
• 每台服务器只处理自身在线玩家，避免重复发放
• 服务器重启或故障后，计时器会自动恢复

注意

• 该功能目前为测试版（beta build），并且仅在 Modrinth 提供。

🎮配置示例

YAML

keyalls:
  example:
    title: "<green>You received a KeyAll reward!"
    actionbar: "<yellow>Enjoy your free key!"
    chat: "<gray>[KeyAll] <aqua>Congrats %player%, you got a reward!"
    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>Don't forget to claim your KeyAll! Time left: %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 – 为 example 设置每 30 秒提醒一次
• /keyallz list – 查看当前活动计时器
• /keyallz reload – 重载配置并停止所有计时器

❓注意事项

• console-commands 中使用 PLAYER: 前缀时，会为每位在线玩家分别执行该命令。
• 计时器会执行玩家命令和控制台命令。
• 循环计时器在结束后会自动重新开始。
• 提醒会按已配置的时间间隔通知玩家。
• 可使用 /keyallz list 监控当前活动计时器。

💡权限

• keyallz.admin – 使用以上所有命令所需权限

⭐性能表现

• 近期构建版本已在 Folia 和 Paper 的高玩家数量环境中进行测试。
• 测试结果表明，该插件在高负载下依然保持稳定，且相比常见的 KeyAll 插件表现良好。

✨支持与反馈

• 加入 Discord 获取支持与更新：

https://discord.gg/e6uXVjp4MX

• 开发者：Infnox @ Zentari
• 版本：3.0.0