CC: Spatial Projector

模组

· 作者 TierForger

可编程的 ComputerCraft 全息图,用于在世界中绘制线条、方框、标记和覆盖层。

0 本站下载 0 关注 更新于 4 个月前

最新 0.1.0 · 1.21.1 · NeoForge

一键开服(送7天)

CC: 空间投影仪

为 CC:Tweaked 电脑和潜行者提供可编程的世界空间叠加层。

CC: 空间投影仪允许 ComputerCraft 程序直接在 Minecraft 世界中绘制线条、路径、方块和标记。

放置一个 空间投影仪,将其连接到 ComputerCraft 电脑、潜行者或有线调制解调器,并佩戴已绑定的 空间护目镜 以查看其输出。可用于技术建筑规划、导航、潜行者调试、自动化显示以及自定义空间界面。

视觉效果仅为叠加层。它们不会放置方块、生成实体或影响碰撞检测。

polyline

功能特性

  • 名为 spatial_projector 的 ComputerCraft 外围设备
  • 用于查看投影仪输出的空间护目镜
  • 支持线条、多段线、方块和标记的 Lua API
  • 命名视觉对象,可更新、移除、列出或清除
  • 默认持久化显示
  • 可选的 TTL(生存时间)用于临时视觉元素
  • 可配置的极限值和默认值
  • 内置演示和实用命令
  • 可选 Curios 模组支持,可在支持的 Curios 槽位中佩戴护目镜

快速入门

  1. 放置一个 空间投影仪。
  2. 在其旁边放置一台 ComputerCraft 电脑或潜行者,或使用有线调制解调器进行连接。
  3. 使用 空间护目镜 右键点击投影仪以完成绑定。
  4. 佩戴已绑定的护目镜。
  5. 运行内置演示:
spatial_projector

有用的 CraftOS 命令:

spatial_projector          -- 运行演示
spatial_projector demo 30  -- 运行持续时间为 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,      -- 标记的大小
}

线条 (Line)

在两个世界坐标之间绘制线段。

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

多段线 (Polyline)

通过一组密集的 {x, y, z} 点数组绘制连续路径。

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

方块 (Box)

在两个对角顶点之间绘制方块。

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

标记 (Marker)

在世界坐标位置绘制标记。

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: 空间投影仪不添加 Create 的机械装置机制。

可选: Curios API 9.x,用于在支持的 Curios 槽位中佩戴空间护目镜。如果没有 Curios,护目镜可作为普通头盔佩戴。

注意事项

  • 只有佩戴了与投影仪绑定的护目镜的玩家才能看到其视觉效果。
  • 坐标使用标准的 Minecraft 世界坐标。
  • list() 返回的是对象 ID,而非完整的几何数据。
  • 视觉元素会一直保留,直到被清除、移除、覆盖、因 TTL 过期而消失,或在区块或世界卸载时清理。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源