ai-hud
HUD и потребности персонажа. Здоровье, броня, голод, жажда, стресс, деньги, работа, спидометр, название улицы, голос и подсказки клавиш.
ai-hud рисует HUD и следит за потребностями персонажа: голодом, жаждой и стрессом. Голод и жажда со временем падают, а еда и напитки их восполняют; стресс растёт от стрельбы и быстрой езды и спадает сам.
Что он делает в игре
- Индикаторы состояния. Здоровье, броня, голод, жажда и стресс.
- Деньги. Наличные и банк, справа вверху.
- Имя и работа. Работа (та, на дежурстве в которой игрок, иначе первая) с рангом, серверный id и имя персонажа, справа вверху. "Off duty" показывается, когда игрок не на дежурстве.
- Блок оружия. Пока в руках оружие: его название, картинка и патроны, под деньгами.
- Спидометр. В транспорте: скорость, передача, топливо и предупреждение о ремне.
- Улица и район рядом с миникартой.
- Голос. Микрофон, дальность голоса, разговор и рация (нужен ai-voice или pma-voice).
- Подсказки клавиш. Слева клавиши того, что игрок может сделать сейчас (пешком или в транспорте).
- Миникарта. Всегда или только в транспорте, как указано в панели. Собственные полосы здоровья и брони GTA под ней скрыты.
- Скрывается сам без персонажа, в меню паузы, во время затемнения экрана и пока открыто полноэкранное меню.
- Настройки игрока.
/hudили пункт радиального меню HUD settings: каждый игрок отключает для себя части HUD. Часть, которую отключила панель, остаётся отключённой.
Как работают потребности
- Голод и жажда идут от 100 (сыт) вниз до 0. Стресс идёт от 0 (спокоен) вверх до 100.
- Каждую минуту игры голод и жажда падают, а стресс спадает на величины из панели.
- Пока голод или жажда на 0, персонаж теряет здоровье каждые 10 секунд.
- Стрельба и быстрая езда добавляют стресс.
- Еда, напитки и другие предметы меняют потребности на свои значения Hunger, Thirst и Stress в настройках предметов инвентаря (ai-inventory).
- Потребности сохраняются в персонаже (ключи метаданных QB
hunger,thirst,stress), поэтому скрипты QB тоже их читают.
Установка
Его устанавливает рецепт AI Core для txAdmin. Вручную: положите папку в resources/[ai]/ и добавьте ensure ai-hud в server.cfg после ensure ai-core. Ему нужен ai-core. Собственной таблицы в базе данных у него нет.
Запускайте только один HUD. AI Core не сообщает о двух одновременно запущенных HUD.
Настройки панели
Откройте админ-панель (F10) и выберите HUD. Всё находится на одной вкладке, HUD and needs.
Needs (потребности): голод и жажда со временем падают; предметы еды и напитков их восполняют.
| Настройка | Что меняет | Значения | По умолчанию |
|---|---|---|---|
| Hunger drop | Очки, которые теряются каждую минуту от 100. 0.25 опустошает примерно за 6,5 часа игры. | от 0 до 10 в мин | 0.25 |
| Thirst drop | Очки, которые теряются каждую минуту от 100. | от 0 до 10 в мин | 0.35 |
| Stress fade | Очки стресса, которые спадают каждую минуту. | от 0 до 10 в мин | 0.5 |
| Stress speed | Езда быстрее этой скорости может добавить очко стресса. 0 отключает. | от 0 до 500 км/ч | 160 |
| Speed stress chance | Шанс добавить очко при каждом изменении скорости выше скорости стресса. | от 0 до 100 % | 1 |
| Stress per shot | Очки, которые добавляет выстрел, не чаще раза в секунду. 0 отключает. | от 0 до 5 | 1 |
| Damage when empty | Здоровье, которое теряется каждые 10 секунд, пока еда или вода на 0. 0 отключает. | от 0 до 50 HP | 2 |
What the HUD shows (что показывает HUD): части HUD, которые игроки видят во время игры.
| Настройка | Что меняет | Значения | По умолчанию |
|---|---|---|---|
| Health and needs | Индикаторы состояния. | вкл. / выкл. | вкл. |
| Money | Наличные и банк. | вкл. / выкл. | вкл. |
| Speedometer | Указатель в транспорте. | вкл. / выкл. | вкл. |
| Street name | Улица и район. | вкл. / выкл. | вкл. |
| Voice | Микрофон и дальность голоса (нужен ai-voice или pma-voice). | вкл. / выкл. | вкл. |
| Name and job | Справа вверху: работа, её ранг, серверный id и имя персонажа. | вкл. / выкл. | вкл. |
| Speed unit | Единица спидометра. | km/h / mph | km/h |
Map and key hints (карта и подсказки клавиш): когда показывается миникарта и список клавиш слева на экране.
| Настройка | Что меняет | Значения | По умолчанию |
|---|---|---|---|
| Minimap | Always или Only in a vehicle. | Always / Only in a vehicle | Only in a vehicle |
| Key hints | Клавиши того, что игрок может сделать сейчас, слева на экране. Какие клавиши показываются и когда, задаётся для каждой клавиши во вкладке Keybinds. | вкл. / выкл. | вкл. |
Команды
| Команда | Аргументы | Кто | Что делает |
|---|---|---|---|
/hud | нет | все | Открывает настройки HUD: по одному переключателю на каждую часть HUD и подсказки клавиш, сохраняются для этого игрока. |
Привязки клавиш
Собственных нет. Подсказки клавиш, которые он показывает, берутся из привязок клавиш каждого скрипта.
Работа с другими скриптами
- Топливо от любого скрипта топлива, который выставляет state bag транспорта
fuel(ai-fuel и другие через слой топлива AI Core). - Ремень безопасности через слой ремня безопасности AI Core (ai-smallresources и другие скрипты ремня).
- Голос от ai-voice или pma-voice.
- Потребности от предметов любого инвентаря, который задаёт значения голода, жажды или стресса (событие использования предмета AI Core).
- Стресс от других скриптов через слой стресса AI Core (
stressиз lib), который вызывает ai-hud. - Его можно заменить. AI Core скрывает и показывает другие HUD (tgiann-lumihud, jg-hud, 0r-hud-v3, codem-supreme-hud, qb-hud, ps-hud и другие) и открывает их настройки из радиального меню. См. Совместимость.
Известные ограничения
- Стресс от клиента ограничен значением от 1 до 5 очков за сообщение и двумя сообщениями в секунду; всё остальное решается на сервере.
- Режим миникарты выбирает владелец: игроки не могут изменить его в
/hud. Администратор может оставить её для себя пешком через меню ai-admin.
ai-inventory для разработчиков
Серверные и клиентские экспорты ai-inventory, используемые предметы, магазины из скриптов, событие usedItem и API ox_inventory и qb-inventory, на которые он отвечает.
ai-hud для разработчиков
Экспорты ai-hud для потребностей (голод, жажда, стресс) и его настроек HUD, а также что он читает из других скриптов.