﻿G3 AutoBalance v34
Author: G3ntEZ
Version: 2.1.0

==================================================
RU
==================================================

Описание:
Модульный плагин автобаланса для Counter-Strike: Source v34 (SourceMod 1.11+).

Основные возможности:
- Автобаланс команд в конце раунда.
- Защита jointeam, если после перехода будет превышен лимит разницы.
- Приоритет переноса: сначала переносятся игроки, которые зашли позже.
- Опциональный иммунитет админов (override: sm_g3ab_immunity).
- Корректный учет/игнорирование ботов.
- Настройка оформления чата (HEX-цвета).
- Логирование действий автобаланса в логи SourceMod.

Структура проекта:
- addons/sourcemod/scripting/g3_autobalance_v34.sp   (основной плагин)
- addons/sourcemod/scripting/g3/g3ab_core.sp         (ядро/утилиты)
- addons/sourcemod/scripting/g3/g3ab_balance.sp      (логика балансировки)
- addons/sourcemod/scripting/g3/g3ab_commands.sp     (команды и обработка jointeam)
- addons/sourcemod/scripting/g3/g3ab_chat.sp         (чат и стили)

Конфиги модулей (cfg/sourcemod/g3):
- g3ab_core.cfg
- g3ab_balance.cfg
- g3ab_commands.cfg
- g3ab_chat.cfg

Главный cfg-файл:
- cfg/sourcemod/g3_autobalance_v34.cfg
  (выполняет все cfg модулей)

Конфиг стилей чата:
- addons/sourcemod/configs/g3/g3ab_chat.cfg

Файл переводов:
- addons/sourcemod/translations/g3_autobalance_v34.phrases.txt

Консольная команда:
- sm_g3ab_reloadchat

CVars:
- sm_g3ab_enable
- sm_g3ab_max_diff
- sm_g3ab_block_join
- sm_g3ab_ignore_bots
- sm_g3ab_immunity
- sm_g3ab_announce
- sm_g3ab_min_players
- sm_g3ab_log_actions

Настройка иммунитета (опционально):
admin_overrides.cfg
"sm_g3ab_immunity" "allow"

Установка:
1) Скомпилированный .smx поместить в addons/sourcemod/plugins/
2) Файл перевода поместить в addons/sourcemod/translations/
3) Конфиг стилей чата поместить в addons/sourcemod/configs/g3/
4) cfg-файлы поместить в cfg/sourcemod/
5) Перезагрузить плагин или карту

Компиляция:
- Компилировать нужно только файл: addons/sourcemod/scripting/g3_autobalance_v34.sp
- Файлы в addons/sourcemod/scripting/g3/*.sp являются модулями (#include) и отдельно не компилируются.

==================================================
EN
==================================================

Description:
Modular autobalance plugin for Counter-Strike: Source v34 (SourceMod 1.11+).

Main features:
- End-round team autobalance.
- Jointeam protection when the move would exceed configured max difference.
- Move priority: latest joiners are moved first.
- Optional admin immunity (override: sm_g3ab_immunity).
- Proper bot-aware counting/ignoring.
- Chat style customization (HEX colors).
- Autobalance action logging to SourceMod logs.

Project structure:
- addons/sourcemod/scripting/g3_autobalance_v34.sp   (main plugin)
- addons/sourcemod/scripting/g3/g3ab_core.sp         (core/helpers)
- addons/sourcemod/scripting/g3/g3ab_balance.sp      (balance logic)
- addons/sourcemod/scripting/g3/g3ab_commands.sp     (commands + jointeam handling)
- addons/sourcemod/scripting/g3/g3ab_chat.sp         (chat and style layer)

Module configs (cfg/sourcemod/g3):
- g3ab_core.cfg
- g3ab_balance.cfg
- g3ab_commands.cfg
- g3ab_chat.cfg

Main cfg entrypoint:
- cfg/sourcemod/g3_autobalance_v34.cfg
  (executes all module cfg files)

Chat style config:
- addons/sourcemod/configs/g3/g3ab_chat.cfg

Translations file:
- addons/sourcemod/translations/g3_autobalance_v34.phrases.txt

Console command:
- sm_g3ab_reloadchat

CVars:
- sm_g3ab_enable
- sm_g3ab_max_diff
- sm_g3ab_block_join
- sm_g3ab_ignore_bots
- sm_g3ab_immunity
- sm_g3ab_announce
- sm_g3ab_min_players
- sm_g3ab_log_actions

Immunity setup (optional):
admin_overrides.cfg
"sm_g3ab_immunity" "allow"

Installation:
1) Put compiled .smx into addons/sourcemod/plugins/
2) Put translation file into addons/sourcemod/translations/
3) Put chat style config into addons/sourcemod/configs/g3/
4) Put cfg files into cfg/sourcemod/
5) Reload plugin or map

Compilation:
- Compile only: addons/sourcemod/scripting/g3_autobalance_v34.sp
- Files inside addons/sourcemod/scripting/g3/*.sp are modules (#include) and must not be compiled separately.

Contacts:
TG: https://t.me/G3ntEZ
VK: https://vk.com/xzx111zxz
Group: https://vk.com/plugins_cssv34
