Описание
# CC: Spatial Projector
**Programmable world-space overlays for CC:Tweaked computers and turtles.**
CC: Spatial Projector lets ComputerCraft programs draw lines, paths, boxes, and markers directly in the Minecraft world.
Place a **Spatial Projector**, connect it to a ComputerCraft computer, turtle, or wired modem, and wear bound **Spatial Goggles** to see its output. Use it for technical build planning, navigation, turtle debugging, automation displays, and custom spatial interfaces.
Visuals are overlays only. They do not place blocks, spawn entities, or affect collisions.
## Features
- ComputerCraft peripheral named `spatial_projector`
- Spatial Goggles for viewing projector output
- Lua API for lines, polylines, boxes, and markers
- Named visual objects that can be updated, removed, listed, or cleared
- Persistent visuals by default
- Optional TTL for temporary visuals
- Configurable limits and default values
- Built-in demo and utility commands
- Optional Curios support for wearing goggles in a supported Curios slot
## Quick start
1. Place a **Spatial Projector**.
2. Put a ComputerCraft computer or turtle next to it, or connect it using a wired modem.
3. Right-click the projector with **Spatial Goggles** to bind them.
4. Wear the bound goggles.
5. Run the built-in demo:
```text
spatial_projector
```
Useful CraftOS commands:
```text
spatial_projector -- run the demo
spatial_projector demo 30 -- run the demo with a 30-second TTL
spatial_projector clear -- clear all visuals
spatial_projector stats -- show projector statistics
spatial_projector list -- list object IDs in the buffer
```
## Lua example
```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()
```
## Drawing API
Each visual is stored under a string ID inside the projector buffer. Drawing another object with the same ID replaces the previous visual.
```lua
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` is optional. If it is omitted, the projector uses its configured defaults.
```lua
{
color = 0x33ff88, -- RGB color
width = 0.0625, -- line, polyline, and box width
ttl = 0, -- seconds before auto-removal; 0 means persistent
size = 0.35, -- marker size
}
```
### Line
Draws a segment between two world positions.
```lua
projector.line("line.id", 0, 64, 0, 10, 64, 0, {
color = 0xff3333,
width = 0.07,
ttl = 30,
})
```
### Polyline
Draws a connected path through a dense array of `{x, y, z}` points.
```lua
projector.polyline("route", {
{0, 64, 0},
{4, 65, 4},
{8, 64, 8},
{12, 64, 4},
}, {
color = 0x33ff88,
width = 0.06,
})
```
### Box
Draws a box between two opposite corners.
```lua
projector.box("build.area", 0, 63, 0, 10, 70, 10, {
color = 0x3399ff,
width = 0.05,
})
```
### Marker
Draws a marker at one world position.
```lua
projector.marker("target", 16, 64, 0, {
color = 0xff33cc,
size = 1.0,
})
```
### Buffer utilities
```lua
projector.clear() -- remove all visuals
projector.remove(id) -- remove one visual by ID
projector.list() -- list object IDs
projector.stats() -- get projector statistics
projector.getLimits() -- get configured limits
projector.sync() -- send pending drawing changes
```
Call `sync()` after a batch of drawing changes.
## Requirements
Requires **Minecraft 1.21.1**, **NeoForge 21.1.x**, **Java 21**, **CC:Tweaked 1.120.0+**, and **Create 6.0.10+**.
Create is used as a rendering/library dependency. CC: Spatial Projector does not add Create contraption mechanics.
**Optional:** Curios API 9.x for wearing Spatial Goggles in a supported Curios slot. Without Curios, goggles can be worn as a normal helmet.
## Notes
- Only players wearing goggles bound to a projector receive its visuals.
- Coordinates use normal Minecraft world coordinates.
- `list()` returns object IDs, not full geometry data.
- Visuals remain until they are cleared, removed, overwritten, expire through TTL, or are cleaned up when the chunk or world unloads.