Скрипты на Lua.

Быстрый старт

Откройте меню клиента → Tools → Scripts и нажмите «Новый скрипт»: в папке .minecraft/atheryx/scripts появится файл из шаблона и откроется в редакторе. Сохраните его — скрипт загрузится, а его модуль появится в своём разделе меню.

-- @name Привет
-- @author вы
-- @version 1.0
-- @description Мой первый модуль

local m = module.create{
    name = "Hello",
    description = "Здоровается при включении",
    category = "player",
}

local text = m:text("Текст", "Привет из Lua!")

m:on("enable", function()
    chat.print(text:get())
end)

m:on("tick", function()
    if player.health() < 6 then
        client.notify("Hello", "Мало здоровья!")
    end
end)

• Шапка из комментариев -- @name, @author, @version, @description — то, что видно в разделе Scripts.
• Правка файла подхватывается за секунду: скрипт выгружается и грузится заново, а включённость и настройки его модулей сохраняются.
• Готовые примеры клиент кладёт в scripts/examples — скопируйте любой в scripts, и он заработает.
• Проверить что-то на лету — команда .lua player.health() прямо в чате.

Как устроено

Жизненный цикл

• При загрузке выполняется весь файл (основной код). Модули, их настройки и команды заводятся именно здесь — из обработчиков module.create не работает.
• Модули скрипта — полноценные модули клиента: карточка в меню, клавиша, поиск, уведомления, сохранение в пресет. Выключенный или упавший скрипт не стирает их настройки из пресета.
• Скрипт можно выключить переключателем в разделе Scripts или командой .script off имя — выбор помнится между запусками.
• Перед выгрузкой (правка файла, выключение) модули скрипта выключаются, затем зовётся events.on("unload").

Ошибки

Ошибка при загрузке показывается на карточке скрипта красным. Ошибка в обработчике модуля выключает модуль, в events.on — снимает обработчик, в таймере — снимает таймер. Каждая ошибка пишется в консоль раздела Scripts (там же вывод print) и в чат — не чаще раза в 5 секунд на одно место.

Команды в чате

Модули

Методы модуля

Настройки

Настройки заводятся у своего модуля при загрузке, рисуются в его карточке и сохраняются в пресет. Каждый вызов возвращает объект настройки.

Методы настройки

События

У модуля — m:on(name, fn), работают, пока модуль включён. У скрипта — events.on(name, fn) / events.off(name), работают, пока скрипт загружен. Таблицы событий с e:cancel() отменяют действие игры.

Игрок

Таблица player. Без мира всё возвращает nil, а действия ничего не делают.

Мир и сущности

Методы сущности

Сущность — лёгкая ссылка по id: если она ушла из мира, e:valid() вернёт false, остальные методы — nil. Сравнение a == b работает.

Рендер 2D

Таблица render — только в обработчиках render2d и render_world. Тот же движок, что у меню клиента: скругления, тени, размытие, чёткий текст. Координаты — в единицах интерфейса. Цвет — число 0xAARRGGBB или строка "#RRGGBB", "#AARRGGBB", "#RGB".

Ножницы и сдвиги, которые вы забыли снять, снимаются сами в конце обработчика.

Рендер 3D

Таблица render3d — в обработчике render3d. Фигуры видно сквозь стены; за обработчик — до 4096 штук.

Чат и команды

command.register("coords", "Мои координаты", function(args, raw)
    local x, y, z = player.position()
    chat.print(string.format("§fXYZ §7%.0f %.0f %.0f", x, y, z))
end)

Таймеры и хранилище

Хранилище у каждого скрипта своё — файл scripts/.data/имя.json, пишется раз в секунду и при выгрузке.

Утилиты

Ограничения

Скрипты работают в песочнице: им нельзя навредить компьютеру и повесить игру.

• Нет io, debug, luajava, dofile, loadfile и os кроме часов — ни файлов, ни процессов, ни Java. load принимает только текст.
• Обработчик события — до 60 мс, загрузка файла — до 2 с. Застрявший цикл обрывается, даже внутри pcall и корутин.
• Файл скрипта — до 1 МБ, string.rep — до 4 млн символов, таймеров — до 512, хранилище — до 4096 ключей.
• Рисовать можно только в обработчиках отрисовки и только из игрового потока.
• Каждый скрипт — в своём окружении: переменные и подмены string одного не видны другим.

Примеры

Все примеры лежат в scripts/examples: hello, autogg, hud, esp, commands, automessage.

Мини-HUD

local m = module.create{ name = "MiniHud", category = "render" }
local accent = m:color("Акцент")              -- цвет темы
local size = m:slider("Размер", 10, 7, 16, 0.5)

m:on("render2d", function(frame)
    local x, y, z = player.position(frame.partial)
    local text = string.format("XYZ %.1f %.1f %.1f  •  %d FPS", x, y, z, client.fps())
    local w = render.text_width(text, size:get(), "medium") + 16
    render.blur(6, 6, w, 22, 10, 6)
    render.rect(6, 6, w, 22, "#B0141820", 6)
    render.rect(10, 11, 2, 12, accent:get(), 1)
    render.text(text, 16, 17, { size = size:get(), font = "medium", valign = "center" })
end)

Подсветка игроков

local m = module.create{ name = "SimpleESP", category = "render" }
local fill = m:color("Заливка", "#28FFFFFF")
local edge = m:color("Рёбра")

m:on("render3d", function(frame)
    for _, p in ipairs(world.players()) do
        if not p:is_self() then
            render3d.entity(p, fill:get(), p:is_friend() and "#63FF8E" or edge:get())
        end
    end
end)

Автоответ и тихий поворот

local m = module.create{ name = "LookAtNearest", category = "combat", bind = "G" }
local range = m:slider("Дальность", 4, 1, 6, 0.1, " бл")

m:on("tick", function()
    local best, bestDistance
    for _, p in ipairs(world.players()) do
        local d = p:distance()
        if not p:is_self() and not p:is_friend() and d <= range:get() and (not best or d < bestDistance) then
            best, bestDistance = p, d
        end
    end
    if best then
        local x, y, z = best:eye()
        rotation.set(rotation.to(x, y - 0.3, z))
    end
end)

m:on("chat", function(e)
    if e.sender and e.text:find("ping", 1, true) then
        timer.after(500, function() chat.send("pong!") end)
    end
end)