HytaleServer.xyz Integration
Connect HytaleServer.xyz to VotePipe using the Votifier protocol. Votes are delivered over raw TCP and verified using RSA encryption or HMAC signatures.
Protocol
HytaleServer.xyz sends votes using the Votifier protocol over raw TCP. VotePipe supports both Votifier V1 (RSA-encrypted) and V2 (HMAC-signed with challenge tokens).
| Property | Value |
|---|---|
| Protocol | Votifier V1 (RSA 2048-bit) & V2 (HMAC-SHA256) |
| Transport | Raw TCP |
| Default Port | 8192 |
| Key Management | Auto-generated by VotePipe, rotatable from dashboard |
Connection Details
When you create a HytaleServer.xyz 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 HytaleServer.xyz
- VotePipe auto-generates your RSA keypair and HMAC token
- Copy the Host, Port, and Public Key shown in the provider details
Step 2: Configure HytaleServer.xyz
- Go to https://hytaleserver.xyz/cp and log in.
- Click Edit Server for your server.
- Scroll down to the Votifier Settings section.
- Enable Votifier by toggling the switch or checkbox.
- Fill in the Address (the "Host" from VotePipe), Port (default: 8192), and Key (the "Public Key" from VotePipe).
- Click Save.
Step 3: Verify
- Cast a test vote on HytaleServer.xyz for your server
- Check the VotePipe dashboard to confirm the vote was received
- Votes will now flow: HytaleServer.xyz → 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 HytaleServer.xyz provider → Rotate Keys). After rotating, update the public key on HytaleServer.xyz.
Troubleshooting
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
Decryption or signature errors
- The public key on HytaleServer.xyz must match the one shown in VotePipe
- If keys were rotated, update the public key on HytaleServer.xyz
- Try rotating keys in VotePipe and re-configuring HytaleServer.xyz
Still having issues? Check our general troubleshooting guide.
API Management
You can manage providers programmatically using the API: