RPGChat - Immersive Chat for RPG Servers

Transform the way players communicate on your RPG server!
Text appears directly above characters, creating an authentic roleplay atmosphere.


✨ What makes RPGChat special?

Immersive Communication: Text appears above characters, not just in chat
Whisper System: Private messages only for nearby players
Fully Customizable: Colors, sounds, range and more
Multi-Channel Support: Different chat channels for different areas
️️️Moderation: Word filter and anti-spam functions


How it works

Normal Messages
• Simply write in chat
• Text appears above your character
• Only players in line of sight can see it

Whispering
• Use the # symbol at the beginning
• Only players in close proximity can read it
• Perfect for private conversations


⚙️ Configuration

Message Settings
Text Prefix - Default: "&f" - Color for normal messages
Chat Symbol - Default: (none) - Symbol before normal messages
Whisper Prefix - Default: "&f&o" - Color for whispered messages
Whisper Symbol - Default: "#" - Symbol for whispering
Whisper Range - Default: 5.0 - Distance in blocks

Sound Settings
Normal Chat Sound - Default: UI_CLICK_BUTTON
Normal Sound Volume - Default: 1.0
Normal Sound Pitch - Default: 1.0
Whisper Sound - Default: UI_CLICK_BUTTON
Whisper Volume - Default: 1.0
Whisper Pitch - Default: 1.0

Display Settings
Display Duration - Default: 5 seconds - How long text remains visible
Height above Character - Default: 0.0 - Blocks above the player
Hide Standard Chat - Default: true - Text only above character, not in chat
Hide Whisper Chat - Default: true - Whispers only above character

️️️Moderation
Word Filter Symbol - Default: "*" - Symbol for censored words (empty = disabled)
Blacklist - Default: "bad", "words" - Forbidden words
Chat Cooldown - Default: -1 - Seconds between messages
Anti-Repeat - Default: true - Prevents spam

Integrations
PlaceholderAPI Support - Default: false
ChatControl Support - Default: false
ChatControl Channels - Default: "global"


Channels !BETA!

Create different chat areas for your server using the format: channelname|range|prefix

Examples:
• admin|10|&c - Admin channel, 10 blocks range, red text
• ooc|-1|&7 - Out-of-character, server-wide range, gray text
• local|15|&a - Local chat, 15 blocks, green text

Explanation:
The | symbol separates the three parameters:
Name (always lowercase), Range (-1 = entire world), Prefix (color code)


Commands

/rpgchat reload - Reloads the configuration Permission: RPGChat.Reload
/rpgchat fix - Removes hanging texts Permission: RPGChat.Fix
/rpgchat channel "name" - Switches chat channel


Permissions

RPGChat.Reload - For the /rpgchat reload command
RPGChat.Fix - For the /rpgchat fix command
RPGChat.Prefix.INSERT - For custom prefixes
RPGChat.Bypass - Bypasses chat cooldown & anti-repeat


Beta Features

⚠️ Experimental Features ⚠️
If you encounter problems, disable these features in the config:

• PlaceholderAPI Support - Dynamic placeholders
• Multi-Channel System - Different chat areas
• ChatControl Integration - Extended chat control


️️️Installation & Support

Installation:
1. Download plugin and place in plugins/ folder
2. Restart server
3. Adjust config (plugins/RPGChat/config.yml)
4. Assign permissions

World Whitelist:
Default enabled worlds: "world", "world_nether", "world_the_end"

Report Problems:
GitHub Issues - Check existing issues first!


Roadmap

• Improved Word Filter [Priority: Low]
• Performance Optimization [Priority: Normal]
• Message Trim Function [Priority: High]
• Extended Word Filter Features [Priority: Low]
• Collision Bug Fix [FIXED]


⭐ DON'T FORGET TO RATE THE PLUGIN! ⭐