API de vot Metin2: cum îți răsplătești jucătorii, pas cu pas

O mică recompensă în joc pentru jucătorul care votează îți face comunitatea mulțumită și îți urcă serverul în clasamentul săptămânal. API-ul de vot al Metin2PvpServarlar.com îi spune automat serverului tău dacă un jucător a votat cu adevărat. În acest ghid îți explicăm pas cu pas configurarea API-ului de vot Metin2, cu un exemplu de cod PHP și regulile de securitate.

Cum funcționează sistemul?

1. Jucătorul dă click, pe site-ul tău sau în joc, pe linkul de vot care conține numărul contului său.
2. Pe site-ul nostru trece de verificarea robot (Cloudflare Turnstile) și votează.
3. Când jucătorul își cere recompensa, serverul tău întreabă adresa de verificare despre acest număr de cont.
4. Dacă răspunsul e 1, dai recompensa; dacă e 0, îi amintești jucătorului să voteze mai întâi.

Același server poate fi votat o dată la 24 de ore. La voturile date prin linkul de vot, limita se aplică atât pe adresa IP, cât și pe contul de joc.

Unde găsești linkurile?

Pe pagina Panou de control › Serverele mele, apasă butonul API de lângă server. Acolo vezi două adrese și un scurt exemplu PHP.

Linkul de vot este adresa pe care dă click jucătorul:

https://www.metin2pvpservarlar.com/oy-ver/{sunucu-adi}/{sunucu_id}/{ID}

Adresa de verificare este adresa pe care o apelează doar serverul tău:

https://www.metin2pvpservarlar.com/api/oy/{sunucu_id}/{api_anahtari}/{ID}

ID de la finalul ambelor adrese este numărul contului de joc al jucătorului și trebuie să fie un număr mai mare decât zero. Copiază linkul de vot exact cum apare în panou și schimbă doar partea ID de la final. Adresa de verificare răspunde cu text simplu: 1 dacă jucătorul a votat pentru serverul tău prin linkul de vot în ultimele 24 de ore, 0 dacă nu.

Configurare pas cu pas

• Generează linkul pentru fiecare jucător: Nu-l pune pe jucător să-și scrie singur numărul contului. În panoul de utilizator de pe site sau la butonul de vot din joc, adaugă automat în link numărul contului autentificat. Așa, recompensa ajunge la contul corect.
• Pune un buton „Ia-mi recompensa”: Jucătorul îl apasă după ce a votat; cererea de verificare o trimite în acel moment codul care rulează pe serverul tău.
• Înregistrează recompensa: Adresa de verificare răspunde cu 1 timp de 24 de ore după vot. Scrie în baza ta de date ora la care ai dat recompensa, împreună cu numărul contului, și nu da o a doua recompensă aceluiași cont înainte să treacă 24 de ore. Altfel, jucătorul apasă butonul de mai multe ori cu un singur vot și strânge recompense.
• Livrează recompensa: Folosește metoda suportată de fișierele serverului, de exemplu adăugarea de credit în Item Shop sau trimiterea unui obiect către jucător.

Exemplu de cod PHP

Codul de mai jos îl poți adăuga într-un fișier PHP de pe site-ul tău, care rulează pe partea de server:

// Nu pune niciodată cheia API în clientul jocului, în codul JavaScript
// sau într-un fișier public.
const SUNUCU_ID    = '{sunucu_id}';    // Numărul serverului tău din panou
const API_ANAHTARI = '{api_anahtari}'; // Cheia ta API din panou

function oyVerdiMi(int $hesapId): bool
{
    if ($hesapId < 1) {
        return false;
    }

    $adres = 'https://www.metin2pvpservarlar.com/api/oy/'
        . SUNUCU_ID . '/' . API_ANAHTARI . '/' . $hesapId;

    $curl = curl_init($adres);
    curl_setopt_array($curl, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_CONNECTTIMEOUT => 5,
        CURLOPT_TIMEOUT        => 10,
    ]);
    $yanit    = curl_exec($curl);
    $hataKodu = curl_errno($curl);
    $httpKodu = curl_getinfo($curl, CURLINFO_HTTP_CODE);

    // Eroare de conexiune, timeout sau cerere invalidă: nu da recompensa.
    if ($yanit === false || $hataKodu !== 0 || $httpKodu !== 200) {
        return false;
    }

    return trim($yanit) === '1';
}

