FactionsChat3

FactionsChat3 is a Minecraft Spigot/Paper server plugin that integrates with MassiveCraft Factions, PvPIndex-Factions, and other factions or teams-based plugins (using the TeamsAPI or FactionsBridge) to provide advanced chat features and channels for faction-based servers.

Features

• Configurable Chat Formatting: The chat format is fully configurable via config.yml, supporting both PlaceholderAPI placeholders and built-in Factions tags.
• Multiple Chat Channels: Supports Ally, Truce, Faction, Enemy, Neutral, Local, Global, Staff, and World chat channels.
• Channel Permissions: Access to each chat channel is controlled by permissions (e.g. factions.chat.ally, factions.chat.faction, etc).
• Channel Switching: Use /f c <channel> or :<channel> to switch your active chat mode (colon prefix configurable).
• Quick Messaging: Use :<channel> <message> to send a one-off message without switching your active chat mode (colon prefix configurable).
• Customizable Prefixes and Colors: Prefixes and text colors for each channel are configurable in config.yml.
• Integration with Essentials and DiscordSRV: SocialSpy support for Essentials, and optional DiscordSRV integration for staff chat relay.
• Integration with PlaceholderAPI: Supports PlaceholderAPI for chat formatting and custom placeholders. If PlaceholderAPI is installed, all placeholders in the chat format will be parsed using PAPI. See the wiki for more details.
• Built-in Tag Parsing: If PlaceholderAPI is not installed, FactionsChat will parse built-in tags for faction names, ranks, relation colors, and more. See the wiki for more details.
• Per-Player Chat Mode Persistence: Remembers each player's last used chat mode across restarts.
• Local Chat Range: Configurable range for local chat visibility.

Usage and Configuration

Please read the Wiki for details about supported commands, permissions, configuration instructions, FAQs, and troubleshooting steps.

Requirements

Designed primarily as a Factions add-on, this plugin operates best with a supported version of Factions, and has optional requirements if you wish to use other integration features that this plugin supports. Note that the plugin will work without a Factions integration, but any factions-specific functionality will not work.

• Spigot or Paper (or other forks)
• Factions - we recommend Factions3 Renewed
• Other supported Factions plugins are:
  • PvPIndex-Factions
  • Any Factions (or other Teams-based) plugin that implements TeamsAPI - install the TeamsAPI plugin alongside it.
  • FactionsBridge (standalone plugin) - supports many Factions forks through one API; install the FactionsBridge plugin on the server with your Factions fork and FactionsChat should be able to connect. File an issue if you encounter any problems.
• (Optional) EssentialsX for SocialSpy support
• (Optional) DiscordSRV for Staff Chat relay
• (Optional) PlaceholderAPI for additional placeholder support

How do I download FactionsChat?

Please visit the GitHub Releases Page and download the latest version. Ensure you have a supported version of Factions installed, then drop it in your plugins folder and restart your server.

I found a bug or have a feature suggestion - where do I report it?

Please visit the GitHub Issues Page and fill out a new issue.

Credits

This plugin is originally based on the plugin Factions3Chat, created in 2020 by eirikh1996 for the original Factions3 by Madus. It has been rewritten in Java (from the original's Kotlin) and updated/extended/modified greatly.

The original plugin download can be found here: https://dev.bukkit.org/projects/factions3chat

The original source can be found here: https://github.com/eirikh1996/Factions3Chat