Skip to content

Latest commit

 

History

169 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

HelperByOrc

Нативный ASI-плагин для GTA San Andreas / SA:MP (Win32/x86): биндер сценариев, быстрое меню, теги, общий блокнот, HUD и фильтр сообщений в одном внутриигровом интерфейсе.

Подробная документация: HelperByOrc Wiki.

Возможности

  • Сценарии из текста, команд, задержек, уведомлений и действий с чатом или диалогами.
  • Запуск биндов по горячим клавишам, командам, сообщениям и через быстрое меню.
  • Помощник текстового триггера позволяет выбрать точную RakNet-строку из последних 100 сообщений, автоматически находит изменяемые части и применяет PCRE2-шаблон только после подтверждения; нужные значения доступны через [chatwordsex(...)].
  • Категории, папки, поиск, ручная сортировка, два вида списка (Проводник и Две панели) и отдельные настройки сохранения последней папки и состояния раскрытия между запусками.
  • Условия запуска и видимости по состоянию игры, SA:MP, чата, курсора и транспорта.
  • Встроенные теги и пользовательские переменные для игровых данных, текста и вычислений.
  • [waitif(...)] неблокирующе ждёт состояние игры, игрока, транспорта или клавиши и продолжает текущий бинд.
  • Ручной выбор цели для {target...}: Q включает курсор, а видимый игрок под ним выделяется белой контурной обводкой; дальность и фильтр по видимому нику SA:MP настраиваются.
  • Общие для всех профилей переменные из Lua через MoonLoader Host.
  • Общий для всех профилей блокнот: встроенная инструкция, поиск внутри и по всем заметкам, разметка, изображения, импорт/экспорт и живые .txt.
  • HUD-конструктор с HUD-блоками, слоями, группами, условиями и шаблонами.
  • Фильтр сообщений с понятным списком правил, автоматическим помощником, живой проверкой и выбором строки из общей истории последних 100 RakNet-сообщений.
  • Неинтерактивные системные OSD-уведомления или запись в лог с независимыми группами и антифлудом.
  • Профили с отдельными биндами, HUD, фильтрами и настройками; заметки остаются общими.
  • Интеграция со стандартным SA:MP и дополнительными интерфейсами Arizona: _chat.asi и CEF-диалогами.

Скриншоты

HelperByOrc - Binder

HelperByOrc - фильтр сообщений

Требования

Параметр Значение
Игра GTA San Andreas + SA:MP
Архитектура Win32 / x86
Конфигурация Release|Win32
Поддерживаемые samp.dll R1, R2, R3, R3-1, R4, R4-2, R5-1, DL-R1

Поддержка привязана к проверенным бинарным вариантам. Неизвестный SHA-256, включая DLL с известным entry point, отключает все зависящие от адресов функции и SA:MP/RakNet hooks.

Установка

  1. Получите HelperByOrc.asi из релиза или локальной сборки.
  2. Поместите файл в папку игры, ASI Loader или modloader.
  3. Запустите игру и откройте меню комбинацией Ctrl + Z.
  4. Выберите профиль и настройте язык, масштаб, горячие клавиши и быстрое меню. Ручной выбор цели для {targetid} включён по умолчанию: нажмите Q, наведите курсор на игрока и нажмите ЛКМ. В Настройки -> Горячие клавиши меняются клавиша, дальность выбора и необязательный фильтр по видимому нику SA:MP.

Конфиг активного профиля:

GTA San Andreas User Files\HelperByOrc\profiles\<profile-id>\HelperByOrc.json

Общий Блокнот хранится в GTA San Andreas User Files\HelperByOrc\notepad и не меняется при переключении профиля.

При использовании portablegta базовая папка user files определяется самой игрой. Не заменяйте HelperByOrc.asi, пока игра запущена.

Lua-переменные размещаются в GTA San Andreas User Files\HelperByOrc\vars и подпапках; поддерживаются UTF-8 и legacy Windows-1251, а новые providers нужно явно включить в Прочее -> Переменные -> Lua. Для их выполнения нужны MoonLoader и moonloader\HelperByOrcVarsHost.lua; установить или обновить Host можно там же. Физически используется один host-файл: MoonLoader повторно загружает его для каждого включённого provider и создаёт отдельные states без копий providers и сгенерированных файлов в %TEMP%. Lua выполняется как доверенный код внутри процесса, а не sandbox.

Подробный локальный контракт: переменные из Lua.

Документация

Сборка

MSBuild HelperByOrc.slnx /t:Build /p:Configuration=Release /p:Platform=Win32 /m

Результат: HelperByOrc\Release\HelperByOrc.asi. Подробнее: Сборка.

Автор

@dmitriyewich — HelperByOrc

Лицензия

Собственный код HelperByOrc распространяется по лицензии MIT. Сторонние компоненты в HelperByOrc/external сохраняют свои лицензии, приложенные в соответствующих каталогах.

About

Биндер на ASI

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages