[LUA] moonloader

Все знают CLEO. Почти каждый знает о многочисленных проблемах со скриптами, использующими CLEO: нестабильность работы, проблемы совместимости на разных версиях, низкая скорость работы и вследствие большая нагрузка от масштабных модификаций, а разработчикам известно о сложности и неудобстве разработки на встроенном скриптовом языке игры.
Безусловно, CLEO - легендарная модификация, внёсшая громадный вклад в моддинг GTA San Andreas, благодаря чему эта игра и является одной из самых популярных игр в сфере моддинга. Но библиотека CLEO стара, хоть и поддерживается разработчиками по сей день. Скриптовый движок игры, который использует CLEO, тоже стар и имеет множество изъянов, а достойной альтернативы* до сих пор не существовало. До пор, пока не появился MoonLoader.



​

v.021-alpha​

MoonLoader** - это мод для игры GTA San Andres, стремящийся стать полной современной заменой CLEO. Он вносит возможность загрузки Lua-скриптов в игру и уже имеет всю функциональность опкодов игры, CLEO, а так же плагина SAMPFUNCS.

MoonLoader будет полезен как разработчикам так и пользователям, не занимающимся разработкой. Поскольку Lua скрипты не требуют обязательной компиляции, каждый может изменить исходный код скрипта любым текстовым редактором. Например, можно поменять кнопку или команду для активации скрипта, совсем не умея программировать и не обращаясь за помощью как это сделать, чтобы всё работало. Кроме этого, MoonLoader можно загружать в уже запущенную игру с помощью любого инжектора, эта возможность может быть полезна тем, кто не хочет держать скрипты и сам плагин в директории игры. Нельзя не упомянуть, что стабильность Lua-скриптов на порядок выше, благодаря встроенным средствам скриптового движка и плагина, а также повышенному качеству разработки, что тоже играет важную роль для любого пользователя.

MoonLoader не зависит от наличия установленного CLEO, не зависит от мультиплеерной модификации SA:MP и плагина SAMPFUNCS (зависят только скрипты, использующие те или иные возможности), а так же он работает (точнее, будет работать) на любой версии игры и совместим с любой версией CLEO, SA:MP и SAMPFUNCS.

Язык программирования Lua является одним из самых популярных скриптовых языков в сфере разработки игр, и в связи с этим для него существует огромное количество готовых решений тех или иных задач, много готовых модулей на самом Lua, с использованием FFI и в виде динамических библиотек, помогут сэкономить время на поиске решения.
Lua значительно упростит разработку и повысит её качество и эффективность, а сами скрипты будут работать стабильнее и быстрее. Благодаря тому, что MoonLoader использует не обычный Lua, а LuaJIT, который широко известен своей колоссальной производительностью и невероятно мощной библиотекой FFI, можно добиться наилучших результатов в реализации задачи.



Установка: распаковать архив 'moonloader.zip' в корневую папку игры.

Разработчики:
FYP, hnnssy, EvgeN 1137

Благодарности:
MISTER_GONWIK

Помимо самого MoonLoader команда Разработчиков подготовила несколько скриптов, которые уже можно использовать, а для разработчиков они будут неплохим примером.
Все скрипты лежат в архиве 'scripts.zip', каждый архив внутри соответствует названию скрипта.
Устанавливать нужно не сами архивы, а их содержимое.

ClickWarp

ClickWarp
Автор: FYP
Описание: телепортирует игрока в позицию, указанную курсором. Умеет телепортировать на динамические объекты и объекты, созданные сервером, корректно телепортирует в тоннели и внутри интерьеров.
Управление: колёсико мыши (нажать) - показать/скрыть курсор; левая кнопка мыши - телепортировать; правая кнопка мыши (держать) - телепортироваться внутрь транспорта.
Установка: распаковать архив в папку 'moonloader'.
Зависимости: SA:MP, SAMPFUNCS

FakeWhisper

FakeWhisper
Автор: hnnssy
Описание: добавляет в чат фейковое оповещение о том, что пришло или было отправлено личное сообщение игроку на сервере.
Команды (чат): /fwt [id] [text] - оповещение об исходящем сообщении; /fwf [id] [text] - оповещение о входящем сообщении
Установка: распаковать архив в папку 'moonloader'.
Зависимости: SA:MP, SAMPFUNCS

GM Patch

GM Patch
Автор: FYP
Описание: отключает античит SA:MP на неуязвимость. Активация и деактивация автоматическая.
Установка: распаковать архив в папку 'moonloader'.
Зависимости: SA:MP

