Gentle Reminders

Gentle Reminders is a mod that sends mindful messages to the player every so often based on a customizable config file.
Available for download on Curseforge and Modrinth. Thank you for over 1800 downloads!

Version Support

Gentle Reminders supports multiple Minecraft versions and mod loaders:

Loader	Minecraft Versions	Notes
Fabric	1.20.1	Separate JAR
Fabric	1.21.1	Separate JAR
Fabric	1.21.6+	Single JAR supports 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, and future 1.21.x versions
NeoForge	1.21.1	Separate JAR
NeoForge	1.21.6+	Single JAR supports 1.21.6, 1.21.7, 1.21.8, and future 1.21.x versions (Note: NeoForge skipped official releases for 1.21.6/1.21.7, so this build uses 1.21.8 as the base)

Features

Multi-version and multi-loader support: Works on Fabric and NeoForge across multiple Minecraft versions (see Version Support table above)
Generates a config file on client startup if one doesn't exist
Checks version of config file to guarantee latest message updates
Client reads from config file to get settings
On world join, sends an initial message if the mod is enabled
Every X ticks, based on config, sends a mindful message
When all messages are sent (in a random order with no repeats), resets the list and starts over
Customizable toasts with block textures as the background and border!
Config persistence: Custom display style settings (background texture, border texture, icon) are automatically saved to the config file when changed via commands
All config values are automatically saved when modified through commands
Config Guide below
Commands Guide below

Version Compatibility & Known Limitations

Icon Support

Fabric 1.20.1: Custom display style icons (exclamation mark) are not supported due to API limitations in this Minecraft version. Icons will not appear even if customIncludeIcon is set to true.
Fabric 1.21.1+: Icons are fully supported.
NeoForge (all versions): Icons are fully supported.

Feature Parity

Fabric vs NeoForge: Both loaders have full feature parity except for the icon limitation in Fabric 1.20.1. All commands, display styles, and config features work identically across both loaders.

Upcoming Features

Add a drastically large amount of messages
- Current # of simple messages: 34
- Current # of unique/special messages: 62
Add support for modded blocks to be used as the background/border
Add custom message icons (not just an exclamation!)
Make a cool GUI to edit custom toasts

Message Examples

Simple Message (Default Style)

Unique Message (Dark Style)

Unique Message (Light Style)

Unique Message (Chat Style)

Custom Dark Oak Planks Background and Amethyst Block Border

Custom Blackstone Background and Resin Brick Border

Custom Redstone Block Background and Diorite Border

Custom Slime Block Background and Sand Border

How it shows up in-game
In-Game Example

Config Guide

The config file can be found at config/gentlereminders-config.toml (after running the game once), which can be edited with any text editor. You can change the values for the interval between messages, add or remove messages, and enable or disable the mod.

Adding messages should be done in the following format:

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

id is a whole number that should be unique between messages
title is the title of the message that will be displayed at the top of the toast
- Important Note: This title can not include a comma (,) or the config file will break
message is the message that will be displayed in the body of the toast
- Important Note: This message can not include a comma (,) or the config file will break
enabled is a boolean that determines if the message can be sent - if you're setting to false anyway, you can also just remove the message unless you think you'll want to re-enable it later
titleColor is a string that represents the color of the title text, which can be any of the colors below:
messageColor is a string that represents the color of the message text, which can be any of the colors below:

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

Command Guide

Required arguments are surrounded by [brackets]

`/gentlereminders` and `/gentlereminders help`

Displays the help message

`/gentlereminders get TimeRemaining`

Displays the time remaining until the next message is sent

`/gentlereminders get ConfigPath`

Displays the path to the config file

`/gentlereminders get ConfigVersion`

Displays the version of the config file

`/gentlereminders get DisplayStyle`

Displays the current display style

`/gentlereminders get TicksBetweenMessages`

Displays the number of ticks between messages, as well as minutes and seconds

`/gentlereminders get Messages [pageNumber]`

Displays 5 messages at a time, starting at the page number specified

`/gentlereminders set DisplayStyle [style]`

Sets the display style to either "default", "light", "dark", or "chat" (use the below command for custom)

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

Sets the display style to custom, then sets the background and border textures, as well as whether or not to include the exclamation mark icon
bgTexture and borderTexture accept block names (e.g., oak_planks, stone) - autocomplete is available for valid block names
includeIcon is a boolean (true or false) that determines if the exclamation mark icon is displayed
Note: Icons do not work in Fabric 1.20.1 (see Version Compatibility section above)
Settings are automatically saved to the config file

`/gentlereminders set TicksBetweenMessages [ticks]`

Sets the number of ticks between messages

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

Overwrites the title, message, enabled status, and colors of a message by ID
titleColor and messageColor accept color names - autocomplete is available for valid colors (see Config Guide for list)

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

Adds a new message with the specified title, message, enabled status, and colors
titleColor and messageColor accept color names - autocomplete is available for valid colors (see Config Guide for list)

`/gentlereminders remove Message [id]`

Removes a message by ID

`/gentlereminders enable GentleReminders`

Enables the mod

`/gentlereminders enable Message [id]`

Enables a message by ID

`/gentlereminders disable GentleReminders`

Disables the mod

`/gentlereminders disable Message [id]`

Disables a message by ID

Version Support

Features

Version Compatibility & Known Limitations

Icon Support

Feature Parity

Upcoming Features

Message Examples

Config Guide

Command Guide

/gentlereminders and /gentlereminders help

/gentlereminders get TimeRemaining

/gentlereminders get ConfigPath

/gentlereminders get ConfigVersion

/gentlereminders get DisplayStyle

/gentlereminders get TicksBetweenMessages

/gentlereminders get Messages [pageNumber]

/gentlereminders set DisplayStyle [style]

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

/gentlereminders set TicksBetweenMessages [ticks]

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

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

/gentlereminders remove Message [id]

/gentlereminders enable GentleReminders

/gentlereminders enable Message [id]

/gentlereminders disable GentleReminders

/gentlereminders disable Message [id]