Configuration

Configuration

The main config is plugins/ChatColor3/config.yml.

Settings

Setting	Type	Default	Description
event-priority	String	LOWEST	Bukkit event priority for the chat listener
auto-save	Boolean	true	Auto-save player data on an interval (YAML storage)
save-interval	Integer	10	Seconds between auto-saves (YAML storage)
color-override	Boolean	false	Strip player-typed colours and force their set colour
notify-others	Boolean	true	Notify a player when someone else changes their colour
join-message	Boolean	true	Show "your colour is..." message on join
confirm-timeout	Integer	15	Seconds to confirm a setting change before it expires
default-color	Colour	&f	The default colour for all players
command-name	String	chatcolor	Custom command alias
force-group-colors	Boolean	true	Force group colours, preventing players from overriding
default-color-enabled	Boolean	true	Enable the default colour system
command-opens-gui	Boolean	false	/chatcolor with no args opens the GUI
ignore-symbol-prefixes	Boolean	true	Don't colour messages starting with symbols (e.g. !, ?)
remove-inaccessible-colors	Boolean	false	Reset a player's colour if they lose permission for it

Default Colour

default:
  code: 1
  color: '&f'

The code is a timestamp that changes whenever the default colour is updated via /chatcolor set default-color. Players whose stored code doesn't match are automatically migrated to the new default.

Placeholders

placeholders:
  - '[item]'

Strings in this list are preserved (not coloured) when applying chat colours. Useful for other plugins' placeholders.

Storage

storage:
  type: yaml    # or "sql"
  database:
    address: localhost
    port: 3306
    name: chatcolor_db
    user: database_user
    password: database_password

See SQL-Storage for details.