CC：增强现实眼镜

CC：HUD 眼镜

3D 立方体

把 ComputerCraft 显示器戴在脸上。一副眼镜加上一个特殊调制解调器，让任意电脑使用你已经熟悉的 monitor/term API，直接在玩家屏幕上绘制平视显示器（HUD）。

带阴影的直升机 HUD

功能简介

• HUD 眼镜 — 佩戴在头盔槽（或 Curios 槽位）中。已绑定调制解调器输出的内容会以全屏覆盖层形式显示。
• HUD 调制解调器 — 一个 ComputerCraft 外设（type = "hud_glasses"）。像其他外设一样连接到电脑，并像操作显示器一样向它写入内容。
• 绑定机制在眼镜上。手持眼镜右键点击调制解调器即可进行绑定。把眼镜交给朋友，HUD 会跟随他们。任意数量的玩家都可以观看同一个调制解调器。

local hud = peripheral.find("hud_glasses")
hud.setBackgroundColour(0)        -- 透明背景
hud.setTextColour(colors.lime)
hud.setCursorPos(1, 1)
hud.write("你好，HUD！")

如果你曾写过显示器程序，那你已经熟悉这个外设了。

特性

• 与显示器兼容的 API：支持 write、blit、clear、scroll、setCursorPos、setTextColour、setBackgroundColour、setPaletteColour、getSize 等方法。大多数显示器脚本无需修改即可运行。
• 透明背景 — 设置 setBackgroundColour(0)（或在 blit 中使用 -）让世界背景透出，使 HUD 叠加在游戏画面上而非遮挡它。
• 像素级 CC 字体 — 复用 CC：Tweaked 的字形表，所有 256 个字符（方框绘图、子像素块、箭头）都与真实终端外观一致。
• 运行时分辨率 — 通过 Lua 使用 setSize(w, h) 设置，或在配置中设定默认值。单元格越少，文字越大。可选择网格在屏幕上的映射方式：FIT（保持比例，留黑边）、STRETCH（填满屏幕）、COVER（填满并裁剪）。
• 共享屏幕 — 将多副眼镜绑定到同一个调制解调器，所有人看到相同显示内容。适用于团队状态板、基地警报和共享坐标。
• 随处放置 — 调制解调器可安装在任意方块表面（地板、墙壁、天花板），屏幕朝外。
• 便携式 HUD — 将口袋电脑与 HUD 调制解调器合成，为其提供 HUD 升级，即可随身携带显示器。同样是 hud_glasses 外设；潜行+右键点击将佩戴的眼镜绑定到它（普通右键点击仍会打开终端）。
• HUD + 末地调制解调器二合一 — 口袋电脑只有一个升级槽，因此合成一个 HUD 末地调制解调器（HUD 调制解调器 + 末地调制解调器）并安装到口袋电脑上：一个外设兼具屏幕和无线电功能。rednet 可在其上工作，peripheral.find("hud_glasses") 能找到它，并且调制解调器部分支持跨维度。服务器可在配置中关闭该合成配方。
• 游戏内配置 — 可通过 Mods 列表的“Config”按钮编辑设置，或绑定快捷键直接打开客户端设置。
• 切换键 — 按 H 键隐藏或显示 HUD；该设置会持久保存。
• 优化渲染 — 批量绘制和服务端负载缓存，即使对于大型且频繁更新的显示内容，也能保持较低开销。

需求

• NeoForge 1.21.1
• CC：Tweaked 1.119.0 或更高版本（必需）

可选集成

• Curios — 增加一个专用的眼镜饰品槽，使眼镜不占用头盔槽。同时兼容原版头盔槽；无论哪种方式，眼镜都会在头部渲染。
• Create：Aeronautics / Sable — 绑定使用稳定的调制解调器 ID 和 Sable 感知的距离检查，因此当调制解调器位于飞行子层级内时，HUD 仍能正常工作。Sable Companion 已内置，无需额外安装。

带武器的动力装甲 HUD

配置

服务端（hudglassescc-common.toml，实时生效）：

• hudWidth（默认 80） — 默认网格宽度（字符数）
• hudHeight（默认 28） — 默认网格高度（字符数）
• maxRangeBlocks（默认 -1） — 调制解调器与玩家之间的最大距离（方块数），-1 表示无限制
• allowPocketHudEnderCraft（默认 true） — 是否允许合成 HUD 末地调制解调器。设为 false 会完全移除该合成配方；已拥有该升级的口袋电脑仍可正常工作

客户端（hudglassescc-client.toml，每个玩家独立）：

• hudEnabled（默认 true） — 渲染 HUD，按 H 键切换
• hudFit（默认 FIT） — HUD 在屏幕上的缩放方式：FIT（保持比例，留黑边）、STRETCH（填满屏幕，可能变形）、COVER（填满并裁剪溢出部分）
• textShadow（默认 NONE） — 文字阴影样式：NONE / SHADOW / OUTLINE（实验性）

状态

Beta 阶段。核心功能已实现且稳定，但在 mod 成熟过程中可能会出现粗糙边缘和破坏性变更。欢迎提交错误报告和反馈。