FiveM: рэгдолл и урон по частям тела для реализма

MAATRIX GAMES

Стандартная система урона в GTA V — это один общий пул HP и рэгдолл, который срабатывает почти случайно: то персонаж красиво падает от пистолетного выстрела в плечо, то стоит на ногах после дробовика в упор. На RP-сервере это разрушает атмосферу перестрелок и превращает серьёзные сцены (ограбление, разборка фракций) в фарс. Разберём, как настроить рэгдолл-физику при попадании и урон по конкретным частям тела, чтобы перестрелки ощущались весомее — без переписывания половины геймплея с нуля.

Почему стандартный HP-урон в FiveM быстро надоедает на RP

В ванильной GTA V здоровье персонажа — это одно число (GetEntityHealth/SetEntityHealth), а рэгдолл — побочный эффект больших разовых повреждений или столкновений, который движок решает сам по внутренней логике. На RP-сервере, где перестрелки — центральная часть геймплея фракций и полиции, плоская система создаёт конкретные проблемы: выстрел в ногу убивает так же «полноценно», как в грудь, никто не хромает и не роняет оружие от боли, а рэгдолл либо не срабатывает вообще, либо выглядит комично на глазах у зрителей сцены.

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

Если сервер ещё не поднят — сначала база: установка ESX или QBCore, а если не определился с ядром — есть сравнение ESX и QBCore, от выбора фреймворка зависит, где именно у тебя будут храниться метаданные ранений.

Рэгдолл-физика: базовые natives и готовые ресурсы

Управление рэгдоллом в FiveM делается клиентскими нативами GTA V. Ключевые из них:

-- Включить/выключить возможность рэгдолла у конкретного педа
SetPedCanRagdoll(ped, true)

-- Заставить педа упасть в рэгдолл вручную
-- time1/time2 — минимальная/максимальная длительность в мс, ragdollType — стиль падения
SetPedToRagdoll(ped, 1500, 2500, 0, false, false, false)

-- Автоматический рэгдолл при столкновениях (машина, падение с высоты)
SetPedRagdollOnCollision(ped, true)

По документации нативов GTA V параметр ragdollType в SetPedToRagdoll переключает манеру падения (обычное, с жёсткими ногами, с широкой или узкой стойкой ног) — конкретные значения стоит свериться в актуальном native reference, так как нумерация не всегда интуитивна и не документирована официально Rockstar. На практике для «упал от попадания» достаточно значения 0 и разумной длительности в 1–3 секунды — дольше персонаж просто беспомощно лежит и раздражает игрока, который не может встать.

Писать ragdoll-логику с нуля обычно не нужно: в комьюнити FiveM есть готовые ресурсы под эту задачу, самый известный — pickle_ragdoll (открытый исходник на GitHub). Он вешает рэгдолл на попадание пулей с настраиваемым шансом по категориям оружия, добавляет состояние «без сознания» с таймером на восстановление и синхронизирует падение между клиентами — без серверной синхронизации у одних игроков персонаж будет падать, а у других на том же месте продолжать стоять. Перед вайпом продакшена проверь совместимость последней версии ресурса со своим фреймворком — часть конфигов между релизами меняется.

Примерная логика того, что обычно настраивается в конфиге такого ресурса (сверяйся с актуальным файлом конкретной версии, а не переноси один в один):

Config.RagdollChance = {
    pistol = 15,     -- шанс рэгдолла в % от пистолетного попадания
    smg = 25,
    shotgun = 60,
    rifle = 45,
    sniper = 95,
}
Config.UnconsciousTime = { min = 20000, max = 45000 } -- мс без сознания при критическом уроне

Как определить, в какую часть тела пришёлся урон

Голый рэгдолл — это только половина задачи, вторая половина — понять, куда именно пришлось попадание, чтобы применить разный эффект. GTA V даёт для этого native GetPedLastDamageBone, который возвращает индекс последней задетой кости:

local function GetHitZone(ped)
    local success, boneId = GetPedLastDamageBone(ped)
    if not success then return 'torso' end

    local zones = {
        [GetEntityBoneIndexByName(ped, 'SKEL_Head')]      = 'head',
        [GetEntityBoneIndexByName(ped, 'SKEL_Neck_1')]    = 'head',
        [GetEntityBoneIndexByName(ped, 'SKEL_L_UpperArm')] = 'left_arm',
        [GetEntityBoneIndexByName(ped, 'SKEL_R_UpperArm')] = 'right_arm',
        [GetEntityBoneIndexByName(ped, 'SKEL_L_Forearm')]  = 'left_arm',
        [GetEntityBoneIndexByName(ped, 'SKEL_R_Forearm')]  = 'right_arm',
        [GetEntityBoneIndexByName(ped, 'SKEL_L_Thigh')]    = 'left_leg',
        [GetEntityBoneIndexByName(ped, 'SKEL_R_Thigh')]    = 'right_leg',
        [GetEntityBoneIndexByName(ped, 'SKEL_L_Calf')]     = 'left_leg',
        [GetEntityBoneIndexByName(ped, 'SKEL_R_Calf')]     = 'right_leg',
    }

    return zones[boneId] or 'torso'
end

