Ir para o conteúdo

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ão true) — 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ão true) — quando a vida ou armadura máxima de um player passa de duas fileiras cheias (20 pontos), o HUD mostra uma barra + um multiplicador xN em 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ão true) — 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ão gc.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. default já vem na lista. Ver Tags.

5. Banco de Dados

  • useMySQL (padrão false) — false usa o arquivo SQLite local embutido (config/GreatCosmetics/database.db). true conecta no servidor MySQL abaixo.
  • mysqlHost / mysqlPort / mysqlDatabase / mysqlUser / mysqlPassword — dados de conexão, usados só quando useMySQL é 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ão false) — 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 .zip do 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 o SERVER_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.