samp.directory
← Scripts et bibliothèques

pnwjdw/LUA-Executor

LuaExecutor — Lua-скрипты с API в стиле MoonLoader и среда разработки (редактор, справочник API, консоль) прямо в GTA San Andreas и SA-MP. Автор — yorenov.

Outil★ 0mis à jour il y a 8 joursOther
Ouvrir sur GitHub

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

Установка

  1. Скачайте LuaExecutor-0.2.0.zip из релиза.
  2. Положите LuaExecutor.asi в папку игры рядом с gta_sa.exe.
  3. Запустите игру и нажмите 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.zipLuaExecutor.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.luaINI через inicfg и JSON/cfg toggle, /cfg <секунды>
05_chat_filter.luaперехват и блокировка входящего RPC/filter
06_console_and_dialog.luaконсольная команда и диалог-список SA-MPlx_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.

Автор — yorenov.

asiasi-plugincode-editorgta-sagta-san-andreasimguilualuajitmoonloadersamp

Cette page est construite à partir de ce que GitHub publie sur le dépôt. samp.directory n’héberge pas le code. Signaler un problème avec cette fiche

pnwjdw/LUA-Executor : Outil SA-MP | samp.directory