Migration from ChatColor2

Migration from ChatColor2

ChatColor3 is a drop-in replacement for ChatColor2 on Paper 26+ servers.

What Changed

	ChatColor2	ChatColor3
Server	Spigot 1.13–1.20	Paper 26.2+
Java	8	21+
Chat event	AsyncPlayerChatEvent	AsyncChatEvent (Adventure)
Text API	Legacy § strings	Adventure Component
Package	com.sulphate.chatcolor2	com.sulphate.chatcolor3
GUI sounds	Enum names (BLOCK_AMETHYST_BLOCK_STEP)	Registry keys (block.amethyst_block.step)

Upgrade Steps

1. Stop your server
2. Remove ChatColor2.jar from plugins/
3. Place ChatColor3.jar in plugins/
4. Copy your existing config folder: rename plugins/ChatColor2/ → plugins/ChatColor3/
5. Update gui.yml sound values from enum names to registry keys:
   • BLOCK_AMETHYST_BLOCK_STEP → block.amethyst_block.step
   • ENTITY_BLAZE_HURT → entity.blaze.hurt
   • (General rule: lowercase, first _ becomes ., rest stay as _)
6. Start the server

Config Compatibility

• config.yml — fully compatible, no changes needed
• messages.yml — fully compatible
• groups.yml — fully compatible
• custom-colors.yml — fully compatible
• gui.yml — sound values need updating (see above)
• players/*.yml — fully compatible (YAML storage)
• SQL database — fully compatible (same table schema)

New Features in ChatColor3

• Rainbow/gradient commands accept named colours: /chatcolor &u[red,blue,green]
• Improved console error messages
• Updated help links (Modrinth)

License

ChatColor3 is licensed under GPL v3, same as ChatColor2. It's a community fork — not affiliated with the original author.