RPChatPlus

RPChatPlus
A feature-rich roleplay chat plugin with PlaceholderAPI, Vault & EssentialsX support

Paper / Spigot · Java 17+ · v2.0.0

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

▌ Overview

RPChatPlus started as a small quality-of-life chat plugin for roleplay servers and grew into something much more complete. It handles your entire chat pipeline — from global announcements to whispered emotes — without needing three other plugins to fill the gaps.

Every format string supports PlaceholderAPI out of the box. Vault prefix/suffix is pulled automatically. EssentialsX mutes, vanish, and ignore lists are all respected without any extra configuration. If you don't have any of those installed, the plugin runs perfectly fine on its own.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

▌ Features

• Four chat channels — Global, Local (radius-based), Staff, and Roleplay
• PlaceholderAPI — drop any %placeholder% directly into your format strings
• Vault — prefix and suffix pulled from any Vault-compatible permissions plugin
• EssentialsX — respects server mutes, vanish status, and ignore lists
• Private messaging — /msg and /r (reply), spied on by staff with spy mode
• Chat spy — staff silently monitor every channel without leaving their own
• Mentions — @PlayerName highlights the token and plays a ping sound to the recipient
• Anti-spam — configurable flood protection and duplicate-message blocking
• Per-channel cooldowns — throttle chat frequency on a per-channel basis
• Channel mutes — mute a player in one specific channel, with optional expiry time
• Color codes — players with rpchatplus.color can use & codes and hex &#rrggbb
• Persistent preferences — active channel and spy state survive server restarts (SQLite)
• Tab completion — every command and sub-command has context-aware suggestions
• Hot reload — /rpc reload refreshes both config and messages without a restart
• Fully translatable — every user-facing string is in messages.yml

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

▌ Commands

Channel command aliases: /g, /gc · /l, /lc · /sc, /staffchat · /roleplay · /tell, /pm, /whisper, /w · /reply

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

▌ Permissions

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

▌ Configuration

Everything is configured in plugins/RPChatPlus/config.yml. Every setting has an inline comment explaining it.

Format string variables:

channels:
  global:
    format: "&8[&6Global&8] &7{prefix}&f{player}&7{suffix}&8: &f{message}"
    switch-message: "&aYou are now in &6Global Chat&a."
    cooldown: 0
    log-to-console: true

  local:
    format: "&8[&cLocal&8] &7{prefix}&f{player}&7{suffix}&8: &f{message}"
    radius: 100

  rp:
    speech-color: "&f&o"
    action-color: "&b&o"
    radius: 0   # 0 = no radius limit

Hello! *waves*

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

▌ Requirements

• Java 17 or newer
• Paper or Spigot 1.19.4+
• (Optional) PlaceholderAPI
• (Optional) Vault + a permissions plugin (e.g. LuckPerms)
• (Optional) EssentialsX

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

▌ Source Code

The full source code is available on GitHub. Pull requests and bug reports are welcome.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Made with care by Axmon / Anonventions