Xus Roleplay — веб-панель игрового сервера

Автор: TBOT 04.07.2026 32
  • 🔐 Регистрация по пригласительному коду — игроки регистрируются с помощью пригласительных кодов, сгенерированных администратором, что гарантирует доступ к панели только для проверенных участников сервера.
  • 📊 Панель игрока — просмотр внутриигровой статистики (убийства, смерти, время игры, деньги), транспортных средств, активных ордеров и информации о фракциях.
  • 🏛️ Система фракций — просмотр фракций, их участников, рангов и журналов активности. Подайте заявку на вступление во фракцию прямо из интернета.
  • 🏆 Таблицы лидеров — ранжирование игроков по статистике с возможностью поиска и фильтрации.
  • 💰 Система пожертвований — процесс пожертвований на основе UPI с корзиной, заявками на получение и проверкой администратором.
  • 📰 Новости и объявления — новостная лента сервера с категориями и временными метками.
  • 🛡️ Панель администратора — управление игроками, фракциями, кодами приглашений, заявками на получение пожертвований, банами, предупреждениями и отчетами.
  • 🎮 Пользовательский интерфейс в стиле GTA — золотая и темная темы с переходами между страницами в стиле GTA, анимацией загрузки и настраиваемыми полосами прокрутки.
  • 📱 Полностью адаптивный дизайн — работает на компьютерах, планшетах и мобильных устройствах.

🎮 Варианты использования

Эта панель, созданная для MTA:SA, может быть адаптирована для любого игрового сервера:

Игровой Сервер Как адаптироваться
MTA: SA Готово к использованию — подключите коды приглашения к серверным скриптам
FiveM / GTA V RP Поменяйте местами источники данных о фракциях и характеристиках в своей базе данных FiveM
SA-MP Подключитесь через базу данных SA-MP MySQL
Minecraft Замените схему статистики игроков на данные, специфичные для Minecraft
Любой RP-сервер Фракция, таблица лидеров и административная система не зависят от игры

🚀 Начало работы

Предварительные условия

  • Node.js (v18+)
  • npm или bun
  • Проект Supabase (для базы данных и аутентификации)

Установка

# Клонируйте репозиторий
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, warnings reports, 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 за вклад в этот проект.

  1. Создайте форк репозитория
  2. Создайте функциональную ветку (git checkout -b feature/amazing-feature)
  3. Зафиксируйте изменения (git commit -m 'Add amazing feature')
  4. Отправьте изменения в ветку (git push origin feature/amazing-feature)
  5. Откройте запрос на слияние

История обновлений пуста или не указана для данного релиза.

Специальная инструкция по установке не предоставлена. Используйте стандартный метод загрузки файлов в корневую директорию.

Принять участие в дискуссии
Продукт в общем доступе
Бесплатно
15
Подготовка ссылки... Пожалуйста, подождите
Скачать файл
Войдите в аккаунт, чтобы скачивать файлы мгновенно и без таймера ожидания.
Имя файла -
Вес файла -
Скачиваний -
Безопасность Чистый (0 / 65)
Загрузка уведомлений...
Загрузка истории...