FragGuard
面向 Paper 服务器的区块日志记录、历史查询与回滚保护
FragGuard 是一款 Minecraft 服务器保护插件,它记录区块变化,帮助管理员调查活动情况,并允许对不需要的更改进行回滚。
无论你是正在处理恶意破坏(griefing)、意外损坏,还是仅仅想知道你的世界中发生了什么,FragGuard 都提供了调查和恢复的工具。
所有操作均在 Minecraft 内直接管理。 无需客户端模组、资源包或外部数据库。
26.3-1.2.1 更新内容
本次更新提升了性能、可靠性以及回滚的准确性。
- 玩家专属回滚: 跨多个世界查找并撤销特定玩家所做的更改。
- 更好的 TNT 和红石追踪: 改进了对爆炸、活塞移动及受支持的红石机制的归属判定。
- 更安全的回滚: 更好地保护由其他玩家或环境造成的更改。
- 更快的历史搜索: 在搜索大量区块历史记录时提升了性能。
- 数据库改进: 降低了迁移存储需求,并改善了从中断升级中恢复的能力。
- 错误修复: 各种修复以提升稳定性和可靠性。
功能特性
详细的区块日志记录
FragGuard 自动记录区块变化,包括玩家行为、爆炸、火灾、液体、活塞、自然变化以及其他支持的事件。
每条记录均包含时间、位置、原因以及调查所需的相关信息。
游戏内 GUI
使用 /fg 打开 FragGuard 易于使用的菜单。
- 按区域或玩家搜索区块历史。
- 浏览和过滤已记录的活动。
- 查看汇总的活动或单个更改。
- 预览并确认回滚。
- 查看并撤消之前的回滚任务。
- 检查数据库状态。
区域与玩家回滚
将某个区域恢复到较早的状态,或有选择地撤销与特定玩家相关的更改。
FragGuard 包含回滚预览、确认提示、冲突保护和撤消支持,以帮助防止意外损坏。
高级玩家归属判定
FragGuard 跟踪直接的玩家行为以及由 TNT、红石、活塞和其他机制引起的受支持的间接更改。
当无法可靠地识别责任玩家时,FragGuard 会记录物理原因而非猜测。
性能与可靠性
FragGuard 旨在高效处理大量的区块历史记录。
- 本地 SQLite 数据库存储。
- 分页的历史搜索。
- 可配置的历史保留期(默认为 30 天)。
- 自动清理过期记录。
- 回滚期间的服务器性能保护。
- 具有重启恢复功能的持久化回滚任务。
命令
| 命令 | 描述 |
|---|---|
/fg |
打开主菜单 |
/fg help |
查看可用命令 |
/fg lookup r:30 |
搜索附近的区块历史 |
/fg lookup u:Player |
搜索某位玩家的历史 |
/fg rollback r:30 t:2d |
预览区域回滚 |
/fg rollback u:Player t:2d |
预览玩家回滚 |
/fg rollback confirm <token> |
确认回滚 |
/fg rollback cancel |
取消预览 |
/fg undo <job-id> |
撤消一次回滚 |
/fg status |
查看数据库状态 |
所有管理命令都需要 fragguard.admin 权限,该权限默认授予服务器操作员。
安装
- 下载 FragGuard 并将
.jar文件放入服务器的plugins文件夹中。 - 重启服务器。
- 使用
/fg打开菜单。
要求
- Minecraft 26.3
- Paper
- Java 25
FragGuard 会自动创建其配置文件和数据库文件。设置可以在 plugins/FragGuard/config.yml 中进行自定义。
无需安装客户端或在外部数据库中设置。
用 FragGuard 保护你的服务器
FragGuard 将详细的历史追踪、易于使用的调查工具和可靠的回滚保护结合在一个服务器端插件中。
从小型私人 SMP 到较大的社区服务器,FragGuard 帮助管理员监控更改、调查损坏并保持世界的安全。
追踪更改。调查活动。恢复你的世界。
FragGuard
Block Logging, History Lookup & Rollback Protection for Paper Servers
FragGuard is a Minecraft server protection plugin that records block changes, helps administrators investigate activity, and allows unwanted changes to be rolled back.
Whether you're dealing with griefing, accidental damage, or simply want to know what happened in your world, FragGuard provides the tools to investigate and restore it.
Everything is managed directly in Minecraft. No client mods, resource packs, or external databases are required.
What's New in 26.3-1.2.1
This update improves performance, reliability, and rollback accuracy.
- Player-Specific Rollbacks: Look up and reverse changes made by a particular player across multiple worlds.
- Better TNT and Redstone Tracking: Improved attribution of explosions, piston movement, and supported redstone mechanisms.
- Safer Rollbacks: Better protects changes made by other players or the environment.
- Faster History Searches: Improved performance when searching large amounts of block history.
- Database Improvements: Reduced migration storage requirements and improved recovery from interrupted upgrades.
- Bug Fixes: Various fixes to improve stability and reliability.
Features
Detailed Block Logging
FragGuard automatically records block changes, including player actions, explosions, fire, liquids, pistons, natural changes, and other supported events.
Each record includes the time, location, cause, and block information needed to investigate what happened.
In-Game GUI
Use /fg to open FragGuard's easy-to-use menu.
- Search block history by area or player.
- Browse and filter recorded activity.
- View condensed activities or individual changes.
- Preview and confirm rollbacks.
- View and undo previous rollback jobs.
- Check database status.
Area & Player Rollbacks
Restore an area to an earlier state or selectively reverse changes associated with a specific player.
FragGuard includes rollback previews, confirmation prompts, conflict protection, and undo support to help prevent accidental damage.
Advanced Player Attribution
FragGuard tracks both direct player actions and supported indirect changes caused by TNT, redstone, pistons, and other mechanisms.
When the responsible player cannot be reliably identified, FragGuard records the physical cause rather than guessing.
Performance & Reliability
FragGuard is designed to handle large amounts of block history efficiently.
- Local SQLite database storage.
- Paginated history searches.
- Configurable history retention (30 days by default).
- Automatic cleanup of expired records.
- Server-performance safeguards during rollbacks.
- Persistent rollback jobs with restart recovery.
Commands
| Command | Description |
|---|---|
/fg |
Open the main menu |
/fg help |
View available commands |
/fg lookup r:30 |
Search nearby block history |
/fg lookup u:Player |
Search a player's history |
/fg rollback r:30 t:2d |
Preview an area rollback |
/fg rollback u:Player t:2d |
Preview a player rollback |
/fg rollback confirm <token> |
Confirm a rollback |
/fg rollback cancel |
Cancel a preview |
/fg undo <job-id> |
Undo a rollback |
/fg status |
View database status |
All administrative commands require fragguard.admin, which is granted to server operators by default.
Installation
- Download FragGuard and place the
.jarfile in your server'spluginsfolder. - Restart your server.
- Use
/fgto open the menu.
Requirements
- Minecraft 26.3
- Paper
- Java 25
FragGuard automatically creates its configuration and database files. Settings can be customized in plugins/FragGuard/config.yml.
No client-side installation or external database setup is required.
Protect Your Server with FragGuard
FragGuard combines detailed history tracking, easy-to-use investigation tools, and reliable rollback protection in one server-side plugin.
From small private SMPs to larger community servers, FragGuard helps administrators monitor changes, investigate damage, and keep their worlds protected.
Track changes. Investigate activity. Restore your world.
下载 FragGuard
下载 FragGuard
下载 FragGuard
下载 FragGuard
下载 FragGuard
下载 FragGuard
下载 FragGuard
下载 FragGuard
下载 FragGuard
下载 FragGuard
26.3-1.2.1 Hotfix 1
修复
- 热修复:在受限的、已提交的批次中删除过期的历史记录和回滚快照,以避免大型 WAL(预写日志)事务;在孤立清理失败时保持活动日志的健康状态 (#183)。
26.3-1.2.1
更改
- 将 Paper API 更新至 26.3 build 241 stable。
- 更新 README 中针对 26.3-1.2.1 的构建说明。
- 更新 artifact GitHub Actions,以上传 7.0.2 并下载 8.0.2 (#122)。
- 将 Gradle wrapper 更新至 9.8.2 (#127)。
- 在 GitHub Actions 中将 Java 设置更新至 6.1.0,Gradle 设置更新至 6.4.1 (#132)。
- 将 SQLite JDBC compile/test 依赖项更新至 3.54.1.0 (#133)。
- 在运行时使用 Paper 的 SQLite JDBC 并添加驱动程序诊断功能 (#149)。
- 改进了在没有旧备份的情况下进行 schema-v7 前向迁移恢复的能力 (#150)。
- 添加了离线全历史迁移检查及最终版本发布验证门控 (#151)。
- 为 Java 25 测试配置了 SQLite JNI 访问权限,并记录了服务器设置说明 (#88)。
- 提高了回滚边界的可见性、采样率及配置选项 (#99)。
- 添加了基于 UUID 的历史玩家解析及 Actor 查询索引 (#100)。
- 添加了针对存储故障的每索引 SQLite 迁移诊断功能 (#138)。
- 减小了历史 Actor 索引的大小,并使索引迁移支持断点续传(可重启)(#139)。
- 添加了感知存储的迁移检查及安全化的 SQLite 故障恢复机制 (#140)。
- 添加了大型历史记录的 SQLite 迁移回归测试及发布清单 (#141)。
- 添加了 v7 坐标索引存储的诊断与恢复调查 (#147)。
- 复用现有的区块索引,以避免执行全历史的坐标索引迁移 (#148)。
- 为可追溯的 TNT 和机械链添加了有界因果玩家归属判定 (#106)。
新增
- 添加了仅限玩家的环形回滚边界预览功能 (#97)。
- 在命令和 GUI 中添加了回滚预览取消及清理功能 (#98)。
- 添加了通过 UUID/名称查找玩家的全局功能,支持世界、时间和分页过滤 (#101)。
- 添加了选择性玩家回滚规划,并提供历史所有权保护 (#102)。
- 添加了玩家回滚预览、确认、持久化多世界任务、撤销操作及区块重叠保护 (#103)。
- 添加了玩家范围的查找与回滚 GUI 界面,包含基于历史的选择、分页、过滤及安全预览功能 (#104)。
修复
- 修复了 Gradle 10 的资源处理警告 (#86)。
- 修复了 Shadow JAR 的服务合并问题 (#87)。
- 修复了无关的 TNT 在未观察到 TNT 移动的情况下继承活塞所有权的问题 (PR #146)。
- 修复了 GUI 玩家历史查询中缺失部分索引条件的问题 (PR #146)。
- 修复了硬链接及必需的历史索引检查相关的离线验证输出安全性问题 (#151)。
- 修复了当玩家关闭红石时活塞缩回的归属判定问题 (#146)。
26.3-1.2.0
更改
- 将 Paper API 更新至 26.3 #177 Stable。
- 提升了大型历史记录 GUI 的查询性能。
- 移除了冗余的数据库查询。
- 改进了过滤器加载及查询超时处理。
- 添加了扩展的 GUI 回归测试。
修复
- 修复了由无效方块图标导致的 GUI 崩溃问题。
- 修复了出错后 GUI 关闭或丢失位置的问题。
- 修复了在大型历史记录查询时加载缓慢和导航卡顿的问题。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