ai-jobs
Рабочие маршруты, которые начинаются на базе (такси, автобус, дальнобойщик, мусоровоз, новости, эвакуатор, переработка, виноградник, дайвинг), и ларёк с хот-догами.
ai-jobs даёт игрокам простые работы, которые можно начать на базе: проехать маршрут и получать плату за каждую остановку, эвакуировать сломанные машины или собирать предметы пешком. Рядом с маршрутами он управляет ларьком с хот-догами: арендуйте тележку, возите её, готовьте и продавайте прохожим. Каждый маршрут и каждая остановка задаются в админ-панели, поэтому новые работы можно добавлять без кода.
Что он делает в игре
- Начало смены. У каждого маршрута есть база с блипом на карте. Подойдите к базе и используйте точку (Start working). Маршруты на транспорте ставят рабочий транспорт в точку появления маршрута и дают вам ключи. Используйте базу снова (Stop working), чтобы закончить смену.
- Остановки. Сервер выбирает вашу следующую остановку и показывает её на карте. На остановке используйте точку (Work here): полоса прогресса идёт время остановки маршрута, затем вам платят (или вы получаете предметы на маршруте сбора), и появляется следующая остановка.
- Типы маршрутов.
- Random stops (случайные остановки): следующая остановка является любой другой остановкой маршрута (такси, дальнобойщик, новости, мусоровоз).
- Stops in order (остановки по порядку): остановки идут друг за другом по id и начинаются снова с первой (автобус).
- Gathering on foot (сбор пешком): без транспорта; каждая остановка даёт случайное количество предмета (переработка, виноградник, дайвинг). Подводные остановки проигрывают анимацию ныряния.
- Towing (эвакуация): на остановке ждёт запертая сломанная машина. Погрузите её на платформу, затем следующей остановкой становится база. Вам платят на базе, только если эвакуируемая машина всё ещё в пределах 15 м от платформы.
- Конец смены. Смена заканчивается, когда пройдены все остановки смены (0 означает, что сама она никогда не заканчивается), когда вы останавливаете её на базе, когда вы выходите с сервера или когда ресурс останавливается. Тогда рабочий транспорт и эвакуируемая машина удаляются. В базе данных ничего не сохраняется.
- Оплата. Маршруты на транспорте и эвакуации платят оплату маршрута за остановку на счёт оплаты маршрута (по умолчанию банк).
Ларёк с хот-догами
- У стойки арендуйте ларёк. Залог списывается со счёта залога. Ларёк появляется в своей точке появления рядом со стойкой.
- Используйте ларёк, чтобы открыть его меню: Push the stand, Prepare hot dogs, Start selling / Stop selling.
- Во время толкания нажмите G, чтобы отпустить. Вы также отпускаете, когда падаете, умираете, целитесь, деретесь или садитесь в транспорт.
- Prepare hot dogs запускает серию проверок навыка. Без промахов получается идеальный (A) хот-дог, с одним промахом редкий (B), с большим числом промахов обычный (C). Каждый хот-дог повышает вашу репутацию продавца хот-догов. Начиная с уровня 2 половина партий удачные и дают больше одного хот-дога.
- Start selling: прохожие рядом подходят к ларьку и делают предложение (от 1 до 3 хот-догов одного качества по цене из диапазона вашего уровня). Примите его у покупателя. Покупатель ждёт 30 с. Если отойти от ларька дальше 10 м или закончится запас, продажа прекращается.
- Верните ларёк у стойки, чтобы получить залог обратно. Выход из игры с ларьком теряет залог; остановка ресурса его возвращает.
Репутация хранится в персонаже (rep.hotdog, тот же ключ, что использует QBCore), поэтому сохраняется между сессиями. Ваш уровень является самым высоким уровнем, From reputation которого вы достигли; уровень определяет, сколько хот-догов каждого качества вмещает ларёк, и их цены.
Установка
Устанавливается рецептом AI Core. Вручную: положите папку в resources/[ai]/ и добавьте ensure ai-jobs после ensure ai-core. Нужны ai-core и OneSync.
Маршруты сбора по умолчанию дают scrapmetal, grape и coral. Убедитесь, что эти предметы есть в списке предметов вашего инвентаря, или измените предмет маршрута в панели. Рабочий транспорт по умолчанию является моделями GTA (taxi, bus, rumpo, trash2, flatbed), дополнительный транспорт не нужен.
Настройки панели
Админ-панель > Work routes. В ней три вкладки: Routes, Stops и Hot dog stand. Значения по умолчанию берутся из data/routes.json, data/stops.json и data/hotdog.json.
Вкладка Routes
Одна запись на маршрут. Маршруты по умолчанию: taxi, bus, trucker, garbage, recycle, vineyard, diving, tow и news.
Route (маршрут)
| Настройка | Что меняет | Единица | По умолчанию для нового маршрута |
|---|---|---|---|
| Name | Название, которое показывается в подсказке базы и на блипе. 1-48 символов. | пусто | |
| Kind | Как выбирается следующая остановка: Random stops, Stops in order, Gathering on foot или Towing broken-down cars (см. выше). | Random stops | |
| Jobs | Начать маршрут могут только участники этих работ. Оставьте работы и банды пустыми, чтобы было доступно всем. База и блип закрытого маршрута показываются только игрокам, которые могут им пользоваться. | пусто (все) | |
| Gangs | Участники этих банд тоже могут его начать. | пусто | |
| Only on duty | Участники работы должны быть на дежурстве в этой работе. | выкл. | |
| Depot | Где игроки начинают и заканчивают работу. Встаньте там и используйте свою позицию. | 0, 0, 0 | |
| Stops per shift | Сколько остановок в одной смене. 0 означает, что смена идёт, пока игрок её не остановит. 0-100. | 5 | |
| Time per stop | Сколько длится работа на остановке (полоса прогресса). 0-120. | с | 5 |
| Depot blip | Спрайт, цвет и размер блипа базы на карте. | спрайт 67, цвет 5, размер 0.65 |
Work vehicle (рабочий транспорт)
| Настройка | Что меняет | Единица | По умолчанию |
|---|---|---|---|
| Vehicle model | Имя для создания рабочего транспорта (taxi, bus, mule, trash). Пусто: без транспорта (маршруты сбора). | пусто | |
| Vehicle spawn | Где появляется рабочий транспорт и куда он смотрит. | 0, 0, 0 | |
| Pay per stop | Выплачивается на счёт оплаты после каждой остановки. 0-100,000. | $ | 100 |
| Pay account | Денежный счёт, на который идёт оплата. | bank | |
| Broken-down cars | Только маршруты эвакуации: имена машин, которые ждут на остановках; одна выбирается случайно. До 40 имён. | 12 машин GTA (sultanrs, zion, oracle...) |
Gathering (сбор)
| Настройка | Что меняет | Единица | По умолчанию |
|---|---|---|---|
| Item per stop | Предмет, который выдаётся на каждой остановке. | пусто | |
| Fewest items per stop | Наименьшее количество за остановку. 1-100. | 1 | |
| Most items per stop | Наибольшее количество за остановку. Каждая остановка даёт случайное количество между ними. 1-100. | 3 |
NPC (необязательно, человек, который стоит на базе)
| Настройка | Что меняет | По умолчанию |
|---|---|---|
| Model | Модель педа; пусто означает без NPC. Игроки видят его в пределах 50 м. | пусто (у базы мусоровозов s_m_y_garbage, у базы дайвинга a_m_m_salton_01) |
| What it does | Анимация ожидания: стоит на месте, нетерпеливо ждёт, держит планшет с бумагами, смотрит в телефон, пьёт кофе, курит, стоит на посту, полицейская стойка, тусуется. | Stands still |
| Where it stands | Место NPC и куда он смотрит. Без него он стоит в точке базы. | база |
Маршруты по умолчанию:
| Маршрут | Тип | Транспорт | Оплата за остановку | Время на остановку | Остановок за смену |
|---|---|---|---|---|---|
Downtown Cab Co. (taxi) | Random stops | taxi | $120 | 4 с | 8 |
Dashound Bus (bus) | Stops in order | bus | $60 | 6 с | 0 (бесконечно) |
Post OP Freight (trucker) | Random stops | rumpo | $250 | 8 с | 5 |
Los Santos Sanitation (garbage) | Random stops | trash2 | $90 | 6 с | 10 |
Recycling Center (recycle) | Gathering | нет, даёт scrapmetal | 5 с | 0 (бесконечно) | |
Marlowe Vineyard (vineyard) | Gathering | нет, даёт grape | 4 с | 0 (бесконечно) | |
Del Perro Diving (diving) | Gathering | нет, даёт coral | 8 с | 7 | |
Hayes Towing (tow) | Towing | flatbed | $250 | 8 с | 5 |
Weazel News (news) | Random stops | rumpo | $180 | 15 с | 5 |
Вкладка Stops
Одна запись на остановку. Маршрут без остановок нельзя начать. Удаление маршрута сохраняет его остановки.
| Настройка | Что меняет | По умолчанию |
|---|---|---|
| Route | Id маршрута, к которому относится эта остановка (taxi, bus...). | taxi |
| Name | Название остановки. 1-48 символов. | пусто |
| Place | Где останавливается работник. Встаньте на место и используйте свою позицию. | 0, 0, 0 |
Вкладка Hot dog stand
Stand (ларёк)
| Настройка | Что меняет | Единица | По умолчанию |
|---|---|---|---|
| Open | Выкл. скрывает стойку. Уже арендованные ларьки продолжают работать, пока их не вернут. | вкл. | |
| Counter | Где игроки арендуют и возвращают ларёк. | 39.31, -1005.54, 29.48 (Legion Square) | |
| Stand spawn | Где появляется арендованный ларёк, лицом туда, куда должен смотреть прилавок ларька. | 38.15, -1001.65, 29.44 | |
| Stand model | Проп ларька. | prop_hotdogstand_01 | |
| Jobs / Gangs / Only on duty | Кто может арендовать ларёк (то же правило, что и для маршрутов). Пусто: все. | пусто | |
| Map blip | Блип стойки. | спрайт 542, цвет 17, размер 0.6 |
Money (деньги)
| Настройка | Что меняет | Единица | По умолчанию |
|---|---|---|---|
| Deposit | Списывается при аренде ларька, возвращается, когда его возвращают у стойки (теряется при выходе из игры). 0-1,000,000. | $ | 250 |
| Deposit account | Счёт, с которого списывается и на который возвращается залог. | bank | |
| Sales paid into | Счёт, на который идут деньги покупателя. | cash |
Cooking and reputation (готовка и репутация)
| Настройка | Что меняет | По умолчанию |
|---|---|---|
| Skill checks | Проверок навыка на один хот-дог. 1-10. | 3 |
| Reputation per perfect | Репутация за идеальный хот-дог. 0-100. | 3 |
| Reputation per rare | Репутация за редкий хот-дог. 0-100. | 2 |
| Reputation per common | Репутация за обычный хот-дог. 0-100. | 1 |
| Highest reputation | Здесь репутация перестаёт расти. 0-100,000. | 200 |
Levels и Prices (один список, до 10 уровней; первый действует с 0)
| Настройка | Что меняет |
|---|---|
| From reputation | Репутация, с которой начинается этот уровень. |
| Hot dogs per quality | Сколько хот-догов каждого качества может вмещать ларёк на этом уровне. |
| Perfect from / to, Rare from / to, Common from / to | Диапазон цены одного хот-дога этого качества в $. Каждое предложение выбирает цену в диапазоне. |
Уровни по умолчанию:
| From reputation | Хот-догов каждого качества | Perfect | Rare | Common |
|---|---|---|---|---|
| 0 | 15 | $8-12 | $6-9 | $4-6 |
| 50 | 30 | $9-13 | $7-10 | $5-7 |
| 100 | 45 | $10-14 | $8-11 | $6-9 |
| 200 | 60 | $11-15 | $9-12 | $7-9 |
У ларька также есть карточка NPC (модель, анимация ожидания, позиция), как у маршрутов.
Команды
Нет.
Привязки клавиш
Каждый игрок может изменить их в настройках клавиш GTA (раздел FiveM); владелец меняет значения по умолчанию в админ-панели (Keybinds).
| Клавиша по умолчанию | Что делает |
|---|---|
| G | Отпустить ларёк с хот-догами, который вы толкаете (jobs_hotdog_release). |
Базы, остановки, стойка и ларёк являются точками взаимодействия: подсказка с клавишей взаимодействия (по умолчанию E) или опция target, в зависимости от настройки Interaction style в ai-core.
Что он заменяет
Нет fxProvide. Один движок покрывает то, что QBCore / Qbox поставляют отдельными скриптами работ (такси, автобус, дальнобойщик, мусоровоз, эвакуатор, новости и работы по сбору), а ларёк с хот-догами является портом qb-hotdogjob. Он не отвечает на экспорты или события этих скриптов.
Совместимые скрипты
Ключи рабочего транспорта идут через слой ключей AI Core, предметы через слой инвентаря. Работает любой скрипт ключей и инвентарь, которые поддерживает AI Core (см. Совместимость).
Известные ограничения
- Смена хранится только в памяти: выход с сервера или перезапуск ресурса её заканчивает, и рабочий транспорт удаляется.
- Сервер отклоняет остановку, если игрок дальше 12 м от неё, дальше 15 м от рабочего транспорта (маршруты на транспорте) или прибывает от предыдущей остановки быстрее 60 м/с (телепорт).
- Хот-доги не являются предметами инвентаря: запас хранится в ларьке, а покупатели только NPC. Игроки не могут покупать друг у друга.
- Каналы логов:
work(оплата маршрутов) иhotdog(продажи).