TerraRenew

插件

· 作者 Aitchn

根据当前世界的种子和生成器重建生成的地形。区块更新不包括原生结构部分,而结构更新仅更改选定的原生结构。

0 本站下载 0 关注 更新于 2 个月前

最新 0.1.0 · 26.2 · Folia / Paper

一键开服(送7天)

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 衍生平台。

安装

  1. 停止服务器并创建完整的世界备份。
  2. 将 TerraRenew-0.1.0.jar 放入服务器的 plugins/ 目录中。
  3. 启动服务器,并在控制台中检查 TerraRenew 的启用消息。
  4. 查看 plugins/TerraRenew/config.yml 和 plugins/TerraRenew/messages.yml。
  5. 仅授予管理员所需的权限。

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。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源