For server owners

How it works

1. Player votes for you on ForgeRanks (with their in-game name).
2. ForgeRanks pings your callback URL with their vote token / username.
3. Your website vote script marks the vote in your database.
4. Player claims in-game (same claim command or reward flow you already use).

ForgeRanks does not replace your vote DB. It talks to the same style of callback endpoint most private-server toplists already use.

List your server

1. Create a ForgeRanks account and sign in.
2. Go to Add Server.
3. Choose the correct game (RuneScape, MU Online, WoW, etc.), set revision/tags for that section, and publish.
4. Copy your public vote page URL — it looks like:
   https://forgeranks-toplist.com/server.html?slug=your-slug

Each game has its own toplist and ad inventory. Listing under the right section puts you in front of the right players.

Set your callback URL

1. Open Account → edit your listing (or use Edit on the server page).
2. Find Vote callback URL.
3. Paste the same callback URL you use for other toplists (RuneLocus, GTop100, etc.).
   Example: https://yourserver.com/vote/callback.php
4. Optional: set a Callback secret if your script checks one. ForgeRanks sends it as p_secret and secret.

After a successful vote we request your callback with common toplist parameters, including callback, userid, username, voted=1, and your secret if set.

Add ForgeRanks to your site’s vote list

Put ForgeRanks next to your other toplist buttons so your vote panel can create a pending vote row (with a uid / token) before the player leaves your site.

Many RSPS panels (Fusion-style fx_sites, etc.) work like this — other games usually have a similar “external vote sites” table. Add a row such as:

Ending the URL with callback= lets most panels append the pending vote uid. If your other sites use a different placeholder, match that format instead and keep the ForgeRanks slug the same.

INSERT INTO fx_sites (title, url, site_id, active)
VALUES (
  'ForgeRanks',
  'https://forgeranks-toplist.com/server.html?slug=YOUR-SLUG&callback=',
  '90001',
  1
);

Pass the player’s username too

ForgeRanks reads the name from the URL and prefills the vote box. Use one of these query keys: username, user, ign, player, or custom.

Example link after the player typed their name on your site:

https://forgeranks-toplist.com/server.html?slug=YOUR-SLUG&username=PlayerName&callback=PENDING_UID

Simple PHP example (build the redirect yourself if your panel only appends callback):

$slug = 'YOUR-SLUG';
$user = urlencode($username);   // from your vote form
$uid  = urlencode($pendingUid); // from your pending vote row

header('Location: https://forgeranks-toplist.com/server.html?slug='
  . $slug . '&username=' . $user . '&callback=' . $uid);
exit;

If you only need the name filled (no reward callback), this is enough:
https://forgeranks-toplist.com/server.html?slug=YOUR-SLUG&username=PlayerName

Test the full loop

1. On your vote page, enter a test username.
2. Click the ForgeRanks button (from your vote list — not a random bookmark).
3. Confirm the ForgeRanks URL includes callback=... (your pending uid).
4. Cast the vote on ForgeRanks.
5. Check your vote DB: the row’s callback / completed field should update.
6. Claim in-game with that username.

Advertise in your game section

Banner packages are capped at 15 slots per placement per game, plus a separate Homepage inventory for the site hub. A MU Online sidebar buy only shows on MU pages — it won’t fill RuneScape, WoW, or Homepage slots.

Pick your game on the Advertise page before reserving a slot.

Quick troubleshooting