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

• 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).
• 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:
  enable: true  # Enable chat
  global-chat-format: "<color:#1eff00>●</color> %luckperms_prefix%<color:#79dae0>{player}</color> <dark_gray>»</dark_gray> <color:#ffeccf>{message}</color>"  # Global chat format
  global-chat-symbol: "!"  # Symbol for global chat
  enable-local-chat: true  # Enable local chat
  local-chat-format: "%luckperms_prefix%<color:#e0e0e0>{player}</color> <dark_gray>»</dark_gray> {message}"  # Local format
  radius: 100  # Local chat radius
  allow-links: true  # Allow links globally

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

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

Dependencies

• Required: Paper 1.21 or above.
• Optional:
  • PlaceholderAPI (for placeholders, e.g., from LuckPerms).
  • LuckPerms (recommended for prefixes and suffixes).

Compatibility

• Tested on Paper 1.21.10.
• 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.

If you have suggestions or bugs, write in the discussions on Modrinth. Developed using IntelliJ IDEA for easy chat customization "as you like"! 😊