> For the complete documentation index, see [llms.txt](https://arivia.rlib.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://arivia.rlib.io/developers/entities/level.md).

# ▸level

## Alias

&#x20;           *`level, lvl`*

## Source

&#x20;           *`added in Arivia v3`*

## Requires

&#x20;           *`compatible level / xp addon`*

## Type

&#x20;           *`integer`*

## Info

Providing the **level** field to an entity will force players to be that particular level before they can buy the item.

## Example

{% tabs %}
{% tab title="addentities.lua" %}

```lua
DarkRP.createEntity( 'Tip Jar',
{
    ent         = 'darkrp_tip_jar',
    model       = 'models/props_lab/jar01a.mdl',
    price       = 5,
    max         = 2,
    cmd         = 'tipjar',
    level       = 4,
} )
```

{% endtab %}

{% tab title="alias" %}

```lua
DarkRP.createEntity( 'Tip Jar',
{
    ent         = 'darkrp_tip_jar',
    model       = 'models/props_lab/jar01a.mdl',
    price       = 5,
    max         = 2,
    cmd         = 'tipjar',
    lvl         = 4,
} )
```

{% endtab %}
{% endtabs %}

## Output

If a player views an entity with a level requirement that the player does not meet; the entity will be faded in the menu:

![Example of entity when player does not have needed level requirement](/files/-MK-jDpC7Z5fZ-58zU45)

The player will also be given an error message:

![Example of selected entity when player does not have needed level requirement](/files/-MK-jG0be3brsvoNYSvj)

\
Notes <a href="#notes" id="notes"></a>
--------------------------------------

If you wish to enable or disable the level plugin all-together on Arivia; you must open **lua\modules\arivia\cfg\sh\_13\_plugins.lua** and modify `cfg.plugins.levels`
