Hytale-Servers.pro Integration
Connect Hytale-Servers.pro to VotePipe for vote notifications. Hytale-Servers.pro supports two integration methods: Webhook (HTTPS) and Votifier (TCP).
Webhook Integration
Receive votes via HTTPS webhooks with HMAC-SHA256 signature verification.
Webhook URL
https://hooks.votepipe.com/{org_slug}/hytale-servers-proExample: https://api.votepipe.com/hooks/your-org/hytale-servers-pro
Setup Instructions
Step 1: Create Provider in VotePipe
- Go to Add Provider and select Hytale-Servers.pro
- Copy the generated webhook URL (it will look like:
https://api.votepipe.com/hooks/your-org/hytale-servers-pro) - Keep this page open - you'll need to paste the webhook secret in the next step
Step 2: Configure Webhook in Hytale-Servers.pro
- Log in to your Hytale-Servers.pro server dashboard
- Navigate to Webhook Settings or Vote Settings
- Generate or copy your Webhook Secret from Hytale-Servers.pro
- Paste your VotePipe webhook URL in the webhook URL field
- Save the webhook secret (you'll need it for the next step)
Step 3: Complete Provider Setup in VotePipe
- Go back to the VotePipe provider creation page
- Paste the Webhook Secret from Hytale-Servers.pro into the Auth Value field
- Click Create Provider
- Test the webhook from Hytale-Servers.pro to verify the connection
Important
Hytale-Servers.pro generates the webhook secret. Copy it from your Hytale-Servers.pro dashboard and paste it into the Auth Value field in VotePipe when creating the provider.
Webhook Verification
Hytale-Servers.pro uses HMAC-SHA256 signatures to verify webhook authenticity. Every webhook request includes a header you can use to verify the request came from Hytale-Servers.pro.
Request Headers
| Header | Description |
|---|---|
X-Webhook-Signature | Hex-encoded HMAC-SHA256 signature of the raw request body |
Content-Type | application/json |
Signature Format
The signature is a hex-encoded HMAC-SHA256 hash of the raw JSON request body.
The signature is computed by:
- Taking the raw JSON body as a string (exactly as received)
- Computing HMAC-SHA256 of that string using your webhook secret
- Encoding the result as hexadecimal
Vote Payload Format
Hytale-Servers.pro sends vote data in the following format:
{
"hytale_username": "Player123",
"timestamp": 1767173012059,
"server_slug": "wDFDtxbf",
"vote_id": "604800b9-473c-40f8-bf4d-6090216e7c3f"
}The voter name is extracted from hytale_username.
Payload Fields
| Field | Type | Description |
|---|---|---|
hytale_username | string | The Hytale username of the voter |
timestamp | number | Unix timestamp in milliseconds when the vote occurred |
server_slug | string | Your server's unique slug identifier |
vote_id | string | Unique identifier for this vote (UUID format) |
Votifier Integration
Receive votes via the Votifier V2 protocol over raw TCP.
Protocol
| Property | Value |
|---|---|
| Protocol | Votifier V2 (HMAC-SHA256) |
| Transport | Raw TCP |
| Default Port | 8192 |
| Key Management | Auto-generated by VotePipe, rotatable from dashboard |
Connection Details
When you create a Hytale-Servers.pro (Votifier) provider in VotePipe, the following credentials are auto-generated:
| Field | Description |
|---|---|
Host | The VotePipe Votifier server address |
Port | TCP port (default: 8192) |
Public Key | RSA 2048-bit public key (PEM format, for V1) |
Token | HMAC token (for V2 protocol) |
Setup Instructions
Step 1: Create Provider in VotePipe
- Go to Add Provider and select Hytale-Servers.pro (Votifier)
- VotePipe will auto-generate your RSA keypair and HMAC token
- Copy the Host, Port, and Public Key shown in the provider details
Step 2: Configure Hytale-Servers.pro
- Go to https://www.hytale-servers.pro/
- Click Dashboard
- Click Your Servers
- Click Edit on your server
- Go to the Vote Rewards tab
- In the Protocol field, select Votifier V2
- Fill in the Host, Port (default: 8192), and Public Key fields using the values from your VotePipe provider
Step 3: Verify
- Cast a test vote on Hytale-Servers.pro for your server
- Check the VotePipe dashboard to confirm the vote was received
- Votes will now flow: Hytale-Servers.pro → Votifier TCP → VotePipe → Discord + Callbacks + Plugin
Key Rotation
You can rotate your RSA keys and HMAC token at any time from the VotePipe dashboard (Providers → your Hytale-Servers.pro Votifier provider → Rotate Keys). After rotating, update the public key on Hytale-Servers.pro.
Troubleshooting
Webhook not receiving votes
- Verify the webhook URL is correct in Hytale-Servers.pro settings
- Ensure your provider is enabled in VotePipe
- Check that the webhook secret matches exactly in both systems
Authentication errors (401)
- Make sure you copied the Webhook Secret from Hytale-Servers.pro (not generated by VotePipe)
- Check there are no extra spaces before or after the secret
- The secret should be pasted in the Auth Value field in your VotePipe provider
Votifier votes not arriving
- Verify the host and port match exactly what VotePipe shows
- Ensure the public key was copied completely (including BEGIN/END markers)
- Check that port 8192 is accessible (not blocked by firewall)
- Ensure the provider is enabled in VotePipe
Signature mismatch / decryption errors
- For webhooks: the signature is computed as
HMAC-SHA256(raw_body, secret) - For Votifier: the public key on Hytale-Servers.pro must match the one shown in VotePipe
- If keys were rotated, update the public key on Hytale-Servers.pro
- Try rotating keys in VotePipe and re-configuring Hytale-Servers.pro
Still having issues? Check our general troubleshooting guide.
API Management
You can manage providers programmatically using the API: