Server sahibləri üçün
Serverini əlavə et, səs linkini saytına qoy və oyunçularını avtomatik mükafatlandır. Üç addım:
1. Səs linki
Bu linki saytına qoy (SERVER_ID Serverlərim bölməsindədir):
https://mmotop100.com/vote/SERVER_ID?u=PLAYER_NAME
u = oyunçunun hesab adı (hərf, rəqəm, _ . @ -, ən çox 64). Postback ilə sənə geri gəlir, beləcə kimi mükafatlandıracağını bilirsən.
2. Oyunçular mükafatı necə alır
Postback - oyunçunun səs verdiyini saytına bildiririk
Sayılan hər səsdən sonra postback ünvanını çağırırıq (POST, forma sahələri):
| Sahə | Mənası |
|---|---|
| server_id | serverinin nömrəsi |
| vote_id | səsin nömrəsi - unikaldır; hər vote_id-i YALNIZ BİR DƏFƏ mükafatlandır |
| user | səs linkindəki u |
| ip | səs verənin IP ünvanı |
| country | səs verənin ölkəsi (iki hərf, boş ola bilər) |
| time | nə vaxt (unix saniyə, UTC) |
| test | 1 = panelindən test, mükafat vermə |
| sig | imza: postback açarınla "vote_id|server_id|user|ip|time" sətrinin HMAC-SHA256-sı |
Saytın GET parametrlərini oxuyur? Ünvana yer tutucuları qoy, biz onları doldurub GET göndərəcəyik: {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}
İstənilən 2xx statusu ilə cavab ver. Saytın cavab verməsə, 1 dəq, 5 dəq, 30 dəq, 2 saat və 6 saat sonra yenidən cəhd edirik. Hər cəhd postback jurnalında görünür.
PHP nümunəsi
<?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 - səsin mükafatı, bir dəfə
Oyun server plaginləri və botlar üçün: səs üçün ilk sorğu claimed:true qaytarır və alınmış kimi işarələyir - sonrakılar alındığını deyir. Oyunçunun IP-si və/və ya adı ilə soruş.
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
Və ya bizdən soruş (API)
Saytın çağırış qəbul edə bilmirsə, bir IP-nin və ya oyunçunun son 12 saatda səs verib-vermədiyini soruş:
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. Qaydalar
- Hər şəxs üçün hər serverə 12 saatda bir səs (ünvan, brauzer və oyunçu hesabı birlikdə yoxlanılır).
- Səs almaq, səs botları, proxy-lər və oyunçuları bir neçə bağlantıdan səs verməyə məcbur etmək = server silinir.
- Qəfil səs axını yoxlayana qədər serveri dondurur.
- Postback ünvanın açıq olmalıdır (127.0.0.1 və ya özəl şəbəkə yox). Yönləndirmələri heç vaxt izləmirik.
- VPN, proxy, Tor və data mərkəzi ünvanlarından gələn səslər sayılmır.