Idioma & MiniMessage
Todo texto que o mod mostra a um jogador — rótulos de GUI, feedback de chat, nomes e lore de item, mensagens de action bar — fica em JSON editável em config/GreatCosmetics/lang/. Não existe um toggle de "idioma" embutido: você edita os valores pro idioma, texto e cores que quiser.
Linhas de log de console não ficam aqui — elas continuam em inglês dentro do código.
Os arquivos
Um arquivo por área. As chaves são namespaced por arquivo (commands.reload.start, accessories.category.head, …).
| Arquivo | Cobre |
|---|---|
general.json |
Erros compartilhados, o fluxo do /gc reload, mensagens de licença |
commands.json |
Feedback de /gc * e /wardrobe * |
messages.json |
Chat / action-bar servidor → jogador (equipar, voo, tags, efeitos, skins, conversão de armadura, kick de join) |
items.json |
Nome-fallback do item cosmético, lore, linhas de atributo de Lure, tooltip do Scanner |
wardrobe.json |
Título da tela, nomes das abas, título do painel, os toggles da aba Preview |
accessories.json |
Nomes de categoria, "Clear All", placeholder de busca, toda linha de tooltip |
party.json |
Lista de Skins de Pokémon, modo preview, rótulos de pose / forma / shiny |
tags.json |
Cabeçalhos do menu de Tags, tooltips, rótulos de campo do editor |
backpack.json |
Título do seletor de mochila, o overlay "Page X/Y" |
devstudio.json |
Todo rótulo, divisor, botão e popup do Dev Studio |
Ao carregar, o mod preenche as chaves que faltam com os padrões em inglês e regrava o arquivo — os seus valores customizados nunca são sobrescritos. Chaves novas de updates futuros aparecem automaticamente.
Formatação — MiniMessage
Os valores são parseados com MiniMessage. Você pode usar:
| Recurso | Exemplo |
|---|---|
| Cores nomeadas | <red>, <gold>, <light_purple> |
| Cores hex | <#ff8800> |
| Gradientes | <gradient:#ff0000:#0000ff>Rainbow</gradient> |
| Decorações | <bold>, <italic>, <underlined>, <st> (riscado), <reset> |
| Hover | <hover:show_text:'<yellow>Clique pra copiar!'>...</hover> |
| Click | <click:copy_to_clipboard:'valor'>...</click> |
Os códigos legados ainda funcionam como fallback — &a, &l, §c e &#rrggbb são convertidos automaticamente antes do parse. Então &a&lTESTE renderiza verde e negrito.
Mensagens de chat suportam hover/click de verdade; texto de GUI é desenhado com o renderer legado, então hover/click lá é ignorado, mas cores (inclusive hex) continuam valendo.
Placeholders
Alguns valores têm tokens {nome} que o mod substitui em runtime, ex:
"commands.give.received": "<green>Você recebeu o cosmético: <white>{item}",
"messages.cosmetic.slot_limit": "<red>[!] Você atingiu o limite de itens no slot {slot} (Limite: {limit})."
Mantenha o token escrito exatamente ({item}, {slot}, {limit}, {id}, {player}, {value}, …) — se remover, a substituição só não acontece.
Exemplo
// accessories.json
"accessories.category.head": "<gradient:#a855f7:#6d28d9><bold>Cabeça</bold></gradient>",
"accessories.tooltip.fly": " <yellow>✦ <white>Concede Voo"
/gc reload, reabra o guarda-roupa — a categoria Cabeça renderiza com um gradiente roxo.
Cliente vs. servidor
Cliente e servidor leem cada um a sua própria pasta config/GreatCosmetics/lang/ do disco — não há sync por rede. Distribua a mesma pasta lang/ com o seu modpack. Se elas divergirem, a GUI usa a cópia do cliente e o chat usa a do servidor.
Migrando um lang.json antigo
Builds mais antigas usavam um único config/GreatCosmetics/lang.json. No primeiro boot de uma build nova o mod importa os valores que você customizou lá pros novos arquivos divididos (com os nomes de chave novos) e renomeia o arquivo antigo pra lang.json.migrated.