Skip to content

Main Config


The file config/GreatCosmetics/mainconfig.conf holds server-wide settings: virtual slots, accessory types, the database, the forced resource pack and startup commands. It is generated on first startup and re-saved (with any missing keys filled in) every time it loads.

Apply changes with /gc reload.


Default Template

{
  "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": []
}

Parameters

1. Models

  • autoDetectModels (default true) — lets the mod scan the resource pack and auto-generate the Custom Model Data overrides on the ghost item. Leave this on unless you build the item model JSON by hand.

2. HUD

Both are client-visible toggles synced from the server; change them here and /gc reload.

  • compactStatusBars (default true) — when a player's maximum health or armor goes past two full rows (20 points), the HUD shows one bar plus an xN multiplier instead of stacking squashed rows (health) or clipping the overflow (armor). Purely visual, and it only ever triggers if a player actually has >20 max health/armor from attributes or equipment — a vanilla-stats server never sees it. Set false for 100% vanilla bars.
  • lureHud (default true) — shows the cosmetic HUD in the bottom-left corner: a grouped list of everything the equipped cosmetics grant (abilities, attributes, potion effects, Lure, fishing, scanner), transparent background, auto-shrinking if it gets tall. Hidden when nothing is active, when the HUD is hidden (F1), or while a GUI is open. See Cobblemon Effects.

3. Dev Mode

  • devModePermission (default gc.perm.devmode) — the permission node that grants the Dev Mode bypass (equip any cosmetic for testing without owning it). Change it if you want a different node name.

4. Tag Group Blacklist

  • tagGroupBlacklist — LuckPerms group names that are never imported as chat Tags (case-insensitive). Add internal/administrative groups here so they don't clutter the Tags menu. default is blacklisted out of the box. See Tags.

5. Database

  • useMySQL (default false) — false uses the built-in local SQLite file (config/GreatCosmetics/ … greatcosmetics.db). true connects to the MySQL server below.
  • mysqlHost / mysqlPort / mysqlDatabase / mysqlUser / mysqlPassword — connection details, used only when useMySQL is true.

Full explanation on Storage (Database).

6. Slots

slots maps each of the nine virtual slot names to:

  • defaultLimit — how many cosmetics a normal player can wear in that slot.
  • permission — the base node for the tiered limit system (<base>.<N>, <base>.bypass). See Slots & Types.

You can remove slots you don't want, but the nine names above are the only valid ones.

7. Types

types is a free-form map — the key is the type name you'll type into a cosmetic's Type field. Each type has:

  • slot — informational; which virtual slot this type belongs to.
  • limitPerPlayer — max cosmetics of this type a player may wear at once.
  • permission — base node for <base>.<N> / <base>.bypass tiers.

8. Forced Resource Pack

The mod pushes the pack itself on join and on /gc reload (no restart needed for a URL/hash change), and keeps server.properties in sync so a plain vanilla login still gets it:

  • forceTexture (default false) — enable pushing the pack on join and on /gc reload.
  • textureId — any string; identifies the pack to the client (does not need to be a UUID).
  • textureUrl — a direct download link to the .zip pack.
  • textureSha1 — leave blank; the mod computes the real SHA-1 automatically. Only set it if you host somewhere that needs a fixed value.

server.properties sync. On a dedicated server, whenever these fields are saved (Dev Studio → Server Config, /gc reload, or the automatic SHA-1 refresh) the mod writes resource-pack, resource-pack-sha1 and resource-pack-id into server.properties, and sets require-resource-pack to match forceTexture. On boot, if mainconfig.conf has no textureUrl yet but server.properties already has a resource-pack, the mod imports it (URL + sha1 + id) and turns forceTexture on. Turning forceTexture off only clears require-resource-pack — the resource-pack lines are left in place. server.properties is only re-read by the server at boot, so a change made while it's running takes effect for vanilla login on the next restart (the mod's own live push already covers the running session).

See Resource Pack.

9. Startup Commands

  • startupCommands — a list of commands run as console a few seconds after the server finishes starting (later than SERVER_STARTED, so mods/plugins that load slowly are ready). Example:
"startupCommands": [ "lp group vip permission set gc.slot.head.3 true" ]

The Dev Studio → Server Config page can edit this list in-game.