Установка и запуск

Где лежат скриптыСкопировать ссылку

Все скрипты лежат в одной папке внутри клиента. Искать её руками не надо: набери в игровом чате .py dir, и папка сама откроется в проводнике.

Один файл это один скрипт. Имя скрипта равно имени файла без расширения: файл hello.py клиент знает как скрипт hello. Именно это имя ты будешь писать в командах.

Команда .pyСкопировать ссылку

Скриптами управляют из игрового чата командой .py. Отдельного меню для этого нет, всё делается в чате.

Первая загрузкаСкопировать ссылку

Самый короткий путь от пустого места до работающего модуля.

1. Пишешь в чат .py create hello. Клиент создаст файл hello.py.
2. Пишешь .py dir, открывается папка. Открой файл редактором и вставь код ниже.
3. Пишешь .py load hello. Клиент выполнит файл, и в меню появится новый модуль.

1
2
3
4
5
6
7mod = Module("Hello", "Other")
mod.setDesc("Первый скрипт")

@events.tick
def on_tick(event):
    if mod.isEnabled():
        client.overlay("Работает!")

Дальше важный момент, на котором спотыкаются почти все. Загрузить скрипт и включить модуль это разные вещи. .py load hello выполняет файл и создаёт модуль Hello, но сам модуль при этом выключен, как любой другой в клиенте. Найди его в меню во вкладке Other и включи.

АвтоперезагрузкаСкопировать ссылку

Пока скрипт загружен, клиент следит за его файлом: сохранил файл, скрипт перезапустился сам. Выходить из игры не надо. Получается удобный цикл: поправил код, нажал Ctrl+S, сразу посмотрел, что вышло.

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

Есть два случая, когда автоперезагрузка не сработает. Оба лечатся одной командой.

• Скрипт ещё ни разу не загружали или ты только что создал файл руками. Клиент за ним пока не следит, нужен .py load <имя>.
• Скрипт упал с ошибкой. Тогда клиент его выгружает и следить за файлом перестаёт. Исправил код, подними скрипт заново тем же .py load <имя>.

Сообщения и ошибкиСкопировать ссылку

Пока пишешь скрипт, тебе постоянно нужно понимать, что внутри него происходит. Способов сказать это несколько, и они попадают в разные места.

Правило простое: client.msg для того, что должен увидеть игрок, а print для себя. print можно звать сколько угодно, он никому не мешает.