Dynamic Join Greetings

模组

· 作者 SwornHero

适用于 Fabric 服务器的随机且可配置的首次与回归玩家问候语。

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

需要前置:Fabric API

最新 1.0.4+26.2 · 26.2 · Fabric

一键开服(送7天)

Dynamic Join Greetings

Dynamic Join Greetings 是一款可配置的 Fabric 服务端模组,每当新玩家或回归玩家加入你的 Minecraft 服务器时,为他们提供更个性化的欢迎信息。

生成的配置包含 60 条开箱即用的欢迎语:

  • 10 条首次加入消息
  • 50 条回归玩家消息

这些消息在默认配置下即可立即生效,你也可以完全自定义这两组消息池,以契合你服务器的身份、主题和社区氛围。

该模组仅在服务器端运行,因此玩家无需安装任何内容。

功能特性

  • 10 条预配置的首次加入欢迎语
  • 50 条预配置的回归玩家欢迎语
  • 完全可定制的首次加入与回归消息池
  • 基于 UUID 的持久化玩家历史记录
  • 自动从现有世界数据中检测玩家
  • 支持随机、加权、无重复和洗牌袋(shuffle-bag)选择模式
  • 可选的按玩家单独记录的消息选择历史
  • 支持仅玩家、广播和混合受众
  • 可配置的发送延迟
  • 支持多行消息
  • 支持 {player} 和 {server} 占位符
  • 支持颜色、渐变、装饰、悬停文本和点击事件
  • 支持运行时重新加载配置
  • 提供预览、模拟和状态命令
  • 自动恢复损坏的玩家历史文件
  • 支持专用服务器,无需客户端安装

开箱即用的欢迎语

Dynamic Join Greetings 会在以下位置生成完整的配置文件:

config/dynamic-join-greetings.json

其中包含两个独立的集合,分别拥有 10 条首次加入欢迎语和 50 条回归玩家欢迎语。这为服务器管理员提供了丰富的消息多样性,无需在使用模组前编写数十条欢迎语。

随附的消息可以直接使用,也可以编辑、移除、重新排序或添加更多条目进行扩展。

可定制的消息池

首次加入和回归欢迎语的配置是相互独立的。

服务器管理员可以:

  • 添加任意数量的消息
  • 替换所有已包含的消息
  • 创建单行或多行欢迎语
  • 分配不同的选择权重
  • 启用或禁用任一消息池
  • 为每个消息池选择不同的受众
  • 使用占位符包含玩家或服务器名称
  • 应用颜色、渐变、装饰、悬停文本或点击事件
  • 在不重启服务器的情况下重新加载更改

示例首次加入欢迎语:

{
  "id": "first_welcome",
  "weight": 1.0,
  "lines": [
    "<gold><bold>Welcome to {server}, {player}!</bold></gold>",
    "<gray>Your first adventure begins here.</gray>"
  ]
}

示例回归玩家欢迎语:

{
  "id": "return_welcome_back",
  "weight": 1.0,
  "lines": [
    "<gold>Welcome back, <yellow>{player}</yellow>!</gold>"
  ]
}

消息选择

Dynamic Join Greetings 提供三种选择模式:

  • 随机(Random): 使用每条消息配置的权重,并可选择避免立即重复。
  • 无重复(No Repeat): 当有其他可用消息时,防止同一条消息连续出现两次。
  • 洗牌袋(Shuffle Bag): 在开始新的随机循环之前,使用完所有配置过的消息。

选择历史可以按每个玩家单独跟踪,也可以在整台服务器上共享。

占位符与格式化

消息支持两种内置占位符:

  • {player} — 加入玩家的当前用户名
  • {server} — 由管理员配置的服务器名称

占位符的值在解析前会进行转义,以防止玩家名称或服务器名称注入格式控制或交互事件。

消息样式使用 Placeholder API 的简化文本格式(Simplified Text Format):

<gold><bold>Welcome to {server}, {player}!</bold></gold>
<gray>Your first adventure begins here.</gray>

支持的格式包括命名颜色和 RGB 颜色、渐变、文本装饰、悬停文本、点击事件、字体、翻译和快捷键。

消息受众

每个消息池可以使用以下三种受众之一:

  • 玩家(Player): 仅向加入的玩家发送欢迎语。
  • 广播(Broadcast): 向除加入玩家之外的所有人发送欢迎语。
  • 两者(Both): 向所有在线玩家(包括加入玩家)发送欢迎语。

这使得首次加入的欢迎保持私密,而回归玩家的消息可以广播——或者根据你的服务器需求采用其他任意组合。

命令

以下命令需要原版权限等级 2(GAMEMASTERS)或更高:

  • /joingreetings status
  • /joingreetings reload
  • /joingreetings preview first
  • /joingreetings preview returning
  • /joingreetings simulate first
  • /joingreetings simulate returning

预览命令仅向管理员立即显示选中的一条消息。

模拟命令测试完整的延迟发送和受众工作流程,而不会更改管理员的首次加入或回归玩家历史记录。

现有服务器

当安装在已有的服务器上时,Dynamic Join Greetings 会扫描 Minecraft 现有的玩家数据,并将已知的 UUID 导入为回归玩家。在安装模组后,现有社区成员不会错误地收到首次加入的欢迎语。

玩家历史记录在每个世界中单独存储,并在重启之间保持持久化。

要求

  • Minecraft Java Edition 26.2
  • Fabric Loader 0.19.3 或更高版本
  • Fabric API 0.160.0 或更高版本(适用于 Minecraft 26.2)
  • Java 25

Placeholder API 已随模组捆绑,无需单独安装。

安装

  1. 在服务器上安装 Fabric Loader 和 Fabric API。
  2. 将 Dynamic Join Greetings 的 JAR 文件放入服务器的 mods 文件夹中。
  3. 启动服务器以生成配置文件。
  4. 如果需要自定义随附的欢迎语,请编辑 config/dynamic-join-greetings.json。
  5. 运行 /joingreetings reload 以应用更改。

客户端无需安装 Dynamic Join Greetings。

链接

许可证

Dynamic Join Greetings 采用 MIT 许可证。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源