MoonLoader — что это и зачем

Что это такое

MoonLoader — это ASI-плагин для GTA San Andreas. Он поднимает внутри игры интерпретатор Lua и даёт скриптам доступ к игровым функциям: транспорту, персонажам, интерфейсу, памяти процесса, сетевому слою SA-MP. По сути это прослойка между игрой и вашим кодом.

Каждый скрипт — отдельный .lua-файл. Он живёт в собственном потоке, может быть перезагружен на лету и не мешает остальным.

Что умеет

Lua-скрипты

Полноценный Lua 5.1 с корутинами, таймерами и горячей перезагрузкой скриптов прямо во время игры.

Доступ к игре

Сотни опкодов и функций: спавн техники, телепорт, погода, время, работа с игроками и объектами.

Интерфейс

Отрисовка текста и примитивов, поддержка ImGui для окон, кнопок, слайдеров и настроек мода.

SA-MP и сеть

Через дополнительные библиотеки — чтение чата, диалогов, RPC и сетевых пакетов многопользовательского режима.

Память процесса

Чтение и запись адресов, хуки и патчи — для тех, кому мало готового API.

Библиотеки

Экосистема готовых модулей: requests, ffi, encoding, vkeys, inicfg и десятки других.

Что нужно

GTA San Andreas версии 1.0 US — другие версии не поддерживаются
Установленный ASI Loader
Windows и права на запись в каталог игры
Для сетевых модов — клиент SA-MP совместимой версии

Как ставится

Скачать установщик MoonLoader с официальной страницы проекта.
Указать папку с gta_sa.exe — установщик сам положит moonloader.asi и создаст каталог moonloader/.
Кинуть нужные .lua-скрипты в moonloader/.
Запустить игру. Логи и ошибки — в moonloader/moonloader.log.

Скрипты перезагружаются сочетанием клавиш без перезапуска игры — удобно, когда правишь свой мод.

Частые вопросы

Забанят ли за это?: На сетевых серверах — зависит от правил конкретного проекта. Читерские скрипты почти везде запрещены, вспомогательные и интерфейсные обычно нет. Решение и ответственность — на игроке.
Работает ли на других версиях игры?: Нет. Нужна именно 1.0 US, остальные сборки имеют другую разметку памяти.
Чем отличается от CLEO?: CLEO использует язык на базе игровых опкодов, MoonLoader — обычный Lua. Оба плагина спокойно работают в одной установке.

Где искать подробности

blast.hk — основное сообщество и раздел с релизами
Wiki проекта — документация по API и функциям