> ## Documentation Index
> Fetch the complete documentation index at: https://perplayerkit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Kit room and public kits in config.yml

> The kitroom and publickits blocks: page names, page icons, and the id, name and icon of every public kit.

Neither block holds items; contents are saved in game.

## kitroom

Choose 1 to 99 pages. Up to seven page buttons fit directly in the bottom row.
With eight or more pages, arrows switch between groups of five page buttons.

```yaml config.yml theme={null}
kitroom:
  pages: 5
  items:
    1:
      name: Crystal
      material: END_CRYSTAL
    2:
      name: Armory
      material: NETHERITE_SWORD
    3:
      name: Potions
      material: SPLASH_POTION
    4:
      name: Arrows
      material: TIPPED_ARROW
    5:
      name: Utility
      material: COBWEB
```

Add optional names and icons under `items` using page numbers such as `6`. Extra pages start empty and default to a chest icon. See [Add more pages](/kit-room#add-more-pages).

## publickits

Nine kits ship in the default config.

```yaml config.yml theme={null}
publickits:
  crystal:
    name: Crystal
    icon: END_CRYSTAL
  mace:
    name: Mace
    icon: MACE
  netherite:
    name: Netherite OP
    icon: NETHERITE_SWORD
  pot:
    name: Pot
    icon: SPLASH_POTION
  uhc:
    name: UHC
    icon: GOLDEN_APPLE
  sword:
    name: Sword
    icon: DIAMOND_SWORD
  axe:
    name: Axe
    icon: DIAMOND_AXE
  ffa:
    name: FFA
    icon: ENCHANTED_GOLDEN_APPLE
  cart:
    name: Cart
    icon: TNT_MINECART
```

The <Tooltip tip="In YAML, the name to the left of the colon.">key</Tooltip> is the kit id. Add your own by copying a block.

Fill the contents with [`/perplayerkit autosetup`](/commands/admin#set-the-server-up-quickly), or save them yourself with `/savepublickit`. See [Public kits](/features/public-kits).

<Note>
  A kit whose `icon` material does not exist on the server is skipped rather than shown empty. This hides `mace` on versions whose API has no `MACE` material.
</Note>