JPChat

Everything for your Paper server's chat: how it looks, how players talk to each other, and how you keep it clean.

Part of JP Plugins, but it works on its own.

Features

How chat looks

• Chat formats per rank (Vault or LuckPerms), with MiniMessage and hex colours
• Name colours players pick themselves (/namecolor)
• Mentions, item showcase and emojis

Talking to each other

• Private messages, replies, ignore and message toggle
• Local chat
• Cross-server chat over MySQL or Redis

Keeping it clean

• Anti-spam, anti-caps and anti-advertising
• A word filter
• Social spy for staff

Keeping it active

• Join and quit messages, broadcasts and an announcer
• Chat games with rewards
• Messages in English, Spanish, Portuguese, French and German, or add your own language

Requirements

• Paper 26.3 or newer (Java 25)

Optional

• Vault: ranks, and money for chat game rewards
• LuckPerms: ranks, prefixes and suffixes
• PlaceholderAPI: placeholders in texts, and JPChat's own placeholders
• JPStaff: mutes, vanish and staff data

Installation

1. Put the jar in your server's plugins folder.
2. Restart the server. plugins/JPChat/ is created with the config and messages.
3. Change what you want in the files, then use /jpchat reload or restart.

Type /jp as an operator to see every JP plugin you have installed, its version and which optional plugins it found.

Commands

• /jpchat : JPChat admin command.
• /msg (also /tell, /w, /whisper, /m, /pm, /message): Send a private message.
• /r (also /r): Reply to your last private message.
• /msgtoggle (also /togglemsg, /tpm): Toggle receiving private messages.
• /ignore (also /unignore): Ignore or unignore a player.
• /socialspy (also /spy): Toggle social spy.
• /broadcast (also /bc, /bcast): Broadcast a message to everyone.
• /namecolor [colour|reset] (also /nc, /namecolour, /chatcolor): Pick the colour of your name in chat.
• /chatgame (also /chatgames): Start or stop a chat game.

Permissions

• jpchat.* (operators): Every JPChat permission.
• jpchat.admin (operators): Reload JPChat and trigger announcements.
• jpchat.namecolor (everyone): Open /namecolor (each colour needs its own jpchat.namecolor.).
• jpchat.chatgames.play (everyone): Take part in chat games.
• jpchat.chatgames.admin (operators): Start and stop chat games with /chatgame.
• jpchat.msg (everyone): Send private messages.
• jpchat.msg.toggle (everyone): Toggle private messages.
• jpchat.ignore (everyone): Ignore players.
• jpchat.emoji (everyone): Use emoji shortcuts.
• jpchat.item (everyone): Show items with [item].
• jpchat.link (everyone): Send clickable links.
• jpchat.socialspy (operators): See other players' private messages.
• jpchat.broadcast (operators): Broadcast messages.
• jpchat.notify (operators): See filtered message alerts.
• jpchat.color (operators): Use &0-&f colours in chat.
• jpchat.style (operators): Use &l &o &n &m &k in chat.
• jpchat.hex (operators): Use &#RRGGBB colours in chat.
• jpchat.minimessage (operators): Use MiniMessage tags in chat.
• jpchat.bypass.cooldown (operators): Bypass the chat cooldown and anti-spam.
• jpchat.bypass.filter (operators): Bypass word, caps and advertising filters.
• jpchat.bypass.ignore (operators): Cannot be ignored.
• jpchat.bypass.msgtoggle (operators): Message players who disabled private messages.
• jpchat.mention.everyone (operators): Ping everyone with @everyone.
• jpchat.announcer.hide (nobody): Do not receive automatic announcements.
• jpchat.format.vip (nobody): Use the vip chat format.
• jpchat.format.staff (nobody): Use the staff chat format.

Placeholders

Needs PlaceholderAPI.

• %jpchat_name%: the player's name in their /namecolor colour
• %jpchat_namecolor%: key of the chosen colour ("" = default)
• %jpchat_msgtoggle%: true when they accept private messages
• %jpchat_socialspy%: true when social spy is on

Support

Full docs, the default config and setup guides are on the JPChat page of the JP Plugins website.
Questions, bugs or ideas? Join the JP Plugins Discord.

License

JPChat is free to use on any server, including servers that make money, but it is not open source. Don't reupload, sell or share modified copies of it. The full terms are in LICENSE.txt inside the jar.