Quill Chat

QuillChat - Customizable Chat for Minecraft Servers

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.

The plugin is developed in Java using Gradle, and it uses `paper-plugin.yml` for the manifest, ensuring compatibility with the Paper API.

Key Features

- Chat Enable/Disable: Now you can create completely custom chat styles for any player group (Default, VIP, Admin, Donor, YouTuber, etc.). - Chat Enable/Disable: All players see messages. Use a prefix (default `!`) to switch from local mode. - Chat Enable/Disable: Messages are visible only within a radius (default 100 blocks). Perfect for immersive gameplay where players communicate only with those nearby. - Chat Enable/Disable: 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%`). - Chat Enable/Disable: Automatic URL parsing in chat with clickability. You can globally allow/disallow links or restrict them with the permission `quillchat.links`. - Chat Enable/Disable: - `/chat reload` - Reload the configuration (requires permission `quillchat.reload`). - Chat Enable/Disable: If installed, the plugin automatically uses placeholders for dynamic content (e.g., prefixes from LuckPerms). - Chat Enable/Disable: - `quillchat.reload`: For reloading the config (default for OP). - `quillchat.links`: For sending links (default for OP if globally allowed). - `quillchat.format.default`: Default chat format (default: true). - Chat Enable/Disable: Fully disable the chat in the config if needed.

Installation

1. Download the JAR file from Modrinth. 2. Place it in your server's `plugins` folder. 3. Restart the server - the plugin will automatically create `config.yml` in the `plugins/QuillChat` folder. 4. Customize the config to your liking and use `/chat reload` to apply changes without restarting.

Configuration (config.yml)

Here's an example of the base config:

```yml

Chat settings for the QuillChat plugin

chat-settings: enable: true global-chat-symbol: "!" enable-local-chat: true radius: 100 allow-links: true

=== FORMATS SYSTEM ===

Important! If the vip format is lower than the default format, the default chat formatting will be used.

Therefore, write the groups in descending order! For example:

Alternatively, set the default permission to false in your permission plugin.

formats: admin: permission: quillchat.format.admin global: "<red>[ADMIN]</red> %luckperms_prefix%<color:#79dae0>{player}</color> <dark_gray>»</dark_gray> <color:#ffeccf>{message}</color>" local: "<red>[ADMIN]</red> %luckperms_prefix%<color:#e0e0e0>{player}</color> <dark_gray>»</dark_gray> {message}"

vip: permission: quillchat.format.vip global: "<gold>[VIP]</gold> %luckperms_prefix%<color:#79dae0>{player}</color> <dark_gray>»</dark_gray> <color:#ffeccf>{message}</color>" local: "<gold>[VIP]</gold> %luckperms_prefix%<color:#e0e0e0>{player}</color> <dark_gray>»</dark_gray> {message}"

default: permission: quillchat.format.default global: "<color:#1eff00>●</color> %luckperms_prefix%<color:#79dae0>{player}</color> <dark_gray>»</dark_gray> <color:#ffeccf>{message}</color>" local: "%luckperms_prefix%<color:#e0e0e0>{player}</color> <dark_gray>»</dark_gray> {message}"

Custom messages

messages: command-usage: "<color:#cfffad>Usage: /chat reload</color>" no-permission: "<red>You don't have permission to execute this command!" reload-success: "<green>The configuration has been successfully reloaded!" no-link-permission: "<red>You don't have the right to send links to the chat!" ```

You can edit colors, formats, and messages using MiniMessage (e.g., `<red>`, `<green>`, or gradients).

Dependencies

- Optional: Paper 26.1.1 - Optional: - PlaceholderAPI (for placeholders, e.g., from LuckPerms). - LuckPerms (recommended for prefixes and suffixes).

Compatibility

- Tested on Paper 26.1.1 - Works with other chat plugins, but it's recommended to disable Minecraft's built-in chat to avoid conflicts. - No conflicts with MiniMessage or Adventure API.