Перейти к содержанию

Клиентский API

CLIENT отвечает за отображение и полученные снимки состояния. ИИ акторов управляет сервер.

Actor

SyncState

actor:SyncState(state)

Внутренняя клиентская синхронизация: сохраняет имя без серверных callbacks. Полная таблица данных состояния клиенту не передаётся.

Исходник: lua/background_npcs_core/actor/components/sh_state.lua.

Окно настроек

Исходник: lua/background_npcs_core/ui/menu/cl_menu.lua; полный пример — расширение меню.

API Назначение
bgNPC.Menu.AddPage(id, def) Регистрирует {title, order, icon, group, build}; build получает страницу.
bgNPC.Menu.RemovePage(id) Удаляет страницу из реестра.
bgNPC.Menu.Open(page_id), Close(), IsOpen() Жизненный цикл окна.
bgNPC.Menu.ShowPage(page_id) Выбор существующей страницы.
bgNPC.Menu.Text(value), Phrase(key) Разрешение локализованных строк.
bgNPC.Menu.IsAdmin() Проверка отображения; сервер всё равно проверяет права.
bgNPC.Actors.ReceiveBinding(npc, npc_type, uid, info, generation, class, model) Внутренний приёмник привязки: игнорирует старые поколения, сохраняет UID. Не создавайте клиентских акторов независимо.

Голоса, субтитры, HUD розыска, исчезновение тел, визуальная толпа и отладка находятся в cl_-файлах. Они обрабатывают серверные события, а не выполняют отдельный клиентский ИИ.