CC: Spatial Projector

CC: Spatial Projector

Программируемые оверлеи в мировом пространстве для компьютеров и черепах CC:Tweaked.

CC: Spatial Projector позволяет программам ComputerCraft рисовать линии, пути, боксы и маркеры прямо в мире Minecraft.

Поставь Spatial Projector, подключи его к компьютеру ComputerCraft, черепахе или проводному модему и надень привязанные Spatial Goggles, чтобы видеть его вывод. Используй для планирования технических построек, навигации, отладки черепах, дисплеев автоматизации и кастомных пространственных интерфейсов.

Визуализация — это только оверлеи. Они не ставят блоки, не спавнят сущностей и не влияют на коллизии.

Возможности

• Периферия ComputerCraft с именем spatial_projector
• Spatial Goggles для просмотра вывода проектора
• Lua API для линий, полилиний, боксов и маркеров
• Именованные визуальные объекты, которые можно обновлять, удалять, перечислять или очищать
• Визуализации сохраняются по умолчанию
• Опциональный TTL для временных визуализаций
• Настраиваемые лимиты и значения по умолчанию
• Встроенные демо- и служебные команды
• Опциональная поддержка Curios для ношения очков в поддерживаемом слоте Curios

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

1. Поставь Spatial Projector.
2. Поставь рядом компьютер или черепаху ComputerCraft либо подключи его через проводной модем.
3. Нажми ПКМ по проектору с Spatial Goggles, чтобы привязать их.
4. Надень привязанные очки.
5. Запусти встроенное демо:

spatial_projector

Полезные команды CraftOS:

spatial_projector          -- запустить демо
spatial_projector demo 30  -- запустить демо с TTL 30 секунд
spatial_projector clear    -- очистить все визуализации
spatial_projector stats    -- показать статистику проектора
spatial_projector list     -- вывести список ID объектов в буфере

Пример на Lua

local projector = peripheral.find("spatial_projector")
if not projector then
    error("spatial_projector not found")
end

projector.clear()

projector.line("axis.x", 0, 64, 0, 16, 64, 0, {
    color = 0xff3333,
    width = 0.07,
})

projector.marker("target", 16, 64, 0, {
    color = 0xff33cc,
    size = 1.0,
})

projector.sync()

API рисования

Каждая визуализация хранится под строковым ID в буфере проектора. Если нарисовать другой объект с тем же ID, предыдущая визуализация заменится.

projector.line(id, x1, y1, z1, x2, y2, z2, options)
projector.polyline(id, points, options)
projector.box(id, x1, y1, z1, x2, y2, z2, options)
projector.marker(id, x, y, z, options)

options необязателен. Если его не указать, проектор использует настроенные значения по умолчанию.

{
    color = 0x33ff88, -- цвет RGB
    width = 0.0625,  -- толщина линии, полилинии и бокса
    ttl = 0,         -- секунды до автоудаления; 0 — постоянно
    size = 0.35,     -- размер маркера
}

Линия

Рисует отрезок между двумя позициями в мире.

projector.line("line.id", 0, 64, 0, 10, 64, 0, {
    color = 0xff3333,
    width = 0.07,
    ttl = 30,
})

Полилиния

Рисует соединённый путь через плотный массив точек {x, y, z}.

projector.polyline("route", {
    {0, 64, 0},
    {4, 65, 4},
    {8, 64, 8},
    {12, 64, 4},
}, {
    color = 0x33ff88,
    width = 0.06,
})

Бокс

Рисует бокс между двумя противоположными углами.

projector.box("build.area", 0, 63, 0, 10, 70, 10, {
    color = 0x3399ff,
    width = 0.05,
})

Маркер

Рисует маркер в одной позиции мира.

projector.marker("target", 16, 64, 0, {
    color = 0xff33cc,
    size = 1.0,
})

Утилиты буфера

projector.clear()       -- удалить все визуализации
projector.remove(id)    -- удалить одну визуализацию по ID
projector.list()        -- вывести список ID объектов
projector.stats()       -- получить статистику проектора
projector.getLimits()   -- получить настроенные лимиты
projector.sync()        -- отправить отложенные изменения рисования

Вызывай `sync()` после пакета изменений отрисовки.

## Требования

Требуется **Minecraft 1.21.1**, **NeoForge 21.1.x**, **Java 21**, **CC:Tweaked 1.120.0+** и **Create 6.0.10+**.

Create используется как зависимость для отрисовки/библиотека. CC: Spatial Projector не добавляет механики конструкций Create.

**Опционально:** Curios API 9.x для ношения Spatial Goggles в поддерживаемом слоте Curios. Без Curios очки можно носить как обычный шлем.

## Примечания

- Визуализацию получают только игроки, носящие очки, привязанные к проектору.
- Координаты используют обычные мировые координаты Minecraft.
- `list()` возвращает ID объектов, а не полные данные геометрии.
- Визуализация сохраняется, пока её не очистят, не удалят, не перезапишут, пока не истечёт TTL или пока она не будет удалена при выгрузке чанка или мира.