// $hesapId vine din sesiunea jucătorului autentificat.
if (oyVerdiMi($hesapId)) {
    // Dacă acest cont nu a primit recompensă în ultimele 24 de ore, dă-i
    // recompensa și salvează ora recompensei în baza de date.
} else {
    // Amintește-i jucătorului să voteze mai întâi.
}

Codul dă recompensa doar când răspunsul este exact 1. Dacă cheia sau numărul sunt greșite, răspunsul poate fi un scurt text de eroare; la timeout nu vine niciun răspuns. Toate aceste situații sunt tratate ca „niciun vot”.

Securitate și reguli

• Ține cheia secretă: Dacă faci verificarea într-un cod care rulează pe calculatorul jucătorului, acesta poate falsifica răspunsul și poate lua recompensa gratis; în plus, cheia ajunge la oricine. Dacă bănuiești că ți-a scăpat cheia, scrie-ne de pe pagina de contact.
• Ține numărul de cereri mic: Fă verificarea doar când jucătorul cere recompensa. Interogarea periodică a tuturor conturilor creează o încărcare inutilă.
• Respectă regulile: Recompensele în joc pentru vot sunt permise. Cumpărarea de voturi, plata pentru voturi sau strângerea lor cu boți, VPN și conturi false sunt interzise; voturile frauduloase pot fi șterse, iar serverul poate fi scos din listă.
• Alege o recompensă echilibrată: În locul recompenselor mari, care strică economia jocului, dă recompense mici, dar regulate. Jucătorii care votează zilnic îți ajută serverul să urce în clasamentul celor mai bune servere.

Probleme frecvente

• Răspunsul e mereu 0: Poate că jucătorul nu a folosit linkul de vot cu numărul contului. Voturile date de pe pagina serverului, cu autentificare pe site-ul nostru, se numără în clasament, dar nu apar la adresa de verificare. Verifică și ca numărul din linkul de vot să fie același cu cel din cererea de verificare.
• Jucătorul nu poate vota: Pentru că la linkul de vot limita se aplică și pe adresa IP, jucătorii care împart aceeași conexiune la internet pot vota prin acest link pentru serverul tău o singură dată la 24 de ore. Explică-le asta dinainte.
• Răspunsul întârzie: Afișează-i jucătorului mesajul „încearcă din nou peste câteva minute”; nu repeta cererea în buclă.

Unde să distribui linkul de vot am explicat în ghidul nostru despre promovarea serverului. Ca să le explici jucătorilor cum își iau recompensa, le poți trimite ghidul nostru de vot.

Întrebări frecvente

Cum configurez API-ul de vot dacă nu folosesc PHP?

Logica e aceeași în orice limbaj: trimite o cerere GET la adresa de verificare și, dacă răspunsul e exact 1, dă recompensa. Dacă site-ul tău e scris în alt limbaj, aplici aceiași pași în acel limbaj.

Poate un jucător să primească recompensa de două ori în aceeași zi?

N-ar trebui. Pentru că adresa de verificare răspunde cu 1 timp de 24 de ore după vot, codul tău trebuie să salveze ora recompensei și să blocheze repetarea.

Ce număr folosesc ca ID?

Numărul contului de joc al jucătorului. Trebuie să fie un număr mai mare decât zero și să fie același atât în linkul de vot, cât și în cererea de verificare.

Resetarea voturilor afectează sistemul de recompense?

Nu. Voturile se resetează pentru clasament în fiecare vineri la 20:59, ora Turciei (UTC+3); intervalul de 24 de ore pentru vot funcționează independent. Dacă jucătorul a votat chiar înainte de resetare, poate vota din nou abia când expiră intervalul.