温馨提示

Gentle Reminders 是一个会根据可自定义的配置文件，每隔一段时间向玩家发送正念提醒消息的模组。
可在 Curseforge 和 Modrinth 下载。感谢超过 1800 次下载！

版本支持

Gentle Reminders 支持多个 Minecraft 版本和模组加载器：

加载器	Minecraft 版本	备注
Fabric	1.20.1	独立 JAR
Fabric	1.21.1	独立 JAR
Fabric	1.21.6+	单个 JAR 支持 1.21.6、1.21.7、1.21.8、1.21.9、1.21.10、1.21.11 以及未来的 1.21.x 版本
NeoForge	1.21.1	独立 JAR
NeoForge	1.21.6+	单个 JAR 支持 1.21.6、1.21.7、1.21.8 以及未来的 1.21.x 版本（注意：NeoForge 跳过了 1.21.6/1.21.7 的官方发布，因此此构建以 1.21.8 为基础）

功能特性

• 多版本和多加载器支持：可在 Fabric 和 NeoForge 上运行，并支持多个 Minecraft 版本（见上方的版本支持表）
• 客户端启动时如果配置不存在，会自动生成配置文件
• 检查配置文件版本以确保获取最新的消息更新
• 客户端从配置文件读取设置
• 加入世界时，如果模组已启用，会发送一条初始消息
• 根据配置，每 X tick 发送一条正念提醒消息
• 当所有消息都发送完后（随机顺序、不重复），会重置列表并重新开始
• 可自定义的提示弹窗，支持以方块纹理作为背景和边框！
• 配置持久化：通过命令更改自定义显示样式设置（背景纹理、边框纹理、图标）时会自动保存到配置文件
• 通过命令修改的所有配置值都会自动保存
• 下方有配置指南
• 下方有命令指南

版本兼容性与已知限制

图标支持

• Fabric 1.20.1：由于此 Minecraft 版本的 API 限制，不支持自定义显示样式图标（感叹号）。即使 customIncludeIcon 设置为 true，图标也不会显示。
• Fabric 1.21.1+：完全支持图标。
• NeoForge（所有版本）：完全支持图标。

功能一致性

• Fabric 与 NeoForge：除了 Fabric 1.20.1 的图标限制外，两个加载器的功能完全一致。所有命令、显示样式和配置功能在两个加载器上的工作方式完全相同。

即将推出的功能

• 添加大量消息
  • 当前简单消息数量：34
  • 当前独特/特殊消息数量：62
• 添加对模组方块作为背景/边框的支持
• 添加自定义消息图标（不仅仅是感叹号！）
• 制作一个用于编辑自定义提示弹窗的酷炫 GUI

消息示例

简单消息（默认样式）

独特消息（深色样式）

独特消息（浅色样式）

独特消息（聊天样式）

自定义深色橡木木板背景和水晶块边框

自定义黑石背景和树脂砖边框

自定义红石块背景和闪长岩边框

自定义黏液块背景和沙子边框

它在游戏中的显示效果

配置指南

配置文件位于 config/gentlereminders-config.toml（运行游戏一次后生成），可以使用任何文本编辑器进行编辑。你可以更改消息间隔的数值、添加或删除消息，以及启用或禁用模组。

添加消息应使用以下格式：

  {id=#, title="String", message="String", enabled=boolean, titleColor="String", messageColor="String"},

• id 是一个整数，在消息之间应保持唯一
• title 是消息的标题，会显示在提示弹窗的顶部
  • 重要提示：此标题不能包含逗号（,），否则配置文件会损坏
• message 是消息的内容，会显示在提示弹窗的主体中
  • 重要提示：此消息不能包含逗号（,），否则配置文件会损坏
• enabled 是一个布尔值，决定该消息是否可以发送——如果你打算将其设置为 false，也可以直接删除该消息，除非你认为以后可能想重新启用它
• titleColor 是一个字符串，表示标题文本的颜色，可以是以下任意颜色：
• messageColor 是一个字符串，表示消息文本的颜色，可以是以下任意颜色：

 "black", "dark_blue", "dark_green", "dark_aqua", "dark_red", "dark_purple", "gold", "gray", "dark_gray", "blue", "green", "aqua", "red", "light_purple", "yellow", "white"

命令指南

必需参数用 [方括号] 括起来

/gentlereminders 和 /gentlereminders help

• 显示帮助消息

/gentlereminders get TimeRemaining

• 显示距离下一条消息发送的剩余时间

/gentlereminders get ConfigPath

• 显示配置文件的路径

/gentlereminders get ConfigVersion

• 显示配置文件的版本

/gentlereminders get DisplayStyle

• 显示当前的显示样式

/gentlereminders get TicksBetweenMessages

• 显示消息之间的 tick 数，以及对应的分钟和秒数

/gentlereminders get Messages [pageNumber]

• 从指定页码开始，每次显示 5 条消息

/gentlereminders set DisplayStyle [style]

• 将显示样式设置为 "default"、"light"、"dark" 或 "chat"（使用下方命令设置 custom）

/gentlereminders set CustomDisplayStyle [bgTexture] [borderTexture] [includeIcon]

• 将显示样式设置为 custom，然后设置背景和边框纹理，以及是否包含感叹号图标
• bgTexture 和 borderTexture 接受方块名称（例如 oak_planks、stone）——对有效方块名称提供自动补全
• includeIcon 是一个布尔值（true 或 false），决定是否显示感叹号图标
• 注意：图标在 Fabric 1.20.1 中无法使用（见上方的版本兼容性部分）
• 设置会自动保存到配置文件

/gentlereminders set TicksBetweenMessages [ticks]

• 设置消息之间的 tick 数

/gentlereminders set Message [id] [title] [message] [enabled] [titleColor] [messageColor]

• 按 ID 覆盖消息的标题、内容、启用状态和颜色
• titleColor 和 messageColor 接受颜色名称——对有效颜色提供自动补全（颜色列表见配置指南）

/gentlereminders add Message [title] [message] [enabled] [titleColor] [messageColor]

• 添加一条新消息，包含指定的标题、内容、启用状态和颜色
• titleColor 和 messageColor 接受颜色名称——对有效颜色提供自动补全（颜色列表见配置指南）

/gentlereminders remove Message [id]

• 按 ID 删除一条消息

/gentlereminders enable GentleReminders

• 启用模组

/gentlereminders enable Message [id]

• 按 ID 启用一条消息

/gentlereminders disable GentleReminders

• 禁用模组

/gentlereminders disable Message [id]

• 按 ID 禁用一条消息