hBar

hBar
Автор: hnnssy
Описание: рисует бар с основной информацией об игроке и управляемом транспорте внизу экрана.
Команды (чат): /hbar - отключить/включить.
Установка: распаковать архив в папку 'moonloader'.
Зависимости: SA:MP, SAMPFUNCS

MapLimit 260

MapLimit 260
Автор: FYP
Описание: снижает лимит минимального размера полноэкранной карты до минимально возможного.
Установка: распаковать архив в папку 'moonloader'.

ML AutoReload

ML AutoReload
Автор: FYP
Описание: следит за изменениями в загруженных скриптах и перезагружает их автоматически, если они были изменены.
Установка: распаковать архив в папку 'moonloader'.

ML Reload all

ML ReloadAll
Автор: FYP
Описание: перезагружает все загруженные скрипты, загружает добавленные и выгружает убранные одним нажатием комбинации клавиш.
Активация: Ctrl + R
Установка: распаковать архив в папку 'moonloader'.

NameTag

NameTag
Автор: hnnssy
Описание: WallHack для SA:MP - показ ников игроков через стены.
Активация: Alt + F3 - включить/выключить
Установка: распаковать архив в папку 'moonloader'.
Зависимости: SA:MP, SAMPFUNCS

QuickMap

QuickMap
Автор: FYP
Описание: быстрый доступ к игровой карте.
Активация: M англ. (удерживать) - показать карту.
Установка: распаковать архив в папку 'moonloader'.

Samp VL AutoPin

SAMP-VL Autopin
Автор: FYP
Описание: автоввод пинкода для сервера SAMP-Virtual Life.
Настройка: настройки задаются в файле 'autopin.lua' в подпапке 'config'
'autopin.serverAddress' - адрес сервера
'autopin.accounts' - список аккаунтов в таком формате: {Your_Nickname = "1234", Another_Account = "3432"}
Активация: автоматическая, при наличии аккаунта в конфиге.
Установка: распаковать архив в папку 'moonloader'.
Зависимости: SA:MP, SAMPFUNCS

Script Manager

Script manager
Авторы: MISTER_GONWIK, FYP
Описание: менеджер Lua-скриптов MoonLoader-а. Интуитивно понятный интерфейс.
Команды (чат): /smenu - показать/скрыть меню
Установка: распаковать архив в папку 'moonloader'.
Зависимости: SA:MP, SAMPFUNCS

SF Integration

SF Integration
Автор: FYP
Описание: интеграция MoonLoader в SAMPFUNCS. Вывод всех сообщений MoonLoader-а в консоль и исполнение Lua-кода из командной строки консоли.
Команды (консоль): lua, >> - выполнить Lua-код.
Установка: распаковать архив в папку 'moonloader'.
Зависимости: SAMPFUNCS

Warp to player

Warp to player
Автор: FYP
Описание: телепорт к игроку по иду. Телепортирует через всю карту, если на сервере включены глобальные маркеры.
Команды (чат): /warpto [playerid] [text] - телепорт к игроку
Установка: распаковать архив в папку 'moonloader'.
Зависимости: SA:MP, SAMPFUNCS

Weapon Menu

Weapon menu
Авторы: FYP, hnnssy, ~Au{R}oN
Описание: чит на оружие, красивое меню с удобным выбором оружия, возможность выбрать количество патронов.
Управление: Правый Ctrl + Delete - показать скрыть меню; стрелки - навигация по списку оружий; +/- - выбор количества патронов; выдать оружие - Enter.
Установка: распаковать архив в папку 'moonloader'.

Weather and time

Weather and time
Автор: hnnssy
Описание: команды для смены погоды и времени
Команды (чат): /st [hour] - задать время; /sw [id] - изменить погоду
Установка: распаковать архив в папку 'moonloader'.

Скачать moonloader: https://yadi.sk/d/Acy379iY3DcRLQ
Скачать скрипты: https://yadi.sk/d/JRKc1uaYuJmsc
:vt2:


* - мне известно о существовании asi-плагинов, но, во-первых, они не являются скриптами и во-вторых - не существует ни одной реализации, которая содержит всю функциональность опкодов игры и CLEO. Единственным аргументом против этого может быть только plugin_sdk от DK22Pac, однако он довольно тяжёлый и требует знаний и опыта разработки на C++.

** - полное название плагина - "SA MoonLoader", но используется оно лишь для того, чтобы избежать конфликта названий.​