# RiotChat<\/p>\n
RiotChat is a lightweight, moderation-focused chat plugin for Spigot\/Paper. It provides formatted chat, mentions, a persistent ignore system, clear\/announce utilities, tablist headers\/footers, and a persistent mute system with database backing and tab-completion for moderation commands.<\/p>\n
This README documents features, installation (binary\/JAR), configuration, database, commands, permissions and how to report issues.<\/p>\n
—<\/p>\n
## Features<\/p>\n
– Formatted chat with prefix\/suffix support (LuckPerms integration) —<\/p>\n ## Installation (JAR \/ release repository)<\/p>\n This repository is intended to host the plugin releases (JAR files) and does not necessarily include the source code. To install the plugin on your server:<\/p>\n 1. Download the release JAR from this repository’s Releases page or Modrinth, SpigotMC, Hangar. If a compiled JAR is not present in the repository, check the Releases tab or the project’s website for binary downloads.<\/p>\n —<\/p>\n ## Configuration<\/p>\n Main config file (generated on first run): `config.yml` in the plugin folder. Important config keys (examples):<\/p>\n – `enable-chat` (boolean) \u2014 Global switch for chat features. Example excerpt:<\/p>\n “`yaml clearchat: —<\/p>\n ## Commands<\/p>\n – `\/msg —<\/p>\n ## Permissions<\/p>\n Suggested default permission nodes (adjust in your permissions system):<\/p>\n – `riotchat.color` \u2014 Use color codes in chat (default: op) —<\/p>\n ## Troubleshooting<\/p>\n – DB connection errors: verify your `config.yml` database settings and reachability.<\/p>\n If you need further help, open an issue on the repository with server logs and configuration excerpts.<\/p>\n —<\/p>\n ## Contributing & Source<\/p>\n This repository is intended to host plugin releases (binary JARs). It may not contain the plugin source code. If you want to contribute or request the source, please open an issue or check the project page for a link to the source repository. Pull requests against compiled-release repositories are not accepted.<\/p>\n —<\/p>\n ## License<\/p>\n This project is provided under the MIT License by default. <\/p>\n —<\/p>\n ## Changelog (short)<\/p>\n – v0.1 \u2014 Core chat formatting, ignore, messaging, announce, clear-chat, tablist A Basic general purpose chat and Tablist plugin with Luckperms and PlaceholderAPI Support<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"riotchat","_minecraft_project_id":"j2dHFjSR","_minecraft_author":"lb-acey","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":7,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"riotchat.zip","_minecraft_size_bytes":6670211,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:28:00.103870Z","_minecraft_date_created":"2026-04-15T02:12:11.227712Z","_minecraft_date_modified":"2026-04-02T12:17:15.624165Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/riotchat","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-07T21:08:35+00:00","_minecraft_import_hash":"18ce3eea1e49a062690bbc600d98e3be","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[127],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-133534","mod","type-mod","status-publish","hentry","mod_category-paper","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– Mentions highlighting and processing
\n– Private messages (`\/msg`, `\/reply`)
\n– Persistent ignore system (database-backed)
\n– Clear chat with optional announcement and sound
\n– Server-wide announcements using MiniMessage templates
\n– Tablist header\/footer support
\n– Persistent mute system with DB storage:
\n – `\/mute
\n – `\/unmute
\n – Mutes stored in `riotchat_mutes` table
\n – Tab-completion for `\/mute` (player names + durations)
\n– Config-driven behavior and H2\/MySQL support<\/p>\n
\n2. Copy the JAR file into your Paper\/Spigot server’s `plugins\/` directory.
\n3. Start or restart the server. The plugin will generate default configuration files on first run.<\/p>\n
\n– `chat.separator` (string) \u2014 Separator between name and message.
\n– `chat.name-hover` \/ `chat.name-click` (boolean) \u2014 Enable hover\/click behaviour on player names.
\n– `clearchat.lines` (int) \u2014 Number of blank lines to send for `\/clearchat`.
\n– `announce.format` (MiniMessage block) \u2014 Template used for broadcast announcements.
\n– `database.type` \u2014 `H2` or `MYSQL`.
\n– `database.h2.file` \u2014 H2 file path (without `.mv.db`).
\n– `database.mysql.*` \u2014 MySQL connection settings.<\/p>\n
\ndatabase:
\n type: “H2”
\n h2:
\n file: “plugins\/RiotChat\/riotchat”<\/p>\n
\n lines: 120
\n message: |
\n
\n
\n
\n
\n“`<\/p>\n
\n– `\/reply
\n– `\/announce
\n– `\/clearchat [silent]` \u2014 Clears chat; `silent` suppresses broadcast (permission: `riotchat.clearchat`).
\n– `\/togglechat` \u2014 Toggle global chat state (permission: `riotchat.chat.toggle`).
\n– `\/ignore
\n– `\/ignorelist` \u2014 Show the players you currently ignore.
\n– `\/mute
\n – Duration examples: `10s`, `5m`, `1h`, `1d`, or `perm` for permanent.
\n – The plugin provides a `MuteTabCompleter` that suggests players and common durations.
\n– `\/unmute
\n– `riotchat.reload` \u2014 Reload configuration (default: op)
\n– `riotchat.announce` \u2014 Use `\/announce` (default: op)
\n– `riotchat.ignore` \u2014 Use ignore commands (default: op)
\n– `riotchat.clearchat` \u2014 Clear chat (default: op)
\n– `riotchat.clearchat.bypass` \u2014 Bypass clear chat effects (default: false)
\n– `riotchat.chat.bypass` \u2014 Bypass global chat-disabled state (default: op)
\n– `riotchat.chat.toggle` \u2014 Toggle chat on\/off (default: op)
\n– `riotchat.mute` \u2014 Mute players (default: op)
\n– `riotchat.unmute` \u2014 Unmute players (default: op)
\n– `riotchat.mute.bypass` \u2014 Bypass mutes (for staff) (default: op)<\/p>\n
\n– v0.2 \u2014 Persistent mute system, `\/mute`\/`\/unmute`, `MuteTabCompleter`<\/p>\n","protected":false},"excerpt":{"rendered":"