Agency-Elevator: Делая многоэтажные здания действительно удобными

Проблема многоэтажности в GTA V

В GTA V есть невероятно выглядящие высокие здания, почти ни одно из которых на самом деле не пригодно для использования. Телепортация игроков между этажами кажется дешевой и ломает погружение. MLO этажи требуют дорогих кастомных интерьеров и все равно обычно ломают физику при переходах. Agency-Elevator , наше решение: настоящий механизм лифта, который ощущается как лифт, работает в любом здании и чисто интегрируется в скриптовую экосистему вашего сервера.

Как это ощущается правильно

Лифт имеет три этапа: анимация входа, подъём с лёгким движением камеры и окружающим звуком, и открытие дверей на нужном этаже. Эта последовательность занимает шесть секунд , достаточно долго, чтобы казаться реалистичной, и достаточно коротко, чтобы не казалось, что ждёшь. Звуковое оформление важно: мягкий механический гул, нежный звонок на вашем этаже. Игроки редко замечают это сознательно, и в этом весь смысл.

Настройка новых лифтов

Добавление нового лифта занимает пять строк конфигурации: координаты входа, координаты назначения для каждого этажа, метки этажей, необязательная функция проверки разрешений. Без редактирования MLO, без трюков с потоковой загрузкой интерьеров. Вставьте координаты, назначьте этажи, готово. Владельцы серверов уже настраивали 12-этажные офисные здания менее чем за десять минут.

Контроль доступа, который действительно работает

Доступ к этажам на основе работы , первоклассный. Лобби , публичное, этажи 5-10 требуют ключ-карты управляющего зданием, а пентхаус , конкретного ID персонажа. Эти правила мгновенно проверяются по данным игрока любого фреймворка, без ожидания запросов к базе данных, которые замедлили бы переход лифта.

Почему это любимый standalone

Agency-Elevator is framework-agnostic out of the box. It doesn't care if you're running QBCore, ESX, or a standalone custom stack, the permission hooks are pluggable functions, not framework imports. This is why it's been one of our most downloaded scripts across all three communities.

Установка & настройка

Agency-Elevator has no database dependency for basic operation. Download from Tebex, drop the folder into your resources directory, and add ensure agency-elevator в server.cfg. Определения лифтов, координаты входа, этажи назначения, метки и правила доступа , все хранится в config.lua.

Стандартная конфигурация содержит определения лифтов для нескольких доступных зданий ванильной GTA V (вестибюль FIB, вход в Maze Bank Tower, входы в жилые дома). Замените или дополните их координатами зданий вашего сервера. Каждое определение занимает менее пяти минут на настройку.

Параметры конфигурации

Параметр config.lua охватывает поведение лифта и контроль доступа:

• Определения лифта массив лифтов, каждый с именем, координатами триггера входа и радиусом, а также массивом этажей назначения.
• Назначения этажей , каждый этаж имеет координаты, отображаемую метку и необязательную функцию доступа.
• Функция доступа , Lua-функция на этаж, которая получает src игрока и возвращает true/false. Используйте её для проверки условий по работе, предметам или ID персонажа.
• Длительность перехода , сколько времени занимает анимация подъёма/спуска в миллисекундах. По умолчанию: 6000 (6 секунд).
• Фоновый звук", переключить звуки механического гудения лифта и звуки уведомления о этаже. По умолчанию: включено.
• Поведение камеры , лёгкий наклон камеры во время перехода для эффекта движения. По умолчанию включено, интенсивность настраивается.
• Стиль UI , визуал панели выбора этажа (минималистичный или детальный с описаниями этажей).

Совместимость с фреймворками

Agency-Elevator is fully standalone by design. The access control functions in your config can call any framework's player data, QBCore, ESX, or custom. No framework imports live in the base resource. This is why it's been one of the most consistently downloaded Agency scripts across all three server communities: it works without any special setup regardless of your stack.

Почему это важно для ролевой игры

Вертикальное пространство , одно из самых недооценённых измерений в GTA V RP. На карте десятки впечатляющих высоких зданий и многоэтажных интерьеров. Без работающих лифтов эти пространства либо недоступны, либо доступны через разрушающие погружение телепорты. Agency-Elevator открывает это вертикальное пространство для RP без резкого перехода телепорта.

Переход за шесть секунд , это не просто пауза, а целенаправленное темпообразование. Поездки на лифте в ролевой игре , это микросцены. Детектив и подозреваемый, оба едущие на 12-й этаж, имеют шесть секунд принудительной близости. Деловые партнёры, едущие на встречу, имеют шесть секунд случайного разговора. Эти короткие взаимодействия создают текстуру RP, и работающий лифт создаёт их естественно, а не пропускает.

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

Пользовательские интерьеры MLO , это то, где этот скрипт приносит наибольшую пользу. Сервер с пользовательским MLO полицейского участка, больницы или бизнес-района в небоскребе может сделать каждый этаж этих интерьеров доступным и навигируемым без клиентской упаковки новых стриминговых зон. Лифтовые переходы между существующими зонами интерьера решают остальное.

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

Могут ли два игрока одновременно пользоваться одним лифтом, направляясь на разные этажи?

Да. Взаимодействие каждого игрока с лифтом независимо. Если игрок A вызывает лифт на 5-й этаж, а игрок B вызывает его на 12-й этаж с той же точки входа, оба перехода воспроизводятся одновременно на клиентах каждого игрока. Лифт не имеет имитируемой вместимости или времени ожидания, это переход для каждого игрока, а не общий физический объект.

Можем ли мы добавить NPC-оператора или панель с кнопками к лифту?

Зона триггера не требует конкретного объекта, она основана на координатах. Вы можете разместить любой объект на координатах входа (клавиатуру, стойку регистрации, NPC) с помощью инструментов размещения объектов вашего сервера. Взаимодействие с лифтом срабатывает, когда игрок входит в радиус триггера, независимо от того, что там физически находится.

Работает ли это с лифтами внутри кастомных ресурсов интерьера с потоковой загрузкой?

Да. Координаты интерьера работают так же, как и внешние координаты в конфиге. Убедитесь, что вы используете координаты внутреннего пространства (которые получаете, находясь внутри интерьера в игре), а не внешние координаты здания. Если ваш интерьер использует пользовательский ID интерьера, укажите его в определении этажа, и Agency-Elevator загрузит игрока в правильный интерьер при переходе.

Можно ли полностью заблокировать лифт во время определённых RP-событий?

Использовать exports['agency-elevator']:LockElevator(elevatorName, reason) из любого серверного скрипта. Игроки, пытающиеся использовать лифт во время блокировки, видят сообщение "временно недоступно". Разблокировать с помощью exports['agency-elevator']:UnlockElevator(elevatorName). Используйте это для скриптовых событий, где неконтролируемый доступ к полу нарушит сцену.

Требования

• Сервер FiveM (любой фреймворк или standalone)
• аккаунт cfx.re с действующей лицензией Agency-Elevator
• Нет зависимости от базы данных для базовой работы
• Нет внешних зависимостей ресурсов