Vote Rewards API
Players vote for your server on metin2.gg and get rewarded in-game. Simple REST API — no C++ client code needed.
How It Works
Three simple steps. No special software, no C++ code, no complex setup.
Player opens vote link
Your game shows a link like metin2.gg/en/server/your-server?player_id=PlayerName. The player clicks it and votes.
Your server checks the API
A simple HTTP request: GET /api/v1/vote/check?player_id=PlayerName with your API key. Returns true or false.
Grant the reward
If voted = true, give the player their reward. Each vote auto-claims on first check — no double rewards possible.
Partner Benefits
Add a backlink to metin2.gg on your website to unlock Partner status and all these perks for free.
Vote Rewards API
Full REST API access. Players vote, your server grants in-game rewards automatically.
15% Ranking Boost
Partner servers get a 15% vote multiplier for ranking calculations. Climb higher, faster.
Partner Badge
Gold 'Partner' badge displayed on your server listing. Builds trust with players.
Analytics Dashboard
See votes per day, unique voters, peak hours, top voters, and claim rates.
Embeddable Widget
Interactive vote widget for your website. Shows rank, votes, and a vote button.
Webhooks
Get instant push notifications when players vote. Real-time rewards without polling.
What You Get — API Panel Preview
This is what the API settings panel looks like once you set up your server. Everything is self-service.
API Credentials
Key: mg_live_5bef...1a70
Quick Start
Two things happen: players open a vote link with their name, your server checks the API to grant rewards.
Give players a vote link
https://metin2.gg/en/server/your-server?player_id=PLAYER_NAMEYour server checks if they voted
GET /api/v1/vote/check?player_id=PlayerName
X-API-Key: mg_live_...Grant the reward
{ "voted": true, "player_id": "PlayerName", "vote_id": "..." }{ "voted": false }Why metin2.gg?
Modern, secure, developer-friendly. No outdated C++ clients or MD5 hashing.
| metin2.gg | Others | |
|---|---|---|
| Integration | Pure REST API | C++ client code |
| Security | HMAC-SHA256 | MD5 |
| API modes | Polling + Webhook | Confusing multi-mode |
| Key management | Self-service panel | Manual config files |
| Partner perks | Badge + 15% boost + analytics | None |
| Documentation | Full API docs + examples | Minimal |
| Vote cooldown | 12 hours | 24 hours |
Get Started in 5 Minutes
Free for everyone. No payment, no trial period.
Submit your server
Don't have a server on metin2.gg yet? Add it first — it takes 2 minutes.
Submit ServerClaim & verify ownership
Go to My Panel > your server > Verify Ownership. Add a DNS TXT record or meta tag to prove you own it.
Go to My PanelAdd a backlink to metin2.gg
Paste a link to metin2.gg anywhere on your server's website. We give you ready-to-copy snippets in the API settings page.
Generate your API key
Once the backlink is verified, click 'Generate API Key' in your API settings. Copy the key — it's shown only once.
Integrate the API
Add one HTTP call to your game server. We provide Python, PHP, and more examples. Players vote, you grant rewards.
Integration GuideFAQ
Is the API free?
Yes, completely free. No payment, no hidden fees, no trial period. Add a backlink and you're in.
Do I need to modify my game client?
No. This is a server-side REST API. Your game server makes a simple HTTP request. No C++ client code or DLL files needed.
What languages are supported?
Any language that can make HTTP requests: Python, PHP, C++, C#, Java, Lua, Node.js — we provide Python and PHP examples, but the API is standard REST.
Can players cheat or claim rewards twice?
No. Each vote is auto-claimed on the first API check. Subsequent checks for the same vote return 'voted: false'. We use optimistic locking to prevent race conditions.
What's the backlink requirement?
Add any link to metin2.gg on your server's website. An HTML link, a banner image, or even a plain URL in your footer. We check automatically and provide ready-to-paste snippets.
What happens if I remove the backlink?
You get a 7-day grace period. If the backlink isn't restored, your API access is paused (not deleted). Add it back and you're immediately re-activated.