Введение

Что такое скрипты

Скрипты Rockstar — это способ расширить клиент собственным кодом на языке Python. С их помощью создают новые модули, автоматизируют действия, реагируют на события игры и меняют поведение клиента без пересборки.

Каждый скрипт — это обычный .py файл, который клиент подгружает при запуске. Внутри вы описываете класс-модуль, наследуясь от базового Module, и подписываетесь на нужные события.

Что можно сделать

• Создавать собственные модули с настройками, биндами и категориями.
• Подписываться на игровые события: тик, отрисовку, пакеты, атаки, нажатия клавиш.
• Читать и изменять состояние игрока, мира и сущностей.
• Выводить уведомления, рисовать элементы в HUD и отправлять сообщения в чат.
• Публиковать свои скрипты на маркете и зарабатывать на продажах.

Минимальный пример

Простейший рабочий скрипт — модуль, который пишет в чат при включении:

1
2
3
4
5
6
7
8
9from rockstar import Module

class Hello(Module):
    name = "Hello"
    category = "Misc"
    description = "Мой первый скрипт"

    def on_enable(self):
        self.notify("Привет из скрипта!")

С чего начать

Если вы только знакомитесь с системой скриптов — переходите к разделу Установка и запуск, чтобы подготовить окружение и загрузить первый скрипт. Затем изучите Структуру скрипта и Систему событий.