Agency-Notify Экспорты & API
Система уведомлений со стилями V1 Classic и V2 Ultra, игровыми настройками, умным приоритетом AgencyAI, защитой от.
01Client Exports
| Экспорт | Описание |
|---|---|
Notify(data: { title, text, type, duration, ... }) | Displays a v2 notification with optional AgencyAI smart-priority/duration/spam handling. |
02События
| Название | Сторона | Описание |
|---|---|---|
Agency:Notify:Send | Client | Legacy v1 entry point to display a notification with the same payload as the export. |
Agency:Notify:LoadSettings | Client | Applies per-player saved UI settings (position, color, scale, style) from the server. |
Agency:Notify:SaveSettings | Server | Validates and persists the player's notify settings (position, accent, scale, style). |
+Полезно знать
На этой странице перечислены доступные exports и события для Agency-Notify, позволяющие другим ресурсам вызывать уведомления или взаимодействовать с настройками уведомлений игроков. Exports и события предоставляются только на стороне клиента, так как серверных exports нет. Интеграция проста и не требует обязательных зависимостей, хотя oxmysql может использоваться для хранения настроек, если включён в конфиге.
- Использование Client Export
- Экспорт Notify доступен на стороне клиента и позволяет отображать уведомления V2 с поддержкой функций AgencyAI, таких как умный приоритет, длительность и защита от спама. Вы можете передать объект данных с полями 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 установлен и включён в конфигурации.