> ## Documentation Index
> Fetch the complete documentation index at: https://items.lodemc.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Free and licensed editions of Lode Items

> What the free version of Lode Items loads without a license key, what a license unlocks, and how to activate a key with /lodeitems activate.

Without a license key, Lode Items runs as the **free version**: everything works, but it loads only a limited amount of some kinds of content. A license unlocks everything. The plugin never switches itself off for want of a key.

| | Free | Licensed |
| - | - | - |
| [Items](https://items.lodemc.net/items.md) (`type: item`) | 20 | No limit |
| [Blocks](https://items.lodemc.net/blocks.md) (`type: block`) | 10 | No limit |
| [Flora](https://items.lodemc.net/flora.md) (plants, crops, saplings and trees) | 7 | No limit |
| [Glyphs](https://items.lodemc.net/glyphs.md) | 10 | No limit |
| [Sounds](https://items.lodemc.net/sounds.md) | 10 | No limit |
| [HUDs](https://items.lodemc.net/huds.md) | None | No limit |
| [Events and actions](https://items.lodemc.net/events.md) | Off | On |
| [3D armour](https://items.lodemc.net/armor/3d.md) | Worn with its flat textures | 3D |
| Props, fluids, paintings, recipes and everything else | No limit | No limit |

## What happens past the limit

* Content is counted in load order: files sorted by their path, entries from top to bottom. The first 20 items load, the 21st and later don't.
* Everything held back is listed in the console after every load, with its file and line. Staff (players with `lodeitems.command`) are told when they join.
* Recipes and trees that need something held back are skipped and listed too, instead of being reported as errors.
* `events:` on items, blocks and props are read, so mistakes in them are still reported, but they don't run.
* Music discs over the sound limit stay registered, but play no sound until a license is activated.

## Activating a license

```text theme={null}
/lodeitems activate <key>
```

The key is checked, and on success Lode Items reloads, so everything held back loads straight away. The key is kept in `plugins/LodeItems/mclicense.txt`, so it's checked again at every start.

`/lodeitems license` shows which edition is running.

> [!NOTE]
>
> If the key can't be checked when the server starts (a wrong key, or no internet connection), Lode Items runs as the free version until it can.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.