Lua Arizona Arizona Rules RAG - Умный справочник правил + ИИ-помощник

swagk1d

Участник
Автор темы
11
2
Версия SA-MP
  1. Любая

Arizona Rules RAG
Умный локальный справочник правил + гибридный ИИ-помощник прямо в игре (VibeCode!)

Автор: swagk1d | Версия: 1.0.5 | Стек: MoonLoader 0.26+ / Mimgui / Effil
​




Описание скрипта
Arizona Rules RAG — это быстрый внутриигровой поисковик и справочник по правилам серверов Arizona RP, написанный на Mimgui. Скрипт избавляет от необходимости сворачивать игру (Alt+Tab) во время спорных ситуаций, задержаний или сделок, чтобы судорожно искать нужный пункт на форуме.

В основе лежит гибридный движок (RAG — Retrieval-Augmented Generation):
  • Уровень 1 — Мгновенный локальный поиск (работает без интернета): взвешенный алгоритм поиска с поддержкой игрового сленга и синонимов. Вводите тазер, аиф, хиф, ковш, пг или зз — скрипт сам поймет, о чем речь, и выдаст нужные пункты.
  • Уровень 2 — ИИ-консультант (опционально, по вашему API-ключу): если включена соответствующая галочка, по кнопке «Спросить ИИ» скрипт берет Топ-5 найденных пунктов из локальной базы и асинхронно (без единого фриза игры через effil) отправляет их вместе с описанием вашей ситуации в нейросеть (OpenAI, DeepSeek, OpenRouter, Grok), выдавая готовый вердикт: пункт, наличие нарушения и меру наказания.




Основной функционал
  • Автоопределение сервера: скрипт сам распознает сервер при входе (включая перелеты на Vice City) и подгружает как общую базу (common.json), так и локальные правила конкретного сервера (<server>.json).
  • Работает «из коробки»: при первом запуске скрипт автоматически создает локальную базу из самых частых нарушений (ДМ, ДБ, ПГ, Сбив, Тайзер в бою, НРП коп, АИФ/ХИФ, НРП разводы).
  • Быстрые действия в один клик:
    • В /b чат — автоматически открывает чат и подставляет готовую аргументацию: /b Согласно п. 3.14 правил сервера: ... (Наказание: Варн).
    • Копировать — копирует номер пункта, полный текст и меру наказания в буфер обмена.
    • Форум — копирует прямую ссылку на раздел форума с этим правилом.
  • Встроенный редактор и автообновление: прямо из меню игры можно добавлять свои заметки/правила в локальную базу или обновлять common.json по прямой ссылке (GitHub Raw URL).
  • Асинхронность без лагов: все сетевые запросы выполняются в изолированных потоках effil — FPS в игре не проседает ни на кадр.




Активация и управление
  • Клавиша: F3 по умолчанию (можно перебиндить на любую удобную во вкладке «Настройки и База»).
  • Команда: /rules




Требования и установка
Зависимости (должны находиться в папке moonloader/lib/):
  • mimgui
  • effil
  • luasocket и luasec (стандартный набор библиотек для HTTPS-запросов)

Установка:
  1. Скачайте файл ArizonaRulesRAG.lua из вложений.
  2. Переместите его в папку GTA San Andreas/moonloader/.
  3. Запустите игру — папка moonloader/config/RulesRAG/ с базой правил создастся автоматически.




Базы хранятся по пути moonloader/config/RulesRAG/:
  • common.json — общие правила проекта.
  • phoenix.json, tucson.json, vice_city.json и т.д. — правила конкретного сервера (подклеиваются автоматически при входе на сервер).

Пример структуры файла:
JSON:
[
  {
    "id": "3.14",
    "category": "МЮ/Гос",
    "title": "Тайзер / Дубинка в бою (Tazer in fight)",
    "short_summary": "Запрещено использовать тайзер или дубинку в перестрелке",
    "text": "Сотрудникам МЮ запрещено использовать электрошокер (тайзер) или дубинку в активной перестрелке, когда преступник ведет огонь в сторону полицейского.",
    "punishment": "Варн (Warn)",
    "keywords": ["тазер", "тайзер", "дубинка", "бою", "электрошокер", "мю", "коп"],
    "forum_url": "https://arizona-rp.com"
  }
]
Доступные значения для поля category: "Общие", "МЮ/Гос", "Гетто/Мафии", "ЦР/Сделки".

Примечание: код открыт. Если сделаете полную JSON-базу правил для своего сервера — кидайте в тему, добавлю в шапку.
 

Вложения

  • ArzRulesRAG.lua
    47.9 KB · Просмотры: 1
  • Bug
Реакции: Hatiko