# Troubleshooting Guide

## Error Codes

{% hint style="info" %}

#### Info

If you encounter an error code not listed below, please open a support ticket in the [Codesign Discord](https://discord.gg/codesign) for assistance.
{% endhint %}

### Server

* <mark style="color:red;">**0886**</mark>**&#x20;-** The `GetIdentifier` function in the `configs/server_customise_me.lua` is returning a nil value instead of a string containing the player's identifier.
* <mark style="color:red;">**0887**</mark>**&#x20;-** The package variable in the database is returning a nil value instead of a string containing the product name(s) of the player's purchase.
* <mark style="color:red;">**0888**</mark>**&#x20;-** The name of the package which was purchased on your Tebex store does not match with any of the packages in your Config.TebexListings. The name of the wrongly named package will be visible in the error message.
* <mark style="color:red;">**4454**</mark> - This means a player is trying to use the `"tebex_purchase"`. This command is only supposed to be triggered from the server-side by tebex when a player makes a purchase on your tebex store.
* <mark style="color:red;">**7742**</mark> - This could mean you are triggering the `"tebex_purchase"` from the server console, which you shouldn't be. This command is only supposed to be triggered from the server-side by tebex when a player makes a purchase on your tebex store. The other reason is that tebex is not sending the correct data due to "Configure Resource" step  not being completed correctly.
* <mark style="color:red;">**0811**</mark> - This means the number of display vehicles you have configured to be on display in `Config.DisplayVehicles.RandomizeVehicles.display_vehicle_count`, is higher than the number of possible vehicle locations in `Config.DisplayVehicles.VehicleCoords['manually_set']`.
* <mark style="color:red;">**0822**</mark> - This means the number of display vehicles you have configured to be on display in `Config.DisplayVehicles.Vehicles`, is higher than the number of possible vehicle locations in `Config.DisplayVehicles.VehicleCoords['manually_set']`.

## Common Issues

Please check out our [**Self Debugging Guide**](https://docs.codesign.pro/coding-information/self-debugging#troubleshooting) before contacting our support.

🔔 <mark style="color:red;">**Folder Name**</mark> Make sure the name of the folder is `cd_vipshop`.

🔔 <mark style="color:red;">**Encrypted Files**</mark> Do not edit the encrypted files in any way.

<details>

<summary><mark style="color:red;"><strong>Can’t Redeem a Purchase?</strong></mark></summary>

**Example:**\
A player has purchased a product from your Tebex store, but cannot redeem it in-game after **10 minutes**.

**Possible Reasons:**

* The `sv_tebexSecret` key is active on **another server** (test/dev/localhost), causing Tebex to send data to the wrong server
* The Tebex command is set to **“Only execute when the player is online”**, and the player was offline at the time of purchase
* Tebex may be experiencing temporary issues

**Solution:**

1. Make sure `sv_tebexSecret` is **only** set on your live server
2. Edit the Tebex product command and set **“Require Player To Be Online”** to **“Execute the command even if the player is offline.”**
3. Restart your server after any changes
4. If the issue persists, wait and try again

</details>

<details>

<summary><mark style="color:red;"><strong>Tebex Secret Key?</strong></mark></summary>

**Example:**\
You see this error in your server console:

```
[cd_donatorshop] - Unable To Start (sv_tebexSecret is nil)
```

**Reason:**\
**Step 5** has not been completed correctly.

**Solution:**

* Make sure `sv_tebexSecret` is set in your **server config**
* Restart the server after adding it

</details>

<details>

<summary><mark style="color:red;"><strong>Redeemed 0 Balance?</strong></mark></summary>

**Example:**\
A player redeems a purchase, but the notification shows **0 balance** instead of the expected amount.

**Reason:**\
The **product name** on your Tebex store does not **exactly match** the `ProductName` in `Config.TebexListings`.

**Solution:**

* Make sure both names match **exactly**
* Check **capital letters, spaces, and punctuation**

</details>

<details>

<summary><mark style="color:red;"><strong>Not All Display Vehicles Spawned?</strong></mark></summary>

**Example:**\
Some display vehicles stop spawning and the vehicle UI is no longer visible.

**Reason:**\
One of the vehicle **models** in the `Config.Vehicle` table (`configs/config.lua`) has an **incorrect spawn name**.

**Solution:**

* Check the **model spawn names** for all vehicles
* The issue is usually the vehicle **listed after the last one that spawned correctly**
* Fix the spawn name and restart the script

</details>


---

# 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://docs.codesign.pro/paid-scripts/vip-shop/troubleshooting-guide.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.