pnwjdw/LUA-Executor
LuaExecutor — Lua-скрипты с API в стиле MoonLoader и среда разработки (редактор, справочник API, консоль) прямо в GTA San Andreas и SA-MP. Автор — yorenov.
README.md
LuaExecutor
ASI-плагин для GTA San Andreas 1.0 US и SA-MP 0.3.7, который запускает Lua-скрипты с API в стиле MoonLoader и
приносит в игру собственную среду разработки. Нажимаешь F12 — и поверх игры открываются редактор кода с
подсказками и проверкой ошибок, список скриптов, справочник API на 2233 записи и консоль. LuaJIT встроен в
LuaExecutor.asi: рядом с игрой не нужны lua51.dll, MoonLoader, CLEO, SAMPFUNCS, BASS или D3DX.
Скачать LuaExecutor 0.2.0 · Руководство · Справочник API · Примеры · Изменения
| Редактор с подсказками | Ошибки видно до запуска |
|---|---|
| Справочник API в игре | Скрипты и автозагрузка |
| Скрипт рисует поверх игры (F5) | Фильтр чата SA-MP через onReceiveRpc |
| Консоль и команды скриптов | Рендер, диалоги SA-MP |
Кадры сняты в GTA San Andreas 1.0 US с SA-MP 0.3.7-R1 на локальном сервере. Скрипты с кадров — в
examples и в руководстве.
Возможности
- Среда разработки в игре — редактор с подсветкой Lua, вкладками, поиском и заменой; подсказки по функциям
(Ctrl+Space), подсказка аргументов, переход к определению (Ctrl+B), справка по F1, подсказки модулей в
require. - Ошибки до запуска — синтаксические ошибки LuaJIT с объяснением на русском, возможные опечатки в именах функций и неверное число аргументов.
- Запуск в одно нажатие — F5 сохраняет и запускает скрипт, повторное нажатие перезапускает его без перезахода
в игру. Сохранение атомарное, с копией
.bak; кодировка UTF-8 или CP1251 определяется сама. - Менеджер скриптов — состояние каждого скрипта, запуск, перезапуск, остановка и автозагрузка выбранных или всех скриптов.
- Справочник API в игре — функции MoonLoader и SAMPFUNCS, события, опкоды игры и стандартная библиотека LuaJIT: сигнатура, параметры, результаты, ограничения и пример, который можно вставить в открытый файл.
- Консоль — сообщения скриптов и системы с уровнями и фильтром, консольные команды скриптов.
- API в стиле MoonLoader —
main,wait,lua_thread, директивыscript_*, события,inicfg,memory,ffi, JSON, рендер, звук (MP3, WAV, FLAC, OGG), DXUT-диалоги, больше 1400 опкодов игры в виде функций. - SA-MP 0.3.7 R1, R2, R3-1, R4, R4-2, R5 — чат, команды, диалоги, игроки, транспорт, текстдравы; перехват, изменение и блокировка RPC и пакетов. Клиент с другим именем DLL указывается в настройках.
- Встроенный CLEO 4 включается сам, если скрипту нужен CLEO-скрипт, а
CLEO.asiнет. - Псевдоним
lua51.dll— бинарные модули, которые импортируютlua51.dll, получают встроенный LuaJIT. - Загрузочный экран с заставкой LuaExecutor.
Требования
| Игра | GTA San Andreas 1.0 US (gta_sa.exe 1.0 US, в том числе HOODLUM) |
| Загрузчик | любой ASI Loader, например Silent's ASI Loader или Ultimate ASI Loader |
| SA-MP | необязательно; 0.3.7 R1, R2, R3-1, R4, R4-2, R5 |
Установка
- Скачайте
LuaExecutor-0.2.0.zipиз релиза. - Положите
LuaExecutor.asiв папку игры рядом сgta_sa.exe. - Запустите игру и нажмите F12.
Скрипты лежат в папке moonloader в папке игры, настройки и журнал — в папке LuaExecutor. Автозагрузка скриптов
по умолчанию выключена: включите её в разделе «Настройки» или запускайте скрипты из раздела «Скрипты».
Первый скрипт
F12 → Редактор → Создать, вставьте код и нажмите F5:
script_name("FirstScript")
script_author("Ваше имя")
function main()
while not isSampAvailable() do wait(100) end
sampRegisterChatCommand("hi", function(argument)
sampAddChatMessage("Hello from LuaExecutor", 0xFFD27A)
end)
wait(-1)
end
Файл сохранится в папку скриптов и сразу запустится. В консоли появится FirstScript: Loaded successfully., а в чате
SA-MP заработает команда /hi.
Меню
| Раздел | Что там |
|---|---|
| Редактор | файлы скриптов, вкладки, подсказки, панель проблем, запуск и остановка |
| Скрипты | все скрипты папки, их состояние, действия и автозагрузка |
| API | справочник с поиском и фильтрами |
| Консоль | журнал скриптов и системы, консольные команды |
| Настройки | папки, горячая клавиша, шрифт и масштаб, сохранение, автозагрузка, клиент SA-MP, окружение |
| О программе | версия, сборка, автор и ссылки |
| Клавиши редактора | |
|---|---|
| F5 / Shift+F5 | запустить или перезапустить / остановить |
| Ctrl+Space | подсказки |
| F1 | справка по слову под курсором |
| Ctrl+B | перейти к определению |
| F8 | следующая проблема в коде |
| Ctrl+S, Ctrl+N, Ctrl+O, Ctrl+W | сохранить, создать, открыть, закрыть вкладку |
| Ctrl+F, Ctrl+H, Ctrl+G | поиск, замена, переход к строке |
Все клавиши и настройки — в руководстве.
Что лежит в релизе
| Файл | Содержимое |
|---|---|
LuaExecutor-0.2.0.zip | LuaExecutor.asi, руководство и справочник API (docs/), примеры (examples/), LICENSE.txt, THIRD_PARTY_NOTICES.txt, README.txt |
LuaExecutor.asi | только сам плагин |
SHA256SUMS.txt | контрольные суммы |
Исходный код LuaExecutor не публикуется: в релизе готовый ASI, документация и примеры.
Примеры
| Пример | Что показывает | Управление |
|---|---|---|
01_hello_command.lua | команда чата и сообщение | /hello [имя] |
02_render_overlay.lua | шрифт, текст с цветовыми тегами и плашка поверх игры | F9 |
03_threads.lua | фоновый поток и поток, который перезапускается | F10 |
04_config_inicfg.lua | INI через inicfg и JSON | /cfg toggle, /cfg <секунды> |
05_chat_filter.lua | перехват и блокировка входящего RPC | /filter |
06_console_and_dialog.lua | консольная команда и диалог-список SA-MP | lx_info, /lxmenu |
07_russian_text.lua | кириллица из UTF-8 в CP1251 для чата и рендера | /privet |
Скопируйте нужный файл в папку moonloader и запустите его из раздела «Скрипты» или откройте в редакторе и
нажмите F5.
Документация
docs/guide.md— руководство: установка, меню, редактор, автозагрузка, настройки, файлы, совместимость с MoonLoader, SA-MP, кодировки, CLEO, ограничения и решение проблем.docs/api/— справочник API по разделам и алфавитный указатель. Это тот же каталог, что встроен в ASI и открывается на вкладке API.
Лицензия
LuaExecutor бесплатен. LuaExecutor.asi можно использовать и распространять без изменений вместе с файлом лицензии;
продавать, изменять и декомпилировать его нельзя. Код примеров и примеры из документации можно свободно использовать
в своих скриптах. Полный текст — в LICENSE.
Сторонние компоненты
LuaExecutor включает LuaJIT, Dear ImGui, ImGuiColorTextEdit, tree-sitter и tree-sitter-lua, MinHook, CLEO 4,
Plugin-SDK, miniaudio, stb, lua-cjson и шрифты Noto Sans и JetBrains Mono. Их лицензии — в
THIRD_PARTY_NOTICES.txt; этот же текст встроен в ASI.
Обратная связь
Баги, вопросы и предложения — в Issues.
- YouTube: youtube.com/channel/UCxVucpxziVBvUJ9TIkitjyQ
- Telegram: @VagizovDanis
Автор — yorenov.
asiasi-plugincode-editorgta-sagta-san-andreasimguilualuajitmoonloadersamp
Diese Seite wird aus dem erstellt, was GitHub über das Repository veröffentlicht. samp.directory hostet den Code nicht. Ein Problem mit diesem Eintrag melden