Compatibility
Minecraft: Java Edition
Platforms
Supported environments
75% of ad revenue goes to creators
Support creators and Modrinth ad-free with Modrinth+Links
Creators
Details
Gentle Reminders is a mod that sends mindful messages to the player every so often based on a customizable config file.
Features
- 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
- Config Guide below
- Commands Guide below
- Can choose a Display Style, currently the default Minecraft toast system or by a chat message
- Can choose some custom toasts via Display Style, currently light or dark
Upcoming Features
- Add a drastically large amount of messages
- Current # of simple messages: 34
- Current # of unique/special messages: 62
- More custom toast display styles
- Custom message icons (instead of an exclamation point)
- Custom message noises?
- Make some super cool GUI to edit how the custom toasts look
- Implement more options into config, possibly split into multiple files
- Create own UI popup with more customization as opposed to using Minecraft's built-in toast system
Message Examples
A Simple Message, using the "default"
display style
A Unique Message, using the "chat"
display style
A Unique Message, using the "light"
display style
A Unique Message, using the "dark"
display style
A Unique Message in-game, using the "default"
display style
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 messagestitle
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
- Important Note: This title can not include a comma (
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
- Important Note: This message can not include a comma (
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 latertitleColor
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"
,"chat"
,"light"
, or"dark"
/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
/gentlereminders add Message [title] [message] [enabled] [titleColor] [messageColor]
- Adds a new message with the specified title, message, enabled status, and colors
/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