红石信号可视化器

Redstone Signal Visualizer

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

---

概述

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

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

---

特性

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

---

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

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

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

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

---

性能与玩家控制

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

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

---

设置与自定义

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

你可以自定义：

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

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

---

安装

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

---

使用场景与示例

• 快速定位信号泄漏或意外时钟
• 直观测量中继器和比较器之间的传播延迟
• 在教学过程中通过显示信号强度渐变来教育玩家
• 在不拖垮性能的情况下调试服务端红石问题