Agency-Notify V2 Экспорты & API
Система уведомлений со стилями V1 Classic и V2 Ultra, игровыми настройками, приоритетами в Smart Mode, защитой от спама.
01Клиентские экспорты
| Экспорт | Описание |
|---|---|
Notify(data: { title, text, type, duration, ... }) | Displays a v2 notification with optional Smart Mode priority/duration/spam handling. |
02События
| Название | Сторона | Описание |
|---|---|---|
Agency:Notify:Send | Клиент | Старая точка входа v1, показывающая уведомление с теми же данными, что и экспорт. |
Agency:Notify:LoadSettings | Клиент | Применяет сохранённые на сервере настройки интерфейса игрока (позиция, цвет, масштаб, стиль). |
Agency:Notify:SaveSettings | Сервер | Проверяет и сохраняет настройки уведомлений игрока (позиция, акцент, масштаб, стиль). |
+Полезно знать
На этой странице перечислены доступные exports и события для Agency-Notify, позволяющие другим ресурсам вызывать уведомления или взаимодействовать с настройками уведомлений игроков. Exports и события предоставляются только на стороне клиента, так как серверных exports нет. Интеграция проста и не требует обязательных зависимостей, хотя oxmysql может использоваться для хранения настроек, если включён в конфиге.
- Использование Client Export
- Экспорт Notify доступен на стороне клиента и позволяет отображать уведомления V2 с поддержкой функций Smart Mode, таких как приоритет, длительность и защита от спама. Вы можете передать объект данных с полями title, text, type и duration для настройки уведомления.
- Поддержка устаревших событий
- Agency-Notify включает совместимость с устаревшей версией v1 через клиентское событие Agency:Notify:Send. Это событие принимает тот же набор данных, что и экспорт Notify, что облегчает обновление старых скриптов или поддержание обратной совместимости с минимальными изменениями.
- События сохранения настроек
- Два события управляют настройками уведомлений игроков: Agency:Notify:LoadSettings (клиент) применяет сохранённые UI-настройки, а Agency:Notify:SaveSettings (сервер) проверяет и сохраняет настройки, такие как позиция, цвет, масштаб и стиль. Для сохранения требуется oxmysql и его включение в конфиге.
?Частые вопросы
Есть ли серверные exports в Agency-Notify?
Нет, Agency-Notify предоставляет только клиентские exports. Все вызовы уведомлений и управление настройками выполняются на клиенте, с событиями для сохранения и загрузки настроек при включённом oxmysql.
Требуется ли oxmysql для работы Agency-Notify?
oxmysql является необязательным. Он нужен только если вы хотите включить сохранение настроек уведомлений игроков в базе данных. Без oxmysql уведомления и настройки интерфейса работают как обычно, но настройки не будут сохраняться между сессиями.
Как вызвать уведомление из другого ресурса?
Вы можете использовать клиентский экспорт Notify для отображения уведомления. Передайте объект данных с нужными полями (title, text, type, duration и т.д.). Альтернативно, используйте клиентское событие Agency:Notify:Send для совместимости с устаревшими версиями с той же структурой данных.
Что проверить, если уведомления не появляются?
Убедитесь, что Agency-Notify корректно запущен с помощью ensure Agency-Notify в вашем server.cfg. Проверьте, что вы вызываете клиентский экспорт или событие с правильными данными. Если используется сохранение, убедитесь, что oxmysql установлен и включён в конфигурации.