Config Principal
O arquivo config/GreatCosmetics/mainconfig.conf guarda as configurações gerais do servidor: slots virtuais, tipos de acessório, banco de dados, resource pack forçado e comandos de boot. Ele é gerado no primeiro boot e regravado (com as chaves que faltarem preenchidas) toda vez que carrega.
Aplique mudanças com /gc reload.
Template Padrão
{
"autoDetectModels": true,
"compactStatusBars": true,
"lureHud": true,
"devModePermission": "gc.perm.devmode",
"tagGroupBlacklist": ["default"],
"useMySQL": false,
"mysqlHost": "localhost",
"mysqlPort": 3306,
"mysqlDatabase": "greatcosmetics",
"mysqlUser": "root",
"mysqlPassword": "password",
"slots": {
"HEAD": { "defaultLimit": 1, "permission": "gc.slot.head" },
"FACE": { "defaultLimit": 1, "permission": "gc.slot.face" },
"NECK": { "defaultLimit": 1, "permission": "gc.slot.neck" },
"CHEST": { "defaultLimit": 1, "permission": "gc.slot.chest" },
"BACK": { "defaultLimit": 1, "permission": "gc.slot.back" },
"WAIST": { "defaultLimit": 1, "permission": "gc.slot.waist" },
"LEGS": { "defaultLimit": 1, "permission": "gc.slot.legs" },
"FEET": { "defaultLimit": 1, "permission": "gc.slot.feet" },
"HAND": { "defaultLimit": 1, "permission": "gc.slot.hand" }
},
"types": {
"necklace": { "slot": "NECK", "limitPerPlayer": 1, "permission": "gc.type.necklace" },
"scarf": { "slot": "NECK", "limitPerPlayer": 1, "permission": "gc.type.scarf" }
},
"forceTexture": false,
"textureId": "greatcosmetics",
"textureUrl": "",
"textureSha1": "",
"startupCommands": []
}
Parâmetros
1. Modelos
autoDetectModels(padrãotrue) — deixa o mod escanear o resource pack e gerar automaticamente os overrides de Custom Model Data no item fantasma. Deixe ligado a menos que você monte o JSON de modelo do item na mão.
2. HUD
Os dois são toggles visíveis no client, sincronizados do servidor; muda aqui e /gc reload.
compactStatusBars(padrãotrue) — quando a vida ou armadura máxima de um player passa de duas fileiras cheias (20 pontos), o HUD mostra uma barra + um multiplicadorxNem vez de empilhar fileiras achatadas (vida) ou cortar o excedente (armadura). É só visual, e só dispara se algum player de fato tiver >20 de vida/armadura máxima por atributo ou equipamento — num servidor de stats vanilla nunca aparece.false= barras 100% vanilla.lureHud(padrãotrue) — mostra a HUD de cosméticos no canto inferior esquerdo: uma lista agrupada de tudo que os cosméticos equipados dão (habilidades, atributos, efeitos de poção, Lure, pesca, scanner), fundo transparente, encolhe sozinha se fica grande. Some quando nada está ativo, quando o HUD está escondido (F1) ou com uma GUI aberta. Ver Cobblemon Effects.
3. Dev Mode
devModePermission(padrãogc.perm.devmode) — o node de permissão que dá o bypass de Dev Mode (equipar qualquer cosmético pra teste sem possuir). Mude se quiser outro nome de node.
4. Blacklist de Grupos de Tag
tagGroupBlacklist— nomes de grupo do LuckPerms que nunca são importados como Tags de chat (sem case-sensitive). Adicione grupos internos/administrativos aqui pra eles não sujarem o menu de Tags.defaultjá vem na lista. Ver Tags.
5. Banco de Dados
useMySQL(padrãofalse) —falseusa o arquivo SQLite local embutido (config/GreatCosmetics/database.db).trueconecta no servidor MySQL abaixo.mysqlHost/mysqlPort/mysqlDatabase/mysqlUser/mysqlPassword— dados de conexão, usados só quandouseMySQLétrue.
Explicação completa em Armazenamento (Banco de Dados).
6. Slots
slots mapeia cada um dos nove nomes de slot virtual pra:
defaultLimit— quantos cosméticos um jogador normal pode usar nesse slot.permission— o node base pro sistema de tiers de limite (<base>.<N>,<base>.bypass). Ver Slots & Tipos.
Você pode remover slots que não quer, mas os nove nomes acima são os únicos válidos.
7. Tipos
types é um mapa livre — a chave é o nome do tipo que você vai digitar no campo Type de um cosmético. Cada tipo tem:
slot— informativo; a qual slot virtual esse tipo pertence.limitPerPlayer— máximo de cosméticos desse tipo que um jogador pode usar ao mesmo tempo.permission— node base pros tiers<base>.<N>/<base>.bypass.
8. Resource Pack Forçado
O mod envia o pack sozinho no join e no /gc reload (sem restart pra trocar URL/hash), e mantém o server.properties sincronizado pra que um login vanilla puro também receba:
forceTexture(padrãofalse) — habilita o envio do pack no join e no/gc reload.textureId— qualquer texto; identifica o pack pro cliente (não precisa ser um UUID).textureUrl— um link de download direto do.zipdo pack.textureSha1— deixe em branco; o mod calcula o SHA-1 real automaticamente. Só preencha se você hospeda em algum lugar que exige um valor fixo.
Sincronização com server.properties. Num servidor dedicado, toda vez que esses campos são salvos (Dev Studio → Server Config, /gc reload, ou o recálculo automático do SHA-1) o mod escreve resource-pack, resource-pack-sha1 e resource-pack-id no server.properties, e ajusta o require-resource-pack pra bater com o forceTexture. No boot, se o mainconfig.conf ainda não tem textureUrl mas o server.properties já tem um resource-pack, o mod importa (URL + sha1 + id) e liga o forceTexture. Desligar o forceTexture só zera o require-resource-pack — as linhas resource-pack ficam onde estão. O server.properties só é relido pelo servidor no boot, então uma mudança feita com ele ligado só vale pro login vanilla no próximo restart (o envio ao vivo do próprio mod já cobre a sessão em andamento).
Ver Resource Pack.
9. Comandos de Boot
startupCommands— lista de comandos rodados como console alguns segundos depois de o servidor terminar de iniciar (mais tarde que oSERVER_STARTED, pra mods/plugins lentos já estarem prontos). Exemplo:
"startupCommands": [ "lp group vip permission set gc.slot.head.3 true" ]
A página Server Config do Dev Studio edita essa lista dentro do jogo.