> For the complete documentation index, see [llms.txt](https://star-generator.gitbook.io/star-generator-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://star-generator.gitbook.io/star-generator-docs/configuration/item-paths.md).

# item paths

StarGenerator uses item path strings to build items in table, recipe, energy, GUI, upgrade, and vanilla-crafting configuration.

## Supported Path Styles

| Path style                 | Example                                     |
| -------------------------- | ------------------------------------------- |
| Minecraft material         | `minecraft:coal:0`                          |
| ItemsAdder                 | `itemsadder:starter_icecream:vanilla_scoop` |
| Legacy ItemsAdder spelling | `itemadder:starter_icecream:vanilla_scoop`  |
| Nexo                       | `nexo:vanilla_scoop`                        |
| Oraxen                     | `oraxen:vanilla_scoop`                      |
| MMOItems                   | `mmoitems:<type>:<id>`                      |
| StarGenerator table output | `table:Starter_IceCream:frostcraft.yml`     |
| Item group                 | `@group:Starter_IceCream:icecream_outputs`  |
| Saved item                 | Path created by `/sg saveitem <name>`       |

## Starter Provider Fallbacks

Starter tables use ItemsAdder-style paths by default:

```
itemsadder:starter_icecream:<id>
```

For the `starter_icecream` namespace, StarGenerator can fall back to equivalent Nexo and Oraxen paths:

```
nexo:<id>
oraxen:<id>
```

This means a starter table can use `itemsadder:starter_icecream:milk_bucket` in YAML while still working on a server that uses Nexo or Oraxen instead of ItemsAdder, as long as the matching starter resources were generated for that provider.

Native provider paths are also valid:

```
nexo:milk_bucket
oraxen:milk_bucket
```

## StarGenerator Table Items

Use a table item path when a recipe should output a StarGenerator table item:

```yaml
items:
  machine:
    chance: 1
    type: "table:Starter_IceCream:frostcraft.yml"
    amount: 1
```

Accepted table prefixes include:

```
table:
sg:
sg:table:
stargenerator:
stargenerator:table:
stargenerator_table:
```

The WebUI can drag StarGenerator tables from the item catalog into a recipe output slot and will fill the table output fields automatically.

## Exact-Meta Items

If a recipe ingredient must match custom metadata exactly, use a provider item path or a saved item.

For one-off custom server items, hold the item and run:

```
/sg saveitem <name>
```

Then use the saved item path in recipe or energy config.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://star-generator.gitbook.io/star-generator-docs/configuration/item-paths.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.