Разработчикам

Игроки голосуют намного чаще, когда получают за это награду в игре. Подключите награды за голоса к Java или PTS серверу за 10–15 минут: проект поднимается в ТОПе месяца, а игроки получают предметы за каждый голос.

Быстрый старт

Java серверы: L2J, L2J Mobius, aCis, L2Scripts, Lucera

Два способа — используйте один или оба:

A. Автоматическая награда (callback) — рекомендуется

1. Загрузите l2s-vote-reward.php на сайт (PHP 7.2+ с pdo_mysql и доступом к БД игры).
2. Укажите server_type = java, БД и режим выдачи:
   • custom_mail — L2J Mobius: предметы приходят почтой в игре, онлайн и оффлайн (General.ini → CustomMailManagerEnabled = True).
   • items_delayed — L2Scripts, Lucera, Rebellion, Overworld: предмет выдаётся при следующем входе.
   • sql — aCis и свои сборки: собственный INSERT/UPDATE (например, очки в донат-магазине).
3. Откройте ?test=1&char=ВашПерсонаж — скрипт проверит подключение, таблицы и поиск персонажа.
4. Пришлите нам 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. Команда в игре .vote

Игрок голосует у нас и пишет .vote в игре. Сервер спрашивает наш API, голосовал ли персонаж (или IP) за последние 12 часов, и выдаёт награду один раз за голос. Сайт не нужен — только игровой сервер.

⬇ L2ServersVote.java (L2J Mobius)

Для aCis / L2Scripts / Lucera логика та же — поменяйте интерфейс voiced-команды, вызов выдачи предмета и место хранения последнего полученного голоса.

PTS серверы (C++, MSSQL)

На PTS обычно нельзя добавить команду как на Java, а писать предметы прямо в user_item, пока персонаж онлайн, небезопасно. Поэтому скрипт работает с PTS через базу — находит персонажа в lin2world.dbo.user_data и передаёт награду системе, которая уже есть на вашем сервере:

Пример настроек для PTS (в PHP нужен pdo_sqlsrv на Windows или pdo_dblib на 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 и команда .vote: если экстендер поддерживает свои команды или скрипты, он может вызывать тот же API, что и Java-пример (/api/vote-check?username=…) — логика та же.

Справочник API

Callback (мы вызываем вас)

После каждого принятого голоса отправляем один GET-запрос на ваш callback URL (таймаут 3 с, без повторов). Плейсхолдеры:

Проверка подписи (готовый скрипт уже делает это и отклоняет старые и повторные запросы):

// 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)));

Проверка голоса (вы вызываете нас)

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

Храните последний выданный voted_at для аккаунта, чтобы один голос = одна награда. Держите API key в секрете — только на сервере, не в клиенте и не в JavaScript.

Проверка интеграции

Проверьте ключ, узнайте, голосовал ли персонаж, и отправьте настоящий подписанный тестовый запрос на ваш скрипт — голосовать самому не нужно.

Кнопка для вашего сайта

<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>

Замените YOUR-SERVER на ваш адрес на L2Servers.top (например /vote/forceplay/). Добавьте ?username=Имя, чтобы подставить имя персонажа — удобно в лаунчере и личном кабинете.

FAQ