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).

Additional Commands (Optional)

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

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:

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.