TerraRenew
TerraRenew 是一个基于种子的地形更新插件,适用于 Paper 和 Folia,由 Aitchn 开发。它使用当前加载世界的种子和生成器重新构建已生成的内容,可以手动执行,或者在标记的目标处于非活动状态达到配置的时间后自动执行。
功能特性
- 刷新单个区块,且不替换区块内的原生结构部件。
- 刷新选定的原生结构,且不替换周围的地形。
- 独立调度区块和结构的刷新;默认的非活动时间为现实世界中的 90 天。
- 在恢复自然生成的实体的同时,保留玩家以及(默认情况下)驯服、命名和人工创建的实体。
- 当玩家位于手动刷新区域内时发出警告,并要求输入两次完全相同的命令。
- 将刷新标记存储在本地 SQLite 数据库中。
- 在
messages.yml 中使用 MiniMessage 自定义所有面向玩家的消息。
- 使用加载的 vanilla(原版)或自定义世界。生成过程始终遵循该世界当前的种子和生成器。
[!CAUTION]
在安装或升级 TerraRenew 之前,请备份你的世界。更改世界的种子、生成器插件、数据包或 Minecraft 版本可能会导致地形与原始生成结果不同。
兼容性
| 平台 |
测试版本 |
所需 Java 版本 |
| Paper |
1.21, 26.2 |
1.21.x 需要 Java 21;26.x 需要 Java 25 |
| Folia |
1.21.4, 1.21.8, 1.21.11, 26.1.2, 26.2 |
1.21.x 需要 Java 21;26.x 需要 Java 25 |
TerraRenew v0.1.0 支持 Paper 1.21 至 26.2 以及已发布的 Folia 版本(从 1.21.4 到 26.2)。在整个支持范围内,使用同一个插件 JAR 文件。不支持其他 Bukkit 衍生平台。
安装
- 停止服务器并创建完整的世界备份。
- 将
TerraRenew-0.1.0.jar 放入服务器的 plugins/ 目录中。
- 启动服务器,并在控制台中检查 TerraRenew 的启用消息。
- 查看
plugins/TerraRenew/config.yml 和 plugins/TerraRenew/messages.yml。
- 仅授予管理员所需的权限。
TerraRenew 会创建 plugins/TerraRenew/terrarenew.db 用于存储计划的任务目标。请勿在服务器运行时编辑此数据库。使用自定义生成器时,请确保在刷新期间保持相同的生成器插件及其配置可用。
刷新机制
区块和结构的刷新被故意分开处理:
- 区块刷新 在一个区块内恢复生成的方块数据、生物群系、方块实体和自然实体,但不包括原生结构部件。
- 结构刷新 仅在其边界框内恢复选定的原版生成结构。结构之外的方块保持不变。
手动刷新忽略非活动计时器。第一个命令会显示任何玩家数量警告并打开确认窗口;默认情况下,需要在 30 秒内再次输入完全相同的命令才能继续。成功的手动刷新会重置任何匹配的计划任务。
自动刷新仅在目标覆盖的所有区块都卸载后运行。如果目标仍被加载、包含玩家或无法进行刷新,它将保持在计划队列中,并在稍后重试。
命令
主命令为 /terrarenew;/tr 为其别名。区块和结构命令必须由玩家执行,因为它们使用玩家当前所在的世界和位置。
| 命令 |
描述 |
/terrarenew chunk renew [chunk-x chunk-z] |
刷新当前区块或提供的区块坐标。 |
/terrarenew chunk mark <id> [duration] |
标记当前区块以进行自动刷新。 |
/terrarenew structure renew [minecraft:structure] |
刷新与当前区块相交的原生结构。 |
/terrarenew structure mark <id> [minecraft:structure] [duration] |
标记选定的原生结构以进行自动刷新。 |
/terrarenew unmark <id> |
删除计划的刷新目标。 |
/terrarenew list |
列出所有标记的目标。 |
/terrarenew info <id> |
显示某个目标的详细信息和到期时间。 |
/terrarenew reload |
重新加载 config.yml 和 messages.yml。 |
持续时间接受 s、m、h 或 d,例如 30s、6h 或 90d。如果有多个结构与当前区块相交,请指定 TerraRenew 显示的命名空间结构键。
权限
所有权限默认仅限服务器操作员(OP)。
| 权限节点 |
允许操作 |
terrarenew.command.chunk |
区块刷新及区块命令访问权限 |
terrarenew.command.structure |
结构刷新及结构命令访问权限 |
terrarenew.command.mark |
创建区块或结构标记 |
terrarenew.command.unmark |
移除标记 |
terrarenew.command.list |
列出标记 |
terrarenew.command.info |
检查标记详情 |
terrarenew.command.reload |
重新加载配置和消息 |
创建标记需要同时具备相关的 chunk 或 structure 权限以及 terrarenew.command.mark 权限。
配置
默认配置等待 90 天的非活动时间,每五分钟检查一次,并且每次检查最多处理两个自动刷新任务:
inactivity-period: 90d
confirmation-window: 30s
scheduler:
check-interval: 5m
missed-run-policy: DELAYED_ONCE
startup-delay: 1m
player-retry-delay: 15m
max-renewals-per-check: 2
renewal:
blocks-per-region-task: 8192
preserve:
tamed-entities: true
named-entities: true
artificial-entities: true
DELAYED_ONCE 允许在启动延迟过后考虑已过期的目标。SKIP 会在插件启动时重置已过期的目标。降低 blocks-per-region-task 的值可以将方块写入分散到更多的 Folia 区域任务中;较高的值则会在更少的任务中完成每个刷新。
编辑 messages.yml 以翻译或重新设计输出样式。值支持 MiniMessage 格式。保留所有必需的消息键,然后运行 /terrarenew reload。
TerraRenew
TerraRenew is a seed-based terrain renewal plugin for Paper and Folia, created by Aitchn. It rebuilds generated content with the loaded world's current seed and generator, either manually or after a marked target has remained inactive for a configured period.
Features
- Renew a single chunk without replacing native structure pieces inside it.
- Renew one selected native structure without replacing surrounding terrain.
- Schedule chunks and structures independently; the default inactivity period is 90 real-world days.
- Preserve players and, by default, tamed, named, and artificial entities while restoring naturally generated entities.
- Warn when players are inside a manual renewal area and require the exact command to be entered twice.
- Store renewal marks in a local SQLite database.
- Customize every player-facing message with MiniMessage in
messages.yml.
- Use loaded vanilla or custom worlds. Generation always follows that world's current seed and generator.
[!CAUTION]
Back up your worlds before installing or upgrading TerraRenew. Changing a world's seed, generator plugin, datapacks, or Minecraft version may produce terrain that differs from the original generation.
Compatibility
| Platform |
Tested versions |
Required Java |
| Paper |
1.21, 26.2 |
Java 21 on 1.21.x; Java 25 on 26.x |
| Folia |
1.21.4, 1.21.8, 1.21.11, 26.1.2, 26.2 |
Java 21 on 1.21.x; Java 25 on 26.x |
TerraRenew v0.1.0 supports Paper 1.21 through 26.2 and published Folia versions from 1.21.4 through 26.2. The same plugin JAR is used across the supported range. Other Bukkit derivatives are not supported.
Installation
- Stop the server and create a full world backup.
- Place
TerraRenew-0.1.0.jar in the server's plugins/ directory.
- Start the server and check the console for the TerraRenew enable message.
- Review
plugins/TerraRenew/config.yml and plugins/TerraRenew/messages.yml.
- Grant only the permissions required by your administrators.
TerraRenew creates plugins/TerraRenew/terrarenew.db for scheduled targets. Do not edit this database while the server is running. When using a custom generator, keep the same generator plugin and configuration available during renewal.
How Renewal Works
Chunk and structure renewal are deliberately separate:
- Chunk renewal restores generated block data, biomes, block entities, and natural entities in one chunk while excluding native structure pieces.
- Structure renewal restores only the selected vanilla-generated structure within its bounding box. Blocks outside that structure are left unchanged.
Manual renewal ignores the inactivity timer. The first command displays any player-count warning and opens a confirmation window; enter the exact same command again within 30 seconds by default to proceed. A successful manual renewal resets any matching schedule.
Automatic renewal runs only after every chunk covered by the target is unloaded. If a target is loaded, contains players, or cannot be renewed, it remains scheduled and is retried later.
Commands
The main command is /terrarenew; /tr is an alias. Chunk and structure commands must be run by a player because they use the player's current world and location.
| Command |
Description |
/terrarenew chunk renew [chunk-x chunk-z] |
Renew the current chunk or the supplied chunk coordinates. |
/terrarenew chunk mark <id> [duration] |
Mark the current chunk for automatic renewal. |
/terrarenew structure renew [minecraft:structure] |
Renew a native structure intersecting the current chunk. |
/terrarenew structure mark <id> [minecraft:structure] [duration] |
Mark the selected native structure for automatic renewal. |
/terrarenew unmark <id> |
Delete a scheduled renewal target. |
/terrarenew list |
List all marked targets. |
/terrarenew info <id> |
Show details and the due time for one target. |
/terrarenew reload |
Reload config.yml and messages.yml. |
Durations accept s, m, h, or d, such as 30s, 6h, or 90d. If multiple structures intersect the current chunk, specify the namespaced structure key shown by TerraRenew.
Permissions
All permissions default to server operators.
| Permission |
Allows |
terrarenew.command.chunk |
Chunk renewal and chunk command access |
terrarenew.command.structure |
Structure renewal and structure command access |
terrarenew.command.mark |
Creating chunk or structure marks |
terrarenew.command.unmark |
Removing marks |
terrarenew.command.list |
Listing marks |
terrarenew.command.info |
Inspecting a mark |
terrarenew.command.reload |
Reloading configuration and messages |
Creating a mark requires both the relevant chunk or structure permission and terrarenew.command.mark.
Configuration
The default configuration waits 90 days of inactivity, checks every five minutes, and processes at most two automatic renewals per check:
inactivity-period: 90d
confirmation-window: 30s
scheduler:
check-interval: 5m
missed-run-policy: DELAYED_ONCE
startup-delay: 1m
player-retry-delay: 15m
max-renewals-per-check: 2
renewal:
blocks-per-region-task: 8192
preserve:
tamed-entities: true
named-entities: true
artificial-entities: true
DELAYED_ONCE allows overdue targets to be considered after the startup delay. SKIP resets overdue targets when the plugin starts. Lower blocks-per-region-task to spread block writes over more Folia region tasks; higher values complete each renewal in fewer tasks.
Edit messages.yml to translate or restyle output. Values support MiniMessage formatting. Keep all required message keys, then run /terrarenew reload.
评论 0
登录后参与评分
还没有评论,来抢沙发吧