VotePipe

Plugin Troubleshooting

Common issues and how to resolve them

Connection Issues

❌ "Invalid plugin token"

The token in your config file doesn't match what's in the dashboard.

  • Verify the token in config.json matches the dashboard
  • Make sure you copied the full token including vpt_ prefix
  • If lost, regenerate a new token in Settings → Plugin

❌ "Plugin token disabled"

The token exists but has been disabled in the dashboard.

❌ "Connection timeout"

The plugin can't reach VotePipe servers.

  • Check your server has outbound HTTPS (port 443) access
  • Verify no firewall is blocking api.votepipe.io
  • Try /votepipe test to diagnose

🟡 Dashboard shows "Intermittent"

Polls are succeeding but not consistently every 5 seconds.

  • Check server isn't overloaded (high TPS lag)
  • Verify poll_interval_ms isn't set too high
  • Check for network instability

Vote Delivery Issues

❌ Votes not being received

Votes appear in dashboard but not on server.

  • Check /votepipe status — is it connected?
  • Verify enabled: true in config
  • Check server console for errors
  • Ensure you have a VoteReceivedEvent handler registered

❌ Votes stuck as "Unclaimed"

Votes are being polled but staying unclaimed.

  • Your event handler isn't calling event.success()
  • Event handler is throwing exceptions before responding
  • Check for errors in your reward code

Every VoteReceivedEvent must have eitherevent.success() orevent.fail(reason) called.

❌ Votes stuck as "Delivered"

Votes were sent to plugin but no claim response received.

  • Plugin may have crashed or restarted mid-poll
  • Event handler timed out (check claim_timeout_ms)
  • These will be retried automatically after a timeout period

❌ Same vote received multiple times

Player getting duplicate rewards.

  • Check you're calling event.success() after giving reward
  • If handling your own queue, always call success()
  • Add idempotency checks using voteId

Configuration Issues

❌ "Invalid JSON in config.json"

The config file has syntax errors.

  • Use a JSON validator to check syntax
  • Ensure all strings are quoted
  • No trailing commas after the last item
json
// ❌ Wrong { "token": vpt_abc123, // Missing quotes "enabled": true, // Trailing comma } // ✓ Correct { "token": "vpt_abc123", "enabled": true }

❌ Config changes not taking effect

You edited config but nothing changed.

  • Run /votepipe reload after editing
  • Or restart the server

Debug Logging

Enable verbose logging to diagnose issues:

json
{ "token": "vpt_your_token", "enabled": true, "debug": true }

Check your server console for detailed VotePipe logs after enabling debug mode.

Still Need Help?