# 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="https://1037498771-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZErcztD5BvrKnwRGJq%2Fuploads%2Fgit-blob-2fd65398e583c143a58603778b5dc49ad03a087f%2Fguide_banners_not_showing_images.jpg?alt=media" 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.