FiveM Native Database Поиск

Поиск по 200+ распространённым FiveM native по имени, хэшу или категории. Получите параметры, типы возвращаемых значений, описания и примеры на Lua.

Для чего этот инструмент

FiveM предоставляет тысячи игровых natives, и их имена описывают движок, а не задачу, поэтому найти нужный обычно значит уже знать его. Этот поиск ограничен natives, которые реально используются в серверной разработке, сгруппированы по областям, с параметрами, типом возвращаемого значения и примером использования рядом с каждой записью.

Как использовать

  1. Шаг 1:

    Ищите по имени, если знаете его, или просматривайте категорию, соответствующую вашей задаче, например vehicles или peds.

  2. Шаг 2:

    Читайте параметры. Порядок важен, в Lua нет именованных аргументов.

  3. Шаг 3:

    Проверьте тип возвращаемого значения. Многие natives возвращают дескриптор, который нужно сохранить, чтобы потом изменить сущность.

  4. Шаг 4:

    Скопируйте пример и адаптируйте его, вместо того чтобы писать вызов по памяти.

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

В чём разница между client и server natives?

Большинство игровых natives существуют только на клиенте, потому что только клиент рендерит мир. На сервере есть гораздо меньший набор natives, связанных с игроками, сущностями и идентификаторами. Вызов клиентского native на сервере просто не существует и вызывает ошибку.

Почему native возвращает пустое значение?

Обычно сущность ещё не существует или не принадлежит этому клиенту. Для моделей нужно использовать RequestModel и ждать HasModelLoaded, а native для сущностей возвращают ноль для всего, что вне области игрока.

Могу ли я вызывать natives по хешу?

Да, Citizen.InvokeNative с хешем работает и иногда это единственный вариант для natives без Lua-обёртки. Это сложнее читать, поэтому предпочитайте именованную форму, если она есть.

Как понять, что native затратный?

Каждый вызов native пересекает границу между Lua и игровым движком, поэтому затраты зависят от количества вызовов, а не от каждого отдельно. Native внутри цикла с 0 мс выполняется шестьдесят раз в секунду. Кэшируйте результаты, которые не меняются в кадре.