# QuillChat – Customizable Chat for Minecraft Servers<\/p>\n
**QuillChat** is a simple and flexible plugin for Paper-based servers (version 1.21 and above), allowing full customization of the in-game chat. With it, you can configure global and local chat, add placeholder support, manage link sending, and more. Ideal for role-playing servers where chat separation by distance is important, or for any projects needing a stylish and functional chat.<\/p>\n
The plugin is developed in Java using Gradle, and it uses `paper-plugin.yml` for the manifest, ensuring compatibility with the Paper API.<\/p>\n
## Key Features
\n– **Advanced Group-Based Chat Formats**: Now you can create completely custom chat styles for any player group (Default, VIP, Admin, Donor, YouTuber, etc.).
\n– **Global Chat**: All players see messages. Use a prefix (default `!`) to switch from local mode.
\n– **Local Chat**: Messages are visible only within a radius (default 100 blocks). Perfect for immersive gameplay where players communicate only with those nearby.
\n– **Customizable Formats**: Use MiniMessage for color formatting. In the config, set templates like `{player}` for the name and `{message}` for the text. Supports placeholders from LuckPerms (e.g., `%luckperms_prefix%`).
\n– **Link Support**: Automatic URL parsing in chat with clickability. You can globally allow\/disallow links or restrict them with the permission `quillchat.links`.
\n– **Commands**:
\n – `\/chat reload` – Reload the configuration (requires permission `quillchat.reload`).
\n– **Integration with PlaceholderAPI**: If installed, the plugin automatically uses placeholders for dynamic content (e.g., prefixes from LuckPerms).
\n– **Permissions**:
\n – `quillchat.reload`: For reloading the config (default for OP).
\n – `quillchat.links`: For sending links (default for OP if globally allowed).
\n – `quillchat.format.default`: Default chat format (default: true).
\n– **Chat Enable\/Disable**: Fully disable the chat in the config if needed.<\/p>\n
## Installation
\n1. Download the JAR file from Modrinth.
\n2. Place it in your server’s `plugins` folder.
\n3. Restart the server – the plugin will automatically create `config.yml` in the `plugins\/QuillChat` folder.
\n4. Customize the config to your liking and use `\/chat reload` to apply changes without restarting.<\/p>\n
## Configuration (config.yml)
\nHere’s an example of the base config:<\/p>\n
“`yml
\n# Chat settings for the QuillChat plugin
\nchat-settings:
\n enable: true
\n global-chat-symbol: “!”
\n enable-local-chat: true
\n radius: 100
\n allow-links: true<\/p>\n
# === FORMATS SYSTEM === vip: default: # Custom messages You can edit colors, formats, and messages using MiniMessage (e.g., ` ## Dependencies ## Compatibility A high-quality chat formatting plugin.<\/p>\n","protected":false},"featured_media":127991,"template":"","meta":{"_minecraft_slug":"quill-chat","_minecraft_project_id":"nxoDYJM2","_minecraft_author":"sitafe","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":48,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"quill-chat.zip","_minecraft_size_bytes":39281,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-15T21:21:08.040852Z","_minecraft_date_created":"2025-11-13T00:52:04.314744Z","_minecraft_date_modified":"2026-04-04T07:18:02.441850Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/quill-chat","_minecraft_icon_attachment_id":127991,"_minecraft_imported_at":"2026-06-07T12:49:19+00:00","_minecraft_import_hash":"f0d06ef5bc9aa8fb982aa533f516aa03","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,156,127,128,867,129,92],"mod_loader":[130,132,133,134],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167],"class_list":["post-127990","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-decoration","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","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","minecraft_version-26-1","minecraft_version-26-1-1"],"yoast_head":"\n
\n# Important! If the vip format is lower than the default format, the default chat formatting will be used.
\n# Therefore, write the groups in descending order! For example:
\n# Alternatively, set the default permission to false in your permission plugin.
\nformats:
\n admin:
\n permission: quillchat.format.admin
\n global: “
\n local: “
\n permission: quillchat.format.vip
\n global: “
\n local: “
\n permission: quillchat.format.default
\n global: “
\n local: “%luckperms_prefix%
\nmessages:
\n command-usage: “
\n no-permission: “
\n reload-success: “
\n no-link-permission: “
\n“`<\/p>\n
\n– **Required**: Paper 26.1.1
\n– **Optional**:
\n – PlaceholderAPI (for placeholders, e.g., from LuckPerms).
\n – LuckPerms (recommended for prefixes and suffixes).<\/p>\n
\n– Tested on Paper 26.1.1
\n– Works with other chat plugins, but it’s recommended to disable Minecraft’s built-in chat to avoid conflicts.
\n– No conflicts with MiniMessage or Adventure API.<\/p>\n","protected":false},"excerpt":{"rendered":"