Chatty — Modern Chat Management

Chatty is a powerful and configurable chat management plugin for Paper and Purpur 26.2 servers. It provides chat channels, private messaging, moderation, notifications, MiniMessage formatting, cross-server communication, and automatic migration from Chatty v2.

This project is an independent fork of the original Brikster/Chatty repository. It is not an official release by the original author. This fork focuses on modern Paper compatibility, Java 25 support, automated releases, dependency updates, testing, and additional bug fixes.

Features

• Configurable local and global chat channels
• Custom chat formats, symbols, ranges, permissions, and cooldowns
• Private messages and reply commands
• Private-message spy mode
• CAPS, advertisement, link, and swear moderation
• MiniMessage, legacy color codes, and hex colors
• Click and hover text replacements
• Chat, action bar, and title notifications
• Configurable join, quit, and death messages
• Mentions with sounds and custom formatting
• PlaceholderAPI and Vault support
• Redis-based cross-server chat
• MySQL and PostgreSQL support for shared player data
• Built-in SQLite storage for regular installations
• Automatic migration from Chatty v2
• DiscordSRV coexistence
• English, German, Spanish, Russian, and Chinese language files

Compatibility

Platform	Support
Paper 26.2	✅ Tested
Purpur 26.2	✅ Supported
Spigot / CraftBukkit	❌ Not supported
Fabric / Forge / NeoForge	❌ Not supported
Velocity / BungeeCord	⚠️ Proxy communication is handled through Redis

Java 25 or newer is required.

Optional Integrations

• PlaceholderAPI — use placeholders in chat formats
• Vault — permissions, prefixes, suffixes, and economy integrations
• DiscordSRV — tested for clean coexistence
• Redis — required for cross-server chat
• MySQL or PostgreSQL — required for shared cross-server player data

Installation

1. Download the latest Chatty JAR.
2. Stop your server.
3. Place the JAR inside the server's plugins folder.
4. Start the server using Java 25.
5. Configure the generated files inside plugins/Chatty/.
6. Restart the server after making configuration changes.

Do not use /reload. Restart the server normally when installing or updating the plugin.

Migrating from Chatty v2

Chatty automatically detects a legacy v2 config.yml.

During migration, Chatty:

1. Creates a timestamped backup named Chatty_old_<timestamp>.
2. Generates the new v3 configuration files.
3. Migrates compatible chats, moderation settings, private messages, mentions, and vanilla messages.
4. Prints a list of settings that require manual review.

Sounds, interactive replacements, notifications, locale messages, per-chat commands, and legacy BungeeCord chat settings may require manual configuration after migration.

Keep the generated backup until you have confirmed that the migrated configuration works correctly.

Updating

1. Stop the server.
2. Back up plugins/Chatty/.
3. Replace the old Chatty JAR with the new version.
4. Start the server and review the console for migration or configuration warnings.

Support and Issues

If you discover a bug or have a suggestion, create an issue in the MCForks/Chatty GitHub repository.

Please include:

• Chatty version
• Server software and build
• Java version
• Relevant configuration
• Complete error logs

Credits

• Brikster — creator of the original Chatty project
• Original Chatty repository
• Maintained fork

This fork preserves attribution to the original project and continues its development for modern Paper-based servers.