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

Параметры актора

Конфигурации: lua/background_npcs_core/config/actors/. Пример полного модуля, изменение существующего.

Поле Тип Назначение
enabled boolean Включён по умолчанию
class string / table Класс сущности или список классов; обязателен для SetActor
name string Название в меню
inherit string ID актора, из которого берутся отсутствующие поля
fullness number Доля общего лимита, 0–100; для фиксированного limit поле должно отсутствовать, в том числе у родителя
limit number Фиксированный лимит вместо процентного заполнения
team table Команды: например residents, police, bandits, zombies
health number / table Здоровье или диапазон { min, max }
weapons table Классы оружия для выбора
getting_weapon_chance number / false Шанс оружия; false — всегда
weapon_skill enum WEAPON_PROFICIENCY_*, влияет и на NextBot
brain string fsm или goap при автоматическом выборе мозга
models table Пути моделей .mdl, которые должны быть установлены
default_models boolean Использовать стандартные модели
random_skin, random_bodygroups boolean Случайные скины и группы тела
at_random table Относительные веса спокойных состояний
at_damage, at_protect table Веса реакций на урон себе и союзнику
disable_states boolean true отключает управление состояниями Background NPCs
replics table Привязки реплик к state_names и state_groups
respawn_delay number Задержка после смерти, секунды. Каждая смерть типа ставит одно отложенное появление в очередь. Наследуется через inherit; потомок отключает её значением 0 (не false)
wanted_level number Уровень появления при включённой системе розыска
money number / table Сумма или диапазон; нужна интеграция денежной системы
vehicles table Классы транспорта, нужны Decent Vehicle и модели
max_vehicle number Лимит машин типа
vehicle_group string Группа транспорта
vehicle_multiply_speed table Множитель скорости по группе состояния, например { danger = 4 }
enter_to_exist_vehicle_chance number Шанс сесть в существующую машину
vehicles_random_color, vehicles_random_skin, vehicles_random_bodygroups boolean Случайный внешний вид машины
vehicles_strict_color_chance number Шанс приглушённого случайного цвета
relationship table Отношения к @player, @actor, @team, @npc через D_HT, D_LI, D_NU
validator function function(self, npc_type): false отменяет создание
bsmod_damage_animation_disable boolean Запрет анимаций BSmod

at_random_range, at_damage_range, at_protect_range устарели и не используются. Для весов { walk = 80, idle = 20 } прогулка выбирается чаще ожидания; веса не обязаны суммироваться до 100.

При EditActor таблицы объединяются: для удаления старых элементов заменяйте поле прямым присваиванием. Установленные в меню значения могут отличаться от исходных значений конфигурации.

Современные поля поведения и банд

Конфиги разрешаются через bgNPC.Config.GetActor; результат кешируется, актору передаётся копия. Новые значения не меняют существующих акторов. Поля транспорта/мозга действуют на сервере, определения типов должны быть доступны в обоих окружениях.

Поле Значение Назначение
brain fsm / goap Мозг при bgn_brain=auto; принудительная cvar имеет приоритет.
carry_items false / table { chance = 5, items = { 'ration', 'suitcase', 'newspaper' }, drop_lifetime = 30 }: редкие предметы у невооружённых акторов; добавляет чекбокс типа. См. правила переноски.
goap_set police / gangster / citizen Набор целей GOAP; иначе определяется по команде.
gang string Идентификатор банды; учитывается союзами, помощью видимым союзникам и групповой ходьбой.
heavy_chance 35 Процент тяжёлых участников для штатных банд.
light_weapons table Классы оружия лёгких участников.
heavy_weapons table Классы оружия тяжёлых участников.
mechanics table Флаги подсистем актора; см. ниже.

Штатные флаги mechanics по умолчанию включены: movement_controller, use_vehicle, call_for_help, fear, fear_scream, enemies_controller, targets_controller, states_controller, animator_controller, enhanced_npc_ignore, inpc_ignore.

Явное булево false выключает механику; отсутствующие/небулевы значения используют её значение по умолчанию. При inpc_ignore = false ядро не устанавливает флаг игнорирования iNPC при создании. Существующие акторы сохраняют свои копии. При regeneration = true поле regeneration_time задаёт интервал (по умолчанию 1 секунда), regeneration_max_health — потолок (по умолчанию максимальное здоровье сущности). Регенерация добавляет один HP за интервал и не уменьшает здоровье, уже превышающее потолок.

Помощь в бою, значения cvars и модели: банды. Источники — actor/sh_actor.lua, config/actors/sh_gangs.lua, brain/sv_brain.lua.