For Developers

Players vote much more often when they get something in game for it. Connect vote rewards to your Java or PTS server in 10–15 minutes: your project climbs the monthly TOP, and players get items for every vote.

Quick start

Java servers: L2J, L2J Mobius, aCis, L2Scripts, Lucera

Two ways — use one or both:

A. Automatic reward (callback) — recommended

1. Upload l2s-vote-reward.php to your website (PHP 7.2+ with pdo_mysql, access to the game database).
2. Set server_type = java, the database and the reward mode:
   • custom_mail — L2J Mobius: items come by in-game mail, online or offline (General.ini → CustomMailManagerEnabled = True).
   • items_delayed — L2Scripts, Lucera, Rebellion, Overworld: the item is given on the next login.
   • sql — aCis and custom packs: your own INSERT/UPDATE (for example vote points in your donate shop).
3. Open ?test=1&char=YourChar on your script — it checks the connection, tables and character lookup.
4. Send us the callback URL:

https://your-site.com/l2s-vote-reward.php?user={username}&ip={ip}&time={time}&sig={sig}

'api_key' => 'YOUR_API_KEY', 'server_type' => 'java', 'db_dsn' => 'mysql:host=127.0.0.1;port=3306;dbname=l2jgs;charset=utf8mb4', 'db_user' => 'l2j', 'db_pass' => 'secret', 'mode' => 'custom_mail', 'items' => array( array( 57, 1000000 ), array( 1538, 1 ) ), // Adena + Blessed Scroll of Escape

B. In-game command .vote

The player votes on our site and types .vote in game. The server asks our API whether this character (or IP) voted in the last 12 hours and gives the reward once per vote. Works without a website — only the game server is needed.

⬇ L2ServersVote.java (L2J Mobius)

For aCis / L2Scripts / Lucera keep the same logic and change three things: the voiced command interface, the "add item" call and where the last claimed vote is stored.

PTS servers (C++, MSSQL)

On PTS you usually cannot add a Java-style command, and writing items directly into user_item while the character is online is unsafe. That is why the reward script works with PTS through the database — it finds the character in lin2world.dbo.user_data and hands the reward to a system that your server already uses:

PTS config example (PHP needs pdo_sqlsrv on Windows or pdo_dblib on Linux):

'api_key' => 'YOUR_API_KEY', 'server_type' => 'pts', 'db_dsn' => 'sqlsrv:Server=127.0.0.1,1433;Database=lin2world', 'db_user' => 'sa', 'db_pass' => 'secret', 'mode' => 'sql', 'items' => array( array( 57, 1000000 ) ), // 1) extender delivery table (check the name in your extender docs): 'custom_sql' => 'INSERT INTO ItemDelivery (char_id, item_id, item_amount) VALUES (:char_id, :item_id, :count)', // 2) or vote points on the website (separate DB connection): // 'custom_sql' => 'UPDATE site_accounts SET vote_points = vote_points + :count WHERE login = :account', // 'sql_dsn' => 'mysql:host=127.0.0.1;dbname=website;charset=utf8mb4',

PTS and the .vote command: if your extender supports custom commands or scripts, it can call the same API as the Java example (/api/vote-check?username=…) — the logic is identical.

API reference

Callback (we call you)

After every accepted vote we send one GET request to your callback URL (timeout 3 s, no retries). Placeholders:

Verify it yourself (the ready script already does this and rejects old and repeated requests):

// PHP $expected = hash_hmac('sha256', $_GET['user'] . '|' . $_GET['ip'] . '|' . $_GET['time'], $apiKey); if (!hash_equals($expected, $_GET['sig']) || abs(time() - (int) $_GET['time']) > 600) { http_response_code(403); exit; } // Java Mac mac = Mac.getInstance("HmacSHA256"); mac.init(new SecretKeySpec(apiKey.getBytes(StandardCharsets.UTF_8), "HmacSHA256")); String expected = HexFormat.of().formatHex(mac.doFinal((user + "|" + ip + "|" + time).getBytes(StandardCharsets.UTF_8)));

Vote check (you call us)

GET https://l2servers.top/api/vote-check?server=SERVER_ID&key=API_KEY&username=CharName GET https://l2servers.top/api/vote-check?server=SERVER_ID&key=API_KEY&ip=1.2.3.4

Store the last voted_at you rewarded for the account, so one vote gives exactly one reward. Keep the API key secret — use it only on your server, never in the game client or JavaScript.

Test tool

Check your key, see if a character has voted, and send a real signed test request to your script — no need to vote yourself.

Vote button for your website

<a href="https://l2servers.top/vote/YOUR-SERVER/" target="_blank"><img src="https://l2servers.top/vote-button.svg" width="88" height="31" alt="Vote for us on L2Servers.top"></a>

Replace YOUR-SERVER with your address on L2Servers.top (for example /vote/forceplay/). Add ?username=Name to prefill the character name — useful in the launcher and in the website account page.

FAQ