> For the complete documentation index, see [llms.txt](https://envi-scripts-organization.gitbook.io/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://envi-scripts-organization.gitbook.io/documentation/premium-scripts/envi-shops.md).

# Envi-Shops

Envi-Shops Official Documentation

***

## Prerequisites

{% hint style="info" %}

* A working FiveM Server
* Basic understanding of FiveM server setup and resource management
* An up-to-date version of [ox\_lib](https://github.com/CommunityOx/ox_lib)
* Followed the [FIRST STEPS (READ FIRST)](/documentation/premium-scripts/first-steps-read-first.md) guide
* `envi-bridge`
* `envi-interact` or a target stack if you switch interactions
* the packaged assetpacks
* Inventory items that match your shop stock
  {% endhint %}

***

## [Tebex](https://envi-scripts.tebex.io/package/6305049)

***

## What this adds

Envi-Shops adds convenience stores with shelf stock, basket flow, checkout animations, and server-side stock control.

Core systems:

* shopkeeper peds
* baskets and basket props
* shelf and counter stock
* checkout flow
* per-shop enable and disable state
* receipt and tax integration
* server stock exports

### Install

{% stepper %}
{% step %}

### Follow the base load order

Follow [FIRST STEPS (READ FIRST)](/documentation/premium-scripts/first-steps-read-first.md) for the correct load order.

Then verify `envi-interact`, `ox_lib`, and the packaged assetpacks are already running before you test this resource.
{% endstep %}

{% step %}

### Choose the interaction mode

Set `Config.Interactions` to:

* `envi-interact`
* or `target`

That value must match your live stack.
{% endstep %}

{% step %}

### Align the stock

Every stock key must match a real inventory item on your server.

Replace placeholder item names before live testing.
{% endstep %}

{% step %}

### Set the live flags

Review these first:

* `Config.Debug = false`
* `Config.UseEnviReceipts`
* `Config.UseApGovernmentTax`
* `Config.DefaultTaxPercentage`
  {% endstep %}
  {% endstepper %}

### Items and inventory

This script does **not** create framework items for you.

The default stock in the config uses placeholder item names. Replace them with names that already exist on your server.

Good starting examples:

* `water`
* `beer`
* `coffee`
* `rolling_paper`
* `sandwich`
* `twerks_candy`
* `snikkel_candy`
* `grape`
* `grapejuice`
* `vodka`
* `whiskey`
* `tosti`
* `cleaningkit`
* `repairkit`

Use the full notes on [Inventory Setup](/documentation/premium-scripts/envi-shops/inventory-setup.md).

### Runtime stock and shop keys

Each shop key in `Config.Shops` is the exact string used by stock exports and cooldown exports.

Use the config key itself, not the blip name.

### Docs in this section

* [Common Issues](/documentation/premium-scripts/envi-shops/common-issues.md)
* [Inventory Setup](/documentation/premium-scripts/envi-shops/inventory-setup.md)
* [Systems Overview](/documentation/premium-scripts/envi-shops/systems-overview.md)
* [Exports](/documentation/premium-scripts/envi-shops/exports.md)
* [Editable Functionality](/documentation/premium-scripts/envi-shops/editable-functionality.md)

### Troubleshooting

* If prompts do not show, check `Config.Interactions` first.
* If purchases fail, your item names usually do not exist in your inventory.
* If peds or shelves fail, confirm the shop is enabled and coordinates are correct.
* For more fixes, see [Common Issues](/documentation/premium-scripts/envi-shops/common-issues.md).

***

## Preview

{% embed url="<https://www.youtube.com/watch?v=9WCbO6OyG3w>" %}