Redstone Signal Visualizer

红石信号可视化器

一眼查看所有红石信号——自信地调试、优化和设计。

概览

红石信号可视化器会在游戏世界中实时叠加显示红石信号强度，让建筑师、红石工程师和服务器管理员无需更改游戏机制，就能快速检查和调试电路。

此模组将服务器和客户端的职责分开：服务器负责权威地采样红石状态（包括比较器输出以及客户端无权访问的其他数值），确保可视化内容反映真实的世界状态。客户端负责渲染叠加效果、处理输入和进行每位玩家的自定义设置。在单人游戏中，或缺少服务端组件时，客户端可以尽力在本地检查，但比较器相关数据的准确性可能不足。

功能

• 实时可视化红石信号强度及其传播
• 服务端采样，并可选择由客户端进行本地回退以确保准确性
• 每位玩家可单独设置客户端渲染：颜色、不透明度和可视化模式
• 可配置更新延迟和范围，以控制性能开销
• 支持按键绑定：切换、按住显示、循环切换模式和冻结
• 游戏内配置界面，以及可编辑的 config/redstone_visualizer.json

工作原理——服务端与客户端

• 服务端（权威数据）：服务器采样方块更新和红石传播，计算权威的信号强度。这能确保可视化内容反映真实的世界状态（适合多人游戏和基于服务器的调试）。

• 客户端（渲染与本地回退）：客户端接收服务器发来的更新，并渲染叠加效果（线条、渐变、标签和动画）。缺少服务端组件时（或在快速单人游戏模式下），客户端可以在本地检查方块，尽力进行可视化。

• 交互方式：服务器会定期发送更新，或根据配置响应客户端请求。客户端可自行控制渲染内容（范围、模式、颜色），因此多位玩家可以各自进行可视化，而无需强制服务器为所有人渲染。

性能与玩家控制

• 更新延迟：可调整刷新间隔（毫秒）。增大延迟可降低 CPU 和网络用量；减小延迟则可让更新更加及时。
• 范围：限制玩家周围多远范围内的信号会被可视化。减小范围可降低繁忙服务器和低端客户端的开销。
• 每位玩家的限制：玩家可以自行设置范围和刷新频率，以限制客户端开销并避免给服务器造成过重负担。

提示：在玩家较多的服务器上，增大更新延迟并缩小范围，可获得最佳性能。

设置与自定义

可通过游戏内界面（控制 / 模组 / 配置）以及 config/redstone_visualizer.json访问设置。

你可以自定义：

• 启用/禁用全局或针对每位玩家启用或禁用模组
• 显示选项：启用/关闭 showEmits、showReceives和 showComparators，以控制渲染哪些信号类型
• 颜色与不透明度可分别设置默认、受阻、发射器和比较器信号
• 范围与更新延迟：控制更新的范围和频率，在响应速度与性能之间进行权衡
• 行为：请求频率、由服务器推送还是由客户端轮询，以及发送的数据量

注意：客户端目前只注册了一个按键绑定（默认为 i），用于打开此模组的选项界面。

安装

• 将模组 JAR 放入 mods/ 文件夹（支持 Fabric 加载器）。重启客户端和/或服务器。
• 服务器管理员：在服务器上安装服务端组件，以便在多人游戏中获得权威视觉效果。

使用场景与示例

• 快速定位信号泄漏或意外时钟电路
• 通过中继器和比较器直观测量传播延迟
• 在教程中展示信号强度梯度，帮助玩家学习
• 调试服务端红石问题，同时避免性能严重下降