ai-streetraces
Уличные гонки из точки в точку до метки на карте со ставкой, где первый гонщик на финише забирает банк.
ai-streetraces позволяет игрокам начать уличную гонку где угодно. Водитель ставит метку на карте как финиш и выбирает ставку. Водители рядом получают приглашение. После обратного отсчёта первый гонщик, которого сервер увидит на финише, забирает все ставки.
Что он делает в игре
- Создание. Поставьте метку не ближе, чем Shortest race из панели. В транспорте откройте радиальное меню и выберите Street race (или введите
/race), затем Race to my waypoint, и введите ставку. Ставка списывается с вашего денежного счёта. - Приглашение. Водители в пределах Invitation distance получают приглашение. Они открывают то же меню и выбирают Join (name)'s race в течение времени присоединения. Для присоединения нужно сидеть на месте водителя рядом с линией старта; ставка списывается при присоединении.
- Старт. Когда время присоединения заканчивается (или хозяин выбирает Start now, когда участников уже двое), гонщики, которые не стоят в транспорте на линии старта, исключаются, и им возвращается ставка. Если гонщиков меньше двух, гонка отменяется, и все получают деньги обратно.
- Обратный отсчёт. Отсчёт 5 секунд; транспорт заморожен. Затем Go!
- Финиш. У финиша есть блип и маркер. Первый гонщик, которого сервер увидит там в транспорте, забирает весь банк.
- Ограничение времени. Если никто не финиширует за Time limit из панели, банк делится поровну между оставшимися гонщиками.
Выход. До старта выход (или отмена хозяином) возвращает ставку. После старта сдавшийся или вышедший с сервера гонщик теряет ставку, она остаётся в банке.
Полиция. Когда начинается обратный отсчёт, гонка может вызвать полицию на линию старта (настройка панели Alert chance).
Читерство. Сервер проверяет позицию каждого гонщика каждые 2 секунды. Перемещение быстрее, чем может ехать любая машина (телепорт), дисквалифицирует гонщика; его ставка остаётся в банке. Финиш быстрее, чем прямая линия на скорости 100 м/с, не засчитывается.
Установка
Устанавливается рецептом AI Core. Вручную: ensure ai-streetraces после ensure ai-core. Нужен ai-core. Ни таблицы в базе данных, ни предметов.
Настройки панели
Админ-панель > Street races > вкладка Settings. Значения по умолчанию берутся из data/settings.json. Изменения применяются к гонкам, созданным после изменения.
Money (деньги): гонщики платят ставку при присоединении; первый на финише забирает все ставки.
| Настройка | Что меняет | Единица | По умолчанию |
|---|---|---|---|
| Money account | Счёт, с которого списываются ставки и на который выплачиваются призы и возвраты. | cash | |
| Lowest buy-in | Наименьшая ставка, которую может задать игрок; 0 разрешает бесплатные гонки. 0-10,000,000. | $ | 100 |
| Highest buy-in | Наибольшая ставка, которую может задать игрок; не ниже наименьшей ставки. 0-10,000,000. | $ | 15,000 |
Races (гонки)
| Настройка | Что меняет | Единица | По умолчанию |
|---|---|---|---|
| Join time | Сколько времени у приглашённых водителей на присоединение; хозяин может начать раньше. Затем следует отсчёт 5 секунд. 15-300. | с | 45 |
| Racers per race | Наибольшее число гонщиков в одной гонке, включая хозяина. 2-16. | 8 | |
| Invitation distance | Водители на таком расстоянии от хозяина получают приглашение; гонщики должны оставаться на таком расстоянии (плюс 25 м) от старта. 10-400. | м | 60 |
| Shortest race | Расстояние по прямой от старта до метки должно быть не меньше этого. 100-10,000. | м | 500 |
| Time limit | Гонка, которую никто не закончил за это время, завершается, и банк делится между оставшимися в ней гонщиками. 1-60. | мин | 10 |
Police (полиция): вызовы идут через систему оповещений, которую использует ai-core.
| Настройка | Что меняет | Единица | По умолчанию |
|---|---|---|---|
| Alert chance | Шанс, что старт гонки отправит вызов полиции на линию старта; 0 означает никогда. 0-100. | % | 25 |
Команды
| Команда | Аргументы | Кто может использовать | Что делает |
|---|---|---|---|
/race | нет | все | Открывает меню уличной гонки (создать, присоединиться, начать, уйти). То же меню, что и пункт радиального меню, для серверов без радиального меню. |
Привязки клавиш
Нет. Меню открывается из радиального меню (Street race, показывается во время езды, при приглашении или в гонке) или командой /race.
Что он заменяет
Нет fxProvide. Он заменяет qb-streetraces / qbx_streetraces (одно меню вместо их четырёх команд), без их экспортов и событий.
Совместимые скрипты
Деньги идут через ai-core, вызовы через слой диспетчера, пункт меню через слой радиального меню. Работает любой скрипт оповещений и радиальное меню, которые поддерживает AI Core (см. Совместимость).
Известные ограничения
- Только гонки из точки в точку: без кругов, без сохранённых трасс, без чекпоинтов.
- У финиша нет высоты: это плоский круг вокруг метки.
- Ставки гонщиков, которые все покинули идущую гонку, теряются (записываются в лог).
- При остановке ресурса каждому оставшемуся гонщику возвращается ставка.
- Канал логов:
races.