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

• Advanced Group-Based Chat Formats: Now you can create completely custom chat styles for any player group (Default, VIP, Admin, Donor, YouTuber, etc.).
• Global Chat: All players see messages. Use a prefix (default !) to switch from local mode.
• Local Chat: Messages are visible only within a radius (default 100 blocks). Perfect for immersive gameplay where players communicate only with those nearby.
• 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%).
• Link Support: Automatic URL parsing in chat with clickability. You can globally allow/disallow links or restrict them with the permission quillchat.links.
• Commands:
  • /chat reload - Reload the configuration (requires permission quillchat.reload).
• Integration with PlaceholderAPI: If installed, the plugin automatically uses placeholders for dynamic content (e.g., prefixes from LuckPerms).
• Permissions:
  • 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:

# 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

• Required: 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.