Кастомные API курса

В процессе прохождения курса мы используем не только стандартные команды языка Lua, но и специальные библиотеки (API), написанные специально для наших космических, неоновых и марсианских приключений.

Если ты случайно удалил нужный файл или он повредился, ты всегда можешь скачать его заново с помощью команды pastebin get <код> <имя_файла>.

Ниже приведена полная документация по каждому кастомному модулю.

1. Редактор Анимаций (Editor)

Продвинутая программа для создания покадровой пиксельной графики. Используется в модуле Нео-Киото.

Команда для установки:

pastebin get T0EkyM4T editor

Как пользоваться:

Напиши editor и нажми Enter.
Введи имя проекта (например, show).
Рисуй кадры!

Горячие клавиши редактора:

1-7 — Инструменты (Карандаш, Заливка, Ластик и т.д.)
Стрелка Вправо / Влево — Следующий / Предыдущий кадр.
C (Copy) — Скопировать ВЕСЬ рисунок из прошлого кадра в текущий.
O (Onion Skin) — Включить "Луковую шелуху" (подсветку бледным контуром прошлого кадра).
WASD — Сдвинуть рисунок (вверх, вниз, влево, вправо).
R (Run) — Запустить просмотр анимации.
E (Edit Config) — Открыть файл настроек config.lua для изменения скорости, зацикливания или вывода на внешний монитор.

Пример конфигурации (config.lua):

Редактор Lua

-- Скорость проигрывания (в секундах между кадрами) speed = 0.15 -- Повторять ли анимацию бесконечно? loop = true -- Выполняется перед началом отрисовки function onStart() -- Перенаправляем вывод на большой монитор сзади компьютера local big_screen = peripheral.wrap("back") if big_screen then term.redirect(big_screen) end end

2. Графический Движок (Engine / GUI)

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

Команды для установки:

pastebin get iZj3qC37 engine

Дополнительные файлы фестиваля из урока 27:

Фейерверк: pastebin get yp86rTcn firework
Музыка: pastebin get P04ja4UM music

Основные методы Engine:

Редактор Lua

Метод	Описание	Аргументы
`gui.init(side, scale, bg)`	Подключает монитор, ставит масштаб и заливает фон.	`side` (сторона), `scale` (масштаб), `bg` (цвет фона)
`gui.add(text, y, color, action, [opts])`	Создает сенсорную кнопку. Если `x` не указан в `opts`, центрирует её.	`text`, `y`, `color`, `action`, `{opts}`
`gui.run()`	Отрисовывает весь интерфейс и запускает бесконечный цикл отслеживания кликов.	—

Параметр Action (Действие кнопки):

Если передана сторона ("left", "back" и т.д.), подается редстоун-сигнал.
Если передана функция function() ... end, она выполнится.
Если передан текст ("music", "show"), движок запустит файл с таким именем через shell.run.

Пример использования (Пульт управления):

Редактор Lua

local gui = require("engine") -- Включаем монитор сверху, ставим масштаб 1 и серый фон gui.init("top", 1, colors.gray) -- Добавляем кнопки с разными действиями gui.add("FIREWORKS", 2, colors.red, function() shell.openTab("firework &") end, {h = 3}) gui.add("PLAY MUSIC", 6, colors.blue, "music", {h = 3}) gui.add("HOLOGRAM", 10, colors.lime, "show", {h = 3}) -- Запускаем интерфейс gui.run()

3. Навигационная Система (Nav API)

Движок (Backend) для создания P2P-радаров и компасов с распределенной синхронизацией базы данных по радиоэфиру.

Команда для установки:

pastebin get C5nkzGbN nav

Основные методы Nav:

Редактор Lua

Метод	Описание
`nav.init(username, color)`	Настраивает навигатор: имя пилота и цветовой акцент интерфейса. Открывает задний модем.
`nav.addBtn(id, text)`	Добавляет кнопку в графическое меню компаса.
`nav.listen()`	Запускает асинхронный слушатель. Ждет клика по экрану ИЛИ перехватывает радиопакеты с новыми метками на фоне. Возвращает `id` нажатой кнопки.
`nav.actionMark()`	Процесс создания новой метки по текущим GPS координатам игрока.
`nav.showDB()`	Открывает список всех меток (База Данных).
`nav.actionRadar()`	Включает визуальный компас со стрелочками до цели.
`nav.exitApp()`	Выключает программу и очищает экран.

Пример использования (Приложение Навигатора):

Редактор Lua

os.loadAPI("nav") -- Инициализируем радар (имя пилота и цвет интерфейса) nav.init("Engineer_Alex", colors.cyan) -- Создаем главное меню nav.addBtn("MARK", "SET NEW MARK") nav.addBtn("DB", "DATABASE") nav.addBtn("RADAR", "COMPASS") nav.addBtn("EXIT", "POWER OFF") -- Запускаем бесконечный цикл слушателя while true do -- Программа ждет нажатия кнопок или прилета пакетов по сети local action = nav.listen() -- Обрабатываем нажатия if action == "MARK" then nav.actionMark() elseif action == "DB" then nav.showDB() elseif action == "RADAR" then nav.actionRadar() elseif action == "EXIT" then nav.exitApp() break end end

4. Таймлайн Фейерверков (FW API)

Продвинутая пиротехническая библиотека, работающая по принципу временной шкалы (хореографии), позволяя наслаивать эффекты друг на друга.

Команда для установки:

pastebin get WBM9ZSFD fw_api

Основные методы FW API:

Редактор Lua

Команда	Описание
`fw.init(skyHeight, groundOffset)`	Настраивает высоты шоу. Базовый вариант: `fw.init(50, 10)`
`fw.play(loops)`	Главная команда запуска. `loops` — количество повторов всего шоу.

Функции Эффектов (Принимают (time, color)): Аргументы всегда одинаковые: секунда запуска (time) и цвет ("red", "random", "white", и т.д.).

fw.arena_columns / fw.fountain / fw.wave / fw.fan / fw.rain — Наземные эффекты.
fw.sphere / fw.cube / fw.pyramid / fw.dna / fw.hourglass — Геометрия.
fw.laser / fw.blackhole / fw.galaxy / fw.vortex / fw.rainbow_ring — Гранд-финал и космос.

Пример: fw.sphere(25, "random") — взорвет сферу случайного цвета ровно на 25-й секунде шоу.

Пример использования (Хореография шоу):

Редактор Lua

local fw = require("fw_api") -- Настройка размеров сцены (50 - высота неба, 10 - стартовая высота с земли) fw.init(50, 10) -- Добавляем эффекты на таймлайн fw.arena_columns(0, "white") -- Запустится сразу fw.fountain(8, "gold") -- На 8-й секунде -- Синхронный двойной запуск на 25-й секунде fw.sphere(25, "random") fw.laser(25, "blue") -- Мощный финал fw.blackhole(40, "purple") fw.galaxy(50, "white") -- Воспроизвести получившееся шоу 1 раз fw.play(1)