# 🎮 PanelSIX


## 🚀 Модульная платформа для управления серверами Counter-Strike 1.6

**PanelSIX** — это современная веб-платформа для владельцев серверов Counter-Strike 1.6 и игровых сетей.
Он сочетает в себе общедоступный игровой сайт и мощную панель администратора, благодаря чему вы можете управлять всем из одного места.

Разработано **illusion** @ https://codestrike.store

---

## ⭐ Почему PanelSIX?

PanelSIX создан для реальных сообществ — это не просто скрипт, а платформа, которая развивается вместе с вами.

- 🎮 Разработано специально для экосистем серверов CS 1.6
- 🌗 По умолчанию — тёмная тема, светлая тема одним щелчком мыши
- 📊 Статистика и графики в режиме реального времени на панели инструментов и главной странице
- 📱 Полная адаптивность — для настольных компьютеров, планшетов и смартфонов
- ⚡ Быстро и легко, без этапа сборки
- 🔌 Архитектура, поддерживающая расширения
- 🔒 Безопасность по умолчанию

Независимо от того, управляете ли вы одним сервером или целой сетью, PanelSIX адаптируется к вашему рабочему процессу.

---

## 📖 Обзор

PanelSIX предлагает:

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

Всё объединено в одной платформе с единым дизайном и единой тематикой.

---

## ✨ Особенности

### 🎨 Дизайн

| Особенность | Описание |
|---|---|
| Тёмная / Светлая тема | По умолчанию — темный режим. Переключатель находится на боковой панели, верхней панели, странице входа и в установщике, и настройка сохраняется для каждого браузера отдельно. |
| Современный игровой интерфейс | Жирный шрифт, карточки в стиле HUD, фоны карт на карточках серверов |
| Адаптивный | Мобильная верхняя панель с выпадающим меню; таблицы прокручиваются по горизонтали на небольших экранах |
| Две схемы расположения | Боковая панель (по умолчанию) или верхняя панель навигации — выбор доступен в настройках сайта |

### 🌐 Общедоступный веб-сайт

| Особенность | Описание |
|---|---|
| Главная страница | Герой с отображением количества активных игроков, кнопкой «Играть сейчас» и статистикой по платформам |
| Серверы | Карты с серверами в режиме реального времени с фоном карты, панелью игроков, функцией копирования IP-адреса и возможностью присоединиться через Steam |
| Сведения о сервере | Список игроков в реальном времени с указанием фрагов, времени игры, а также меток сообщений ботов и сервера |
| Статистика | Серверы, игроки, администраторы, баны, ограничения, сообщения и 14-дневная статистика модерации |
| Список заблокированных | Поиск, значки статуса (активный, постоянный, срок действия истек, разблокирован) и оставшееся время |
| Список шуток | Поиск, тип чата (текстовый / голосовой / оба) и оставшееся время |
| Список администраторов | Служебные удостоверения с указанием должности и срока действия |
| Новости и обновления | Карточки с изображениями, страницы с подробностями, на которых указано время чтения и похожие публикации |

### 🔧 Панель администратора

| Модуль | Функции |
|---|---|
| Панель управления | Ключевые показатели (игроки, серверы, действующие баны и ограничения, администраторы, контент), график 14-дневных банов/ограничений, разбивка статусов банов, последние баны и ограничения, основные причины банов, самые активные администраторы, таблица серверов, быстрый доступ |
| Серверы | Добавление, редактирование и управление серверами |
| Администраторы | SteamID / IP / Никнейм администраторов со сроком действия |
| Уровни доступа | Предустановленные настройки разрешений |
| Запреты | Просмотр, редактирование, снятие и удаление банов |
| Шутки | Управление ограничениями на чат и голосовую связь |
| Редактор новостей | Редактор форматированного текста |
| Редактор обновлений | Опубликовать изменения на сервере |
| Пользователи панели | Управление доступом к панели управления |
| Расширения | Установка и управление официальными расширениями |
| Настройки сайта | Название, URL, ссылки на социальные сети, макет и система блокировок |

---

## 🔌 Система расширения

PanelSIX построен на основе модульной экосистемы. Расширения добавляют новые функции без изменения основной панели и автоматически адаптируются к теме панели.

