FlectoneGrowth

插件

· 作者 MISQZY

基于游戏时长提升玩家成长的轻量级插件

0 本站下载 0 关注 更新于 3 周前

最新 0.3.0 · 26.3 · Bukkit / Paper

一键开服(送7天)

FlectoneGrowth

FlectoneGrowth 是一个 Minecraft 服务器插件,它会根据玩家的在线游戏时长逐渐增加其游戏内身高,而不是让所有玩家从加入服务器起就保持固定的相同尺寸。身高通过原版的缩放属性(scale attribute)实现,因此兼容任何资源包或皮肤,且无需客户端模组支持。

功能特性

成长系统

  • 随游戏时长渐进成长。 每位玩家会从可配置的最小身高线性增长至最大身高,基于实际游戏分钟数——而非真实世界时间,因此无法通过挂机 AFK 来作弊。当玩家被实心方块包围时,成长会自动暂停(growth.pause-when-boxed-in)。该检测会按方块位置缓存,因此静止不动不会产生额外开销。
  • 固定或随机化的成长周期。 可以设置所有玩家达到完全身高所需的配置分钟数相同(growth.time-minutes),或者——如果配置了最小/最大值范围(growth.time-min-minutes / growth.time-max-minutes)——每位玩家在首次加入时会被分配一个独立的目标值,该值会被持久化保存,确保在重启后保持一致。
  • 按性别区分的身高上限。 性别类型可在 gender.yml 中完全自定义——你可以添加、重命名或别名为任意数量,每种性别拥有各自的最大身高上限——或者关闭整个性别系统,为所有人使用统一的上限。
  • 手动覆盖。 玩家(或管理员对其他玩家)可以随时设置精确的自定义身高,此后该值将被保留原样,不再被成长曲线覆盖。自定义身高始终保持在配置的界限内,即使在更改性别或从其他服务器同步数值时也如此。

网络与跨服游玩

  • 集中式游戏时长追踪。 在共享同一数据库的网络中(network.sync-enabled: true),驱动成长的玩家游戏时长会在中央进行追踪,而不是每台服务器单独记录,从而避免因在后端服务器间分散时间而导致成长数据不同步。以下两项设置是针对每台服务器的,而非整个网络:
    • network.per-server — 将该服务器的游戏时长计入其独立的桶中,而不是贡献到全网总时长。
    • network.include-server — 在该服务器上的时间是否计入成长;在枢纽/大厅服务器上设置为 false,以避免在此闲置帮助玩家成长。
  • 实时跨服同步。 轻量级的 Velocity 代理中继(minecraft/velocity)会立即在后端服务器之间传播身高/性别变更,而不是让玩家在重新连接前看到过时的数值。传入的值会被限制在接受服务器的上限范围内。数据库始终保持唯一事实来源——同步仅为延迟优化,并非必需。可选:在单服务器设置中跳过 Velocity 模块。更改 network.sync-enabled 需要重启(插件在重载时会发出警告)。
  • 兼容 FlectonePulse。 如果安装了 FlectonePulse,FlectoneGrowth 会使用其稳定 API 复用其服务器标识符、通过其管道传递消息,并匹配其 <fcolor:N> 配色方案。即使 FlectonePulse 启动较晚或被重启,插件也能正常工作。各部分功能可在 integrations.yml 中独立开关。

存储

  • 四种后端: H2(嵌入式,零配置,默认)、MySQL、MariaDB 或纯 YAML 文件——通过 storage.type 切换。
  • 可配置表前缀。 storage.database.table-prefix(默认 flectonegrowth,分隔符自动添加)允许共享同一物理 MySQL/MariaDB/H2 数据库的网络运行多个 FlectoneGrowth 实例而不会发生表冲突。首次更改此设置时,现有表会自动重命名。
  • 可配置连接参数。 storage.database.params 允许你覆盖 JDBC URL 的查询字符串(例如 useSSL=true&characterEncoding=utf8),用于 MySQL/MariaDB,以替代插件内置的默认值。
  • 崩溃安全写入。 YAML 存储和配置文件通过临时文件和原子重命名进行写入,防止因崩溃导致文件截断。
  • 自动降级。 如果配置的后端在启动时无法连接,FlectoneGrowth 将回退到 YAML 存储并记录警告,而不是让插件处于半损坏状态。
  • 快速查找。 玩家数据存储在专用表中,用户名字段已建立索引,加入时的读取操作合并为单次查询。

集成

  • PlaceholderAPI 支持。 提供丰富的 %flectonegrowth_*% 占位符,涵盖当前/最小/最大身高(以米为单位及原始缩放值)、性别、成长百分比、剩余时间及自定义缩放状态——可通过 /papi info flectonegrowth 在游戏中查阅文档。对离线玩家同样有效(例如排行榜/全息图插件),且不会阻塞服务器线程。性别、单位和剩余时间将以查看器自身的语言显示。
  • 供其他插件使用的 API。 通过 Bukkit 的 ServicesManager 注册的强类型只读 Java API(FlectoneGrowthAPI),暴露与上述占位符相同的 height/gender/growth-progress 数据,无需安装 PlaceholderAPI 或进行字符串解析。
  • 按集成项独立开关。 integrations.yml 允许你关闭 PlaceholderAPI 支持,或独立关闭 FlectonePulse 集成的任何单个部分(颜色匹配、服务器 ID 复用、消息分发),而无需移除另一个插件。所有选项默认均为开启。

