JHS-Votifier | Voting, Vote Party & Streaks

[1.3.0] - 2026-02-13

Added

Vote Forwarding

Hub servers can now forward votes to backend servers using the V2 protocol.

• Forwards votes asynchronously to all configured targets over TCP
• Uses the target server's V2 token for HMAC-SHA256 authentication
• Exponential backoff retry on failure (1s → 2s → 4s → up to 30s cap)
• Configurable max retries (1–10), connect timeout, and read timeout
• Test votes are excluded from forwarding
• Config file: forwarding_config.json (disabled by default)

/forwardtest Command

Diagnostic tool for testing connectivity to forwarding targets.

• Tests DNS resolution
• Tests TCP connection
• Tests V2 greeting handshake
• Helps diagnose Docker / Pterodactyl networking issues
• Requires permission: jhs.votifier.admin

Forwarding Section in /votestatus

• Shows forwarding enabled/disabled status
• Displays configured target list
• Shows forwarded and failed vote counts

Localization Support

All user-facing messages are now fully configurable.

• New messages.json file (~90 message keys)
• Uses dot-notation (example: command.reload.success)
• Supports TaleMessage formatting
• Supports %placeholder% variables
• Translators can customize all command responses, errors, UI text, and notifications
• Automatically merges new keys on upgrade without overwriting existing translations

Config Changes

New File: forwarding_config.json

{
  "enabled": false,
  "maxRetries": 3,
  "connectTimeoutMs": 5000,
  "readTimeoutMs": 10000,
  "targets": [
    {
      "name": "Example Backend",
      "address": "localhost",
      "port": 8192,
      "token": "TARGET_V2_TOKEN"
    }
  ]
}