Agency-Repairkit: Простые ремонты транспортных средств, которые игроки действительно используют

Проблема полевого ремонта

Ваш транспорт повреждается во время миссии. Мастерская в 10 минутах езды. Ожидание этой поездки убивает темп любой экшен-сцены. Но мгновенный саморемонт кажется несправедливым. Agency-Repairkit находит золотую середину с используемыми, но ограниченными инструментами полевого ремонта.

Три уровня комплектов

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

Целостность анимации

Каждый ремонт сопровождается видимой анимацией в повреждённой части транспорта. Игроки не могут быстро починить из водительского сиденья, им нужно выйти, подойти к повреждению и выполнить анимацию ремонта. Это предотвращает злоупотребления ремонтом в бою и делает действие заслуженным.

Важность прерываний

Получение урона или попадание во время ремонта прерывает его и расходует набор. Ремонт происходит вне боя, не посреди него. Это защищает погони от превращения в whack-a-mole, где ничего не фиксируется.

Интеграция экономики

Ремонтные наборы изготавливаются механиками NPC или игроками-механиками через цепочку поставок металла Agency-Minerjob. Вся автомобильная экономика, добыча, крафт, полевые и магазинные ремонты становятся связанной системой. Наборы , это не одноразовый предмет, а узел в большой системе.

Установка & настройка

Скачайте Agency-Repairkit из вашей библиотеки Tebex и поместите папку в директорию ресурсов. Добавьте ensure agency-repairkit в server.cfg. Для постоянного отслеживания комплектов между перезапусками ресурс требует oxmysql; без него количество комплектов сохраняется только в сессии и сбрасывается при перезапуске сервера.

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

Параметры конфигурации

Параметр config.lua предоставляет полный контроль над поведением набора:

• Уровни наборов , определяйте любое количество типов наборов, каждый с максимальным количеством ремонта, скоростью ремонта и длительностью анимации.
• Блокировка боя", разрешать ли ремонт, если игрок помечен как находящийся в бою. По умолчанию: отключено во время боя.
• Порог повреждений при прерывании , сколько входящего урона отменяет активный ремонт. Установите 0, чтобы любой удар отменял его.
• Анимация по зоне повреждения , для повреждений двигателя, кузова и шин проигрываются разные анимации.
• Интеграция экономики , включить хук события крафта, чтобы выход металла из Agency-Minerjob мог использоваться для создания наборов.

Совместимость с фреймворками

Agency-Repairkit ships with built-in adapters for QBCore and ESX. Framework detection is automatic, drop the resource in, and it detects which you're running. For standalone servers:

• Реализовать Config.GetItem и Config.RemoveItem подключить вашу систему предметов.
• Реализовать Config.GetVehicleHealth и Config.SetVehicleHealth для вашего слоя повреждений транспортного средства.
• Всё остальное (анимации, UI, логика прерываний) работает без изменений.

Почему это важно для ролевой игры

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

Система комплектов с уровнями создает естественные экономические решения в инвентаре. Носить ли профессиональный комплект "на всякий случай" и платить за его ношение? Или полагаться на базовые комплекты и принять, что серьезный урон потребует посещения мастерской? Такие значимые мелкие решения делают управление инвентарем реалистичным, а не произвольным.

Механика прерывания боя особенно важна для chase RP. Без неё преследуемый игрок мог бы ремонтировать машину прямо во время погони, что полностью снижает напряжение. С ней ремонт становится постконфликтной или межсценной активностью, а не кнопкой паники.

Часто задаваемые вопросы

Могут ли механики продавать ремонтные комплекты из своего меню?

Да. Agency-Repairkit экспортирует серверное событие agency-repairkit:giveKit который может вызвать любой скрипт механика. Передайте серверный ID игрока, уровень комплекта и количество. Ваш существующий скрипт механика магазина просто должен добавить один вызов события в свою процедуру продажи.

Работает ли комплект на лодках и самолетах?

Да. Система повреждений использует нативные свойства здоровья транспортных средств FiveM, применимые ко всем типам транспорта. Самолёты используют упрощённую анимацию (игроки не могут ходить по конкретной зоне повреждения в полёте), а лодки ремонтируются с позиции у причала. Оба поведения настраиваемы.

Могу ли я ограничить, какие уровни комплектов могут использовать определённые профессии?

Доступ к комплектам по работе поддерживается в определении предметов. Установите requiredJob = 'mechanic' привязано к типу набора, и использовать его могут только игроки с этой профессией. Это полезно, если вы хотите, чтобы профессиональные наборы были инструментом исключительно для механиков, а не товаром для покупки.

Как комплект взаимодействует со скриптами респауна транспорта?

Agency-Repairkit fires agency-repairkit:onRepairComplete с netId транспортного средства и суммой ремонта при успешном использовании набора. Любой скрипт, слушающий это событие, может реагировать соответствующим образом, ваш скрипт сохранения транспорта может пометить транспорт как отремонтированный на месте для целей логирования.

Требования

• Сервер FiveM (QBCore, ESX или standalone)
• oxmysql (опционально, для постоянного отслеживания комплектов)
• аккаунт cfx.re с действующей лицензией Agency-Repairkit
• Регистрация предметов фреймворком для комплектов

Балансировка ремонтных наборов в экономике вашего сервера

Экономический вопрос, который серверы чаще всего задают про Agency-Repairkit: насколько редкими должны быть наборы? Ответ зависит от текущего баланса экономики вашего сервера.

Если на вашем сервере активны автомастерские с хорошим ролевым взаимодействием, сделайте базовые и продвинутые наборы доступными, а профессиональные , редкими или эксклюзивными для механиков. Это возвращает крупный ремонт в мастерские, позволяя выполнять мелкий ремонт на месте, сохраняя жизнеспособность механика RP.

Если на вашем сервере проблемы с вовлечённостью игроков в работу механиков, уменьшите доступность полевых наборов и убедитесь, что наборы, созданные механиками, лучше коммерчески доступных. Экономический стимул посещать игрока-механика должен быть реальным, а не только нарративным.

Если на вашем сервере сильная криминальная экономика, цены на наборы через Agency-Blackmarket или крафт игроками создают параллельный рынок. Ремонтные наборы военного уровня как товары чёрного рынка создают интересный логистический RP, не подрывая рынок гражданских механиков.

Ключевой принцип: ремонт на месте должен восприниматься как полезный вариант, а не оптимальный. Если игроки никогда не посещают автомастерские, ваши наборы слишком мощные или слишком дешевые. Регулируйте выход и цену вместе, а не по отдельности.