ОПИСАНИЕ НОВЫХ МОДУЛЕЙ FAKECLIENTSFIX 1.3.4
═══════════════════════════════════════════════════════════════
1. FakeClientsFix_Performance
Назначение:
Модуль оптимизации производительности сервера. Автоматически контролирует FPS и управляет количеством ботов для поддержания оптимальной производительности.
Основные функции:
• Мониторинг FPS сервера в реальном времени
• Автоматическое удаление ботов при падении FPS ниже заданного порога
• Настройка минимального допустимого FPS
• Настройка максимального количества ботов при низком FPS
• Настраиваемый интервал проверки производительности
ConVar'ы:
- sm_fakeclients_perf_minfps - Минимальный FPS для нормальной работы (по умолчанию: 30)
- sm_fakeclients_perf_maxbots_lowfps - Максимальное количество ботов при низком FPS (по умолчанию: 5)
- sm_fakeclients_perf_check_interval - Интервал проверки производительности в секундах (по умолчанию: 5.0)
- sm_fakeclients_perf_enabled - Включить/выключить модуль (по умолчанию: 1)
Применение:
Используйте этот модуль на серверах, где важна стабильная производительность. Особенно полезен для серверов с большим количеством игроков или на слабом оборудовании.
═══════════════════════════════════════════════════════════════
2. FakeClientsFix_MultiServer
Назначение:
Модуль синхронизации между несколькими серверами. Позволяет координировать работу ботов на нескольких серверах через мастер-сервер.
Основные функции:
• Мастер-сервер для координации клиентских серверов
• Синхронизация конфигураций между серверами
• Общий пул имен для всех серверов
• Координация количества ботов
• Настраиваемый интервал синхронизации
ConVar'ы:
- sm_fakeclients_multiserver_enabled - Включить синхронизацию (по умолчанию: 0)
- sm_fakeclients_multiserver_master - Адрес мастер-сервера (IP:PORT, оставить пустым если это мастер)
- sm_fakeclients_multiserver_interval - Интервал синхронизации в секундах (по умолчанию: 30)
Применение:
Идеален для сетей серверов, где нужно синхронизировать работу ботов. Требует настройки мастер-сервера и клиентских серверов.
Примечание:
Требует дополнительной настройки для работы с HTTP запросами или сокетами (базовая структура готова, нужна доработка под вашу инфраструктуру).
═══════════════════════════════════════════════════════════════
3. FakeClientsFix_AI
Назначение:
Модуль искусственного интеллекта для умного управления ботами. Анализирует тренды и предсказывает оптимальное количество ботов.
Основные функции:
• Анализ истории количества игроков за последние 60 секунд
• Предсказание оптимального количества ботов на основе трендов
• Умное удаление ботов (сначала из спектаторов, затем из играющих)
• Адаптация к нагрузке сервера
• Автоматическая оптимизация без вмешательства администратора
ConVar'ы:
- sm_fakeclients_ai_enabled - Включить AI режим (по умолчанию: 1)
- sm_fakeclients_ai_check_interval - Интервал проверки AI в секундах (по умолчанию: 10.0)
Алгоритм работы:
- Собирает данные о количестве реальных игроков каждые 10 секунд
- Вычисляет среднее значение за последние 60 секунд
- Предсказывает необходимое количество ботов на основе текущей и средней нагрузки
- Автоматически удаляет или создает ботов для достижения оптимального баланса
Применение:
Рекомендуется для серверов, где количество игроков сильно варьируется. AI автоматически адаптируется к изменениям нагрузки.
═══════════════════════════════════════════════════════════════
4. FakeClientsFix_Events
Назначение:
Модуль системы событий и триггеров. Позволяет создавать кастомную логику на основе событий ботов и игры.
Основные функции:
• Триггеры на события подключения/отключения ботов
• Триггеры на события раундов (начало/конец)
• Триггеры на подключение реальных игроков
• Кастомная логика на основе событий
• Интеграция с событиями игры
ConVar'ы:
- sm_fakeclients_events_enabled - Включить систему событий (по умолчанию: 1)
Доступные события:
- bot_connected - Бот подключился
- bot_disconnected - Бот отключился
- check_remove_bots - Проверка удаления ботов
- round_start - Начало раунда
- round_end - Конец раунда
- real_player_connect - Подключение реального игрока
- real_player_disconnect - Отключение реального игрока
Применение:
Используйте для создания кастомной логики, которая реагирует на события. Например, автоматическое удаление ботов при большом количестве реальных игроков.
═══════════════════════════════════════════════════════════════
5. FakeClientsFix_Queue
Назначение:
Модуль очереди операций с ботами. Позволяет планировать операции с ботами с приоритетами и задержками.
Основные функции:
• Приоритетная очередь создания ботов
• Очередь удаления ботов
• Очередь переименования ботов
• Настройка задержек перед выполнением операций
• Автоматическая сортировка по приоритету
ConVar'ы:
- sm_fakeclients_queue_enabled - Включить систему очереди (по умолчанию: 1)
- sm_fakeclients_queue_interval - Интервал обработки очереди в секундах (по умолчанию: 1.0)
Приоритеты:
- 0 - Низкий приоритет
- 1 - Средний приоритет (по умолчанию)
- 2 - Высокий приоритет
API функции (stock):
- QueueCreateBot(name, priority, delay) - Добавить в очередь создание бота
- QueueRemoveBot(client, priority, delay) - Добавить в очередь удаление бота
- QueueRenameBot(client, newName, priority, delay) - Добавить в очередь переименование
Применение:
Полезен для планирования массовых операций с ботами или для создания ботов с задержкой. Операции выполняются в порядке приоритета.
═══════════════════════════════════════════════════════════════
6. FakeClientsFix_Profiles
Назначение:
Модуль профилей конфигураций. Позволяет сохранять и быстро переключаться между различными настройками плагина.
Основные функции:
• Сохранение профилей настроек
• Быстрое переключение между профилями
• Профили для разных карт
• Профили для разных режимов игры
• Автоматическое применение профиля при смене карты
ConVar'ы:
- sm_fakeclients_profiles_enabled - Включить систему профилей (по умолчанию: 1)
- sm_fakeclients_profiles_current - Текущий активный профиль (по умолчанию: "default")
Файл конфигурации:
configs/fakeclients_profiles.txt
Структура профиля:
"Profiles"
{
"profile_name"
{
"maxBots" "10"
"delay" "15.0"
"connectInterval" "8.0"
"threshold" "0"
"maxPlayers" "40"
"nameChangeSpec" "0.0"
"nameChangePlaying" "0.0"
}
}
Применение:
Идеален для серверов с разными режимами игры или картами, где нужны разные настройки ботов. Можно создать профили "competitive", "casual", "dm", "surf" и т.д.
═══════════════════════════════════════════════════════════════
7. FakeClientsFix_Restrictions
Назначение:
Модуль ограничений и правил. Позволяет устанавливать ограничения на создание ботов по времени, картам и другим условиям.
Основные функции:
• Ограничения по времени суток
• Ограничения по картам
• Правила для разных режимов
• Временные ограничения
• Условная логика блокировки
ConVar'ы:
- sm_fakeclients_restrictions_enabled - Включить систему ограничений (по умолчанию: 1)
Файл конфигурации:
configs/fakeclients_restrictions.txt
Пример ограничения:
"Restrictions"
{
"Time"
{
"night"
{
"start" "2" // С 2:00
"end" "6" // До 6:00
"enabled" "1"
}
}
}
Применение:
Используйте для блокировки создания ботов в определенное время (например, ночью) или на определенных картах. Полезно для серверов с расписанием работы.
═══════════════════════════════════════════════════════════════
8. FakeClientsFix_Testing
Назначение:
Модуль тестирования и отладки. Предоставляет инструменты для тестирования функциональности плагина.
Основные функции:
• Автоматические тесты создания ботов
• Тесты удаления ботов
• Тесты переименования ботов
• Тесты всех API функций
• Настраиваемое количество итераций
Команды:
- sm_fakebot_test - Запустить все тесты
- sm_fakebot_test_create - Тест создания ботов
- sm_fakebot_test_remove - Тест удаления ботов
- sm_fakebot_test_rename - Тест переименования ботов
ConVar'ы:
- sm_fakeclients_test_enabled - Включить режим тестирования (по умолчанию: 0)
- sm_fakeclients_test_iterations - Количество итераций теста (по умолчанию: 10)
Применение:
Используйте для проверки работоспособности плагина после установки или обновления. Все результаты выводятся в консоль сервера.
Требования:
Требуются права
ADMFLAG_ROOT для использования команд.
═══════════════════════════════════════════════════════════════
9. FakeClientsFix_Metrics
Назначение:
Модуль детальной аналитики. Собирает и отображает статистику работы с ботами.
Основные функции:
• Подсчет созданных ботов
• Подсчет удаленных ботов
• Подсчет переименований
• Экспорт метрик в файл
• Статистика в реальном времени
Команды:
- sm_fakebot_metrics - Показать текущие метрики
- sm_fakebot_metrics_reset - Сбросить все метрики
- sm_fakebot_metrics_export - Экспортировать метрики в файл
ConVar'ы:
- sm_fakeclients_metrics_enabled - Включить сбор метрик (по умолчанию: 1)
Файл метрик:
logs/fakeclients_metrics.txt
Собираемые данные:
- Количество созданных ботов
- Количество удаленных ботов
- Количество переименований
- Текущее количество ботов
- Количество реальных игроков
Применение:
Используйте для анализа работы плагина, отслеживания активности ботов и для отчетов. Метрики сохраняются с временными метками.
═══════════════════════════════════════════════════════════════
10. FakeClientsFix_Competitive
Назначение:
Модуль для соревновательных серверов. Обеспечивает строгие правила работы с ботами для турнирных и соревновательных серверов.
Основные функции:
• Строгие правила для ботов
• Минимальное количество реальных игроков для создания ботов
• Боты только в спектаторах (опционально)
• Приоритет реальным игрокам
• Минимальное вмешательство в игровой процесс
ConVar'ы:
- sm_fakeclients_competitive_enabled - Включить режим (по умолчанию: 1)
- sm_fakeclients_competitive_minplayers - Минимальное количество реальных игроков для создания ботов (по умолчанию: 8)
- sm_fakeclients_competitive_strictbalance - Строгий баланс (боты только в спектаторах) (по умолчанию: 1)
Особенности:
- Боты создаются только если реальных игроков меньше минимального порога
- При достаточном количестве реальных игроков все боты автоматически удаляются
- В строгом режиме боты остаются только в спектаторах
- Минимальное вмешательство в игровой процесс
Применение:
Идеален для турнирных серверов, соревновательных матчей и серверов с строгими правилами. Обеспечивает честную игру без вмешательства ботов в игровой процесс.
═══════════════════════════════════════════════════════════════
11. FakeClientsFix_Casual
Назначение:
Модуль для казуальных серверов. Предоставляет гибкие настройки и развлекательные функции для обычных серверов.
Основные функции:
• Гибкие настройки
• Автоматическая балансировка команд ботами
• Развлекательные функции (случайные префиксы имен)
• Простое управление
• Максимальная автоматизация
ConVar'ы:
- sm_fakeclients_casual_enabled - Включить режим (по умолчанию: 1)
- sm_fakeclients_casual_autobalance - Автоматическая балансировка команд (по умолчанию: 1)
- sm_fakeclients_casual_funfeatures - Развлекательные функции (по умолчанию: 1)
Особенности:
- Автоматическая балансировка команд при начале раунда
- Случайные префиксы к именам ботов ([BOT], Bot_, Player_)
- Боты автоматически переводятся в команды для баланса
- Гибкие настройки для разных типов серверов
Применение:
Идеален для публичных серверов, DM серверов, серверов с развлекательными режимами. Обеспечивает веселую и динамичную игру.
═══════════════════════════════════════════════════════════════
12. FakeClientsFix_Development
Назначение:
Модуль для разработчиков. Предоставляет расширенные инструменты отладки и тестирования API.
Основные функции:
• Подробное логирование всех событий
• Отладочный вывод в консоль
• Тестирование всех API функций
• Детальная информация о системе
• Профилирование работы плагина
Команды:
- sm_fakebot_dev_info - Показать отладочную информацию
- sm_fakebot_dev_test_api - Тест всех API функций
ConVar'ы:
- sm_fakeclients_dev_enabled - Включить режим разработки (по умолчанию: 0)
- sm_fakeclients_dev_verbose - Подробное логирование (по умолчанию: 1)
- sm_fakeclients_dev_debug - Отладочный вывод (по умолчанию: 1)
Логируемые события:
- Подключение/отключение ботов
- Переименование ботов
- Проверки удаления ботов
- Все вызовы API функций
Применение:
Используйте при разработке собственных модулей или для отладки проблем. Включайте только при необходимости, так как создает много логов.
Требования:
Требуются права
ADMFLAG_ROOT для использования команд.
═══════════════════════════════════════════════════════════════
13. FakeClientsFix_Production
Назначение:
Модуль для продакшн серверов. Обеспечивает максимальную стабильность, автоматическое восстановление и мониторинг.
Основные функции:
• Автоматическое восстановление при ошибках
• Проверка здоровья системы
• Обнаружение "мертвых" ботов
• Мониторинг работоспособности
• Автоматические алерты о проблемах
ConVar'ы:
- sm_fakeclients_production_enabled - Включить режим (по умолчанию: 1)
- sm_fakeclients_production_autorecovery - Автоматическое восстановление (по умолчанию: 1)
- sm_fakeclients_production_maxfailures - Максимум ошибок перед действием (по умолчанию: 3)
Проверки здоровья:
- Наличие Core плагина
- Наличие доступных имен
- Корректность количества ботов
- Обнаружение "мертвых" ботов
Автоматическое восстановление:
- Удаление "мертвых" ботов
- Проверка при смене карты
- Логирование всех действий
Применение:
ОБЯЗАТЕЛЬНО для всех продакшн серверов! Обеспечивает стабильную работу плагина без вмешательства администратора. Автоматически исправляет проблемы и предупреждает о критических ошибках.
═══════════════════════════════════════════════════════════════
РЕКОМЕНДАЦИИ ПО ИСПОЛЬЗОВАНИЮ
Обязательные модули для всех серверов:
- FakeClientsFix_Core - Обязателен всегда
- FakeClientsFix_Production - Рекомендуется для всех продакшн серверов
Рекомендуемые модули:
- FakeClientsFix_Performance - Для серверов с проблемами производительности
- FakeClientsFix_AI - Для автоматической оптимизации
- FakeClientsFix_Metrics - Для отслеживания статистики
Специализированные модули:
- FakeClientsFix_Competitive - Только для соревновательных серверов
- FakeClientsFix_Casual - Только для казуальных серверов
- FakeClientsFix_Development - Только для разработки
Несовместимые модули:
- FakeClientsFix_Competitive и FakeClientsFix_Casual - Не используйте одновременно
Опциональные модули:
- Все остальные модули можно включать/выключать по необходимости
═══════════════════════════════════════════════════════════════
УСТАНОВКА
- Установите FakeClientsFix_Core.smx в plugins/
- Установите include/FakeClientsFix.inc в scripting/include/
- Выберите нужные модули и установите их .smx файлы в plugins/
- Перезагрузите сервер или выполните sm plugins reload
- Настройте ConVar'ы через консоль или server.cfg
ВАЖНО: Все модули требуют установленного Core плагина!
═══════════════════════════════════════════════════════════════