Расширения устанавливаются из официального магазина CodeStrike. При удалении расширения его таблицы базы данных удаляются — отключите его, если хотите просто приостановить его работу.

---

## 💻 Требования

### Минимальный

- PHP 7.0+ (работает на PHP 7.x и 8.x)
- MySQL 5.7 или выше либо MariaDB 10.2 или выше
- Apache или Nginx
- Расширения PDO, cURL и JSON

### Рекомендуется

- PHP 8.1 и выше
- MySQL 8 и выше
- HTTPS включен
- mod_rewrite
- Расширение DOM (оптимальная очистка контента новостей и обновлений)

---

## 🚀 Установка

### Шаг 1 — Загрузка файлов

Загрузите PanelSIX в каталог вашего хостинга:

```
/var/www/html/panelsix/
```

---

### Шаг 2 — Запустите программу установки

Открыть в браузере:

```
http://your-domain.com/install.php
```

Следуйте инструкциям мастера настройки:

1. Добро пожаловать
2. Настройка базы данных
3. Создать учетную запись администратора
4. Завершить установку

После установки вы автоматически авторизуетесь.

На этапе 2 вы выбираете режим установки:

- **При новой установке** таблицы PanelSIX удаляются и создаются заново с данными по умолчанию. Остальные таблицы в той же базе данных, например таблицы плагинов игрового сервера, не затрагиваются.
- **Функция «Миграция / Обновление»** предназначена для обновления старой версии PanelSIX. Все таблицы и данные сохраняются. Установщик сравнивает базу данных с исходной версией и`SQL/PanelSIX.sql` добавляет только отсутствующие таблицы, столбцы, первичные ключи и параметр AUTO_INCREMENT. Существующие пользователи панели и настройки сохраняются, а на третьем шаге отображается отчет обо всех изменениях. Эту процедуру можно безопасно запускать несколько раз.

В обоих режимах сначала`backups/` сохраняется полная резервная копия. Если резервное копирование завершится с ошибкой, никаких изменений не произойдет.

---

### Шаг 3 — Безопасность

Удалите программу установки:

```
rm install.php
```

---

### Шаг 4 — Вход в панель администратора

```
http://your-domain.com/admin/
```

---

## ⬆️ Обновление с версии v1

1. Сделайте резервную копию ваших файлов и базы данных.
2. Загрузите новые файлы, перезаписав старые.
3. Нажмите «Удалить»`install.lock`, откройте страницу`install.php`, введите данные базы данных заново на шаге 2 и выберите **«Миграция / Обновление**».
4. Очистите кэш браузера один раз, чтобы загрузился новый дизайн.

Для реализации версии v2 не требуется вносить никаких изменений в базу данных — ваши данные останутся без изменений.

---

## 🎮 Интеграция с игровым сервером

PanelSIX управляет администраторами вашего сервера через подключение к базе данных, используя **официальные плагины AMX Mod X,** которые поставляются в комплекте с каждым сервером.

### Как загрузить администраторов из базы данных

1. **Включите плагин администрирования SQL:**
- Открыть `cstrike/addons/amxmodx/configs/plugins.ini`.
- Отключите плагин администратора по умолчанию: `;admin.amxx`(добавьте точку с запятой).
- Включите плагин администрирования SQL: `admin_sql.amxx`(удалите все точки с запятой).

2. **Настройте подключение к базе данных:**
- Открыть `cstrike/addons/amxmodx/configs/sql.cfg`.
- Введите данные базы данных (хост, имя пользователя, пароль, название базы данных), которые вы использовали при установке.

3. **Перезапустите сервер:**
- Перезапустите сервер или введите `amx_reloadadmins`в консоли.

PanelSIX использует стандартное имя таблицы`diveban_admins` для обеспечения полной совместимости.

### Система запретов

PanelSIX поддерживает два плагина для блокировки. При установке программа запрашивает, какой из них использовать, и этот выбор можно изменить позже в **панели администратора → Дашборд → Настройки сайта → Система блокировки**.

