ULTIMATE GAMING HUB

FREE-TO-PLAY WORLDS, MULTIPLAYER ARENAS, HIGH-PERFORMANCE HOSTS

Server Submission Guide


Follow this guide to correctly add your server to the list and attract more players.

Adding a New Server

To add your server, go to the Add Server page and fill in the required fields:

  • Category – Choose the game type (e.g., MMORPG, PvP, Survival)
  • Server Name – Choose a clear and short name
  • Website URL – Must be a real, reachable address (checked automatically)
  • Description – Between 100 and 1000 characters

Note: Category and name cannot be changed later. Choose carefully!

Description Tips

A good description helps attract more players. Here are some suggestions:

  • Mention the server's main features (PvE, PvP, mods, version)
  • Include your community size or activity level
  • Highlight what makes your server unique
  • Avoid too much formatting or keyword stuffing

You can edit the description later, so keep it updated!

Banner Image

You can upload a 728×90 px banner when adding your server, but it will only be visible if you activate Premium.

  • Accepted formats: JPG, PNG, GIF
  • Max size: 500KB
  • Make it clean, clear, and professional

If you upgrade to Premium later, your banner will appear automatically.

Voting Widget Integration


Use our JavaScript widget to allow players to vote directly from your site or game launcher, with automatic cooldown and validation.

What is the Voting Widget?

The voting widget is a small script you can embed on your site to let players vote without leaving your page.

  • Lightweight & fast
  • Customizable with your player's ID
  • Includes automatic vote cooldown

The widget handles validation and cooldown internally — no extra logic needed on your side.

Integration Example

Include the following script in your page where you want the voting widget to appear:

<script>
  const player_id = 'JohnDoe'; // Replace with your player's ID
</script>
<script src="https://rankly.top/js/vote_widget.js"></script>
    

The widget will automatically fetch the current vote status and display the vote button or the cooldown timer.

Cooldown & Validation

Unlike other vote sites, we combine player ID and user IP to prevent duplicate votes and enforce cooldowns.

  • If a player tries to vote before the cooldown ends, the widget will show a timer instead of the button.
  • This ensures fair voting and prevents abuse from browser spoofing or VPNs.
  • No sensitive data is stored in the frontend.

Cooldown is typically 12 to 24 hours, depending on the server settings.

Customization & Support
  • You can style the widget using CSS to match your layout
  • Widget returns a basic HTML block you can wrap inside your UI
  • More advanced API integrations (e.g., via AJAX or events) are planned soon

Need help or want a customized version? Contact us.

Postback Guide


How Postback Works

Our postback system allows your server to receive a notification when a player successfully votes.

Just set your postback URL in your server panel — we’ll handle the rest automatically after each vote.

Vote URL (for your players)

Use this link format on your website or client to send players to vote:

https://yourtopsite.com/vote.php?server_id=123&player_id=PLAYERNAME
    

Replace PLAYERNAME with your player's in-game name or unique ID.

Postback URL (called after vote)

Once the vote is confirmed, we send a request to the Postback URL you provided in your server settings.

URL example:

https://yourserver.com/callback.php?player_id={player_id}&secret={postback_secret}&success=1
    

Parameters:

  • {player_id} – The player who voted
  • {postback_secret} – A secure token linked to your server
  • success=1 – Indicates the vote was valid and counted
Basic PHP Example
<?php

$player_id = $_GET['player_id'] ?? '';
$success   = $_GET['success'] ?? 0;
$referer = $_SERVER['HTTP_REFERER'] ?? '';

if (stripos($referer, 'https://rankly.top') !== 0) {
    echo 2;
    return;
}

// Success check
if ($success == 1 && !empty($player_id)) {

    //thanks your player with a reward!
    
    echo 1;
    return;
} 
   
   echo 0;


?>
    

Premium Server Guide


Upgrade your server with Premium to gain better visibility and extra votes.

What is Premium?

Premium servers are highlighted and prioritized in listings. This gives your server more exposure and a higher chance of receiving clicks and votes.

  • Better visibility in server lists
  • Extra 100 votes added instantly
  • Premium tag and design improvements

Premium is purely promotional — it does not affect rankings unfairly.

Available Premium Packages

Select how long you want to keep your server in Premium mode. Longer plans come with discounts:

  • 30 days – €10.00
  • 60 days – €18.00
  • 90 days – €25.00
  • 180 days – €45.00

The extra 100 votes are added only once per activation, not per month.

How Duration Works

If your server already has Premium active, the new package will be added to your current expiration date. If not, the Premium starts today.

Current Premium until: 2025-07-10
Buy 30 days → New expiration: 2025-08-09
    

You can stack Premium without losing any remaining time.

Payment & Activation
  • You must select one of your servers and a Premium duration.
  • After payment, your server is upgraded instantly.
  • Premium expiration is shown in your server list.

Currently, payments are processed via PayPal. More options may be added soon.

Advertising Guide


You can promote your game by purchasing a banner in a featured position, visible on specific category pages. This helps increase visibility and clicks from players interested in your game genre.

How It Works
  • You select a game category (e.g., MMORPG, PvP, Survival).
  • You choose a position (1st, 2nd, 5th) which has a fixed daily price.
  • You choose how many days your ad will be shown (minimum 7, maximum 30).
  • You upload a valid banner and enter the site URL players will be redirected to when clicking it.

Once purchased, your banner will appear immediately in the selected position, unless that spot is already booked by another advertiser.

Banner Requirements
  • Size: 728 × 90 px (Leaderboard format)
  • Max file size: 500KB
  • Format: JPG, PNG or GIF
  • Animated GIFs are allowed

Make sure your banner is clear and attractive. Offensive or misleading banners will be rejected.

Availability & Conflicts

Each category + position combination can only host one banner at a time.

If a position is already taken, it will be disabled automatically in the form. You will also see until when it's booked.

Payment & Activation
  • Once you select your options and upload your banner, the total cost is calculated automatically.
  • You can pay securely via PayPal (credit/debit cards supported).
  • After payment, your ad will be visible until the selected end date.

If the upload fails or there's an error with the banner, no payment is processed.