CosmeticTokenCountHUD

v4.0.0·Updated 2026-05-11

【Client MOD】Shows cosmetic token counts by rarity in the shop HUD.

About this mod Author’s original text

COMPATIBLE WITH COSMETICS UPDATE V0.4.0.

CosmeticTokenCountHUD

This mod is a client-only mod that shows your cosmetic token counts by rarity on the bottom-right of the shop screen.

It helps you quickly check how many Common, Uncommon, Rare, and UltraRare cosmetic tokens you currently have while using the cosmetic shop.

The mod only reads your local cosmetic token list and does not change token gain, token consumption, reward selection, currency conversion, or host-side gameplay logic.

Main Features

  • Shows cosmetic token counts by rarity while in the shop
  • Hides automatically outside the shop
  • Hides automatically when you have no cosmetic tokens, if enabled
  • Updates after token gain, token consumption, shop initialization, and cosmetic machine usage
  • Supports configurable HUD position, size, opacity, labels, display order, and rarity colors
  • Uses the in-game token colors by default
  • Runs as a local client-side HUD only

Installation

  • Install BepInEx 5.
  • Place CosmeticTokenCountHUD.dll into your BepInEx/plugins folder.
  • Start the game once to generate the config file.
  • Edit the config file if you want to change HUD position, colors, or text.

Notes

  • This is a Client MOD.
  • Other players do not need to install it.
  • It does not modify the actual cosmetic token data.
  • It does not control which token rarity is consumed.
  • It does not affect the host or other players.
  • The HUD is only created when needed and is destroyed when leaving the shop.

Config

General

| Setting | Description | Default | Minimum | Maximum |

|---|---|---:|---:|---:|

| Enable | Enables the HUD display | true | false | true |

| ShowDebugLog | Shows debug logs | false | false | true |

| RefreshIntervalSeconds | Refresh interval in seconds | 0.35 | 0.10 | 2.00 |

Display

| Setting | Description | Default | Minimum | Maximum |

|---|---|---:|---:|---:|

| ShowOnlyInShop | Shows the HUD only while you are in the shop | true | false | true |

| HideWhenNoToken | Hides the HUD when you have no cosmetic tokens | true | false | true |

| ShowZeroCountRarity | Shows rarity rows even when the count is zero | true | false | true |

| Anchor | HUD anchor position. Allowed values: TopLeft, TopRight, BottomLeft, BottomRight | BottomRight | Not applicable | Not applicable |

| OffsetX | Horizontal offset from the anchor | -40 | No fixed limit | No fixed limit |

| OffsetY | Vertical offset from the anchor | 160 | No fixed limit | No fixed limit |

| FontSize | Text font size | 18 | 8 | 48 |

| BackgroundOpacity | Background opacity | 0.35 | 0.00 | 1.00 |

| TextOpacity | Text opacity | 1.00 | 0.10 | 1.00 |

| SortingOrder | Canvas sorting order | 300 | 0 | 1000 |

Layout

| Setting | Description | Default | Minimum | Maximum |

|---|---|---:|---:|---:|

| LineSpacing | Spacing between lines | 4 | 0 | 24 |

| PaddingX | Horizontal padding | 12 | 0 | 60 |

| PaddingY | Vertical padding | 10 | 0 | 60 |

| Width | HUD width | 260 | 120 | 800 |

| AutoResizeWidth | Automatically widens the HUD when text is long | true | false | true |

| TextAlign | Text alignment. Allowed values: Left, Center, Right | Left | Not applicable | Not applicable |

| DisplayOrder | Rarity display order. Allowed values: LowToHigh, HighToLow, Vanilla, Custom | LowToHigh | Not applicable | Not applicable |

| CustomDisplayOrder | Custom display order when DisplayOrder is Custom | Common,Uncommon,Rare,UltraRare | Not applicable | Not applicable |

Text

| Setting | Description | Default | Minimum | Maximum |

|---|---|---|---|---|

| TitleText | HUD title text | Cosmetic Tokens | Not applicable | Not applicable |

| CommonLabel | Common rarity label | Common | Not applicable | Not applicable |

| UncommonLabel | Uncommon rarity label | Uncommon | Not applicable | Not applicable |

| RareLabel | Rare rarity label | Rare | Not applicable | Not applicable |

| UltraRareLabel | UltraRare rarity label | UltraRare | Not applicable | Not applicable |

Color

| Setting | Description | Default | Minimum | Maximum |

|---|---

Install & use Install: BepInEx plugin

  1. The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
  2. Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
  3. Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
  4. Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.

Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file.

Dependencies

Install these first, or the mod will not work:

BepInEx-BepInExPack

File & checksum

Filename
CosmeticTokenCountHUD-4.0.0.zip
File size
145.1 KiB