HazeAT — админ-панель для Advance RP
====================================

Открой этот файл целиком перед установкой: тут пять минут чтения и один
пункт, из-за которого чаще всего «не работает».


1. ЧТО ДОЛЖНО СТОЯТЬ В ИГРЕ
----------------------------

  CLEO 4        основа для всех модификаций. Без неё не грузится ничего,
                включая MoonLoader. У большинства уже стоит: в папке с игрой
                есть CLEO.asi и папка cleo.

  SAMPFUNCS     на Advance стоит практически у всех.
                Признак: SAMPFUNCS.asi в папке с игрой.

  MoonLoader    сам загрузчик Lua-скриптов.
                Скачать: https://blast.hk/moonloader/

     ВАЖНО. При установке MoonLoader показывает список компонентов.
     ОБЯЗАТЕЛЬНО отметь галочку:

         SAMP.Lua

     Без неё скрипт не запустится вообще: с этой библиотеки начинается
     первая строка кода, ею разбирается весь чат и все диалоги сервера.

     Остальные компоненты не нужны:
         MoonAdditions    скрипт к нему не обращается
         SF Integration   не используется
         Update Checker   обновляет сам MoonLoader, к нам отношения не имеет
         Auto Reboot      ЛУЧШЕ СНЯТЬ. Он перезагружает скрипты при любом
                          изменении файла, а HazeAT обновляет себя сам и
                          перезагружается сам. Вдвоём они могут дёрнуть
                          перезагрузку прямо посреди записи файла.


2. УСТАНОВКА HazeAT
--------------------

  Распаковать архив в папку С ИГРОЙ (там, где gta_sa.exe), поверх
  существующей папки moonloader. Пути внутри архива уже правильные,
  раскладывать файлы руками не нужно.

  Что попадёт на место:

     moonloader\ai_admin.luac        сам скрипт
     moonloader\hazeat_logo.png      логотип в шапке меню
     moonloader\hazeat_mp.txt        готовые точки стадиона для мероприятий
     moonloader\lib\mimgui\          библиотека окон

  ПРО mimgui. Она не входит в MoonLoader, поэтому едет здесь. Без неё
  скрипт не покажет ни одного окна — останутся только панели поверх игры.

  ЕСЛИ У ТЕБЯ УЖЕ ЕСТЬ mimgui и другие скрипты ею пользуются — распаковывай
  без папки lib. Наша версия проверена с этим скриптом, но чужие могут быть
  собраны под другую.


3. ПЕРВЫЙ ЗАПУСК
-----------------

  Меню открывается клавишей   F11

  Скрипт молчит, пока сервер не подтвердит права администратора — он ждёт
  соответствующую строку. Это не ошибка, а защита: у обычного игрока он
  просто ничего не сделает.

  КАРТИНКИ СКИНОВ И МАШИН качаются отдельно и одной кнопкой. Открой
  «О скрипте» — там появится предложение скачать набор (3 МБ). Без него всё
  работает, но списки в /skin и /vec будут без превью.

  НАСТРОЙКИ создаются сами и лежат рядом со скриптом:
     ai_admin_data.txt    все настройки
     ai_admin_cmds.txt    свои команды
     ai_admin_gui.ini     положение и размеры окон

  Удалить эти файлы = вернуть всё к заводскому виду.


4. ОБНОВЛЕНИЯ
--------------

  Скрипт сам проверяет новую версию при запуске игры и ставит её кнопкой.
  Перед установкой сверяются размер и контрольная сумма, а старая сборка
  сохраняется рядом как ai_admin.luac.bak — откатиться есть куда.

  Скачивать что-то вручную второй раз не нужно.


5. ЕСЛИ НЕ РАБОТАЕТ
--------------------

  Ничего не происходит, меню не открывается по F11
     Скорее всего не отмечен компонент SAMP.Lua при установке MoonLoader.
     Переустанови MoonLoader с этой галочкой.

  Меню не открывается, но панели поверх игры видны
     Не встала папка lib\mimgui — распакуй архив ещё раз.

  Вместо букв вопросительные знаки
     Не хватает шрифта Segoe UI. Скрипт сам перейдёт на Tahoma или Arial,
     но если знаки остались — напиши, разберём.

  Скрипт «не видит», что я администратор
     Он ждёт строку от сервера. Появится после того, как сервер её пришлёт.

  ДВЕ КОПИИ СРАЗУ. В папке moonloader НЕ ДОЛЖНО быть файла ai_admin.lua
  рядом с ai_admin.luac. MoonLoader грузит оттуда всё подряд, и две копии
  запустятся разом: подерутся за команды, за клавиши и за общий файл
  настроек. Выглядеть это будет как что угодно, только не как «у меня
  запущено два скрипта».


СВЯЗЬ
------
  Сайт:     https://hazecore.ru
  Телеграм: https://t.me/hazecoresystems

  Разработчик — Claude Haze.
  Вопросы, находки и пожелания пиши в канал, я их читаю и правлю.
