Modify Color

A Step by step to add/change/remove a color.

This guide outlines the proper procedure for modifying chat colours using ChatColor2. Follow the section that applies to your objective (personal use, custom preset, or group configuration).

---

Method 1 — Changing Your Own Chat Colour (In-Game)

Step 1 — Verify Permission

Ensure you have the required permission:

chatcolor.use

If using hex colours:

chatcolor.use-hex-codes

---

Step 2 — Apply a Standard Colour

Use:

/chatcolor <color>

Example:

/chatcolor red
/chatcolor c

---

Step 3 — Apply a Hex Colour (Optional)

/chatcolor %<name>

This applies a custom RGB colour to your chat.

---

Step 4 — Add Modifiers (Optional)

To apply bold formatting:

/chatcolor add bold

To remove it:

/chatcolor remove bold

Available modifiers:

bold
italic
underline
strikethrough
obfuscated

---

Step 5 — Reset to Default

/chatcolor default

---

Method 2 — Creating or Modifying a Custom Colour Preset (Recommended for Servers)

Custom presets allow consistent branding and rank-based colours.

---

Step 1 — Navigate to the Plugin Directory

Open:

/plugins/ChatColor2/

---

Step 2 — Open custom-colors.yml

Use a proper YAML editor (Notepad++, VS Code, etc.).

---

Step 3 — Add or Modify a Colour Entry

Example:

vip-gold: '&6&l'
ocean-blue: '#1E90FF'
sunset-gradient: '&u[#FF512F,#DD2476]'

To modify an existing preset, simply replace its value.

Example (before):

vip-gold: '&6'

After:

vip-gold: '&6&l'

---

Step 4 — Save the File

Ensure formatting is correct. Improper indentation or missing quotes may break the configuration.

---

Step 5 — Reload the Plugin

In console or in-game:

/chatcolor reload

---

Step 6 — Assign Permission

Grant players access:

chatcolor.custom.vip-gold

Players can now use:

/chatcolor %vip-gold

---

Method 3 — Modifying a Group Colour

Group colours automatically apply to permission groups.

---

Step 1 — Open groups.yml

Located inside:

/plugins/ChatColor2/

---

Step 2 — Edit or Add a Group

Example:

admin: '&c&l'
moderator: '&2'
vip: '&6'

To modify:

vip: '&u[#FFD700,#FFA500]'

---

Step 3 — Save Changes**

Ensure no formatting errors are introduced.

---

Step 4 — Reload Configuration

/chatcolor reload

---

Method 4 — Using the GUI (Player-Friendly Option)

If enabled:

/chatcolor gui

1. Select a colour from the interface.

2. Confirm selection.

3. The change applies immediately.

---

Best Practices

• Always back up configuration files before editing.

• Use consistent branding colours across ranks.

• Restrict gradients and hex colours to premium groups if desired.

• After every modification, reload the plugin.

---

Verification Checklist

✔ Colour applies correctly in chat ✔ No console errors after reload ✔ Permissions assigned correctly ✔ Formatting displays as intended

---

Completion

You have successfully modified chat colours using ChatColor2. For advanced setups, consider combining hex gradients with rank-based presets for a professional server appearance.