> For the complete documentation index, see [llms.txt](https://lavandula-collective.gitbook.io/site/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://lavandula-collective.gitbook.io/site/citl/citl-cit-ledger.md).

# CITL (CIT Ledger)

<p align="center"><img src="https://4176630171-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWAWLoHjLGTPQJHo99559%2Fuploads%2FrsRKJ8bsHj0BAdenX0Hk%2Ficon.png?alt=media&amp;token=e1dec7b6-92c1-42b2-9883-d407cb7ad9f7" alt=""></p>

**CITL** is a client/server-side mod that provides an in-game menu for browsing installed **OptiFine/CIT Resewn** CIT packs.

{% hint style="warning" %}
**This doesn't work with modern vanilla CITs!** Introduced in Minecraft 1.21.4, which replaced the old item model override system with the new item model definitions.
{% endhint %}

<figure><img src="https://4176630171-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWAWLoHjLGTPQJHo99559%2Fuploads%2FG6XcHQvvS0AhYt1fLqd0%2FScreenshot%202026-08-26%20at%205.40.12%E2%80%AFAM.png?alt=media&amp;token=55992f14-f009-469b-8189-11ff1e87782b" alt=""><figcaption><p>Credits: Ghoulcraft CIT</p></figcaption></figure>

### Features

* **Interactive Catalog:** Live preview and inspection of loaded CIT items across all active resource packs.
* **Multi-Mode Search:** Target queries by `General`, `Item ID`, `Custom Name`, or `Pack Name`.
* **Favorites System:** Pin frequently used assets to the top of the index.
* **Direct Actions:** Context menu support to copy display strings or execute `/give` commands.
* **Diagnostics:** Filter invalid `.properties` definitions and naming collisions across packs.
* **Configurable:** Persistent search queries, audio feedback toggles, and animation controls via ModMenu.

### Command reference

| **Open Screen**  | `G` (default)     | Opens the CITL Screen/Ledger                                |
| ---------------- | ----------------- | ----------------------------------------------------------- |
| **Inspect**      | `Left Click`      | Loads model preview, base item ID, and source pack details  |
| **Give Item**    | `Double Click`    | Dispatches `/give` command with item components applied     |
| **Favorite**     | `Click Star`      | Toggles pinned status for the selected entry                |
| **Context Menu** | `Right Click` row | Opens quick actions (`Copy Name` / `Give Item`)             |
| **Filter Mode**  | `Click Mode`      | Cycles between `General`, `Item`, `Name`, and `Pack` scopes |
| **Clear Search** | `Right Click` bar | Clears active query string                                  |
| **Settings**     | `Click Gear`      | Opens configuration screen                                  |

### Configuration

* **Search & UI:** Query persistence, search mode memory, right-click clear toggle, and animation controls.
* **Audio Feedback:** Independent toggles for give, copy, clear, and error sound effects.
* **Diagnostics:** Visibility toggles for broken definitions and conflicting item names.

### Report an issue

Report bugs and feature requests through [GitHub Issues](https://github.com/aerhazu/CITL/issues).

### License

This project uses the [Apache License 2.0](http://www.apache.org/licenses/). Feel free to include into your modpacks with credits.