LPC Pro · Configuration
Smart Announcements
Documents LPC Pro 4.0.0 · mirrored from the product wiki, updated 2026-02-07 · GitBook version
Smart announcements are context-aware messages that trigger based on conditions like player count, playtime, permissions, or world. Unlike regular timed announcements, they only send when their conditions are met. Configuration is in features/smart-announcements.yml.
Configuration
enabled: true
# How often to check conditions (seconds)
check-interval-seconds: 60
Defining Announcements
Each announcement has a message, conditions, and delivery settings:
announcements:
welcome:
enabled: true
message: "<dark_gray> »</dark_gray> <green>Welcome</green> <dark_gray>—</dark_gray> <gray>Welcome to the server!"
per-player: true
cooldown-seconds: 3600
priority: 10
random-chance: 1.0
conditions:
min_playtime_minutes: 0
max_playtime_minutes: 5
worlds: []
Announcement Properties
| Property | Type | Description |
|---|---|---|
enabled |
boolean | Enable/disable this announcement |
message |
string | MiniMessage-formatted message text |
per-player |
boolean | true = per-player cooldown, false = global cooldown |
cooldown-seconds |
integer | Time before this announcement can trigger again |
priority |
integer | Higher priority announcements are checked first (1-10) |
random-chance |
float | Chance to send (0.0 to 1.0, where 1.0 = 100%) |
worlds |
list | Restrict to specific worlds (empty = all worlds) |
Available Conditions
| Condition | Description |
|---|---|
min_players |
Minimum online player count |
max_players |
Maximum online player count |
min_playtime_minutes |
Player must have played at least X minutes this session |
max_playtime_minutes |
Player must have played at most X minutes this session |
permission |
Player must have this permission |
world |
Player must be in this world |
Default Announcements
LPC Pro ships with these examples:
| Name | Trigger | Description |
|---|---|---|
welcome |
First 5 minutes of playtime | Welcome message for recent joins |
chat_tip |
After 30 minutes | Tip about @mentions |
busy_server |
20+ players online | Acknowledgment of a busy server |
vote_reminder |
5+ players, 30% chance | Vote reminder |
vip_tip |
Has group.vip permission, hub world |
VIP-specific tip (disabled by default) |
Examples
Permission-Gated Announcement
announcements:
donor_perk:
enabled: true
message: "<gold>Thanks for donating! Use <white>/kit donor</white> for your daily rewards."
per-player: true
cooldown-seconds: 86400
priority: 1
random-chance: 1.0
conditions:
permission: "group.donor"
worlds: []
World-Specific Announcement
announcements:
pvp_tip:
enabled: true
message: "<red>PvP is enabled in this world! Watch your back."
per-player: true
cooldown-seconds: 600
priority: 5
random-chance: 1.0
conditions: {}
worlds:
- "pvp_arena"