Skip to content

Expansion: FactionsChat

Mark Hughes edited this page Aug 14, 2017 · 3 revisions
Expansion Info
This expansion allows players to use faction chat.

Since: v1.4.2

Chat Formatting

There is one placeholder exclusive to FactionsChat {fc_message} which has the message the player is sending.

You can use all the regular placeholders as specified.

Configuration

There are a handful of configuration options for FactionsChat - read this documentation carefully! The new FactionChat works a lot better than the previous ones in terms of event handling and performance.

enabled

Default: true
If enabled, players will be able to use FactionsChat.

enableAllianceChat

Default: true
If enabled, as well as faction chat, players can also use alliance chat (/f chat a)

enableTruceChat

Default: true
If enabled, as well as faction chat, players can also use truce chat (/f chat t)

enableFormatPublicChat

Default: false
If enabled, factionsChatFormatPublic will be used for regular public chat. Do not use this if you want your chat manager to handle this for you.

chatFormatPublic

Default: {factions_player_role_prefix}%s:§f%s
This is the format used for public chat (if enabled) the first % is the players display name and the second % is the message. Optionally omit these for {factions_player_name} and {fc_message}. See Chat Formatting.

chatFormatFaction

Default: §a{factions_player_role_prefix}%s:§f %s
This is the format used for faction chat (if enabled) the first % is the players display name and the second % is the message. Optionally omit these for {factions_player_name} and {fc_message}. See Chat Formatting.

chatFormatAlliance

Default: §d{factions_player_role_prefix}%s:§f %s
This is the format used for alliance chat (if enabled) the first % is the players display name and the second % is the message. Optionally omit these for {factions_player_name} and {fc_message}. See Chat Formatting.

chatFormatTruce

Default: §5{factions_player_role_prefix}%s:§f %s
This is the format used for truce chat (if enabled) the first % is the players display name and the second % is the message. Optionally omit these for {factions_player_name} and {fc_message}. See Chat Formatting.

chatFormatSpy

Default: §7(spy) {factions_player_role_prefix}%s:§7 %s
This is the format used for spy chat (if enabled) the first % is the players display name and the second % is the message. Optionally omit these for {factions_player_name} and {fc_message}. See Chat Formatting.

chatPluginChannelUse

Default: true
If enabled and available, faction chat will use your chat managers channels instead. Currently only VentureChat is supported. Your chat commands will automatically sync to that plugins channels. E.g. /f chat a will join the channel alliance.

chatPluginChannelGlobal

Default:
This value is only used if the above setting is enabled and used. If a channel name is placed here it will be used as the global/public chat (/f chat p) channel.

chatTagEnabled

Default: true
If enabled the chat tag chatTagPlaceholder will automatically be replaced from formats. This only really needs to be used with plugins that don't support placeholder APIs.

chatTagRelationalOverride

Default: false
You really shouldn't use this. It cancels the chat event, replaces relational placeholders, and then sends it to players manually. Your chat plugin should handle relational placeholders for you, but if not - enable this.

chatTagPlaceholder

Default: {factions_chat_tag}
Placeholder to replace for chat tag. In previous versions this was [FACTION].

chatTagFormatDefault

Default: {factions_player_role_prefix}{factions_faction_name}§f
The default chat tag format.

chatTagFormatDefault

Default:
The default chat tag format for factionless players.