> 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/citx/citx.md).

# CITX (CIT Extension)

<h2 align="center"><img src="https://296404500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYFKPHjDb6bIm7gCTbAc3%2Fuploads%2FMu3smj8reCKe2oCYhKPz%2FCITX.png?alt=media&amp;token=a712715a-1c2d-479a-aaae-2a5a670ebd0d" alt=""></h2>

**CITX** is a client-side mod for renaming CIT items.

Use a command to add or swap an extension. You can also replace or reset the full item name.

{% hint style="warning" %}
**After every command, open and close your inventory. This refreshes the item name in the world.** Minecraft controls this client-side update behavior.
{% endhint %}

### Features

* Rename items with commands.
* Swap extensions without stacking them.
* Replace a display name or restore the default name.
* Clean up malformed extensions automatically.
* Use CITX without server-side installation.

### Command reference

| Command                    | Alias                 | Description                     |
| -------------------------- | --------------------- | ------------------------------- |
| `/citx <input>`            | —                     | Adds or swaps an extension.     |
| `/citx extend <extension>` | `/citx e <extension>` | Adds or swaps an extension.     |
| `/citx rename <name>`      | `/citx r <name>`      | Replaces the full display name. |
| `/citx reset`              | `/citx x`             | Restores the default item name. |

### Commands

<details>

<summary>/citx extend</summary>

Adds or swaps an extension. The base name stays unchanged.

```
/citx extend <extension>
/citx e <extension> # Alias
/citx <input>        # Shortcut
```

Use `/citx <input>` when you need a quick extension change:

```
/citx red
Grass Block → Grass Block_red
```

Use the full command when it improves clarity:

```
/citx extend red
Grass Block → Grass Block_red
```

Running the command again replaces the extension. It never stacks extensions:

```
Grass Block_old
/citx e new
→ Grass Block_new        ✅
→ Grass Block_old_new    ❌ (never happens)
```

</details>

<details>

<summary>/citx rename</summary>

Replaces the full display name.

```
/citx rename <name>
/citx r <name>            # alias
```

**Example**

```
/citx rename Mystic Sword
→ Mystic Sword
```

</details>

<details>

<summary>/citx reset</summary>

Restores the default item name.

```
/citx reset
/citx x                   # alias
```

</details>

### Automatic cleanup

CITX handles extension formatting automatically:

* Collapses duplicate underscores
* Keeps only one extension at a time
* Adds a missing leading underscore
* Blocks malformed names before they happen

```
Stone__red → Stone_red
```

### Example workflow

```
Hold a Grass Block:

/citx blue              → Grass Block_blue
/citx green             → Grass Block_green
/citx r Emerald Trophy  → Emerald Trophy
/citx x                 → Grass Block
```

### Report an issue

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

### License

This project uses the [Apache License 2.0](http://www.apache.org/licenses/).