| Система запретов | Таблица | Примечания |
|---|---|---|
| **Diveban X** (по умолчанию) | `divebanx` | Входит в состав `plugins/`. |
| **Система блокировок CodeStrike** | `codestrike_bans` | Продается отдельно. В `addons/amxmodx/configs/CodeStrikePlugins/codestrike_bans.ini`наборе `Type = mysql`и`Table = codestrike_bans` с теми же параметрами базы данных, что и у PanelSIX. При снятии блокировки с панели запись сохраняется в истории, так же как и в случае с`amx_unban` . |

### Система заглушки

Запреты считываются из `gag_system`таблицы плагина ILLUSION GAG System (входит в состав `plugins/`). `gag_time`— продолжительность в минутах, а `expire_time`— время окончания; `-1`означает постоянный запрет.

---

## 🆕 Что нового в версии 2.0

### Дизайн
- **Полная переработка** дизайна общедоступного сайта, панели администратора и программы установки с использованием единого дизайна.
- **По умолчанию** используется **тёмная тема**, с возможностью переключения на **светлую**; настройки сохраняются для каждого браузера отдельно.
- **Полностью адаптивная** верстка с верхней панелью для мобильных устройств и выпадающим меню.
- Боковая панель администратора, сгруппированная по разделам: «Обзор», «Игровые серверы», «Модерация», «Контент», «Система».

### Статистика
- **Панель администратора:** игроки в сети и загруженность слотов, серверы в сети, действующие баны и ограничения доступа с графиками динамики, игровые администраторы, контент, 14-дневный график банов и ограничений доступа, разбивка статусов банов, последние баны и ограничения доступа, основные причины банов, самые активные администраторы и таблица серверов.
- **Предупреждение** о том, что срок полномочий администраторов игры истекает в течение 7 дней или уже истек.
- **Главная страница:** количество игроков в режиме реального времени, статистика платформы и график активности модераторов.

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

### Безопасность и исправления
- Содержимое новостей и обновлений очищается — из него удаляются скрипты и атрибуты событий.
- Защита от CSRF в настройках сайта, а также при установке, включении, отключении и удалении расширений.
- Идентификатор сеанса обновляется при входе в систему.
- Постоянные цензурные ограничения отображались в общедоступном списке цензурных ограничений как «Без цензуры».
- Выделение пунктов меню на страницах добавления/редактирования, а также ссылки на меню расширений со страниц расширений.

---

## 📁 Структура проекта

```
panelsix/
├── admin/ Admin panel pages
│ └── includes/ Admin navigation
├── assets/
│ ├── css/ panelsix.css — design system and themes
│ ├── js/ panelsix.js — theme switch, menus, charts
│ └── images/ Logos, map backgrounds, post images
├── backups/ Installer backups
├── cache/ Server status cache (5 minutes)
├── cron/ Scheduled cleanup scripts
├── extensions/ Installed extensions
├── includes/ Shared header, navigation, footer, statistics, content sanitizer
├── plugins/ AMX Mod X plugins (Diveban X, GAG System)
├── protected/ Database connection, settings, ban system
├── SQL/ Database schema
├── index.php
├── install.php
└── README.md
```

---

## 🔒 Безопасность

PanelSIX оснащён встроенными средствами защиты:

- CSRF-токены
- Подготовленные заявления
- Фильтрация XSS и очистка форматированного текста
- Безопасное хеширование паролей (BCRYPT)
- Безопасность сеанса (идентификатор перегенерируется при входе в систему)
- Проверка вводимых данных

### Рекомендации

- Удалить `install.php`
- Используйте HTTPS
- Не разглашайте учетные данные для доступа к базе данных
- Регулярно создавайте резервные копии
- Защитить каталог`/protected`

---

## 🎨 Технологии

- PHP 7.0+ / 8.x
- MySQL / MariaDB
- Tailwind CSS
- Chart.js
- CKEditor 5
- SweetAlert2
- Шрифты Google (Chakra Petch, Inter, JetBrains Mono) и значки Material

---

## 📞 Служба поддержки

Веб-сайт: https://codestrike.store
Discord: официальный сервер сообщества
Контакты: Форма обратной связи на сайте

---

## 📄 Лицензия

© PanelSIX — Все права защищены.

Данное программное обеспечение является проприетарным. Несанкционированное распространение запрещено.

---

**Создано с ❤️ и ☕ от illusion @ codestrike.store**