VotePipe

Compatibility Mode

Zero Risk

Run VotePipe alongside your existing voting plugin for a risk-free migration

What is Compatibility Mode?

Compatibility mode allows VotePipe to observe votes handled by your existing plugin (HytaleVotifier or HyVote) without interfering with reward delivery. This gives you:

  • Side-by-side analytics comparison in VotePipe dashboard
  • Zero disruption to your current vote handling
  • Confidence to switch when you're ready
  • Migration progress tracking

How It Works

VotePipe uses reflection to listen for vote events from HytaleVotifier or HyVote. When a vote is detected, it's sent to VotePipe as an "intercepted" vote. These votes appear in your dashboard analytics but do not trigger:

  • Discord notifications
  • Callback webhooks
  • VotePipe plugin rewards

Your existing plugin continues to handle all reward delivery normally.

Setup Instructions

Step 1: Install VotePipe Plugin

  1. Download VotePipe plugin from CurseForge or Modtale
  2. Place it in your mods folder alongside your existing plugin
  3. Start the server to generate config

Step 2: Configure Plugin Token

Edit mods/Mythlane_VotePipe/config.json and add your token:

json
{ "token": "vpt_your_token_here", "intercept_legacy_votes": true }

Note: intercept_legacy_votes is enabled by default. VotePipe automatically detects HytaleVotifier or HyVote if installed.

Step 3: Restart Server

Restart your server. You should see in the logs:

[VotePipe] HytaleVotifier detected - interception enabled [VotePipe] Vote interception enabled | votifier=true, hyvote=false

Dashboard Indicators

Intercepted votes are clearly marked in your dashboard:

Intercepted Badge

Shows "HytaleVotifier" or "HyVote" source

No Delivery Status

Discord/Callback/Plugin status shows as "Skipped"

Migration Stats Card

When you have intercepted votes, your dashboard shows a migration progress card:

Migration Progress42% Direct
Direct: 127Intercepted: 175

When to Complete Migration

You're ready to fully switch when:

  • You've configured your VotePipe rewards
  • You've tested webhook delivery from vote sites to VotePipe
  • You're comfortable with the VotePipe dashboard
  • You've updated vote site webhooks to point to VotePipe

Complete the Migration

  1. Stop your server
  2. Remove your old plugin (HytaleVotifier or HyVote)
  3. Update config.json: Set intercept_legacy_votes: false
  4. Ensure all vote site webhooks point to VotePipe
  5. Start your server
  6. Verify with /votepipe status

Technical Details

Detection: VotePipe uses Java reflection to detect HytaleVotifier's VotifierVoteEvent or HyVote's HyVoteEvent.

API Endpoint: Intercepted votes are sent toPOST /v1/plugin/observe.

Quota: Intercepted votes do NOT count against your plan's vote limits.

Troubleshooting

Legacy plugin not detected?

  • Ensure HytaleVotifier or HyVote is installed and enabled
  • Check that VotePipe loads after the legacy plugin
  • Enable debug mode to see detailed detection logs

Votes not appearing as intercepted?

  • Verify intercept_legacy_votes: true in config
  • Check server logs for interception messages
  • Ensure your plugin token is valid