安全重置 Minecraft 结构,无需重新生成区块
StructureCycle 将结构恢复至捕获的干净状态,而不会替换区块或整个区域。它从实时服务器注册表中发现原版和数据包结构,捕获其精确的结构块,在每次重置前备份当前结构,并在需要时允许管理员回滚重置操作。
为什么选择 StructureCycle?
公共服务器上的结构通常在被掠夺或损坏一次后,就永远处于空置状态。重新生成区块可能会摧毁玩家建筑、改变地形,或者替换比预期更多的世界内容。StructureCycle 针对结构块本身进行操作,因此管理员可以在保护周围世界的同时刷新内容。
功能特性
- 基于注册表的发现机制,支持原版和数据包结构
- 基于精确结构块的快照,包含方块、方块状态、容器、方块实体和实体
- 手动和自动重置,无需重新生成区块
- 保留重置前的备份,支持回滚
- 精美的库存 GUI,具备分页、筛选、详情、预览、控制和确认功能
- 支持按类型设置默认值,并可为单个结构覆盖重置模式和冷却时间
- 可配置的安全边界,防止在玩家附近进行重置
- 清晰的消息提示,指明阻止操作的玩家
- 活动追踪,记录方块、桶、爆炸、活塞和实体方块变化
- 事务性重新捕获、原子元数据保存、操作锁定以及中断捕获恢复
- 无依赖项、遥测、广告、账户或外部服务
兼容性
一个未修改的 JAR 文件支持 Minecraft 1.21.4 到 26.3 版本,适用于:
- CraftBukkit / Spigot
- Paper
- Purpur
- 兼容的 Bukkit/Paper 分支
不支持 Folia。请在每个后端世界服务器上安装 StructureCycle,而不是安装在 Velocity 或 BungeeCord 上。
Minecraft 1.21.4–1.21.11 需要 Java 21 或更高版本。Minecraft 26.1–26.3 需要 Java 25 或更高版本。
安装
- 停止服务器。
- 将
StructureCycle.jar 放入服务器的 plugins 文件夹中。
- 启动服务器。
- 授予管理员
structurecycle.admin 权限,或使用操作员权限。
- 运行
/sc 打开结构浏览器。
无需任何依赖项。支持现有世界,结构会在区块加载时进行索引。如果附近尚未出现结构,请站在其中并运行 /sc scan。
首次基线
在玩家掠夺或修改结构之前捕获其状态。捕获时的状态将成为未来重置所使用的干净状态。
- 访问该结构,如有需要则运行
/sc scan。
- 打开
/sc 并选择该结构。
- 预览受影响的边界。
- 选择 Capture baseline(捕获基线)并确认。
- 在重置前将所有玩家移出显示的安全区域。
村庄、要塞和废弃矿井默认被禁用,因为玩家通常会在其中建造。你可以在 config.yml 中有意更改它们的策略,或通过 GUI 或命令覆盖单个结构的策略。
主要命令
| 命令 |
用途 |
/sc |
打开结构浏览器 |
/sc scan |
发现与当前区块相交的结构 |
/sc inspect [id] |
检查附近或指定名称的结构 |
/sc preview [id] |
预览受影响的结构块边界 |
/sc capture [id] |
捕获或替换干净基线 |
/sc reset <id> |
准备安全重置 |
/sc rollback <id> |
准备恢复到最新备份 |
/sc confirm |
确认已暂存的世界变更操作 |
/sc mode <id> <default|disabled|manual|automatic> |
设置重置模式覆盖 |
/sc cooldown <id> <default|duration> |
设置自动冷却时间覆盖 |
/sc automatic <on|off> |
全局切换自动重置 |
/sc reload |
重新加载配置 |
首次安装时,自动重置在全局范围内被禁用。StructureCycle 的备份保护单独的重置操作,但不能替代定期的完整世界备份。
Safely reset Minecraft structures without regenerating chunks
StructureCycle restores structures to a captured clean state without replacing chunks or entire regions. It discovers vanilla and data-pack structures from the live server registry, captures their exact pieces, backs up the current structure before every reset, and lets administrators roll the reset back when needed.
Why StructureCycle?
Structures on public servers are often looted or damaged once and then remain empty forever. Regenerating chunks can destroy player builds, change terrain, or replace far more of the world than intended. StructureCycle targets the structure pieces themselves so administrators can refresh content while protecting the surrounding world.
Features
- Registry-driven discovery for vanilla and data-pack structures
- Exact piece-based snapshots of blocks, block states, containers, block entities, and entities
- Manual and automatic resets without chunk regeneration
- A retained pre-reset backup with rollback support
- A polished inventory GUI with pagination, filters, details, previews, controls, and confirmations
- Per-type defaults plus per-structure reset-mode and cooldown overrides
- Configurable safety boundaries that prevent resets while players are nearby
- Clear messages naming the players blocking an operation
- Activity tracking for blocks, buckets, explosions, pistons, and entity block changes
- Transactional recapture, atomic metadata saves, operation locking, and interrupted-capture recovery
- No dependencies, telemetry, advertisements, accounts, or external services
Compatibility
One unchanged JAR supports Minecraft 1.21.4 through 26.3 on:
- CraftBukkit / Spigot
- Paper
- Purpur
- Compatible Bukkit/Paper forks
Folia is not supported. Install StructureCycle on each backend world server, not on Velocity or BungeeCord.
Minecraft 1.21.4–1.21.11 requires Java 21 or newer. Minecraft 26.1–26.3 requires Java 25 or newer.
Installation
- Stop the server.
- Put
StructureCycle.jar in the server's plugins folder.
- Start the server.
- Grant administrators
structurecycle.admin, or use operator permissions.
- Run
/sc to open the structure browser.
No dependencies are required. Existing worlds are supported, and structures are indexed as their chunks load. If a nearby structure has not appeared yet, stand inside it and run /sc scan.
First baseline
Capture a structure before players loot or modify it. The state at capture time becomes the clean state used by future resets.
- Visit the structure and run
/sc scan if needed.
- Open
/sc and select the structure.
- Preview the affected boundaries.
- Select Capture baseline and confirm.
- Move every player outside the displayed safety area before resetting.
Villages, strongholds, and mineshafts are disabled by default because players commonly build in them. You can deliberately change their policies in config.yml or override an individual structure through the GUI or commands.
Main commands
| Command |
Purpose |
/sc |
Open the structure browser |
/sc scan |
Discover structures intersecting the current chunk |
/sc inspect [id] |
Inspect a nearby or named structure |
/sc preview [id] |
Preview the affected piece boundaries |
/sc capture [id] |
Capture or replace the clean baseline |
/sc reset <id> |
Stage a safe reset |
/sc rollback <id> |
Stage restoration of the newest backup |
/sc confirm |
Confirm a staged world-changing operation |
/sc mode <id> <default|disabled|manual|automatic> |
Set a reset mode override |
/sc cooldown <id> <default|duration> |
Set an automatic cooldown override |
/sc automatic <on|off> |
Toggle automatic resets globally |
/sc reload |
Reload the configuration |
Automatic resets are disabled globally on first install. StructureCycle backups protect individual reset operations, but they are not a replacement for regular full-world backups.
评论 0
登录后参与评分
还没有评论,来抢沙发吧