RuneTopic Help Centre

Everything you need to get set up.

Simple, current instructions for players and server owners—from creating an account to safely testing live vote callbacks.

8 guide sections
01
Getting started

Create the right account

  1. Open Create account.
  2. Choose Player if you mainly vote and browse, or Server Owner if you will list and manage an RSPS.
  3. Verify the details, accept the terms and create the account.
  4. Use Log in. If needed, use Forgot password; reset links are single-use and expire.

A player account can still browse every public listing. Owner-only tools remain protected until a server is attached to the account.

02
Server owners

Add and manage a server

  1. Sign in and choose Add server.
  2. Enter your server name, description, website and game information.
  3. Upload a valid image banner/icon. Images are checked using their real file type, size and dimensions.
  4. Open Owner dashboard to edit the listing, configure voting, view premium and open your store catalogue.

GIF uploads are preserved. Active premium enables animation; free listings receive a secure static preview automatically.

03
Voting

Set up vote rewards

  1. Open RuneTopic Integration while signed in.
  2. Select the server you own.
  3. Choose API, Callback or Both.
  4. Add reward commands using {player} where the in-game name belongs.
  5. Save the settings, then test before announcing rewards to players.

Each vote has its own claim state. The API lease and acknowledgement flow prevents the same vote being delivered twice.

04
Safe callback setup

Configure and test a callback

  1. Your callback must be a public HTTPS URL on port 443. Private, loopback, link-local and reserved network addresses are blocked.
  2. Open Integration settings, select your own server, enter the URL and choose GET or POST.
  3. Save the settings.
  4. Open the safe callback tester. You must be logged in, and only servers belonging to your account are selectable.
  5. Send a test and review the exact URL, method, parameters, status, response, timing, attempts and RuneTopic success decision.
RuneTopic sendsusername, server_id, site_id, vote_id, test

A 2xx response is normally accepted unless the body explicitly says 0, -1, false, failed or error. Network/5xx failures receive one controlled retry; 4xx responses do not.

Open safe callback tester
05
API & integration JAR

Connect your game server

  1. Open Integration settings and select your server.
  2. Generate an API token. Copy it immediately; RuneTopic stores only its one-way hash.
  3. Download the RuneTopic Java integration JAR.
  4. Configure your server ID and your own token in the game server—not in public client files.
  5. Use vote check/claim and acknowledgement methods from the API documentation.

Never commit your token to a public repository. Regenerate it from RuneTopic if you think it has been exposed.

06
Premium

Choose and manage premium

  1. Compare the $10, $20 and $30 packages.
  2. Select the server receiving the package and continue through hosted Stripe checkout.
  3. After verified payment, the dashboard shows the tier, benefits and expiry.
  4. VIP styling, toplist highlighting, GIF animation and tier benefits are derived from the active entitlement automatically.

When premium expires, the listing remains live but premium visuals, animation and other entitlement-only features stop automatically.

07
Advertising

Book a tracked advert

  1. Compare every position on the advertising price page.
  2. Sign in, open Advertise and select one of your servers.
  3. Choose the position and 7-90 day period.
  4. Add a public HTTPS banner and optional safe destination. If left blank, clicks go to your RuneTopic server page.
  5. Complete payment, then view impressions, clicks, CTR, status and end date from the owner page.

$20 and $30 Premium packages include advertising credit that can be applied during booking.

08
Store catalogue

Build your server store page

  1. Open Store manager and attach the store to a server you own.
  2. Customise the colours, logo, description and product grid.
  3. Add item images, names, descriptions, prices and safe delivery commands containing {player}.
  4. Preview the public catalogue before publishing it.

Store checkout remains marked Coming Soon while live payment and delivery are being verified. No customer can enter a fake or incomplete payment flow.

Still need help?

Talk to RuneTopic support.

Include your RuneTopic username, server name and what you expected to happen. Never send passwords, API tokens, Stripe details or private keys.

Open support centre