[RHV] 地区历史查看器

关于本模组

区域历史查看器是一款实用模组，让你可以捕捉任何区域的快照，稍后回来查看，并能看到在你离开期间该区域发生的所有修改。通过对比所拍摄的快照与新的快照（或当前的实时世界），玩家可以查看哪些内容被添加、移除或更改。

这款模组有多种用途，例如监控服务器上你的基地以防被恶意破坏、查看（或许是不可信的）玩家在服务器上建造/移除的内容、监控农场、追踪红石装置中出了什么问题等等！

---

开始使用

首先，制作或获取一个“区域选择器”，由3个铁锭、1个红石粉和一个石英碎片合成。这是你用来选择所需区域的主要工具。

接下来，设置你的角落：左键点击设置一个角落，右键点击设置第二个角落。然后使用命令：

/rhv snapshot <快照名称>

添加、移除或更改（方块状态改变，例如改变楼梯的朝向），随心所欲。

然后运行命令：

/rhv diff <快照名称>

覆盖层将立即出现，绿色框表示新添加的方块，红色方块表示被移除的方块，橙色方块表示方块状态已更改的方块。

此外，在空中右键点击区域选择器会打印你当前的选择，按住Shift并右键点击会清除你的选择。这个选择即使在死亡或退出服务器后也会保留，所以你永远不会丢失已选择的区域。

---

命令

以下是完整的命令列表及其功能：

• 创建区域快照（/rhv snapshot <快照名称>）：捕捉当前选定的范围，将其保存到磁盘。打印返回区域大小、耗时和内存使用情况。它们存储在<世界名称>/region_history/下，因此会随世界备份一起移动，并且不会弄乱你的世界文件。如果出现以下情况，此命令将拒绝执行：快照名称有误或与其他快照重名，区域超过大小限制（8,388,608个方块，约为256x128x256）。
• 与实时世界的差异对比（/rhv diff <快照名称>）：将快照与当前的世界进行比较。
• 快照之间的差异对比（/rhv diff <快照名称> <快照名称2>）：比较两个快照，两个快照必须覆盖完全相同体积的区域，否则将拒绝执行。
• 列出所有快照（/rhv list）：列出此世界中存储的每个快照，显示大小、维度和捕捉时间。
• 快照信息（/rhv info <快照名称>）：显示特定快照的完整详细信息，包括边界、体积、维度、捕捉者、捕捉时间和磁盘占用大小。
• 删除快照（/rhv delete <快照名称>）：移除一个快照及其文件。
• 清除覆盖层（/rhv clear）：隐藏当前的覆盖层。
• 显示限制（/rhv limits）：显示服务器设置的限制，包括最大区域大小、条目上限，以及删除是否需要管理员权限。
• 选择显示（/rhv sel）：打印当前选择的尺寸。

---

覆盖模式

有多种可用的覆盖模式，并配有快捷键来循环切换。按下K键切换覆盖层，Shift + K循环切换覆盖模式，O键打开快照浏览器，Shift + O切换区域边界显示。各种覆盖模式包括：

• 方框：带轮廓的半透明彩色方框
• 轮廓：仅显示轮廓
• 透视：透过地形显示轮廓
• 幽灵：渲染原来方块的实际模型，并相应地着色。

区域边界会在整个快照范围周围绘制一个框。

---

快照浏览器

按下O键会打开快照浏览器界面，显示你完整的已存储快照历史记录。

左键点击一个快照将其设置为你的第一参考，A，这应该是你的“之前”状态。右键点击另一个区域将其设置为你的对比参考，B。然后对比A > B 比较这两个快照。与实时世界对比 将A与当前世界进行比较，即现在实时的状态。按住Shift点击一个快照两次即可删除它。

浏览器还控制你的显示，例如覆盖模式、区域边界和类别过滤器。你可以切换添加、移除和更改来隐藏和显示类别。

---

配置

客户端设置是可编辑的，例如颜色、不透明度和行为。目前它们只能通过修改文件来更改，不过在下次更新中我会添加更简单的配置方式。

服务器设置可以在config/region_history_viewer-server.toml下更改，在这里你可以自定义最大区域大小、权限和大型捕捉的警告阈值。

---

已知错误/即将推出的功能

• 更好的配置系统
• 设置角落时的音效
• 边界可以随时可见，而不仅仅是在进行差异对比时