Support Discord

If you need more help or for some reason cannot understand the tutorial. You can post a comment on this thread or reach us at our support Discord.

https://discord.gg/rGN8zCV

Getting started

• First off download our everythingrs-api.jar from here and include it into your project. and include it into your project.

Registration and secret key

• After adding the everything-rs.jar into your project create an account at https://everythingrs.com, once the account is created you must register onto the toplist as we use the toplist data in many of our api's.
• Now go to your dashboard and you should see your secret key http://i.imgur.com/fWlKyhh.png

Your Hiscores subdomain!

• Go to your main panel at https://everythingrs.com/account . You should now see your voting URL in the "Your API Pages" section

Making the Hiscores work with your server

This part of the tutorial is for PI, but can easily be changed to work with any server. If you want me to add a snippet on the thread so it can work with your framework leave a comment with the server base you want the snippet for. 

In Client.java under

public void destruct() {

Add this

boolean debugMessage = false;
com.everythingrs.hiscores.Hiscores.update("secret_key",  "Normal Mode", this.playerName, this.playerRights, this.playerXP, debugMessage);

Be sure to change "secret_key" to the secret key on your ERS account.

Fin

You now have a working Hiscores on your server! If you have any suggestions or need help please leave a comment. 

Lets take a look at your new Hiscores

http://i.imgur.com/vBylqpP.png

http://i.imgur.com/2KsdLkg.png

Hiscores Dashboard

You can remove members and add new modes from your Hiscores Dashboard 

http://i.imgur.com/e1EiZAt.png

Support Discord

If you need more help or for some reason cannot understand the tutorial. You can post a comment on this thread or reach us at our support Discord.

https://discord.gg/rGN8zCV

Getting started

• First off download our everythingrs-api.jar from here and include it into your project.

Registration and secret key

• After adding the everything-rs.jar into your project the next step is to create an account at https://everythingrs.com, once the account is created you must register onto the toplist as we use the toplist data in many of our api's.
• Now go to your dashboard and you should see your secret key http://i.imgur.com/fWlKyhh.png

Setting up your donation with Paypal

In order for the donation script to work, you must set it up with your Paypal. 

• To set up your donation script to receive Paypal payments, go to your settings here
• Input your Paypal email and hit submit

http://i.imgur.com/t7xglTW.png

Adding and removing items

Adding and removing items from your Auto Donate is simple.

• Go to your Auto Donate dashboard here
• Under "Add new product", fill out the form information, then hit submit
• To remove an item just click "Remove" next to the item that you are trying to remove

http://i.imgur.com/dMDK8Zl.png

(Optional) Creating a Sale

We promote sales on our front page. This is a good way for new players to find deals on servers before joining, and for servers to earn new customers.

• To create a sale go to your Sales dashboard here
• Choose the item that you want to put on sale
• Set the expiration date, and what % off you want to make the item
• Read our notification and confirm that you commit to the sale.

http://i.imgur.com/9SIkjK3.png

Lets take a look at your new donation page

You can find your donation script at:  yoursubdomain.everythingrs.com/services/store

Making the auto donate work with your server

This part of the tutorial is for PI & Ruse, but can easily be changed to work with any server. If you want me to add a snippet on the thread so it can work with your framework leave a comment with the server base you want the snippet for. 

• Add the code below into Commands.java and you're all done!

For PI

            if (playerCommand.equalsIgnoreCase("claim")) {
                new java.lang.Thread() {
                    public void run() {
                        try {
                            com.everythingrs.donate.Donation[] donations = com.everythingrs.donate.Donation.donations("secret_key", 
                                    c.playerName);
                            if (donations.length == 0) {
                                c.sendMessage("You currently don't have any items waiting. You must donate first!");
                                return;
                            }
                            if (donations[0].message != null) {
                                c.sendMessage(donations[0].message);
                                return;
                            }
                            for (com.everythingrs.donate.Donation donate : donations) {
                                c.getItems().addItem(donate.product_id, donate.product_amount);
                            }
                            c.sendMessage("Thank you for donating!");
                        } catch (Exception e) {
                            c.sendMessage("Api Services are currently offline. Please check back shortly");
                            e.printStackTrace();
                        }    
                    }
                }.start();
            }
	

For Vencillio

In PlayerCommand.java under 

switch (parser.getCommand()) {

Add

case "claim":
            new java.lang.Thread() {
                public void run() {
                    try {
                        com.everythingrs.donate.Donation[] donations = com.everythingrs.donate.Donation.donations("secret_key", 
                                player.getUsername());
                        if (donations.length == 0) {
                            player.send(new SendMessage("You currently don't have any items waiting. You must donate first!"));
                            return;
                        }
                        if (donations[0].message != null) {
                            player.send(new SendMessage(donations[0].message));
                            return;
                        }
                        for (com.everythingrs.donate.Donation donate : donations) {
                            player.getInventory().add(new Item(donate.product_id, donate.product_amount));
                        }
                        player.send(new SendMessage("Thank you for donating!"));
                    } catch (Exception e) {
                        player.send(new SendMessage("Api Services are currently offline. Please check back shortly"));
                        e.printStackTrace();
                    }    
                }
            }.start();
            return true;

For Ethos / Exotic

In ethos/model/players/packets/commands/all

Open or create (if it does not exist) Claim.java

and replace the entire file with this

package ethos.model.players.packets.commands.all;
	import ethos.model.players.Player;
import ethos.model.players.packets.commands.Command;
	/**
 * Auto Donation System / https://EverythingRS.com
 * @author Genesis
 *
 */
	public class Claim extends Command {
	    @Override
    public void execute(Player player, String input) {
        new java.lang.Thread() {
            public void run() {
                try {
                    com.everythingrs.donate.Donation[] donations = com.everythingrs.donate.Donation
                            .donations("secret_key", player.playerName);
                    if (donations.length == 0) {
                        player.sendMessage("You currently don't have any items waiting. You must donate first!");
                        return;
                    }
                    if (donations[0].message != null) {
                        player.sendMessage(donations[0].message);
                        return;
                    }
                    for (com.everythingrs.donate.Donation donate : donations) {
                        player.getItems().addItem(donate.product_id, donate.product_amount);
                    }
                    player.sendMessage("Thank you for donating!");
                } catch (Exception e) {
                    player.sendMessage("Api Services are currently offline. Please check back shortly");
                    e.printStackTrace();
                }
            }
        }.start();
    }
	}

For Ruse

if (command[0].equalsIgnoreCase("claim")) {
            new java.lang.Thread() {
                public void run() {
                    try {
                        com.everythingrs.donate.Donation[] donations = com.everythingrs.donate.Donation.donations("secret_key", 
                                player.getUsername());
                        if (donations.length == 0) {
                            player.getPacketSender().sendMessage("You currently don't have any items waiting. You must donate first!");
                            return;
                        }
                        if (donations[0].message != null) {
                            player.getPacketSender().sendMessage(donations[0].message);
                            return;
                        }
                        for (com.everythingrs.donate.Donation donate : donations) {
                            player.getInventory().add(new Item(donate.product_id, donate.product_amount));
                        }
                        player.getPacketSender().sendMessage("Thank you for donating!");
                    } catch (Exception e) {
                        player.getPacketSender().sendMessage("Api Services are currently offline. Please check back shortly");
                        e.printStackTrace();
                    }    
                }
            }.start();
        }
[/spoiler]

Fin

You are now finished adding the auto donation script to your website and server. If you have any suggestions for features, leave a comment and let me know.

Support Discord

If you need more help or for some reason cannot understand the tutorial. You can post a comment on this thread or reach us at our support Discord.

https://discord.gg/rGN8zCV

Getting started

• First off download our everythingrs-api.jar from here and include it into your project.
•  

Registration and secret key

• After adding the everything-rs.jar into your project create an account at https://everythingrs.com, once the account is created you must register onto the toplist as we use the toplist data in many of our api's.
• Now go to your dashboard and you should see your secret key http://i.imgur.com/fWlKyhh.png

Your voting subdomain!

• Go to your main panel at https://everythingrs.com/account . You should now see your voting URL in the "Your API Pages" section

http://i.imgur.com/5PtxrJy.png

http://i.imgur.com/Y43oM58.png

Making the auto vote work with your server

This part is for PI & Ruse but can easily be changed to work with any server. If you have a request for a specific server let me know and I can add it to the tutorial.

• Add the code below into Commands.java and you're all done!
•  

For PI

            if (playerCommand.startsWith("reward")) {
                String[] args = playerCommand.split(" ");
                if (args.length == 1) {
                    c.sendMessage("Please use [::reward id], [::reward id amount], or [::reward id all].");
                    return;
                }
                final String playerName = c.playerName;
                final String id = args[1];
                final String amount = args.length == 3 ? args[2] : "1";
	                com.everythingrs.vote.Vote.service.execute(new Runnable() {
                    @Override
                    public void run() {
                        try {
                            com.everythingrs.vote.Vote[] reward = com.everythingrs.vote.Vote.reward("secret_key",
                                    playerName, id, amount);
                            if (reward[0].message != null) {
                                c.sendMessage(reward[0].message);
                                return;
                            }
                            c.getItems().addItem(reward[0].reward_id, reward[0].give_amount);
                            c.sendMessage(
                                    "Thank you for voting! You now have " + reward[0].vote_points + " vote points.");
                        } catch (Exception e) {
                            c.sendMessage("Api Services are currently offline. Please check back shortly");
                            e.printStackTrace();
                        }
                    }
	                });
            }

For Vencillio

In PlayerCommand.java under

switch (parser.getCommand()) {

Add 

    case "reward":
        if (!parser.hasNext(1)) {
            player.send(new SendMessage("Please use [::reward id], [::reward id amount], or [::reward id all]."));
            return true;
        }
        final String playerName = player.getUsername();
        final String id = parser.nextString();
        final String rewardAmount = parser.hasNext(1) ? parser.nextString() : "1";
	        com.everythingrs.vote.Vote.service.execute(new Runnable() {
            @Override
            public void run() {
                try {
                    com.everythingrs.vote.Vote[] reward = com.everythingrs.vote.Vote.reward("secret_key", playerName, id, rewardAmount);
                    if (reward[0].message != null) {
                        player.send(new SendMessage(reward[0].message));
                        return;
                    }
                    player.getInventory().add(new Item(reward[0].reward_id, reward[0].give_amount));
                    player.send(new SendMessage("Thank you for voting! You now have " + reward[0].vote_points + " vote points."));
                } catch (Exception e) {
                    player.send(new SendMessage("Api Services are currently offline. Please check back shortly"));
                    e.printStackTrace();
                }
            }
	        });
        return true;

For Ruse

In CommandPacketListener.java

under 

private static void playerCommands(final Player player, String[] command, String wholeCommand)  {

Add

Code for Ruse

        
        if (command[0].startsWith("reward")) {
            if (command.length == 1) {
                player.getPacketSender().sendMessage("Please use [::reward id], [::reward id amount], or [::reward id all].");
                return;
            }
            final String playerName = player.getUsername();
            final String id = command[1];
            final String amount = command.length == 3 ? command[2] : "1";
	            com.everythingrs.vote.Vote.service.execute(new Runnable() {
                @Override
                public void run() {
                    try {
                        com.everythingrs.vote.Vote[] reward = com.everythingrs.vote.Vote.reward("secret_key",
                                playerName, id, amount);
                        if (reward[0].message != null) {
                            player.getPacketSender().sendMessage(reward[0].message);
                            return;
                        }
                        player.getInventory().add(reward[0].reward_id, reward[0].give_amount);
                        player.getPacketSender().sendMessage("Thank you for voting! You now have " + reward[0].vote_points + " vote points.");
                    } catch (Exception e) {
                        player.getPacketSender().sendMessage("Api Services are currently offline. Please check back shortly");
                        e.printStackTrace();
                    }
                }
	            });
        }
        

For Matrix

        case "reward":
            final String playerName = player.getUsername();
            final String id = cmd[1];
            final String rewardAmount = "1";
            com.everythingrs.vote.Vote.service.execute(new Runnable() {
                @Override
                public void run() {
                    try {
                        com.everythingrs.vote.Vote[] reward = com.everythingrs.vote.Vote.reward(
                                "secret_key", playerName,
                                id, rewardAmount);
                        if (reward[0].message != null) {
                            player.getPackets().sendGameMessage(reward[0].message);
                            return;
                        }
                        player.getInventory().addItem(new Item(reward[0].reward_id, reward[0].give_amount));
                        player.getPackets().sendGameMessage("Thank you for your support in voting! You have "
                                + reward[0].vote_points + " vote points left.");
                        player.getCompCapeManager().increaseRequirement(Requirement.VOTES, 1);
                        player.setVoteTokens(player.getVoteTokens() + 1);
                    } catch (Exception e) {
	                        player.getPackets().sendGameMessage("Voting services are currently offline, please check back shortly.");
                        e.printStackTrace();
                    }
                }
	            });
            return true;

For Other Servers

The script is compatible with any base, if you however need help adding it to a specific one, leave a link to the base and I'll add it to the tutorial.

Fin

You are now finished adding the auto vote onto your server. Continue if you want to learn how to add and remove items, and adding support for several toplists.

Adding and removing items

• Adding and removing items is incredibly simple. Go to you voting dashboard at  https://everythingrs.com/account/vote/manage
• Once there go to the "Add new reward" section, and you can proceed to enter the reward information (item id, item name, item points, item amount)
• To remove a reward just press the red "x" button 
• The voting script goes by a point system. So for each vote on a toplist your players will get a certain amount of points which is set by you.
• To claim an item and use your points type ::reward x in-game
•  

http://i.imgur.com/JZ57sU0.png

http://i.imgur.com/kTFPwRN.png

Adding several toplists

When registering onto a new toplist and asked for an optional callback use this exactly how it is. 

https://callback.everythingrs.com/process.php?i=

• Once you enter the callback, go onto EverythingRS and in your AutoVote place your toplist id
• If you want to only show toplists that you are registered on, check the "Do not display listings as "unregistered" if I have decided not to add it"

In order to create a topic in the tutorials section, please ensure that your topic does not contain the following;

• Little Code: Do not create tutorials that contain little code
  • This can be done in the snippets section
• Uncredited/Stolen Work: Do not create tutorials that contain uncredited or stolen code
• Implementation: Do not create tutorials that have no information about the implementation of said tutorial

In addition, the tutorial must include code that you as an author understand and can stand for. Do not submit tutorials that can not be used by others. Make sure you follow through with the tutorials that are submitted.

If a thread does not fit the section or if it contains any of the aforementioned points, it will be locked and/or moved to the correct section of the community. Community Rules apply to all sections. Please read them here.