⏰ Keville — Minecraft 服务器的智能消息插件
Keville 是一款为 Minecraft 服务器打造的强大、灵活且轻量级的消息插件。
它允许你根据时间、条件、触发器和目标自动向玩家发送消息,无需命令刷屏或手动干预。
无论是简单的提醒还是复杂的基于条件的公告,Keville 都能确保在正确的时刻将正确的信息发送给正确的玩家。
⚠️ 状态:BETA(测试版)
Keville 目前处于测试阶段。
功能已稳定,但配置结构和行为可能仍在演变中。
欢迎提供反馈和错误报告!
✨ 核心功能
? 定时消息
使用简单且易读的配置文件,在指定时间发送消息。
- 使用24小时制 (HH:mm) 安排消息
- 可限制执行日期(特定几天或所有天)
- 支持多种消息类型:
- 聊天栏 (Chat)
- 动作栏 (Actionbar)
- 标题 (Title)
- 每条消息可选声音
- 配置完成后完全自动化
适用场景:
? 循环消息(基于游戏时长)
根据 Minecraft 游戏时长以固定间隔发送消息。
- 间隔单位为 Minecraft 秒(20 tick = 1 秒)
- 可限制特定天数
- 支持随机消息和声音
- 可选条件和目标
适用场景:
⚡ 触发式消息
当条件变为真时,仅发送一次消息。
- 仅在条件从 假 → 真 变化时触发
- 不会刷屏或循环
- 使用与定时器和循环器相同的消息系统
- 可执行预定义的自定义命令
适用场景:
- 在线人数里程碑
- 基于世界的警报
- 特殊服务器状态(繁忙时段、活动等)
? 条件系统
Keville 包含一个强大且可复用的条件引擎。
- 条件分组并可复用
- 组内所有条件必须同时为真
- 支持使用以下方式进行比较:
- 内置占位符 (
{online}, {world}, {time} 等)
- PlaceholderAPI 占位符 (
%player_level%, %vault_balance% 等)
- 支持的运算符:
示例用例:
- 仅当在线玩家数量足够时发送消息
- 针对特定世界
- 基于玩家属性或权限触发消息
? 目标群体
精确控制谁接收消息。
目标群体是可复用的,并支持:
- 所有玩家
- 特定世界(支持 Multiverse-Core)
- 权限节点(支持 LuckPerms)
- LuckPerms 用户组
- 单个玩家
目标群体可应用于定时、循环和触发式消息。
? 自定义命令
定义可复用的消息操作,并动态触发它们。
- 自定义命令可以发送消息、播放声音以及应用条件和目标
- 消息和声音可以随机选择
- 可在触发式消息中引用
这避免了代码重复,使复杂设置保持整洁且易于维护。
? 插件集成
Keville 可与流行的服务器插件无缝集成:
- PlaceholderAPI — 高级动态占位符
- Multiverse-Core — 基于世界的目标和条件
- LuckPerms — 基于权限和用户组的靶向
? 时间与时区支持
Keville 在各种环境中都能正确处理时间。
- 可配置的 IANA 时区
- 可选的 NTP 同步以确保无漂移的准确性
- 重启后行为一致
? 日志记录
可选地记录所有发送的消息。
- 完全可配置的日志模板
- 包含如下占位符:
{time}, {section}, {type}, {player}, {message}
- 适用于管理、审计或调试
⌨ 命令
Keville 提供了一个简洁的命令界面:
/keville schedule — 创建定时消息
/keville message — 手动发送消息
/keville conditions — 列出条件组
/keville today — 查看今天的定时消息
/keville debug — 检查内部状态
/keville reload — 重新加载配置
- 别名:
/kev
每个命令都支持权限控制和 OP 覆盖。
⚙️ 轻量级且适合生产环境
Keville 的设计目标是:
- 易于配置
- 性能开销极低
- 后台安静运行
- 即使在繁忙的服务器上也能可靠运行
? 特别注意事项
Keville 目前处于 BETA(测试版) 阶段。
- 配置格式可能会发生变化
- 新功能正在积极开发中
- 非常感谢您的反馈
- 该插件在您的服务器上显示的名称为 kwallieKeville
? 需要帮助?发现问题?
您可以通过 pascal@boschma.wtf 联系我。我会尽快为您提供帮助。如果您发现了问题,也请告诉我!
⏰ Keville — Smart Messaging for Minecraft Servers
Keville is a powerful, flexible, and lightweight messaging plugin for Minecraft servers.
It allows you to send messages to players automatically based on time, conditions, triggers, and targets — without command spam or manual intervention.
From simple reminders to complex, condition-based announcements, Keville ensures the right message reaches the right players at the right moment.
⚠️ Status: BETA
Keville is currently in beta.
Features are stable, but configuration structure and behavior may still evolve.
Feedback and bug reports are very welcome!
✨ Core Features
? Scheduled Messages
Send messages at specific times using a simple and readable configuration.
- Schedule messages using 24-hour time format (HH:mm)
- Limit execution to specific days (or all days)
- Supports multiple message types:
- Optional sounds per message
- Fully automated once configured
Perfect for:
- Daily announcements
- Event reminders
- Rule notices
- Server-wide alerts
? Repeater Messages (Playtime-Based)
Send messages at a fixed interval based on Minecraft playtime.
- Interval defined in Minecraft seconds (20 ticks = 1 second)
- Can be limited to specific days
- Supports random messages and sounds
- Optional conditions and targets
Great for:
- Vote reminders
- Tips & hints
- Repeating informational messages
⚡ Triggered Messages
Send messages once when conditions become true.
- Fires only when conditions change from false → true
- Does not spam or loop
- Uses the same message system as scheduler & repeater
- Can execute a predefined custom command
Ideal for:
- Player count milestones
- World-based alerts
- Special server states (busy hours, events, etc.)
? Conditions System
Keville includes a powerful and reusable conditions engine.
- Conditions are grouped and reusable
- All conditions in a group must be true
- Supports comparisons using:
- Built-in placeholders (
{online}, {world}, {time}, etc.)
- PlaceholderAPI placeholders (
%player_level%, %vault_balance%, etc.)
- Supported operators:
Example use cases:
- Only send messages when enough players are online
- Target specific worlds
- Trigger messages based on player stats or permissions
? Target Groups
Precisely control who receives messages.
Target groups are reusable and support:
- All players
- Specific worlds (Multiverse-Core supported)
- Permissions (LuckPerms supported)
- LuckPerms groups
- Individual players
Targets can be applied to scheduled, repeater, and triggered messages.
? Custom Commands
Define reusable message actions and trigger them dynamically.
- Custom commands can send messages, play sounds, and apply conditions/targets
- Messages and sounds can be randomly selected
- Can be referenced from triggered messages
This avoids duplication and keeps complex setups clean and maintainable.
? Plugin Integrations
Keville integrates seamlessly with popular server plugins:
- PlaceholderAPI — advanced dynamic placeholders
- Multiverse-Core — world-aware targeting and conditions
- LuckPerms — permissions and group-based targeting
? Time & Timezone Support
Keville handles time correctly across environments.
- Configurable IANA timezone
- Optional NTP synchronization for drift-free accuracy
- Consistent behavior across restarts
? Logging
Optional logging of all sent messages.
- Fully configurable log template
- Includes placeholders like:
{time}, {section}, {type}, {player}, {message}
- Useful for moderation, auditing, or debugging
⌨ Commands
Keville includes a clean command interface:
/keville schedule — create scheduled messages
/keville message — send messages manually
/keville conditions — list condition groups
/keville today — see today’s scheduled messages
/keville debug — inspect internal state
/keville reload — reload configuration
- Alias:
/kev
Each command supports permissions and OP overrides.
⚙️ Lightweight & Production-Ready
Keville is designed to be:
- Easy to configure
- Lightweight on performance
- Quiet in the background
- Reliable even on busy servers
? Take some special notes
Keville is currently in BETA.
- Configuration format may evolve
- New features are actively being developed
- Feedback is highly appreciated
- The Plugin is known on your server as kwallieKeville
? Help needed? Issue found?
You can contact me at pascal@boschma.wtf. I'll help you as soon as I can. If you find an issue, please let me know too!
评论 0
登录后参与评分
还没有评论,来抢沙发吧