# Common issues & solutions

## 🖼️ Why You Can't See Your Placed Posters or Billboard Images

Are your **posters, banners, or billboard images/text** not appearing in-game —\
even though the upload succeeded or the placement message was sent?

Don’t worry — this guide explains **every possible reason** and how to fix it quickly.

***

### ⚙️ Overview

If your banner or poster isn’t showing up, it’s usually caused by one of the following:

* A **conflicting resource** disables or clears decals.
* Another script repeatedly calls **render-blocking natives**.
* **Graphics settings** or **shader mods** hide decal layers.
* The **resource start order** in your `server.cfg` is incorrect.

To help diagnose these issues faster, we’ve introduced a new debug command:

***

### 🧰 Banner Visibility Helper: `debug_banners_visible`

The `debug_banners_visible` feature acts as a **diagnostic guide**, helping you identify why banners, posters, or billboard images are not visible in-game.\
It does **not automatically fix issues**, but provides information to help you resolve them manually.

Use this helper in-game to review:

* Whether banners are properly loaded and visible on your client.
* Any detected conflicts or rendering problems that may prevent images from showing.

You can also **type this helper command in your txAdmin Live Console** to run it remotely for testing.

<figure><img src="/files/9pHAhBVmoEkYlrPgc901" alt="Result of command" width="254"><figcaption><p>Example output from the visibility helper</p></figcaption></figure>

💡 *Use this visibility helper first whenever your uploaded or placed banners don’t appear. It will point you toward the cause, such as resource conflicts, rendering issues, or missing permissions.*

***

### 🔎 What to Look For

If banners or posters still don’t appear after using the debug tools, check the following common causes:

* **Disable any “FPS booster”, “optimization”, or shader mods.**\
  These often call functions that remove or hide decals globally.
* **Check your graphics settings.**\
  Make sure **Texture Quality** and **Decal Quality** are **not set to Low** — low settings can prevent decals from rendering entirely.
* **Watch out for graphics mods or shader packs.**\
  Mods such as **NaturalVision Evolved (NVE)**, **Redux**, or similar packs can change material behavior and\
  **break decal rendering**, causing banners to disappear.\
  ➝ *Try testing without them enabled to confirm.*
* **Restart your client** after removing or reordering conflicting resources.\
  Some changes only take effect after a full client restart.

If banners reappear after disabling a mod or resource, you’ve found the conflict.

***

### 🧩 Possible Script Conflicts

It’s possible that another resource is interfering with **decal rendering**, preventing banners or posters from appearing correctly.\
This usually happens when a script repeatedly calls one or both of the following native functions each frame:

```lua
SetDisableDecalRenderingThisFrame(true)
RemoveDecalsInRange(...)
```

If you find those natives remove them from script and make sure to reach out so we can list as known conflict resource.

***

## ❌ Error: `SCRIPT ERROR: ?:-1: table index is nil`

This error typically means the script is trying to access a value in a table that doesn't exist — often because it's `nil`.

### ✅ Cause

You're likely using a **new version of the script** with an **old configuration or structure** — especially if you skipped a full reinstall.

### 🩹 Fix

Follow these steps carefully:

1. Fully **delete** the old folders:
   * `[banners]`
   * `rcore_banners`
   * `rcore_banners_assets`
2. Download and install the **latest version** from [**Keymaster**](https://keymaster.fivem.net/).
3. **Do not overwrite** the new version over the old one — always do a clean install.

> ℹ️ *This is a very common mistake.* Overwriting old files often causes this exact error.

***

## 🖼️ Banner Image Hosting Limitations

### 🚫 Imgur and Discord Are No Longer Supported

Due to recent policy changes and abuse prevention measures, **Discord** and **Imgur** are no longer reliable for hosting images:

* **Imgur** has restricted hotlinking support.\
  [Learn more here](https://github.com/citizenfx/fivem/pull/2407)
* **Discord** now blocks direct image links in some cases.\
  [Details here](https://www.reddit.com/media?url=https%3A%2F%2Fpreview.redd.it%2Fnot-sure-if-this-is-real-v0-t2yhv60cj3rb1.jpg%3Fauto%3Dwebp%26s%3D00cedeec15b58db36a1ea444957fcb11decbba55)

> ℹ️ **Note:** We block Imgur and Discord image links internally. Images hosted on these platforms may are not going to load on fivem.

## 🧰 Banner Billboard Access Helper: `debug_banners_player`

* Type: This command is client only

The `debug_banners_player` helper is a **diagnostic tool** designed to help you understand why a player **cannot access or interact** with a banner or billboard marker.\
It does **not automatically fix** access issues but provides clear feedback to guide you through resolving them manually.

Use this helper in-game to check:

* Whether your current **job or role** allows access to the selected banner.
* If you are **within the required marker range**.
* Any restrictions or configuration mismatches preventing interaction.

***

### 🧾 How to Fix Access Issues

If the helper reports missing job permissions or denied access:

1. **Check your current job**
   * Use your framework’s job management command (e.g. `/setjob`, `/job`, `/charinfo`) to confirm your active role.
   * Ensure it matches one of the jobs listed in your banner configuration.
2. **Verify job registration**
   * Make sure the job is correctly defined in your framework (ESX/QB-Core).
   * If using a custom job, ensure it’s **registered before** the `rcore_banners` resource starts.
3. **Restart and retest**
   * Update your job if needed.
   * Restart your client or re-log and use the helper again to confirm access.

💡 *Use this helper whenever players can’t see or interact with billboard markers. It helps you identify and fix access restrictions step by step.*

***

## ✅ Recommended Hosting Options

Use a trusted third-party image host for banners:

* [**FiveManage**](https://fivemanage.com/)\
  Offers a **free tier with 10 GB storage** — perfect for hosting multiple banners.

***

> ⚠️ **This script requires artifacts version 4752 or newer, and OneSync must be enabled.**

> ℹ️ **Always make sure you're using the latest update** from your [Keymaster](https://keymaster.fivem.net/) account before submitting support tickets.


---

# 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://documentation.rcore.cz/paid-resources/rcore_banners/common_issues.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.