# \u23f0 Keville \u2014 Smart Messaging for Minecraft Servers<\/p>\n
Keville is a **powerful, flexible, and lightweight messaging plugin** for Minecraft servers.
\nIt allows you to send messages to players automatically based on **time, conditions, triggers, and targets** \u2014 without command spam or manual intervention.<\/p>\n
From simple reminders to complex, condition-based announcements, Keville ensures **the right message reaches the right players at the right moment**.<\/p>\n
> \u26a0\ufe0f **Status: BETA**
\n> Keville is currently in **beta**.
\n> Features are stable, but configuration structure and behavior may still evolve.
\n> Feedback and bug reports are very welcome!<\/p>\n
—<\/p>\n
## \u2728 Core Features<\/p>\n
### \ud83d\udd52 Scheduled Messages
\nSend messages at specific times using a simple and readable configuration.<\/p>\n
– Schedule messages using **24-hour time format (HH:mm)**
\n– Limit execution to specific days (or all days)
\n– Supports multiple message types:
\n – **Chat**
\n – **Actionbar**
\n – **Title**
\n– Optional sounds per message
\n– Fully automated once configured<\/p>\n
Perfect for:
\n– Daily announcements
\n– Event reminders
\n– Rule notices
\n– Server-wide alerts<\/p>\n
—<\/p>\n
### \ud83d\udd01 Repeater Messages (Playtime-Based)
\nSend messages at a fixed interval based on **Minecraft playtime**.<\/p>\n
– Interval defined in **Minecraft seconds** (20 ticks = 1 second)
\n– Can be limited to specific days
\n– Supports random messages and sounds
\n– Optional conditions and targets<\/p>\n
Great for:
\n– Vote reminders
\n– Tips & hints
\n– Repeating informational messages<\/p>\n
—<\/p>\n
### \u26a1 Triggered Messages
\nSend messages **once** when conditions become true.<\/p>\n
– Fires only when conditions change from *false \u2192 true*
\n– Does **not** spam or loop
\n– Uses the same message system as scheduler & repeater
\n– Can execute a predefined custom command<\/p>\n
Ideal for:
\n– Player count milestones
\n– World-based alerts
\n– Special server states (busy hours, events, etc.)<\/p>\n
—<\/p>\n
## \ud83e\udde0 Conditions System
\nKeville includes a powerful and reusable **conditions engine**.<\/p>\n
– Conditions are grouped and reusable
\n– All conditions in a group must be true
\n– Supports comparisons using:
\n – Built-in placeholders (`{online}`, `{world}`, `{time}`, etc.)
\n – **PlaceholderAPI** placeholders (`%player_level%`, `%vault_balance%`, etc.)
\n– Supported operators:
\n – `=`, `>`, `>=`, `<`, `<=`\n\nExample use cases:\n- Only send messages when enough players are online\n- Target specific worlds\n- Trigger messages based on player stats or permissions\n\n---\n\n## \ud83c\udfaf Target Groups\nPrecisely control **who receives messages**.\n\nTarget groups are reusable and support:\n- All players\n- Specific worlds (**Multiverse-Core supported**)\n- Permissions (**LuckPerms supported**)\n- LuckPerms groups\n- Individual players\n\nTargets can be applied to **scheduled**, **repeater**, and **triggered** messages.\n\n---\n\n## \ud83e\udde9 Custom Commands\nDefine reusable message actions and trigger them dynamically.\n\n- Custom commands can send messages, play sounds, and apply conditions\/targets\n- Messages and sounds can be **randomly selected**\n- Can be referenced from triggered messages\n\nThis avoids duplication and keeps complex setups clean and maintainable.\n\n---\n\n## \ud83d\udd0c Plugin Integrations\n\nKeville integrates seamlessly with popular server plugins:\n\n- **PlaceholderAPI** \u2014 advanced dynamic placeholders\n- **Multiverse-Core** \u2014 world-aware targeting and conditions\n- **LuckPerms** \u2014 permissions and group-based targeting\n\n---\n\n## \ud83d\udd70 Time & Timezone Support\nKeville handles time correctly across environments.\n\n- Configurable **IANA timezone**\n- Optional **NTP synchronization** for drift-free accuracy\n- Consistent behavior across restarts\n\n---\n\n## \ud83d\udcdd Logging\nOptional logging of all sent messages.\n\n- Fully configurable log template\n- Includes placeholders like:\n - `{time}`, `{section}`, `{type}`, `{player}`, `{message}`\n- Useful for moderation, auditing, or debugging\n\n---\n\n## \u2328 Commands\nKeville includes a clean command interface:\n\n- `\/keville schedule` \u2014 create scheduled messages\n- `\/keville message` \u2014 send messages manually\n- `\/keville conditions` \u2014 list condition groups\n- `\/keville today` \u2014 see today\u2019s scheduled messages\n- `\/keville debug` \u2014 inspect internal state\n- `\/keville reload` \u2014 reload configuration\n- Alias: `\/kev`\n\nEach command supports permissions and OP overrides.\n\n---\n\n## \u2699\ufe0f Lightweight & Production-Ready\nKeville is designed to be:\n\n- Easy to configure\n- Lightweight on performance\n- Quiet in the background\n- Reliable even on busy servers\n\n---\n\n## \ud83e\uddea Take some special notes\nKeville is currently in **BETA**.\n\n- Configuration format may evolve\n- New features are actively being developed\n- Feedback is highly appreciated\n- The Plugin is known on your server as kwallieKeville\n\n---\n\n## \ud83d\udea8 Help needed? Issue found?\nYou 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!\n\n<\/p>\n","protected":false},"excerpt":{"rendered":"
Keville is a scheduled messaging plugin for Minecraft Paper servers. It allows you to send messages to players based on time, events, and configurable triggers – fully automated and reliable.<\/p>\n","protected":false},"featured_media":90113,"template":"","meta":{"_minecraft_slug":"keville","_minecraft_project_id":"skqzHl6b","_minecraft_author":"Paskwallie","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":11,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"keville.zip","_minecraft_size_bytes":40471,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T23:06:30.242061Z","_minecraft_date_created":"2026-01-24T23:32:30.406670Z","_minecraft_date_modified":"2026-01-23T21:02:46.397151Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/keville","_minecraft_icon_attachment_id":90113,"_minecraft_imported_at":"2026-06-05T03:29:19+00:00","_minecraft_import_hash":"769e8afa31e1996a6159c70f37e69fb6","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,129,92],"mod_loader":[132,134],"minecraft_version":[845,846,847,848,849,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-90112","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_category-spigot","mod_category-utility","mod_loader-paper","mod_loader-spigot","minecraft_version-1-2-1","minecraft_version-1-2-2","minecraft_version-1-2-3","minecraft_version-1-2-4","minecraft_version-1-2-5","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n