消息与本地化

  • 本地化消息。 捆绑了英文和俄文的翻译,完全采用 MiniMessage 格式,方便自定义颜色和样式;只需放入另一个 messages_<locale>.yml 文件即可添加更多语言环境。
  • 按玩家的语言环境。 当捆绑了匹配的翻译文件时,每位玩家在 Minecraft 客户端中都会看到自己语言的对应消息;否则回退到 config.yml 中配置的 locale(控制台发送者也是如此)。
  • 主题颜色。 每条消息都支持 <primary>/<secondary> 主题色标签,可在 config.yml 中一次性配置,从而让整个插件从一处重新着色,同时兼容 MiniMessage 自身的任何标签。主题色可以是十六进制、旧版颜色或 FlectonePulse 的 <fcolor:N>。
  • 可点击、可悬停的消息。 点击命令语法提示会将内容填入聊天输入框;/growth summary 的标题和重载消息可以点击以再次运行,更新通知包含一个可点击下载链接。这在非 Paper 服务器上也能正常工作。
  • 每个命令一条消息。 /growth summary 等多行输出会合并为单条聊天消息发送。

操作

  • 安全的配置/数据库迁移。 升级插件会自动合并新添加的配置键,而不会丢弃您的自定义设置或注释,并应用任何必要的数据库架构更改。配置文件会先备份到 backups/,如果备份失败则永远不会重写该文件。
  • 更新通知。 启动时在 GitHub 上检查一次是否有新版本;如果存在,会在控制台中发出警告,并在玩家加入时通过权限 flectonegrowth.update-notify(默认:op)通知玩家。可通过设置 update-checker.enabled: false 完全禁用此功能。
  • 实时重载。 /flectonegrowth reload 会重新读取所有配置文件并将生长设置重新应用到已在线的玩家,无需重启服务器。它在主线程上运行,报告耗时,并在失败时告知您原因(例如 YAML 语法错误)。重叠的重载请求会被序列化,且数据库设置的更改无需重启即可生效。
  • 游戏时长导入。 /flectonegrowth migrate playtime 将每位已知玩家的原版游戏时长统计信息导入 FlectoneGrowth 自己的追踪系统中,这是累加到现有记录之上,而非覆盖。
  • 简洁的控制台日志。 失败情况会以一行日志记录根本原因,相同的错误每分钟限报一次,完整的堆栈跟踪仅在 FINE 日志级别下显示。

支持的平台

模块 适用场景...
minecraft/bukkit 您的后端服务器 — 在 Spigot、CraftBukkit、Paper、Purpur 以及任何其他 Bukkit-API 服务器软件上均可无修改使用。运行时检测 Paper 的原生 Adventure 支持并在可用时自动使用。
minecraft/velocity 您正在运行 Velocity 代理,并希望跨后端服务器同步数据。可选 — 在单服务器设置中可跳过此项。

在每个后端服务器上安装 minecraft/bukkit。不支持 BungeeCord;Velocity 是唯一支持的代理。不支持 Folia。

命令

当输入拼写错误的命令时,会显示用法提示,并且仅列出适用于您所输入内容的部分。

命令 描述 权限 (默认)
/height <type> 设置您自己的自定义身高。 flectonegrowth.height (所有人)
/height remove 移除您的自定义身高并恢复自然生长。 flectonegrowth.height (所有人)
/height set <player> <type> 设置另一位玩家的自定义身高。 flectonegrowth.height.others (op)
/height remove <player> 移除另一位玩家的自定义身高。 flectonegrowth.height.others (op)
/gender <type> 设置您自己的性别。 flectonegrowth.gender (所有人)
/gender set <player> <type> 设置另一位玩家的性别。 flectonegrowth.gender.others (op)
/growth summary [player] 查看身高、性别和生长进度。支持通过用户名查看离线玩家的数据。 flectonegrowth.info (所有人) / .others (op)
/growth height [player] 仅查看身高和生长进度。 flectonegrowth.info (所有人) / .others (op)
/growth gender [player] 仅查看性别。 flectonegrowth.info (所有人) / .others (op)
/flectonegrowth reload (别名 /fg reload) 在不重启的情况下重载配置/性别/消息。 flectonegrowth.admin.reload (op)
/flectonegrowth migrate playtime (别名 /fg migrate playtime) 将原版游戏时长统计信息导入 FlectoneGrowth 自己的追踪系统。 flectonegrowth.admin.migrate (op)

flectonegrowth.update-notify(默认:op)不是命令权限——它控制谁能在游戏中收到关于待处理插件更新的通知。

配置

每个安装的模块均附带:

  • config.yml — 服务器 ID、生长速度/曲线、缩放边界、主题颜色、存储后端(包括表前缀/连接参数)、跨服务器网络设置、更新检查器。
  • gender.yml — 性别类型、别名、每种类型的最大身高。
  • integrations.yml — 各集成项的开/关开关(PlaceholderAPI、FlectonePulse 及其子模块)。
  • localizations/messages_<locale>.yml — 每条面向玩家的消息,每种语言环境一个文件。

这四个文件均在内部添加了注释,如果删除会自动重新生成。现有安装在版本升级时会向前迁移,先在 backups/ 中创建带时间戳的备份,且不会丢失自定义设置或注释。

在跨越架构更改进行升级之前(例如从 0.2.7 之前的版本),请备份您的数据库。 MySQL 和 MariaDB 无法回滚失败的表更改。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源