PromoChatColors

---

English

PromoChatColors gives your players colorful chat: solid colors, hex, gradients and ✨ text, all managed from simple YAML files and in-game menus.

Features

• Admin menu (/promochatcolors or /pcc): a double chest with every chat color, a gray border and page arrows.
  • Left-click a color to get its item.
  • Right-click a color to open its settings: green (visible) or red (hidden) controls whether the color shows in the players' chat color menu.
• Color items: players right-click the item to unlock the color permanently.
• Player menu through /chatcolor and /sohbetrengi. Add any extra commands you want in commands.yml, with per-command allowed users, groups, permission and cooldown.
• Colors in colors.yml: solid colors, hex (&#FF8800), gradients with two or more colors, ✨, bold, italic, underline, strikethrough, obfuscated, a {message} placeholder, the item's name, glow and lore, and group access.
• Default colors per group in config.yml, so each rank can start with its own color.
• LuckPerms and other permission plugins: groups work out of the box, plus promochatcolors.color.<id> permissions.
• Admin commands: give items, list, add, remove, set, clear or reset a player's colors (/pcc user <player> chatcolors ...), reload, and show version info.
• Languages: English and Türkçe included. Add more by copying a section in lang/messages.yml, then switch in game with /pcc setlang <language>.
• Update checker: checks Modrinth on every server start. Operators get a clickable link when a new version is out.
• Automatic config upgrades: when you update, missing settings are added, your values are kept, and a backup is saved.
• Safe chat: players cannot inject color codes into their messages.
• Compatibility: Spigot, Paper, Purpur, Folia and Paper forks, Minecraft 1.16 to the latest 1.21.x. Not for Fabric, Forge, NeoForge, Sponge, Velocity or BungeeCord.

Setup: drop the jar in plugins/, start the server, and edit the files in plugins/PromoChatColors/. The full guide with LuckPerms setup is in the README.

---

Türkçe

PromoChatColors, oyuncularınızın renkli yazmasını sağlar: düz renkler, hex, gradient ve gökkuşağı yazıları; hepsi basit YAML dosyaları ve oyun içi menülerle yönetilir.

Özellikler

• Admin menüsü (/promochatcolors veya /pcc): tüm sohbet renklerinin olduğu double chest, gri kenarlık ve sayfa okları.
  • Bir renge sol tıklayınca o rengin eşyası verilir.
  • Bir renge sağ tıklayınca ayarları açılır: yeşil (görünür) veya kırmızı (gizli), rengin oyuncuların sohbet rengi menüsünde görünüp görünmeyeceğini belirler.
• Renk eşyaları: oyuncular eşyaya sağ tıklayarak rengi kalıcı olarak açar.
• Oyuncu menüsü /chatcolor ve /sohbetrengi ile açılır. commands.yml içine istediğin kadar ekstra komut ekleyebilirsin; her komut için kullanıcı, grup, yetki ve bekleme süresi ayrı ayarlanır.
• Renkler colors.yml içinde: düz renkler, hex (&#FF8800), iki veya daha fazla renkli gradient, gökkuşağı, kalın, italik, altı çizili, üstü çizili, gizemli (obfuscated) yazılar, {message} yer tutucusu, eşyanın adı, parlaması ve açıklaması, grup erişimi.
• Gruba varsayılan renk (config.yml): her rütbe kendi rengiyle başlayabilir.
• LuckPerms ve diğer yetki eklentileri: gruplar hazır çalışır; ayrıca promochatcolors.color.<id> yetkileri de kullanılabilir.
• Admin komutları: renk eşyası verme, listeleme, bir oyuncunun renklerini ekleme, kaldırma, seçme, temizleme veya sıfırlama (/pcc user <oyuncu> chatcolors ...), yeniden yükleme ve sürüm bilgisi.
• Diller: İngilizce ve Türkçe hazır. lang/messages.yml içinde bir bölümü kopyalayıp yeni dil ekleyebilir, /pcc setlang <dil> ile oyun içinden değiştirebilirsin.
• Güncelleme kontrolü: her sunucu açılışında Modrinth'i kontrol eder. Yeni sürüm varsa OP'ler tıklanabilir link görür.
• Otomatik ayar yükseltme: güncelleyince eksik ayarlar eklenir, senin değerlerin korunur ve yedek alınır.
• Güvenli sohbet: oyuncular mesajlarına renk kodu enjekte edemez.
• Uyumluluk: Spigot, Paper, Purpur, Folia ve Paper forkları; Minecraft 1.16 ile son 1.21.x sürümleri. Fabric, Forge, NeoForge, Sponge, Velocity veya BungeeCord için değildir.

Kurulum: jar dosyasını plugins/ klasörüne at, sunucuyu başlat ve plugins/PromoChatColors/ içindeki dosyaları düzenle. LuckPerms kurulumu dahil tam rehber README'dedir.