Roleplay Chat

This mod allows players to communicate in a roleplay (RP) setting with different ranges for various types of messages. The goal is to enhance RP immersion by limiting how far messages can be seen based on their type.

How It Works

Messages are triggered by a special character placed at the start of your message. For example, !Hello will shout "Hello" (range of 80 blocks).

When speaking in the chat, your message will NOT be visible across the entire server. If no player is within your message’s range, you won’t get a response! Check the table below to understand how the system works.

This approach is designed to foster RP and local interactions between players.

Default colors, ranges, and prefix characters match the tables below; server admins can override them in config/roleplay-chat.json (see Configuration).

TYPE	COLOR	RANGE	TRIGGER CHARACTER	TRIGGER COMMAND	DESCRIPTION
Whisper	🟪 Violet (#CC33CC)	4 blocks	« or " (configurable)	/whisper <message>	Speak quietly to someone nearby
Action	🟩 Green (#3C3)	25 blocks	*	/action <message>	Describe an action you're performing (like /me)
Speak	⬜️ White (#FFF)	30 blocks	None	/speak <message>	Normal conversation
Shout	🟥 Red (#C30)	80 blocks	!	/shout <message>	Shout, for example, before attacking!

Additional Commands (Optional)

These commands are for Out of Character (OOC) interactions. Use them sparingly! Thank you.

TYPE	COLOR	RANGE	TRIGGER CHARACTER	TRIGGER COMMAND	DESCRIPTION
Support	Pink (#FF99CC)	Unlimited	? (configurable)	/support <message>	Request help from staff (admins/helpers)
Private Message (PM)	White (#FFFFFF)	Unlimited	none	/m <player> <message>	Send a private message to another player
Reply to PM	White (#FFFFFF)	Unlimited	none	/r <message>	Reply to the last received private message
OOC Chat	Gray (#AEC1D5)	60 blocks	(	/ooc <message>	Chat out of character on the server
Global OOC	Gray (#AEC1D5)	Unlimited	[	/globalOoc <message>	Speak in a global OOC channel (requires activation)

Global OOC Chat

To speak in the global OOC chat, you first need to activate it by using the /global command. By default, it is activated. You can deactivate it with the same command, /global.

Once activated, this command allows you to communicate with all players who have also activated the global OOC chat. Keep in mind that not all players use the global chat, so you may not always get responses.

Configuration (server admins)

Per-message settings live in config/roleplay-chat.json (next to your server or client .minecraft folder). Edit the file in UTF-8 so special prefixes (e.g. «) stay valid.

On first run, if the file is missing, the mod creates it with built-in defaults. Invalid values for a block fall back to those defaults (see server log).

Each message type is a JSON object with:

Field	Meaning
radius	Hearing distance in blocks. 0 means unlimited range (everyone online receives the message).
color	RGB color: either a decimal integer (e.g. 11449813 for gray-blue) or a hex string ("#AEC1D5" or "AEC1D5").
characters	List of valid prefix strings at the start of chat. The first entry is also used when a player uses the matching slash command (e.g. /shout). speak uses an empty list [] (no prefix). Other types must have at least one string.

Reload without restart: operators who pass the game’s owner-level check can run /roleplaychat reload to re-read the file. If reload fails, the previous settings stay active; check the server log.

Example (shortened; your generated file will list all types):

{
  "speak": {
    "radius": 30,
    "color": 16777215,
    "characters": []
  },
  "whisper": {
    "radius": 8,
    "color": "#CC33CC",
    "characters": ["«", "\""]
  },
  "shout": {
    "radius": 80,
    "color": 13369344,
    "characters": ["!"]
  }
}

Keys for all supported types: speak, whisper, shout, action, ooc, globalOoc, support.