Para donos de servidores
Adicione seu servidor, coloque o link de votação no seu site e recompense seus jogadores automaticamente. Três passos:
1. O link de votação
Coloque este link no seu site (o SERVER_ID está em Meus servidores):
https://mmotop100.com/vote/SERVER_ID?u=PLAYER_NAME
u = o nome da conta do seu jogador (letras, dígitos, _ . @ -, até 64). Ele volta para você no postback, assim você sabe quem recompensar.
2. Como os teus jogadores recebem a recompensa
Postback - avisamos seu site que o jogador votou
Depois de cada voto contado chamamos seu endereço de postback (POST, campos de formulário):
| Campo | Significado |
|---|---|
| server_id | o número do seu servidor |
| vote_id | o número do voto - único; recompense cada vote_id UMA VEZ |
| user | o u do seu link de votação |
| ip | o endereço IP de quem votou |
| country | o país de quem votou (duas letras, pode vir vazio) |
| time | quando (segundos unix, UTC) |
| test | 1 = um teste do seu painel, não recompense |
| sig | assinatura: HMAC-SHA256 de "vote_id|server_id|user|ip|time" com seu segredo de postback |
Seu site lê parâmetros GET? Coloque os marcadores no endereço e enviamos um GET com eles preenchidos: {user} {ip} {vote_id} {server_id} {time} {country} {test} {sig}
https://your-site.com/vote_reward.php?name={user}&ip={ip}&id={vote_id}&t={time}&sig={sig}
Responda com qualquer status 2xx. Se seu site não responder, tentamos de novo depois de 1 min, 5 min, 30 min, 2 h e 6 h. Cada tentativa fica no seu log de postbacks.
Exemplo em PHP
<?php
// vote_reward.php - called by MMOTop100 when a player voted
$secret = 'YOUR_POSTBACK_SECRET'; // My servers -> your server -> Keys
$in = $_POST ?: $_GET;
$user = (string)($in['user'] ?? '');
$ip = (string)($in['ip'] ?? '');
$vote = (string)($in['vote_id'] ?? '');
$sid = (string)($in['server_id'] ?? '');
$time = (int)($in['time'] ?? 0);
$sig = (string)($in['sig'] ?? '');
$want = hash_hmac('sha256', "$vote|$sid|$user|$ip|$time", $secret);
if (!hash_equals($want, $sig) || abs(time() - $time) > 86400) { http_response_code(403); exit('bad signature'); }
if (($in['test'] ?? '0') === '1') { exit('OK test'); }
// pay ONCE per vote_id (the same vote can arrive again if your answer got lost):
// INSERT INTO vote_log (vote_id, ...) with vote_id UNIQUE - if it already exists, do nothing.
// then give the reward to $user
echo 'OK';
3. Claim API - a recompensa de um voto, uma só vez
Para plugins de servidores e bots: a primeira chamada por um voto devolve claimed:true e marca-o como usado - as seguintes dizem que já foi usado. Pergunta com o IP e/ou o nome do jogador.
GET https://mmotop100.com/api/claim?server=SERVER_ID&key=API_KEY&ip=1.2.3.4&user=PLAYER_NAME
{"claimed":true,"vote_id":123,"at":1762900000} = give the reward now (each vote only once)
{"claimed":false,"voted":true,"next":1762943200} = already taken - can vote again at "next"
{"claimed":false,"voted":false} = no vote in the last 12 hours
Ou pergunte para nós (API)
Se seu site não pode receber chamadas, pergunte se um IP ou jogador votou nas últimas 12 horas:
GET https://mmotop100.com/api/voted?server=SERVER_ID&key=API_KEY&ip=1.2.3.4
GET https://mmotop100.com/api/voted?server=SERVER_ID&key=API_KEY&user=PLAYER_NAME
{"voted":true,"at":1762900000,"next":1762943200} or {"voted":false}
4. Regras
- Um voto por servidor a cada 12 horas por pessoa (endereço, navegador e conta do jogador são verificados).
- Comprar votos, bots de votação, proxies e obrigar jogadores a votar de várias conexões = o servidor é removido.
- Uma enxurrada repentina de votos congela o servidor até a gente verificar.
- Seu endereço de postback deve ser público (não 127.0.0.1 nem uma rede privada). Nunca seguimos redirecionamentos.
- Votos de VPNs, proxies, Tor e endereços de datacenter não são contados.