DrawMarker, помощь текста и lib.showTextUI без лага в FiveM

Вы рисуете маркер, подходите к нему и он мерцает, или никогда не показывается, или ваш скрипт сидит на 0.30 мс в resmon не делая ничего. Маркеры и подсказки «Press E» выглядят простыми, но они классический источник тяжёлых циклов. Эта статья показывает, как рисовать маркер правильно, как показывать подсказку, и как перестать платить за это, когда игрок далеко.

#DrawMarker должна работать каждый кадр

Маркер рисуется в течение одного кадра каждый раз, когда вы вызываете DrawMarker. Чтобы держать это на экране, вы вызываете это снова каждый кадр, в цикле с Wait(0):

local coords = vec3(441.2, -981.9, 30.7)

CreateThread(function()
    while true do
        DrawMarker(
            1,                                  -- type: cylinder
            coords.x, coords.y, coords.z - 1.0, -- position (on the ground)
            0.0, 0.0, 0.0,                      -- direction
            0.0, 0.0, 0.0,                      -- rotation
            1.5, 1.5, 0.5,                      -- scale
            50, 150, 255, 120,                  -- red, green, blue, alpha
            false, false, 2, false, nil, nil, false
        )
        Wait(0)
    end
end)

Это работает, но это работает каждый кадр для целого сеанса, даже когда игрок по всей карте. Исправьте это далее.

#Рисуйте только когда игрок рядом

Измеряйте расстояние и спите дольше, когда игрок далеко. Только близкое состояние требует Wait(0):

local coords = vec3(441.2, -981.9, 30.7)

CreateThread(function()
    while true do
        local sleep = 1000
        local pedCoords = GetEntityCoords(PlayerPedId())
        local distance = #(pedCoords - coords)

        if distance < 15.0 then
            sleep = 0
            DrawMarker(1, coords.x, coords.y, coords.z - 1.0,
                0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 1.5, 1.5, 0.5,
                50, 150, 255, 120, false, false, 2, false, nil, nil, false)

            if distance < 1.5 then
                -- show the prompt here (next section)
            end
        end

        Wait(sleep)
    end
end)

Далеко, цикл просыпается один раз в секунду и делает одно вычитание. Рядом маркера он работает за кадр, только пока ему требуется. Почему это имеет значение и как читать это в resmon находится в resmon high ms: как оптимизировать.

Совет: #(a - b) — это длина векторной разности, расстояние. Ему требуются значения vec3, которые GetEntityCoords уже возвращает.

#Типы маркеров

Первый аргумент — это тип маркера, число. Несколько, которые серверы используют много:

Полный список типов находится на сайте документации FiveM, под ссылками игры, маркеры. Аргументы масштаба меняют размер, и последнее значение цвета — это альфа (прозрачность). Поместите маркер земли на z - 1.0, чтобы он сидел на полу, а не плавал на талии игрока.

#Помощь текста: встроенная подсказка

Игра имеет справочное сообщение вверху слева экрана. Вы определяете ярлык, затем отображаете его каждый кадр, пока игрок в диапазоне:

AddTextEntry('MY_SCRIPT_HELP', 'Press ~INPUT_CONTEXT~ to open the garage')

local function showHelp()
    BeginTextCommandDisplayHelp('MY_SCRIPT_HELP')
    EndTextCommandDisplayHelp(0, false, true, -1)
end

~INPUT_CONTEXT~ заменяется на ключ, который игрок использует для действия контекста, по умолчанию E. Вызовите showHelp() внутри ветки distance < 1.5 выше, затем проверьте ключ:

if distance < 1.5 then
    showHelp()
    if IsControlJustReleased(0, 38) then
        print('opened')
    end
end

Зарегистрируйте ярлык один раз вверху файла, не внутри цикла.

#lib.showTextUI и lib.hideTextUI

С ox_lib вы можете показать стилизованную подсказку, и вы вызываете её один раз когда игрок входит, не каждый кадр:

lib.showTextUI('[E] Open the garage', {
    position = 'right-center',
    icon = 'warehouse',
})

-- when the player leaves:
lib.hideTextUI()

lib.isTextUIOpen() говорит вам, если один уже на экране. Ему требуется shared_script '@ox_lib/init.lua' в вашем манифесте (см. ox_lib menu guide). Текст не привязан к ключу: вы всё ещё проверяете ключ сами, или используете привязку ключей.

#ox_lib точки: вообще никакого цикла расстояния

Написание цикла расстояния вручную для каждой зоны накапливается. lib.points делает это для вас: ox_lib проверяет расстояние игрока ко всем точкам вместе, и только запускает ваш код рядом с ними:

local point = lib.points.new({
    coords = vec3(441.2, -981.9, 30.7),
    distance = 15.0,
})

function point:onEnter()
    lib.showTextUI('[E] Open the garage')
end

function point:onExit()
    lib.hideTextUI()
end

function point:nearby()
    DrawMarker(1, self.coords.x, self.coords.y, self.coords.z - 1.0,
        0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 1.5, 1.5, 0.5,
        50, 150, 255, 120, false, false, 2, false, nil, nil, false)

    if self.currentDistance < 1.5 and IsControlJustReleased(0, 38) then
        print('opened')
    end
end

Как это работает:

• onEnter работает один раз, когда игрок входит в distance.
• onExit работает один раз, когда они уходят.
• nearby работает каждый кадр, пока они находятся внутри distance, и вообще не иначе. Это где идёт DrawMarker.
• self.currentDistance — это текущее расстояние к точке.

Вы можете создать сотни точек и только те, рядом с которыми игрок стоит, стоят что-то. Удалите точку, которую вам больше не нужны с point:remove().

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

• Одна или две зоны: цикл расстояния со сном хорошо.
• Много зон, или скрипт, который создаёт зоны из конфига: используйте lib.points.
• Взаимодействия на объектах и персонажах: target лучше чем маркер. См. ox_target: как добавить targets.

#Контрольный список