[VNXF] Level System 2.0.3

1. Продвинутый алгоритм прокачки (XP Engine)​

Система не рассчитывает уровни на основе физических очков опыта (XP), полученных за реальные действия. Поддерживаются два стандартных метода расчёта из MMORPG-игр:

• Линейный: Простой в расчёте, каждый уровень требует одинакового количества XP (например, 100 XP = 1 уровень).
• Прогрессивный: Настоящий уровень. Чем выше уровень, тем круче растёт количество XP, необходимое для перехода на следующий уровень, что проверяет терпение участника! Формула расчёта: BaseXP * level^coefficient.

2. Современный интерфейс в стиле «Glassmorphism» (Premium UI/UX)​

Каждый элемент дизайна проработан до пикселя:

• Индикатор прогресса: Эффектный неоновый градиент в блоке сообщений (postbit) создаёт визуально привлекательный и профессиональный вид.
• Микро-взаимодействия (Glass Tooltip): При наведении курсора на шкалу опыта появляется всплывающая подсказка в стиле Glassmorphism, отображающая информацию «Достигнутый уровень / Необходимо для следующего уровня» — максимально ненавязчиво и компактно, экономя место на мобильных устройствах.
• Уникальная система динамических значков: 10 цветовых уровней — от Bronze (Бронзовый), Silver (Серебряный), Gold (Золотой), Platinum (Платиновый) до Divine (Божественный). Чем выше уровень, тем ярче и насыщеннее цвет значка!

3. Виджет таблицы лидеров​

Встроенный виджет для отображения топ-участников с наивысшим уровнем:

• Аккуратные круглые аватары в изысканном оформлении.
• Адаптивная вёрстка с автоматической подстройкой под размер экрана.
• Гибкая настройка количества отображаемых участников в параметрах виджета.

4. Панель управления администратора (Backend)​

Удобное, прозрачное и надёжное управление:

• Журнал взаимодействий: Фиксирует все транзакции по получению XP участниками (Кто? Сколько? Из какого сообщения/темы/реакции?), включает кнопку «Очистить журнал за 1 секунду» для сверхбыстрой очистки базы данных.
• Пользовательские звания: Администраторы могут настраивать отображаемые названия для каждого уровня по своему усмотрению (например, Уровень 1 — Новичок, Уровень 99 — Повелитель Демонов).
• Точечное редактирование параметров: В разделе редактирования пользователя в AdminCP можно напрямую «инжектировать» текущий уровень XP или процент прогресса для конкретного участника — быстро и удобно.
• Механизм хранения общего исторического XP: Гарантирует, что пользователи НИКОГДА не потеряют накопленный опыт и не смогут накрутить уровни при изменении коэффициентов начисления очков.

ИНСТРУКЦИЯ ПО ИСПОЛЬЗОВАНИЮ И НАСТРОЙКЕ (ВАЖНО)​

Чтобы система работала корректно после установки, ПОЖАЛУЙСТА, ВНИМАТЕЛЬНО ПРОЧИТАЙТЕ СЛЕДУЮЩИЕ ШАГИ.

---

Шаг 1: Настройка формулы XP​

После установки аддона перейдите в Настройки → [VNXF] Level System. Здесь вы определяете «судьбу» прокачки уровней на вашем форуме:

• Награды XP (за действие): В этом разделе указывается количество очков опыта, получаемых за создание новой темы, ответ в теме или получение реакций (лайков).
• Максимальный уровень (Max Level): Ограничивает «спам уровнями», который мог бы перегрузить систему (по умолчанию: 100).
• Тип формулы (Formula Type): Рекомендуется установить значение Progressive (Прогрессивная).
• Base XP: Сколько XP требуется для получения 2-го уровня? (Рекомендуется: 50 или 100).
• Multiplier (Множитель): Чем выше множитель, тем сложнее становится игра, начиная с 3-го уровня. (Рекомендуется использовать фиксированное значение от 1.2 до 1.5).

Совет: Прогрессивная формула с множителем 1.2–1.5 обеспечивает сбалансированную кривую роста — новички быстро прогрессируют, а высокие уровни требуют реальных усилий.

Нажмите, чтобы раскрыть...

---

Шаг 2: ПЕРЕСТРОЙКА УРОВНЕЙ (ОБЯЗАТЕЛЬНО)​

ЭТО САМЫЙ ВАЖНЫЙ ЭТАП. Аддон разработан в соответствии со стандартами Data Safe. Поэтому каждый раз, когда вы изменяете 4 ключевых параметра в разделе Настройки (Формула, Max Level, Base XP, Multiplier) и нажимаете Сохранить, алгоритм не активируется немедленно — это сделано для того, чтобы избежать зависаний/лагов форума, если на нём находятся тысячи пользователей онлайн.

Чтобы применить новые настройки, необходимо вручную запустить пересчёт в системе XenForo:

1. Перейдите в Admin CP → VNXF Level → Manage Levels.
2. Найдите и нажмите кнопку Rebuild Base XP Formula — это обновит все базовые ориентиры начисления уровней в базе данных.
3. Затем найдите команду Rebuild All User XP и нажмите Run, чтобы система просканировала накопленные очки всех участников и автоматически пересчитала их уровни/звания согласно новой формуле!

Важно: Если вы вручную изменяли XP или уровень для конкретного пользователя, используйте опцию Safe Rebuild All User XP вместо обычной Rebuild All User XP, чтобы не потерять внесённые вручную корректировки.

Нажмите, чтобы раскрыть...

---

Шаг 3: Создание виджета (Опционально, но рекомендуется)​

Демонстрируйте достижения участников, чтобы повысить вовлечённость:

1. Перейдите в Внешний вид → Виджеты.
2. Нажмите Добавить виджет → выберите [VNXF] Top Level Widget.
3. Укажите количество участников для отображения (например, 5).
4. В поле Display in positionsвыберите:
   • Forum list: Sidebar — для отображения в боковой панели, или
   • Forum list: Above nodes — для размещения над списком разделов.
5. Протестируйте отображение на интерфейсе вашего форума!