Server Postback System Guide

What is a Postback?

A postback is a server-to-server notification that occurs when a player votes for your server. When configured, our system will send a notification to your specified postback URL with vote details, allowing you to reward players automatically.

Quick Voting Links

You can create links that automatically open the voting modal with a pre-filled player name. This makes voting faster and easier for your players.

Replace [serverID] in the URLs below with your server's unique ID number. You can find your server ID in the URL when viewing your server's page.

Standard server link:

https://mmoservers.top/runescape/server/[serverID]

Note: "runescape" will be replaced with your server's game category

Link with auto-vote feature:

https://mmoservers.top/runescape/server/[serverID]?incentive=PlayerName

Example complete link:

https://mmoservers.top/runescape/server/2?incentive=DragonSlayer

This example shows a voting link for server ID 2 and player "DragonSlayer"

When players click a link with the incentive parameter, the voting modal will automatically open with their name pre-filled. They only need to click the "Vote" button to complete their vote.

Player Name Format:

The player name can be up to 30 characters and supports various formats:

• Traditional names: DragonSlayer

• Numeric IDs: Player123456

• Pure numbers: 987654321

• Mixed formats: Pro-Player5000

Postback Methods

We offer two different methods for receiving postback notifications. Choose the one that best suits your technical requirements:

The Simple GET Method provides an easy way to receive vote notifications through HTTP GET requests. When a player votes, our system will send a request to your server with the following information:

Parameters You will Receive:

  • incentive - The player's username who voted
  • ip - The IP address of the voter (or "unknown")
  • timestamp - The date and time of the vote (ISO 8601 format, e.g., 2024-12-20T12:00:00.000Z)

Example URL format:

https://yourserver.com/postback.php?incentive=PlayerName&ip=xxx.xxx.xxx.xxx
&timestamp=2024-12-20T12:00:00.000Z

Implementation Examples

Select a tab below to view example code. We provide both data receiving examples (how to capture incoming votes) and data processing examples (how to handle the vote data).

Code Examples Note

These code snippets serve as basic examples to get you started. You can extend and customize them based on your specific needs, adding features like database integration, advanced error handling, detailed logging, or custom reward distribution logic. Feel free to adapt the code structure to match your application's architecture and requirements.

Security Best Practices

  • Always use HTTPS for your postback URL
  • Only accept postback requests from mmoservers.top
  • Validate all input data before processing
  • Implement proper error handling and logging
  • Return HTTP 200 status code on successful processing
  • Store vote records to prevent duplicate processing
  • Use prepared statements for database operations

Important: Your endpoint should handle duplicate requests gracefully. We may retry failed postbacks to ensure vote delivery. Always implement proper vote verification and duplicate checking.