RollbackCore - 高效回滚竞技场插件

RollbackCore 是一款功能强大的回档插件，能够高效回档任意大小的竞技场区域。它也可用于粘贴建筑，具体取决于您的使用方式。通过其 API，它可以集成到任何 Bukkit/Spigot 插件中。

💡主要特性

• 广泛的版本兼容性：支持 Minecraft 1.4.7 至 1.20.3+。1.12.2 及更早版本的存档格式会自动更新至 1.13+ 格式（目前不支持 1.13 降级到 1.12）。
• 渐进式操作：将任务分步执行，防止服务器卡顿。
• 性能优化：可配置每 tick 的操作时长，以最小化延迟并最大化操作速率。内置压缩功能以节省硬盘空间。
• 数据保存：存储告示牌文本、头颅所有者（1.13+）和命令方块命令（1.13+）。
• 高扩展性：引入 [BETA] 版 WatchDogRegion 和 [EXPERIMENTAL] 版 WholeWorldRollback 功能，以支持更大规模的回档。
• 版本独立：仅使用 Java 库和 Spigot API，确保在新版 Minecraft 发布时不会崩溃。

🎮命令、权限与配置

完整的命令、权限和配置说明，请查阅 Wiki 页面：

https://bitbucket.org/lizardfreak321/rollbackcore/wiki/Home

🔧插件集成

与 SurvivalGames 插件集成

您可以通过我制作的教程了解所有集成细节。

Skript 支持

RollbackCore 支持 Skript 事件。Skript 2.6.4 需使用旧版插件，2.7.2 可使用最新版。

可用事件示例

on rollbackcore copy end:
broadcast "Copy ended! Status: %event-string%, Location: %event-location%"
on rollbackcore paste end:
broadcast "Paste ended! Status: %event-string%, Location: %event-location%"

API 与开发者文档

• API 文档：https://www.shadowxcraft.net/javadocs/rollbackcore/
• Wiki 指南：https://bitbucket.org/lizardfreak321/rollbackcore/wiki/Home
• Maven 仓库：可通过 JitPack 获取。
• 主仓库：https://jitpack.io/#null321-jared/rollbackcore/
• 旧版仓库：https://jitpack.io/#null321-jared/rollbackcore-legacy/

**Maven 依赖示例**

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>
<dependency>
    <groupId>com.github.null321-jared</groupId>
    <artifactId>rollbackcore</artifactId>
    <version>replace-with-newest-version</version>
</dependency>

**Java 代码示例**

import net.shadowxcraft.rollbackcore.*;
// 保存区域
new Copy(min, max, yourPlugin.getDataFolder() + "/arenas/" + arenaName.toLowerCase(), sender, prefix).run();
// 粘贴区域
new Paste(min, yourPlugin.getDataFolder() + "/arenas/" + arenaName.toLowerCase(), sender, true, false, prefix).run();

✨方块数据更新

RollbackCore 允许管理员配置方块数据更新，以应对 Minecraft 版本更新导致的方块 ID 变化。

• 更新原理：配置文件使用 YAML 格式，通过正则表达式定义从旧版本方块 ID 到新版本的映射。
• 自定义更新：可以在配置文件中创建 custom-mappings: 根节，并使用与内置更新相同的格式添加自定义映射。
• 重要提示：YAML 格式要求严格，请确保熟悉其语法后再进行修改。错误的转换可能导致问题，但插件会生成 .dat_old 备份文件，重命名为 .dat 后可手动修复。

⭐其他信息

开源与统计

• 开源协议：本插件基于 LGPL 协议开源。
• 当前版本源码：https://github.com/null321-jared/rollbackcore
• 旧版源码：https://github.com/null321-jared/rollbackcore-legacy
• 统计：插件使用 bStats 收集匿名统计信息，您可以在 bStats 配置中禁用此功能。

软依赖

• WorldEdit：部分命令需要 WorldEdit，但使用 API 时则不需要。
• Skript：部分功能支持 Skript，但非必需。

已知限制与注意事项

• 方块实体数据：目前仅保存告示牌文本、头颅所有者和命令方块命令的方块实体数据。如需其他数据支持，请在讨论区留言。
• WatchDogRollback [BETA]：由于通过监听器记录方块变化，有时可能遗漏更改（例如 WorldEdit 或插件直接修改方块）。如需确保区域完整，请使用 Copy 功能进行备份。
• WholeWorldRollback [EXPERIMENTAL]：在备份整个世界前，可能需要手动保存世界。
• 版本测试：已在 Java 8 和 Bukkit/Spigot 1.4.7 - 1.16.4 上测试通过。请注意，CraftBukkit 版本越旧，稳定性可能越差。请确保使用与服务器版本对应的正确 Jar 文件。

支持与反馈

• 问题反馈：
• 1.13+ 版本问题：https://github.com/null321-jared/rollbackcore/issues
• 1.12.2- 版本问题：https://github.com/null321-jared/rollbackcore-legacy/issues
• 测试服务器：
• shadowxcraft.net /server hg （游戏开始时回档竞技场）
• shadowxcraft.net /server kitpvpretro （BuildUHC 和 QuickHG）
• 注意：我不会收到评论的邮件通知。如有问题，请在讨论区提问，我通常会在当天或次日回复。

如果您喜欢这个插件，请给予评分。开发投入了大量时间，捐赠也将被欣然接受。