# Item Builder

### 🛠️ Universal Item Configuration

All **Aliien** plugins utilize a unified item-building engine powered by **AliienCore**. This allows for consistent and advanced customization across all menus, including resource pack support and attribute masking.

***

### 📦 Configuration Fields

| Field        | Type    | Description                                                               |
| ------------ | ------- | ------------------------------------------------------------------------- |
| `material`   | String  | A valid Bukkit Material (e.g., `DIAMOND_SWORD`, `PAPER`).                 |
| `name`       | String  | The display name of the item. Supports all formatting types.              |
| `lore`       | List    | A list of lines displayed under the name.                                 |
| `model-data` | Integer | **(Optional)** The `CustomModelData` ID for resource packs. Default: `0`. |
| `item-flags` | List    | **(Optional)** List of flags to hide specific item tooltips.              |
| `glow`       | Boolean | **(Optional)** Set if the item should glow or not.                        |

***

### 🚩 Item Flags

Item flags allow you to hide specific parts of an item's tooltip (like "Attack Damage" or "Enchantment" text) to keep your GUIs looking clean and professional.

**Commonly Used Flags:**

* **`HIDE_ATTRIBUTES`**: Hides damage, armor, and speed stats.
* **`HIDE_ENCHANTS`**: Hides enchantment names and levels.
* **`HIDE_ADDITIONAL_TOOLTIP`**: Hides various other tooltips like potion effects or armor trims.

🔗 [**Click here to view all available Item Flags**](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/inventory/ItemFlag.html)

***

### 📝 Example YAML Block

This example shows a high-end item configuration using the new features:

```yaml
example_item:
  material: DIAMOND_SWORD
  name: "<#00ffcc><bold>Special Sword"
  # Makes the item glow
  glow: true
  # This individual lore overrides global defaults where applicable
  lore:
    - "<gray>A unique item for your collection."
    - ""
    - "<yellow>▶ Click to select"
  # Custom Model Data for resource pack users
  model-data: 1001
  # Hiding attributes and enchants to keep the GUI clean
  item-flags:
    - "HIDE_ATTRIBUTES"
    - "HIDE_ENCHANTS"
```

> **Note:** If a field like `lore`, `model-data`, or `item-flags` is missing from a specific item configuration, the plugin will automatically fall back to its internal default or global configuration setting. In some plugins, the name of these fields may have slightly different names (for example, in AliienChatColor you have a "lore" and a "lore-without-perm")


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://aliien.gitbook.io/aliien-docs/all-plugins/item-builder.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.