# 🎮 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. Наличните потребители на панела и настройките се запазват, а в стъпка 3 се показва отчет за всяка промяна. Процедурата може да се изпълнява безопасно повече от веднъж.

И в двата режима първо`backups/` се създава пълно резервно копие. Ако резервното копие се провали, нищо не се променя.

---

### Стъпка 3 — Сигурност

Изтрийте инсталатора:

```
rm install.php
```

---

### Стъпка 4 — Достъп до панела за администратори

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

---

## ⬆️ Актуализиране от версия 1

1. Направете резервно копие на файловете и базата данни.
2. Запишете новите файлове върху старите.
3. Изтрийте`install.lock`, отворете`install.php`, въведете отново данните за базата си в стъпка 2 и изберете **„Миграция / Актуализация**“.
4. Изчистете кеша на браузъра си, за да се зареди новият дизайн.

За дизайна на версия 2 не са необходими промени в базата данни — данните ви остават така, каквито са.

---

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

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` и PanelSIX. |

### Система за запушване на устата

Забраните се четат от `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 Fonts (Chakra Petch, Inter, JetBrains Mono) и Material Icons

---

## 📞 Поддръжка

Уебсайт: https://codestrike.store
Discord: Официален сървър на общността
Контакт: Формуляр за контакт на уебсайта

---

## 📄 Лиценз

© PanelSIX — Всички права запазени.

Този софтуер е защитен с авторски права. Неоторизираното му разпространение е забранено.

---

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