Configuration

Configuration

Applies to all versions. NeoForge and Fabric store the same options in different files; the legacy NeoForge 26.2 betas use an older set of options (see the end of the page).

Where the options live

Build	File(s)	Notes
NeoForge (1.21.1, 26.1.2, 26.2.0.57, 26.3)	config/armor_cosmetic/client.toml and config/armor_cosmetic/common.toml	Standard NeoForge config files. On the 26.x builds they can also be edited in-game from the mod list (Config button); the 1.21.1 build has no config screen.
Fabric (all versions)	config/armor_cosmetic.json	One JSON file, read when the game or server starts: restart after editing it. Each option has a _comment_<option> entry that tells whether it is [Client] or [Common].

Client options only change your own screen. Common options are read on both the server and the client; on a server, set them in the server's config.

Fabric file details

• The file is created with the default values on the first launch, and rewritten when options are missing, so new options appear with their default value.
• Integer values outside their allowed range are clamped when the file is loaded.
• On the 26.1.2, 26.2 and 26.3 Fabric builds the file has a configVersion entry (currently 2). A file without it, or with an older value, is discarded and written again with the defaults. The 1.21.1 Fabric build has no configVersion.

Options

Client

Option	Default	Description
CosArmorGuiButton_Hidden	false	Hide the cosmetic armor button in the survival inventory.
CosArmorGuiButton_Left	75	Horizontal position of that button, in pixels from the left edge of the inventory.
CosArmorGuiButton_Top	50	Vertical position of that button, in pixels from the top edge of the inventory.
CosArmorToggleButton_Hidden	false	Hide the rendering toggle button.
CosArmorToggleButton_Left	77	Horizontal position of the rendering toggle.
CosArmorToggleButton_Top	45	Vertical position of the rendering toggle.
CosArmorCreativeGuiButton_Hidden	false	Hide the cosmetic armor button in the creative inventory.
CosArmorCreativeGuiButton_Left	95	Horizontal position of the creative button.
CosArmorCreativeGuiButton_Top	38	Vertical position of the creative button.

Common

Option	Default	Description
CosArmorKeepThroughDeath	false	Keep cosmetic items in their slots when the player dies (see Death and storage).
CosArmorDisableRecipeBook	true	Hide the recipe book in the cosmetic inventory.
CosArmorDisableCosHatCommand	false	Do not register the /coshat command (see Commands). Takes effect the next time the world or server starts.

Example (Fabric 26.x)

{
  "configVersion": 2,
  "CosArmorGuiButton_Hidden": false,
  "CosArmorGuiButton_Left": 75,
  "CosArmorGuiButton_Top": 50,
  "CosArmorKeepThroughDeath": false,
  "CosArmorDisableRecipeBook": true,
  "CosArmorDisableCosHatCommand": false
}

(Only some options are shown; the real file also contains the _comment_ entries and the remaining options.)

Legacy 26.2 betas

The NeoForge 26.2.0.32, 26.2.0.37 and 26.2.0.45 betas register a single client config, config/armor_cosmetic-client.toml, with these options:

Option	Default
CosArmorGuiButton_Hidden / _Left / _Top / _Width / _Height	false / 76 / 7 / 20 / 20
CosArmorToggleButton_Hidden / _Left / _Top / _Width / _Height	true / 76 / 22 / 10 / 10
CosArmorCreativeGuiButton_Hidden / _Left / _Top / _Width / _Height	false / 127 / 7 / 60 / 12
SkinArmorToggle_Left / _Top / _Spacing / _Width / _Height	98 / 55 / 18 / 5 / 5
CosArmorDisableRecipeBook	true
CosArmorDisableCosHatCommand	true

There is no CosArmorKeepThroughDeath option on these builds.