SA:MP Lua Arizona [ARZ] ARENDA TRACKER // Статистика Аренды

AhkOnly

Участник
Автор темы
44
8
Версия SA-MP
  1. Любая
ARENDA TRACKER
Учёт дохода с аренды предметов на Item Market — статистика, история и
Telegram-бот




Что делает

Скрипт слушает чат и автоматически записывает каждую аренду ваших предметов на Item Market: ник арендатора, сумму
начисления и точное время. Ничего вводить руками не нужно — открыли рынок, выставили предметы, дальше скрипт считает
сам.

Вся статистика хранится локально в JSON и доступна как из игрового окна, так и из Telegram — можно смотреть доход, не
заходя в игру.




Игровой интерфейс

Тёмная панель в cyan-акценте, три раздела:


  • ОБЗОР — четыре метрики (сегодня / неделя / месяц / всё время) с суммой и количеством операций, ниже лента
    последних аренд.
  • ИСТОРИЯ — полный журнал с фильтром по периоду (все / день / неделя / месяц) и живым поиском по нику
    арендатора.
  • TELEGRAM — привязка бота в три клика, индикатор состояния подключения и наличия модулей.

Окно открывается и закрывается плавным затуханием, весь рендер — на DrawList, без «дефолтного» вида ImGui.




Telegram-бот

Автопривязка. Вставляете токен от @BotFather, отправляете боту /start, жмёте
ПРИВЯЗАТЬ — Chat ID определяется сам, команды регистрируются в меню Telegram, снизу появляется постоянная
клавиатура.

Уведомления. Каждая новая аренда приходит в чат карточкой: арендатор, сумма, время и сводка за день / неделю /
всё время. Уведомления можно выключить одной кнопкой, команды при этом продолжают работать.

Аналитика. Средний чек, число уникальных арендаторов, сравнение «сегодня к вчера» в процентах, лучший день,
крупнейшая аренда и график дохода за последние 7 дней прямо в сообщении.

  • /stats — сводная статистика за все периоды
  • /today, /yesterday — отчёт за день
  • /week, /month — отчёт за неделю и месяц
  • /date 22.07.2026 — отчёт за конкретную дату
  • /recent 20 — последние N аренд (от 1 до 30)
  • /renter Nick_Name — карточка арендатора: доход, число аренд, средний чек, первая и последняя сделка
  • /analytics — расширенная аналитика с графиком
  • /top — топ-10 арендаторов
  • /last — последняя аренда
  • /notifications — включить или выключить уведомления
  • /status — состояние скрипта
  • /menu — обновить нижние кнопки
  • /help — справка
Команды принимает только привязанный Chat ID — чужой человек, нашедший бота, статистику не увидит.




Надёжность данных


  • Атомарная запись. Файл пишется во временный и только потом заменяет основной — краш игры на середине
    сохранения не портит статистику.
  • Резервная копия. Перед каждой записью прошлая версия уходит в ArendaTracker.backup.json; если
    основной файл повреждён, скрипт поднимется с бэкапа.
  • Защита от дублей. Сервер иногда дублирует уведомление — одинаковая пара «ник + сумма» в пределах заданного
    окна пишется один раз. Окно настраивается от 0 до 60 секунд, по умолчанию 3.
  • Гибкий парсер. Разбирается структура сообщения, а не одна конкретная фраза — новые типы арендуемых предметов
    (аксессуары, охрана, обычные предметы) считаются без правок скрипта.
  • Пересчёт при загрузке. Общая сумма всегда пересобирается из записей, так что рассинхрона тотала и истории не
    бывает.




Установка


  1. Скинуть ArendaTracker.lua в moonloader.
  2. Зайти в игру, ввести /arenda.
  3. Для Telegram — создать бота у @BotFather, вставить токен во вкладку TELEGRAM, отправить боту
    /start и нажать ПРИВЯЗАТЬ.

Требования: MoonLoader 0.26+, SAMPFUNCS, библиотека SAMP.Lua. Для Telegram дополнительно нужны
effil и requests — без них скрипт полностью работает как локальный трекер, просто
вкладка Telegram сообщит о нехватке модулей.

Файлы: moonloader\config\ArendaTracker.json — статистика,
ArendaTracker.backup.json — бэкап, ArendaTelegram.log — лог запросов к API (пригодится,
если бот не отвечает).




Команда

/arenda — открыть или закрыть панель.





Нашли баг или сервер сменил формат сообщения — пишите в тему,
поправлю.
 

Вложения

  • photo_1_2026-08-26_05-37-06.jpg
    photo_1_2026-08-26_05-37-06.jpg
    33.8 KB · Просмотры: 58
  • photo_2_2026-08-26_05-37-06.jpg
    photo_2_2026-08-26_05-37-06.jpg
    27.7 KB · Просмотры: 58
  • photo_3_2026-08-26_05-37-06.jpg
    photo_3_2026-08-26_05-37-06.jpg
    42.1 KB · Просмотры: 58
  • ArendaTracker_TG_PLUS_FIXED.lua
    80.8 KB · Просмотры: 6
Последнее редактирование: