Vote Broadcast System

Vote Broadcast System

The Vote Broadcast System controls how vote messages are announced to players.

It replaces the legacy broadcast behavior with a flexible system supporting:

• Per-vote broadcasts
• Cooldowns
• Vote batching
• First-vote-of-day messages
• Global interval summaries
• Proxy-wide broadcast routing

Configured in:

• Config.yml (Backend servers)
• bungeeconfig.yml / proxy config (Proxy-side)

---

Backend VoteBroadcast (config.yml)

VoteBroadcast:
  Type: EVERY_VOTE
  Duration: 2m
  MaxSitesListed: 0
  Format:
    BroadcastMsg: '&6[&4Vote&6] &aThanks &e%player% &afor voting on &e%site%&a!'
    Header: '&6[&4Vote&6] &a%player% voted on &e%sites_count% &asites:'
    ListLine: '&7 - &e%site%'

Broadcast Types

NONE

Disables vote broadcasts entirely.

EVERY_VOTE

Broadcast every vote (including offline processed votes).

EVERY_VOTE_ONLINE_ONLY

Broadcast only if the voting player is online.

COOLDOWN_PER_PLAYER

Broadcast at most once per Duration per player.

BATCH_WINDOW_PER_PLAYER

Collect votes during Duration and broadcast once.

• 1 vote → BroadcastMsg
• 2+ votes → Header + ListLine

FIRST_VOTE_OF_DAY

Broadcast only the first vote per calendar day per player.

INTERVAL_SUMMARY_GLOBAL

Every Duration, broadcast a global vote summary.

---

Duration Format

Supported units:

• s (seconds)
• m (minutes)
• h (hours)
• d (days)
• w (weeks)

Example:

30s
5m
1h
1d

Months are NOT supported.

---

Format Placeholders

Common:

• %player%
• %site%
• %sites_count%
• %sites%
• %reason%

Interval-only:

• %players%
• %numberofplayers%
• %numberofsites%

---

Proxy Broadcast System (bungeeconfig.yml)

Proxy broadcasts are controlled separately.

Availability: The proxy broadcast settings below are present in the latest public release, 7.1.1. In 7.1.1, an offline vote that is being queued can delay an OfflineMode: FORWARD broadcast until the vote itself is delivered. Immediate forwarding independent of queued vote delivery is available only in development builds containing VotingPlugin PR #1541, merged after 7.1.1.

ProxyBroadcast:
  Enabled: true
  Scope:
    Mode: ALL_SERVERS
    Servers: []
  OfflineMode: FORWARD
  OfflineForward:
    Servers:
    - lobby

Scope Modes

• PLAYER_SERVER → Only the server the player is on
• ALL_SERVERS → All backend servers
• SERVERS → Only specific listed servers
• ALL_EXCEPT → All except listed servers

OfflineMode

Controls what happens if the voting player is offline:

• NONE → Drop broadcast
• QUEUE → Send when player logs in
• FORWARD → Select a backend forwarding target. In 7.1.1, queued vote delivery can also delay this broadcast; development builds containing PR #1541 forward it independently.

OfflineForward.Servers

Used only when OfflineMode = FORWARD.

Example:

OfflineForward:
  Servers:
  - lobby

---

Backend vs Proxy Broadcast Behavior

Backend VoteBroadcast:

• Controls message formatting and timing logic.
• Runs per server.

Proxy ProxyBroadcast:

• Controls where broadcasts are routed across the network.
• Determines which backend server or servers receive the broadcast.

Recommended setup for networks:

• Use MySQL shared storage
• Enable ProxyBroadcast
• Use ALL_SERVERS scope
• Use BATCH_WINDOW_PER_PLAYER or COOLDOWN_PER_PLAYER on backend

---

Recommended Configurations

Small Server

Type: EVERY_VOTE

Medium Server

Type: COOLDOWN_PER_PLAYER
Duration: 5m

Large Network

Backend:

Type: BATCH_WINDOW_PER_PLAYER
Duration: 30s

Proxy:

ProxyBroadcast:
  Enabled: true
  Scope:
    Mode: ALL_SERVERS

Summary

The new Vote Broadcast system provides:

• Spam protection
• Vote batching
• First vote announcements
• Global summaries
• Proxy routing control
• Offline handling options
• Network-wide broadcast scope control

It is designed for both standalone servers and large proxy networks.