Момент, который стоит проверить самому: вызов нужно делать сразу после события повреждения, пока последняя кость ещё актуальна. Сам момент попадания удобно ловить через AddEventHandler('gameEventTriggered', ...), слушая событие CEventNetworkEntityDamage — оно приходит при любом сетевом уроне педу и несёт флаги вроде «урон от оружия», «урон от рукопашной» и признак смерти. Точный порядок аргументов этого события менялся между билдами CitizenFX, поэтому не переноси чужой код с индексами args[7], args[15] бездумно — сверься с актуальным native reference и залогируй событие целиком через json.encode(args) на тестовом сервере, чтобы увидеть реальную структуру на своей сборке.

Серверную часть урона лучше держать авторитетной: клиент присылает серверу, что попал по такому-то педу в такую-то зону, а сервер уже сам решает, сколько снять HP — иначе игрок с модифицированным клиентом сможет слать фейковые события «попал в ногу» с нулевым уроном.

Модель урона по частям тела: пороги и эффекты

Дальше — дизайнерское решение, а не техническое: как именно зона попадания должна влиять на исход. Рабочая база, от которой можно оттолкнуться и подстроить под темп своего сервера:

Хромоту от ранения ноги проще всего реализовать не через физический перелом кости (это тяжело и плохо синхронизируется), а через снижение параметров спринта и форсированную анимацию хромой походки:

-- клиент, после подтверждения ранения ноги от сервера
SetRunSprintMultiplierForPlayer(PlayerId(), 0.6)
RequestAnimSet('move_m@injured')
SetPedMovementClipset(PlayerPedId(), 'move_m@injured', 0.5)

Для руки логичнее не трогать физику стрельбы напрямую (это конфликтует с большинством стрелковых читов-детектов), а снижать точность мягче — через увеличение разброса прицела в скрипте оружия или временное отключение прицеливания в упор (ADS), если у сервера уже есть кастомный weapon-скрипт, который это позволяет.

Кровотечение стоит делать отдельной таймерной механикой поверх зон: после ранения торса или конечности персонаж медленно теряет HP, пока не применена перевязка (бинт/аптечка как предмет инвентаря) или помощь EMS-игрока. Это близко к тому, что используют RP-серверы в скриптах медслужбы (qb-ambulancejob и аналоги), где состояние ранений хранится в метаданных персонажа и переживает релог — если такой ресурс уже стоит на сервере, проще расширить его систему «wounds», чем городить параллельную.

Интеграция с фреймворком: где хранить состояние ранения

И в ESX, и в QBCore подходящее место для хранения текущих зон урона — метаданные персонажа, а не отдельная таблица в базе, если только тебе не нужна долгая история ранений для медицинской RP-механики. В QBCore это Player.PlayerData.metadata, дополненный собственным полем:

Player.Functions.SetMetaData('bodydamage', {
    head = 0, torso = 0,
    left_arm = 0, right_arm = 0,
    left_leg = 0, right_leg = 0,
})

Клиентские эффекты (хромота, дрожь прицела) навешиваются на событие обновления этих метаданных, а не пересчитываются на каждый тик — иначе получишь лишнюю нагрузку без пользы, раз сама зона урона меняется только в момент попадания. Сброс bodydamage логично делать при полном излечении у EMS или в больнице, а не автоматическим угасанием со временем — иначе теряется смысл ходить к медику, и вся механика превращается в чистый таймер ожидания.

Для торса имеет смысл сохранить привычную логику брони (SetPedArmour/GetPedArmour) — бронежилет должен поглощать урон именно в грудь и живот, а не защищать от ранения в ногу или руку, это самое интуитивное для игрока правило и оно же добавляет тактического смысла в позиционирование во время перестрелки.

Баланс перестрелок: на что это реально влияет

Система урона по зонам меняет темп PvP сильнее, чем кажется на старте разработки, и это стоит продумать заранее, а не по факту жалоб игроков:

• Время до нейтрализации (TTK) становится менее предсказуемым. Хедшот с высоким множителем резко укорачивает бой — это честно для шутера, но может ощущаться как «рандомная смерть» в медленном RP-темпе. Проверяй множители на тестовых перестрелках с добровольцами, а не только в теории.
• Ранение ноги не должно превращаться в гарантированную смерть. Если хромота снижает скорость слишком сильно, раненый не может ни отступить, ни получить помощь — это фрустрация, а не реализм. Мягче снижать скорость (на 30–40%), чем обездвиживать полностью.
• Рэгдолл при массовых перестрелках нагружает сеть. Каждое падение — синхронизация физики педа между клиентами; на сценах с 15–20 участниками (штурм фракции, крупный ивент) стоит ограничивать частоту рэгдолла кулдауном на игрока, а не пересчитывать на каждое попадание. Заодно посмотри оптимизацию FPS на больших RP-картах, если сервер и так просаживается на массовых сценах.
• Авторитетность сервера — это ещё и защита от читеров. Система, которая доверяет клиенту цифры урона или зону попадания без проверки, открывает дыру для «no-damage» и «god mode» модов — доверяй только серверным расчётам, клиент присылает лишь событие «что произошло». Тема читов подробнее — в статье про защиту от читеров на GTA-серверах.

Частые вопросы