VotePipe - Unified Vote Rewards for Hytale

The only Hytale vote plugin that handles both Webhook and Votifier sites through one unified pipeline. Connect all 7 major server list sites with a single plugin — no open ports, no extra setup per protocol, no juggling multiple vote plugins.

• Webhook + Votifier in one plugin — supports V1 RSA, V2 HMAC, and HTTPS webhooks natively
• No port forwarding required — outbound-only connections keep your server secure
• Visual reward builder — configure rewards from a web dashboard, no code needed
• Free tier available — get started in minutes with no commitment

Supported Providers

Every provider feeds into the same reward system — no separate plugins needed.

Webhook Providers

Votes arrive over HTTPS. You get a webhook URL and secret from the dashboard — paste them into the vote site settings.

Votifier Providers

Votes arrive over TCP using the Votifier protocol. VotePipe auto-generates your RSA keys and HMAC tokens — just copy the connection info from the dashboard into the vote site. One-click key rotation if you ever need it.

Quick Start

1. Download VotePipe.jar and place it in your server's plugins/ folder
2. Start the server — a default config file is generated automatically
3. Create an account at app.votepipe.com and add your server
4. Copy your plugin token from Settings > Plugin in the dashboard
5. Set the token in-game with /votepipe token vpt_your_token or edit plugins/votepipe/config.json
6. Add providers in the dashboard — you'll get webhook URLs or Votifier connection info to paste into each vote site

Votes start flowing within seconds. Your server only makes outbound requests — no open ports, no firewall rules. Failed deliveries retry automatically.

Operating Modes

Automatic Mode

Configure everything from the dashboard. No code required.

1. Go to Settings > Rewards in your dashboard
2. Set Plugin Mode to Automatic
3. Create reward configurations with the visual builder
4. The plugin handles execution, retry, and claim tracking

Developer Mode

Full control with custom code. Register a handler for VoteReceivedEvent and implement your own reward logic.

1. Set Plugin Mode to Developer in the dashboard
2. Register an event handler (see Plugin API below)
3. Call event.success() or event.fail(reason) to report delivery status

Reward Types

Available Actions

Actions are the building blocks of rewards. Combine them freely in each reward config.

Variables available in actions:

Text formatting tags:

Example:

<#FFD700><BOLD>{player}<RESET> voted on <#00BFFF>{service}<RESET>!

Configuration

Location: plugins/votepipe/config.json

{
  "token": "vpt_your_token_here",
  "api_base_url": "https://api.votepipe.com/v1",
  "poll_interval_ms": 5000,
  "claim_timeout_ms": 5000,
  "enabled": true,
  "debug": false
}

Commands

Plugin API

For developers who want full control, VotePipe provides both an event system and a static API.

Developer Mode Event Handler

import com.mythlane.votepipe.event.VoteReceivedEvent;

public class MyPlugin extends JavaPlugin {
    @Override
    public void setup() {
        getEventRegistry().register(VoteReceivedEvent.class, event -> {
            Player player = server.getPlayer(event.getVoterName());

            if (player != null && player.isOnline()) {
                player.getInventory().add(new ItemStack(Items.DIAMOND, 5));
                player.sendMessage("Thanks for voting on " + event.getProviderName() + "!");
                event.success();
            } else {
                event.fail("Player offline");
            }
        });
    }
}

Event fields:

Static API

Add VotePipe as a compile-only dependency:

dependencies {
    compileOnly("com.mythlane:votepipe:1.0.1")
}

import com.mythlane.votepipe.api.VotePipe;

// Check connection status
boolean connected = VotePipe.isConnected();

// Get leaderboard
VotePipe.getLeaderboard().thenAccept(leaderboard -> {
    for (LeaderboardEntry entry : leaderboard.getEntries()) {
        System.out.println(entry.getRank() + ". " + entry.getPlayerName());
    }
});

// Get leaderboard with options
VotePipe.getLeaderboard(new LeaderboardOptions()
    .period(Period.WEEKLY)
    .limit(20)
    .provider("hytalecharts")
);

// Trigger manual poll
VotePipe.triggerPoll();

Migrating from Votifier / NuVotifier

VotePipe now natively supports the Votifier protocol (both V1 RSA and V2 HMAC), making migration simpler than ever. You don't need to change how your vote sites send votes — VotePipe can receive them directly.

Migration Steps

1. Install VotePipe alongside your existing Votifier plugin

   • Download and place VotePipe.jar in your plugins/ folder
   • Set your plugin token via /votepipe token <token>

2. Add your vote sites as Votifier providers in the VotePipe dashboard

   • VotePipe auto-generates RSA keys and HMAC tokens for each provider
   • Copy the generated Host, Port, and Public Key into each vote site's Votifier settings
   • For V2-compatible sites, also copy the HMAC token

3. Configure rewards

   • Automatic mode: Set up reward configs in the dashboard's visual builder
   • Developer mode: Port your existing reward logic to use VoteReceivedEvent

4. Remove the old plugin once votes are flowing through VotePipe

   • Delete Votifier/NuVotifier from plugins/
   • Clean up old config files

What changes

Plan Comparison

Requirements

• Hytale Server
• Java 25 or higher
• VotePipe account (free signup)

Plugin API calls (polling, claims, leaderboard) don't count against your rate limits.

Support

• Dashboard: app.votepipe.com
• Documentation: votepipe.com/docs
• API Documentation: api.votepipe.com/docs

License

MIT License