Dynamic Join Greetings
Dynamic Join Greetings 是一款可配置的 Fabric 服务端模组,每当新玩家或回归玩家加入你的 Minecraft 服务器时,为他们提供更个性化的欢迎信息。
生成的配置包含 60 条开箱即用的欢迎语:
这些消息在默认配置下即可立即生效,你也可以完全自定义这两组消息池,以契合你服务器的身份、主题和社区氛围。
该模组仅在服务器端运行,因此玩家无需安装任何内容。
功能特性
- 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 已随模组捆绑,无需单独安装。
安装
- 在服务器上安装 Fabric Loader 和 Fabric API。
- 将 Dynamic Join Greetings 的 JAR 文件放入服务器的
mods 文件夹中。
- 启动服务器以生成配置文件。
- 如果需要自定义随附的欢迎语,请编辑
config/dynamic-join-greetings.json。
- 运行
/joingreetings reload 以应用更改。
客户端无需安装 Dynamic Join Greetings。
链接
许可证
Dynamic Join Greetings 采用 MIT 许可证。
Dynamic Join Greetings
Dynamic Join Greetings is a configurable, server-side Fabric mod that gives new and returning players a more personal welcome whenever they join your Minecraft server.
The generated configuration includes 60 ready-to-use greetings:
- 10 first-time join messages
- 50 returning-player messages
These messages work immediately with the default configuration, or you can completely customize both message pools to fit your server’s identity, theme, and community.
The mod runs entirely on the server, so players do not need to install anything.
Features
- 10 preconfigured first-time greetings
- 50 preconfigured returning-player greetings
- Fully customizable first-time and returning message pools
- Persistent UUID-based player history
- Automatic detection of players from existing world data
- Random, weighted, no-repeat, and shuffle-bag selection
- Optional per-player message-selection history
- Player-only, broadcast, and combined audiences
- Configurable delivery delay
- Multi-line messages
{player} and {server} placeholders
- Colors, gradients, decorations, hover text, and click actions
- Runtime configuration reloads
- Preview, simulation, and status commands
- Automatic recovery from damaged player-history files
- Dedicated-server support with no client installation required
Ready-to-use greetings
Dynamic Join Greetings generates a complete configuration at:
config/dynamic-join-greetings.json
It includes separate collections containing 10 first-time greetings and 50 returning-player greetings. This gives server owners plenty of message variety without requiring them to write dozens of greetings before using the mod.
The included messages can be used as-is, edited, removed, reordered, or expanded with additional entries.
Customizable message pools
First-time and returning greetings are configured independently.
Server administrators can:
- Add as many messages as they want
- Replace every included message
- Create single-line or multi-line greetings
- Assign different selection weights
- Enable or disable either message pool
- Choose a separate audience for each pool
- Include the player or server name using placeholders
- Apply colors, gradients, decorations, hover text, or click actions
- Reload changes without restarting the server
Example first-time greeting:
{
"id": "first_welcome",
"weight": 1.0,
"lines": [
"<gold><bold>Welcome to {server}, {player}!</bold></gold>",
"<gray>Your first adventure begins here.</gray>"
]
}
Example returning-player greeting:
{
"id": "return_welcome_back",
"weight": 1.0,
"lines": [
"<gold>Welcome back, <yellow>{player}</yellow>!</gold>"
]
}
Message selection
Dynamic Join Greetings provides three selection modes:
- Random: Uses each message’s configured weight while optionally avoiding immediate repeats.
- No Repeat: Prevents the same message from appearing twice consecutively whenever another message is available.
- Shuffle Bag: Uses every configured message before beginning a new randomized cycle.
Selection history can be tracked separately for each player or shared across the entire server.
Placeholders and formatting
Messages support two built-in placeholders:
{player} — the joining player’s current username
{server} — the server name configured by the administrator
Placeholder values are escaped before parsing, preventing player names or server names from injecting formatting or interactive events.
Message styling uses Placeholder API’s Simplified Text Format:
<gold><bold>Welcome to {server}, {player}!</bold></gold>
<gray>Your first adventure begins here.</gray>
Supported formatting includes named and RGB colors, gradients, text decorations, hover text, click actions, fonts, translations, and keybinds.
Message audiences
Each message pool can use one of three audiences:
- Player: Sends the greeting only to the joining player.
- Broadcast: Sends the greeting to everyone except the joining player.
- Both: Sends the greeting to every online player, including the joining player.
This allows first-time welcomes to remain private while returning-player messages are broadcast—or any other combination that fits your server.
Commands
The following commands require vanilla permission level 2 (GAMEMASTERS) or higher:
/joingreetings status
/joingreetings reload
/joingreetings preview first
/joingreetings preview returning
/joingreetings simulate first
/joingreetings simulate returning
Preview commands immediately display a selected message only to the administrator.
Simulation commands test the complete delayed-delivery and audience workflow without changing the administrator’s first-time or returning-player history.
Existing servers
When installed on an established server, Dynamic Join Greetings scans Minecraft’s existing player data and imports known UUIDs as returning players. Existing community members will not mistakenly receive first-time greetings after the mod is installed.
Player history is stored separately within each world and remains persistent across restarts.
Requirements
- Minecraft Java Edition 26.2
- Fabric Loader 0.19.3 or newer
- Fabric API 0.160.0 or newer for Minecraft 26.2
- Java 25
Placeholder API is bundled with the mod and does not need to be installed separately.
Installation
- Install Fabric Loader and Fabric API on the server.
- Place the Dynamic Join Greetings JAR in the server’s
mods folder.
- Start the server to generate the configuration.
- Edit
config/dynamic-join-greetings.json if you want to customize the included greetings.
- Run
/joingreetings reload to apply your changes.
Clients do not need Dynamic Join Greetings installed.
Links
License
Dynamic Join Greetings is available under the MIT License.
评论 0
登录后参与评分
还没有评论,来抢沙发吧