红石信号可视化器

Redstone Signal Visualizer

一目了然地查看每个红石信号——自信地进行调试、优化和设计。

---

概述

Redstone Signal Visualizer 在世界中叠加显示实时红石信号强度，让建筑玩家、红石工程师和服务器管理员能够快速检查和调试电路，而无需改变游戏机制。

此模组在服务器与客户端之间划分职责：服务器执行红石状态的权威采样（包括比较器输出及其他客户端无权访问的值），确保可视化反映真实的世界状态。客户端专注于渲染叠加层、处理输入和玩家自定义。在单人游戏中或缺少服务器端组件时，客户端可以执行尽力而为的本地检查，但可能无法达到比较器级别的准确性。

---

功能

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

---

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

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

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

• 交互： 服务器发送周期性更新或响应客户端请求（取决于配置）。客户端控制其渲染内容（半径、模式、颜色），因此多位玩家可以独立可视化，而无需为所有人强制进行服务器端渲染。

---

性能与玩家控制

• 更新延迟： 可调整的刷新间隔（毫秒）。增加延迟可减少 CPU/网络使用，或减小延迟以获得更灵敏的更新。
• 半径： 限制从玩家处可视化信号的距离。较小的半径可减少繁忙服务器和低端客户端的开销。
• 每位玩家限制： 玩家可以设置自己的半径和刷新率，以限制客户端开销并避免使服务器过载。

提示：在人口众多的服务器上，增加更新延迟并减小半径以获得最佳性能。

---

设置与自定义

可通过游戏内 UI（控制 / 模组 / 配置）以及 config/redstone_visualizer.json 进行设置。

你可以自定义：

• 全局或每位玩家启用/禁用模组
• 显示开关： 打开/关闭 showEmits、showReceives 和 showComparators，以控制渲染哪些信号类型
• 颜色和不透明度：用于默认/受阻/发射器/比较器信号
• 半径和更新延迟： 控制更新的距离和频率，以在响应性和性能之间进行权衡
• 行为： 请求频率、服务器推送与客户端轮询，以及发送多少数据

注意：客户端目前注册了一个按键绑定（默认为 o）来打开模组的选项界面。

---

安装

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

---

使用场景与示例

• 快速定位信号泄漏或意外的时钟电路
• 通过中继器和比较器直观地测量传播延迟
• 在教学过程中通过展示信号强度渐变来教育玩家
• 调试服务器端红石问题而不影响性能