Xus Roleplay — веб-панель игрового сервера
- 🔐 Регистрация по пригласительному коду — игроки регистрируются с помощью пригласительных кодов, сгенерированных администратором, что гарантирует доступ к панели только для проверенных участников сервера.
- 📊 Панель игрока — просмотр внутриигровой статистики (убийства, смерти, время игры, деньги), транспортных средств, активных ордеров и информации о фракциях.
- 🏛️ Система фракций — просмотр фракций, их участников, рангов и журналов активности. Подайте заявку на вступление во фракцию прямо из интернета.
- 🏆 Таблицы лидеров — ранжирование игроков по статистике с возможностью поиска и фильтрации.
- 💰 Система пожертвований — процесс пожертвований на основе UPI с корзиной, заявками на получение и проверкой администратором.
- 📰 Новости и объявления — новостная лента сервера с категориями и временными метками.
- 🛡️ Панель администратора — управление игроками, фракциями, кодами приглашений, заявками на получение пожертвований, банами, предупреждениями и отчетами.
- 🎮 Пользовательский интерфейс в стиле GTA — золотая и темная темы с переходами между страницами в стиле GTA, анимацией загрузки и настраиваемыми полосами прокрутки.
- 📱 Полностью адаптивный дизайн — работает на компьютерах, планшетах и мобильных устройствах.
Эта панель, созданная для MTA:SA, может быть адаптирована для любого игрового сервера:
| Игровой Сервер | Как адаптироваться |
|---|---|
| MTA: SA | Готово к использованию — подключите коды приглашения к серверным скриптам |
| FiveM / GTA V RP | Поменяйте местами источники данных о фракциях и характеристиках в своей базе данных FiveM |
| SA-MP | Подключитесь через базу данных SA-MP MySQL |
| Minecraft | Замените схему статистики игроков на данные, специфичные для Minecraft |
| Любой RP-сервер | Фракция, таблица лидеров и административная система не зависят от игры |
# Клонируйте репозиторий
git clone https://github.com/mk-pioneer/Game-Server-Web-Panel.git
# Перейдите в проект
cd Game-Server-Web-Panel
# Установите зависимости
npm install
# Запустите сервер разработки
npm run dev
Создайте файл .env в корневом каталоге:
VITE_SUPABASE_URL=ваш_url_supabase
VITE_SUPABASE_PUBLISHABLE_KEY=ваш_анонимный_ключ_supabase
В проекте используется Supabase со следующими основными таблицами:
profiles— Профили игроков, связанные с авторизованными пользователямиplayer_stats— Игровая статистика (убийства, смерти, время игры)factions— Фракции сервера с рангами и возможностью наймаfaction_members— Список фракций с ролямиinvite_codes— Регистрационные коды, генерируемые администраторомdonation_claims— Отслеживание и проверка пожертвованийnews_posts— Объявления на сервереuser_roles— Ролевой контроль доступа (администратор, модератор, пользователь)bans,warningsreports,warrants— Инструменты модерации
Миграции SQL находятся в supabase/migrations/. Примените их к своему проекту Supabase, чтобы настроить схему.
| ТЕХНОЛОГИЯ | Цель |
|---|---|
| Реагировать 18 | Фреймворк пользовательского интерфейса |
| Машинописный текст | Безопасность типа |
| Vite 5 | Инструмент для сборки и сервер разработки |
| Попутный ветер CSS | Укладка |
| shadcn/пользовательский интерфейс | Библиотека компонентов |
| Супабаза | База данных, аутентификация и периферийные функции |
| Реагирующий Маршрутизатор | Маршрутизация на стороне клиента |
| Запрос TanStack | Получение и кэширование данных |
| Перезаряжается | Визуализация данных |
| Движение Фреймера | Анимация |
src/
├── assets/ # Logo and static assets
├── components/ # Reusable UI components
│ ├── ui/ # shadcn/ui primitives
│ └── donate/ # Donation flow components
├── contexts/ # Auth context provider
├── hooks/ # Custom React hooks
├── integrations/ # Supabase client & types
├── lib/ # Utilities & mock data
├── pages/ # Route pages
└── index.css # Global styles & theme tokens
Мы будем рады вашим предложениям! Особая благодарность mkdev за вклад в этот проект.
- Создайте форк репозитория
- Создайте функциональную ветку (
git checkout -b feature/amazing-feature) - Зафиксируйте изменения (
git commit -m 'Add amazing feature') - Отправьте изменения в ветку (
git push origin feature/amazing-feature) - Откройте запрос на слияние
История обновлений пуста или не указана для данного релиза.
Специальная инструкция по установке не предоставлена. Используйте стандартный метод загрузки файлов в корневую директорию.