What is Votepipe?

Votepipe is a unified voting API designed for game server owners. Instead of managing five different voting site api's and systems, Votepipe combines them into a single service. This allows you to create seamless Hytale vote rewards for your community while accessing a high-level dashboard to monitor your server's growth and voting metrics.

Why Server Owners Choose Votepipe

Using Votepipe simplifies the technical hurdle of rewarding players. Key benefits include:

• Simplified Systems: Use their Vote Reward Configurator to create custom and reactive Vote Rewards without even knowing how to code.
• Advanced Analytics: Track which voting sites bring in the most players.
• Reliability: Votepipe handles the downtime of individual voting lists so your rewards don't break.

Step-by-Step: Integrating Votepipe with Hytale Servers Pro

Integrating votepipe with Hytale Servers Pro is a simple process. We'll start by setting up a custom webhook inside your server's dashboard on Hytale-Servers.pro.

Enabling custom webhooks for your server

1. Go to your dashboard on Hytale-Servers.pro!
2. Find the server you want to enable custom webhooks for. Press the "Edit" button.
3. Go to the "Technical" tab on the left.
4. Enable the "Custom Voting Webhook".

5. Click "Copy" on the Secret Hash field. This will be used to tell votepipe that the votes come from Hytale-Servers.pro.
6. Don't leave this page, as we'll need to add the Custom Voting Webhook URL later on!

Setting up votepipe

To properly setup votepipe and create Vote Rewards for your players, you need to do 2 things. First is setting up your account and connecting Votepipe with Hytale Servers Pro. The second part is actually creating your vote rewards. We'll start with setting up your account and connect Hytale Servers Pro.

Creating a Votepipe account and Connecting to Hytale Servers Pro

1. Go to Votepipe and create an account. You can login/register using Discord. Once logged in, you'll get prompted to set up your account.
2. First setup your organization's name and slug. In this case we'll go with HyServer and hyserver resepctively. Go to the next step. Press continue.
3. If you want to setup discord notifications when someone votes, you can do that here. If not, you can press the "Skip for now" button.
4. Once done with the previous step you'll be able to add your first provider. We'll go for Hytale-Servers.pro.
5. Leave the Provider Key and Display Name as is. Remember the Secret Hash field we copied earlier? Past that in the Auth Key from Hytale-Servers.pro field inside Votepipe. Then press the "Create Provider" button.

6. Copy the Webhook URL that is now shown in Votepipe and go back to the Hytale-Servers.pro dashboard of your server.
7. Paste the copied URL inside the Custom Voting Webhook URL field. Press "Save Changes" to save.

All votes made towards your server on Hytale-Servers.pro are now sent to Votepipe and properly registered!

Setting up Vote Rewards

Votepipe uses a very powerful custom engine that allows you to visually create conditional Vote Rewards. Going into all this functionally would be a bit out of scope for this guide. So today we'll focus on a simple item reward.

Make sure you have the Votepipe Plugin installed on your server to be able to receive Vote Rewards! You can find a guide on how to do that here!

1. Inside the votepipe dasbhoard go to the Rewards tab on the left.
2. Change the Plugin mode from Developer Mode to Automatic Mode.
3. Press the Create First Configuration button to add a new Reward Configuration.
4. Select Base Rewards. The other reward types require a premium account.
5. You should now see your Base Rewards under Reward Configurations, click it to open it up. It should be empty with zero actions.

6. Press the Add Action button to add an action. If it's not already selected, select the Command action.
7. Set the command to give {player} Ingredient_Bar_Mithril 1. This will give the voting player 1 Mithril ingot.
8. Add another action by pressing Add Action again. This time select the Player Message action.
9. Set the Message to {player} just voted on {server} and reveid 1 Mithril Ingot!. This will let other players know that someone voted and what they got. Incentivizing them to also vote.
10. Press the Save Changes button. Your final Configuration should look like this:

If everything went well your players should now receive rewards everytime they vote!