VoteLogging

VoteLogging

VoteLogging is the unified logging system in VotingPlugin that records vote-related activity to storage (MySQL only).
It is intended for auditing, analytics, debugging, and tracking reward/vote activity across your network.

---

Overview

VoteLogging works by listening to internal vote/reward events and writing structured entries to a storage backend.

Common logging listeners include:

• PlayerPostVoteLoggerListener
• PlayerSpecialRewardLoggerListener
• VoteMilestoneVoteLogListener
• VoteShopPurchaseLoggerListener

When MySQL logging is enabled, entries are written through the MySQL table handler (for example: VoteLogMysqlTable).

---

What Gets Logged

VoteLogging currently logs the following (MySQL only):

• Votes
• Vote shop purchases
• Top Voter rewards
• VoteMilestone rewards
• VoteStreaks (new system; not the legacy/old version)

---

Configuration

VoteLogging can be configured on both backend servers and proxies.

Backend configuration (Config.yml)

###########################################
# Vote Logging
# Optional logging of votes and rewards (MySQL only)
###########################################

# Currently logs:
# - Votes
# - Vote shop purchases
# - Top voter rewards
# - VoteMilestones rewards
# - VoteStreaks (not the old version)

VoteLogging:
  # If enabled, will log votes in MySQL
  # Enable on backend servers to access commands
  Enabled: false
  # Purge votes older than X days
  # Set to -1 to disable automatic purging
  PurgeDays: 30
  UseMainMySQL: true
  # MySQL settings only used if above is false

Field reference

• Enabled: Master toggle for VoteLogging on this server.
• PurgeDays: Automatically deletes vote log records older than this many days.
  • Set to -1 to disable automatic purging.
• UseMainMySQL: If true, VoteLogging uses the main plugin MySQL settings.
  • If false, VoteLogging uses the MySQL settings defined under VoteLogging (if present).

---

Proxy configuration

VoteLogging:
  # If enabled, will log votes in mysql
  # Enable on backend servers to access commands
  Enabled: false
  # Purge votes older than X days
  # Set to -1 to disable automatic purging
  PurgeDays: 30
  UseMainMySQL: true
  # Mysql settings only used if above is false

Tip: If you want logs available for commands that query VoteLogging, enable VoteLogging on the backend server(s) that run those commands.

---

Operational Notes

Purging behavior

If PurgeDays is enabled (not -1), the system will periodically remove older log entries from MySQL to keep the database size manageable.

Recommended setup

• Enable VoteLogging on your backend server(s) where you want command access.
• Use UseMainMySQL: true unless you have a specific reason to isolate VoteLogging into a separate database.

---

Disabling VoteLogging

To disable completely:

VoteLogging:
  Enabled: false

This stops VoteLogging from writing any new entries.