# Roleplay Chat<\/p>\n
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.<\/p>\n
## How It Works<\/p>\n
Messages are triggered by a special character placed at the start of your message. For example, `!Hello` will shout “Hello” (range of 80 blocks).<\/p>\n
When speaking in the chat, **your message will NOT be visible across the entire server**. If no player is within your message\u2019s range, you won\u2019t get a response! Check the table below to understand how the system works.<\/p>\n
This approach is designed to foster RP and local interactions between players.<\/p>\n
Default colors, ranges, and prefix characters match the tables below; server admins can override them in **`config\/roleplay-chat.json`** (see [Configuration](#configuration-server-admins)).<\/p>\n
| **TYPE** | **COLOR** | **RANGE** | **TRIGGER CHARACTER** | **TRIGGER COMMAND** | **DESCRIPTION** | ## Additional Commands (Optional) | **TYPE** | **COLOR** | **RANGE** | **TRIGGER CHARACTER** | **TRIGGER COMMAND** | **DESCRIPTION** | ### Global OOC Chat 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.<\/p>\n ## Configuration (server admins)<\/p>\n 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. `\u00ab`) stay valid.<\/p>\n 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).<\/p>\n Each message type is a JSON object with:<\/p>\n | Field | Meaning | **Reload without restart:** operators who pass the game\u2019s **owner-level** check can run **`\/roleplaychat reload`** to re-read the file. If reload fails, the previous settings stay active; check the server log.<\/p>\n **Example** (shortened; your generated file will list all types):<\/p>\n “`json Keys for all supported types: `speak`, `whisper`, `shout`, `action`, `ooc`, `globalOoc`, `support`.<\/p>\n","protected":false},"excerpt":{"rendered":" This mod allows players to communicate in a roleplay (RP) setting with different ranges for various types of messages.<\/p>\n","protected":false},"featured_media":133949,"template":"","meta":{"_minecraft_slug":"roleplay-chat","_minecraft_project_id":"BLylB8sp","_minecraft_author":"cprodhomme","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":2489,"_minecraft_follows":8,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"roleplay-chat.zip","_minecraft_size_bytes":122734,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-15T19:33:22.181752Z","_minecraft_date_created":"2024-10-07T00:57:47.300083Z","_minecraft_date_modified":"2026-03-28T23:01:45.119398Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/roleplay-chat","_minecraft_icon_attachment_id":133949,"_minecraft_imported_at":"2026-06-07T21:43:38+00:00","_minecraft_import_hash":"7c9b4e4194027ece22e91b4644883ebf","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,97,89,867],"mod_loader":[99],"minecraft_version":[37,41],"class_list":["post-133948","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-fabric","mod_category-game-mechanics","mod_category-social","mod_loader-fabric","minecraft_version-1-21-1","minecraft_version-1-21-11"],"yoast_head":"\n
\n|———–|——————|————|———————–|———————–|———————–|
\n| Whisper | \ud83d\udfea Violet (#CC33CC) | 4 blocks | `\u00ab` or `”` (configurable) | `\/whisper
\n| Action | \ud83d\udfe9 Green (#3C3) | 25 blocks | `*` | `\/action
\n| Speak | \u2b1c\ufe0f White (#FFF) | 30 blocks | None | `\/speak
\n| Shout | \ud83d\udfe5 Red (#C30) | 80 blocks | `!` | `\/shout
\nThese commands are for **Out of Character (OOC)** interactions. Use them sparingly! Thank you.<\/p>\n
\n|———————-|—————–|———–|———————–|————————-|—————————-|
\n| Support | Pink (#FF99CC) | Unlimited | `?` (configurable) | `\/support
\n| Private Message (PM) | White (#FFFFFF) | Unlimited | none | `\/m
\n| Reply to PM | White (#FFFFFF) | Unlimited | none | `\/r
\n| OOC Chat | Gray (#AEC1D5) | 60 blocks | `(` | `\/ooc
\n| Global OOC | Gray (#AEC1D5) | Unlimited | `[` | `\/globalOoc
\nTo 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`.<\/p>\n
\n|——-|———|
\n| `radius` | Hearing distance in blocks. **`0`** means unlimited range (everyone online receives the message). |
\n| `color` | RGB color: either a decimal integer (e.g. `11449813` for gray-blue) **or** a hex string (`”#AEC1D5″` or `”AEC1D5″`). |
\n| `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. |<\/p>\n
\n{
\n “speak”: {
\n “radius”: 30,
\n “color”: 16777215,
\n “characters”: []
\n },
\n “whisper”: {
\n “radius”: 8,
\n “color”: “#CC33CC”,
\n “characters”: [“\u00ab”, “””]
\n },
\n “shout”: {
\n “radius”: 80,
\n “color”: 13369344,
\n “characters”: [“!”]
\n }
\n}
\n“`<\/p>\n