KeyAllZ – 自动密钥分发
通过灵活的计时器、命令和完全可自定义的效果,自动化全服奖励。
功能
- 创建多种类型的 KeyAll,如投票密钥、捐赠者密钥、活动奖励或任何自定义奖励
- 运行定时事件,为所有在线玩家执行命令
- 使用固定或随机间隔,实现一致或动态的奖励发放
- 针对每个玩家或从控制台全局执行命令
- 完全自定义聊天消息、动作栏、标题、音效和粒子效果
- 内置重复提醒功能,通知玩家
- 支持 PlaceholderAPI 集成,提供实时倒计时占位符
- 可选 Redis 支持,用于多服务器同步计时器
- 经过优化且轻量级,对性能影响极小,即使在大型网络中也能保持高效
推荐依赖项
PlaceholderAPI
PlaceholderAPI 是倒计时和时间相关占位符所必需的。
文档可在 Wiki 上查看:
安装
- 下载
KeyAllZ.jar(v3.x.x) - 将 jar 文件放入
/plugins目录 - 重启服务器
- 根据需要编辑
config.yml - 运行
/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 服务器获取支持和更新:
KeyAllZ – Automated Key Distribution
Automate server-wide rewards with flexible timers, commands, and fully customizable effects.
Features
- Create multiple KeyAll types such as vote keys, donor keys, event rewards, or any custom reward
- Run timed events that execute commands for all online players
- Use fixed or randomized intervals for consistent or dynamic rewards
- Execute commands per player or globally from the console
- Fully customizable chat messages, action bars, titles, sounds, and particle effects
- Built-in repeating reminders for players
- PlaceholderAPI integration with live countdown placeholders
- Optional Redis support for multi-server synced timers
- Optimized and lightweight with minimal performance impact, even on large networks
Recommended Dependency
PlaceholderAPI
PlaceholderAPI is required for countdown and time-based placeholders.
Documentation is available on the Wiki:
Installation
- Download
KeyAllZ.jar(v3.x.x) - Place the jar file into the
/pluginsdirectory - Restart the server
- Edit
config.ymlto your needs - Run
/keyallz reloadto apply changes
Redis (Optional Multi-Server Support)
KeyAllZ can sync timers across multiple servers using Redis.
When enabled:
- Timers stay in sync across your entire network
- Players cannot claim rewards multiple times by switching servers
- Each server handles its own online players without duplication
- Timers recover automatically after restarts or server failures
Configuration
redis:
enabled: false
host: "localhost"
port: 6379
password: ""
database: 0
# Key prefix for all Redis keys. Change this if you share Redis with other plugins.
key-prefix: "keyallz"
# Unique ID for this server in the cluster. Leave empty to auto-generate.
server-id: ""
Set enabled to true and configure your Redis connection.
All servers must use:
- The same Redis connection
- The same KeyAll definition names
Rewards can differ per server.
Configuration Example
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 Placeholders
%keyallz_timer_<name>%shows the full remaining time (for example:1d 2h 10m 5s)%keyallz_days_<name>%shows remaining days%keyallz_hours_<name>%shows remaining hours%keyallz_minutes_<name>%shows remaining minutes%keyallz_secs_<name>%or%keyallz_seconds_<name>%shows remaining seconds%keyallz_time_short_<name>%shows time inHH:mm:ssformat%keyallz_remaining_<name>%shows a condensed remaining time such as10m 30s
Commands
/keyallz start <definition> <seconds> [loop]starts a timer and optionally enables looping/keyallz stop <definition>stops a running timer/keyallz loop <definition> <true|false>enables or disables looping/keyallz remind <definition> <intervalSeconds>sets a repeating reminder interval/keyallz listshows all active timers with remaining time/keyallz reloadreloads the configuration and stops all timers
Usage Examples
/keyallz start votekey 300 truestarts the votekey timer for 5 minutes and loops it/keyallz stop votekeystops the votekey timer/keyallz loop donorkey falsedisables looping for donorkey/keyallz remind example 30sends reminders every 30 seconds/keyallz listdisplays all active timers/keyallz reloadreloads the plugin configuration
Notes
- Console commands with the
PLAYER:prefix are executed individually for each online player - Both player commands and console commands are executed when a timer finishes
- Looping timers automatically restart after completion
- Reminders notify players at the configured interval
- Use
/keyallz listto monitor running timers
Permissions
keyallz.admingrants access to all KeyAllZ commands
Support and Feedback
Join the Discord server for support and updates:
下载 KeyAllZ
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 KeyAllZ
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 KeyAllZ
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 KeyAllZ
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 KeyAllZ
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 KeyAllZ
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 KeyAllZ
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
- 修复了
plugin.yml中缺失的keyallz.admin权限。keyallz.use保持不变。添加了对 PlaceholderAPI 的软依赖。 - 在周期重置时清除已领取的奖励钥匙,以防止内存堆积。
- 修复了在多服务器环境中 Redis
END或CYCLE_RESET事件后奖励重复执行的问题。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