MTA Resource Cash Box - это интерфейс для взаимодействия в реальном времени с вашим игровым серверов, разработан для владельцев игровых серверов MTA SA, с помощью которого вы можете в автоматическом режиме принимать оплату и продавать различные услуги на игровом сервере, организовать донат. Перед вами открываются безграничные возможности, вы можете делать магазины прямо у себя на сервере, продавать что либо и т.д, ограничения лишь в вашей голове.

Персональная страница для каждого сервера

После подключения игрового сервера вам доступна персональная страница, вы можете ее оформить по своему желанию, изменить фон, установить логотип, добавить ссылки на ваш сервер в социальных сетях, разместите ссылку этой страницы на своем сайте / группе сервера, после пополнения счета через эту страницу игрок моментально получает игровые деньги, услугу и т.д. на вашем сервере

Готовые решения

Система доната для RP/Play

Донат магазин DayZ с автоматическим пополнением баланса

Как это работает

Игрок переходит на персональную страницу игрового сервера, где необходимо ввести логин существующего аккаунта на вашем игровом сервере

Сайт делает запрос к игровому серверу, вызывая функцию MRCashBoxCheck которая содержит в себе всего лишь один параметр - введенный логин

server.lua

function MRCashBoxCheck (user)
	--- return OK
	--- return ERROR
end

Ваш игровой сервер должен проверить наличие аккаунта, если аккаунт игрока существует, в LUA скрипте возвращается

return OK

Если же такого аккаунта не существует, необходимо возвращать

return ERROR

В случае положительного ответа пользователь допускается к пополнению

После пополнения счета сайт автоматически "уведомляет" ваш сервер о том, что был совершен платеж.

Пример простого скрипта, с выводом в чат логина и суммы пополнения:

server.lua

function MRCashBoxData (user, amount)
	outputChatBox("Пополнение счета. Логин: "..user.." | Сумма: "..amount)
end

meta.xml

<meta>
	<info author="www.MTA-Resource.ru" type="script" version="1.0.0" name="MTA Resource Cash Box"/>
	<script src="server.lua" />
	<export function="MRCashBoxData" type="server" http="true" />
	<export function="MRCashBoxCheck" type="server" http="true" />
</meta>

Обратите внимание что название функции нельзя изменять. В случае успешного платежа происходит вызов функции, которой передаются 2 параметра:

user - логин игрока (указывается игроком на странице пополнения)
amount - сумма на которую игрок пополнил счет

Результат выполнения:

В новых версиях МТА сервера необхоимо отредактировать mtaserver.conf установив значение 0 для атрибута auth_serial_http

<auth_serial_http>0</auth_serial_http>

Подключение к серверу

1. Скачайте базовый ресурс, не изменяя название архива / папки поместите его в .../mods/deathmatch/resources

2. Откройте acl.xml, и добавьте в группу Admin пользователя MRCashBoxBot

<object name="user.MRCashBoxBot"></object>

3. Откройте mtaserver.conf и добавьте ресурс MRCashBox в автозагрузку

<resource src="MRCashBox" startup="1" protected="0" />

В консоле сервера пропишите команду

addaccount MRCashBoxBot <придумайте_пароль>

Придумайте сложный пароль, разрешены только цифры и латинские буквы в верхнем и нижнем регистре, пароль должен быть длиной не менее 10 и не более 20 символов.

Если вы всё сделали верно в чате появиться собщение:

4. Запустите ресурс MRCashBox на сервере

5. Перейдите на страницу подключения, заполните форму. Если вы всё сделали правильно появиться следующее сообщение:

7. Не забудьте в базовом ресурсе отредактировать функцию MRCashBoxCheck, она обязательно должна вернуть ответ.

Эта функция вызывается когда игрок на странице с оплатой вводит свой логин на сервере. Пример LUA скрипта проверки аккаунта на игровом сервере можно взять из темы [Туториал] Дополнение для MTA Resource Cash Box

OK - если аккаунт игрока был найден

ERROR - если аккаунт игрока не найден

Если ответа от игрового сервера не последовало, появится ошибка "Игровой сервер не настроен"

Вы можете просматривать статистику пополнения в своем кабинете

Дополнительно

Если на момент пополнения счета на сервере наблюдается сбой в работе, или он отключен платеж автоматически будет отменен

Если у вас есть предложение, или вы нашли баг, или у вас возникли проблемы с подключением, сообщите об этом в эту тему