Bukkit

Basic information

Current version is v1.4.
This plugin works like ChatManager, with Factions and PEX.

Supported plugins

• Factions (Required!)
• PermissionsEx
• Multiverse-Core
• Jobs
• TagAPI
• GeoIPTools

Configuration

Configuration file config.yml

Plugin will create config.yml file on first server launch.
Then you can set:

enable: false 
time-format: 'yyyy/MM/dd HH:mm:ss' 
format: '{W} {F} {T} <{P}{N}{S}> {M}' 
allow-colorcodes: false 
range-mode: false
range: 100
blocked-words: 'fuck,shit,...'
prevent-dots: 0
change-tablist: false
tablist-format: '{N}'
use-tagapi: false
tagapi-format: '{N}'

Explanation

• enable - Enables the plugin, can be true or false
• time-format - Sets the time format used by this plugin
• format - Sets the chat format
• allow-colorcodes - Enables using color codes in chat, can be true or false
• range-mode - Enables/disables message range mode
• range - Sets the length in blocks from message sender, so if you are farther than is this range, you won't see message in chat
• blocked-words - Words in chat which will be hidden by stars
• prevent-dots - Maximum number of dots in one word (set to 0 to disable)
• change-tablist - Enable/disable changing TAB player list with tablist-format
• tablist-format - Tablist format using formatting codes (without {M}) and color codes (Beware of maximum length of format - 16 chars)
• use-tagapi - Enables/disables using of TagAPI plugin - changing name bubble above head
• tagapi-format - Format of name in bubble, max. 16 chars

Configuration file advanced.yml

You should use this, when you don't use PEX and you use other permission plugin.

groups:
  group1:
    prefix: '&6[Group 1]&e'
    suffix: '&2[end]&f'

You can add new groups and set them prefixes and suffixes.
Then you have to add new permission to you permissions plugin, pattern is "factionschat.group.<group name>". E.g. factionschat.group.group1 and every player who has this permission will use prefix and suffix from group "group1".
Important: If you are admin, and you have enabled all server permissions ('*'), you have to disable permission factionschat.group.* and then you have to enable only one specified group, e.g. factionschat.group.admin

Formats, colors

Formatting codes

{W} - World name (if available, it is world alias from MultiVerse plugin)
{T} - Current time using formating time-format
{F} - Faction tag, you don't have to use chatTagReplaceString from Factions conf.json
{+F} - Faction tag with space before
{F+} - Faction tag with space behind
{+F+} - Faction tag with space before and behind
{P} - Prefix from PermissionsEx
{N} - Player's name
{S} - Suffix from PEX
{M} - Message text
{I} - Shows players IP
{:P} - Shows players port of his ip with : before
{C} - Shows ISO2 code of players country (by his IP), e.g. US, UK, CZ, PL,...
{C+} - Shows full name of players country, e.g. Czech Republic, Poland, Slovakia, Australia,...
{J:args} - Shows jobs prefix - args can be full, title, job, shortfull, shottitle and shortjob

Color codes "&"

You can find the list here

Time formating

You can find the tutorial here

Commands & Permissions

• factionschat.reload - Allows you to use command /factionschat, which reloads the plugin's config
• factionschat.colorcodes - Allows you to use color codes like &1, &a, &f,... in chat
• factionschat.see - Allows you to see every message posted in chat including out of range messages
• factionschat.bypass - With this permission you will bypass range mode and everyone on the server will see your message in chat
• factionschat.group.<group name> - Use this when you don't use PEX and you use advanced.yml config.

Changelog

Quote from v1.4:

• Updated for newest CB
• Added support for Jobs and for TagAPI
• Fixed issue with geolocation - now you have to have enabled GeoIPTools plugin for this

Quote from v1.3.1:

• Fixed error IllegalArgumentException - Notice that player list names can only be a maximum of 16 characters long, or it will be automatically truncated

Quote from v1.3:

• Fixed bug ClassNotFoundException when player used /factionchat command after /reload command
• Fixed bug NullPointerException when player messaged after /reload command
• Fixed bug of {F} formatting codes, when {F} wasn't used -> Now, you can teoretically use this plugin without Factions!
• Added MultiVerse world aliases support - when is MV enabled, {W} will be world alias
• Added advanced.yml config, you should use this, when you use other permissions plugin -> Added new group permissions.
• Cleaned code

Quote from v1.2:

• Added configurale maximum of dots in one word (prevents advertisements - URLs and IPs)
• Added new color codes for bold, italic, underline, line-through, magic and reset
• Added new formatting codes - {F+}, {+F}, {+F+}, {I}, {:P}, {C} and {C+}
• Added permissions for bypassing range mode (see and write)
• Configurable TAB player list with formatting codes and color codes
• Fixed some bugs

Quote from v1.1:

• Added message range mode.
• Added configurable list of blocked words in chat.

Quote from v1.0:

• First version of FactionsChat plugin.

To do

• Add Jobs support
• Add TagAPI support (to change nick bubbles above players head)
• Add MultiVerse support
• Add PermissionsBukkit support (added advanced.yml config file)
• Add {C} for showing players country (like CZ, UK, US, FR,...)
• Add {I} for showing players IP
• Configurable (TAB) list of players on server
• Add permission to see every message posted in chat (default for every OP)
• Add permission for bypassing range mode (you can send message visible for everyone)
• Add {F+} format code (same as {F} but with space behind)
• Add new color codes (&w - bold (as wide), &u - underline,...)
• Hiding IP adresses and URLs in chat (maximum number of dots in one word)
• Ranged mode for messages
• Blocked words in chat

Do you like my plugins?