# How to Begin

Our resource offers a comprehensive business system that enables players to interact with billboards, create custom posters, and display text, images, or even GIFs on billboards throughout Los Santos.

This guide provides step-by-step instructions on how players can access, create, and manage business banners and billboards. Follow the steps below to get started.

***

### Adding admin rights

### ESX Server

* To set admin rights directly in-game, use the `/setgroup` command. This command assigns administrative permissions to a player based on their player ID. You have two options: `admin` and `superadmin`.

*Example*: `/setgroup playerId admin`

**Command Usage**:

* **playerId**: The unique ID of the player in the server (can be found via `/playerId`).
* **group**: The role you want to assign. You have two options:
  * **admin**: This grants standard administrative privileges, allowing the player to manage server activities, monitor players, and handle routine server issues.
  * **superadmin**: This provides full administrative access, including permissions to modify core server settings, manage all aspects of server control, and access advanced commands that may not be available to standard admins.

### QBCore Server

Follow the guide to set admin rights: [Setting Permissions Guide](https://docs.qbcore.org/qbcore-documentation/guides/setting-permissions).

***

### Step 0: How to define business

**To register business**

<details>

<summary>ESX</summary>

* Open your **txAdmin** (your server's control panel).
* Go to the **Live Console** tab.
* Type the following command `bannersetup es_extended` and press **Enter**:

</details>

<details>

<summary><strong>QBCore</strong></summary>

You have **two options** to register your business with QBCore:

✅ **Option 1: Use the Deployer Command (Easy Way)**

* Open **txAdmin** (your server's control panel).
* Go to the **Live Console** tab.
* Type the following command `bannersetup qb-core` and press **Enter**:

🛠️ **Option 2: Manual Setup**

* Find the section related to **QBCore jobs**. (`rcore_banners/business.md`)
* Copy the business/job info into: `qb-core/shared/jobs.lua`

</details>

<details>

<summary>QBOX</summary>

You have **two options** to register your business with QBOX:

🛠️ **Option 1: Manual Setup**

* Find the section related to **QBOX jobs**. (`rcore_banners/business.md`)
* Copy the business/job info into: `qbx-core/shared/jobs.lua`

</details>

<details>

<summary>STANDALONE</summary>

* Admins can set player jobs using the following command in-game:

*Example*: `/set_business_job playerId printers 4`

* **playerId**: The ID of the player
* **jobName**: The name of the job (e.g., printers)
* **grade**: The job grade (e.g., 4)

> **Tip**: To find a player's ID, they can use the chat command:
>
> ```
> /playerId
> ```
>
> This will display their ID number.

```lua
local Jobs = {
    ['printers'] = {
        grades = {
            ['4'] = {
                name = "boss",
                isboss = true,
            },
            ['3'] = {
                name = "manager",
            },
            ['2'] = {
                name = "novice",
            },
            ['1'] = {
                name = "member",
            }
        }
    },
    ['gov'] = {
        grades = {
            ['4'] = {
                name = "boss",
                isboss = true,
            },
            ['3'] = {
                name = "manager",
            },
            ['2'] = {
                name = "novice",
            },
            ['1'] = {
                name = "member",
            }
        }
    }
}
```

</details>

***

### Step 1: Accessing the Billboards

Players must be in specific jobs to interact with billboards and access the billboard management menu.

**To access and manage a billboard:**

1. Ensure you are in one of the following jobs:
   * **GOV**
   * **Printers**
2. Approach the billboard in-game and locate the **yellow marker** found below it to open the buy/management menu.
3. Once you arrive at the interact point, access the creation menu to design your banner. Here, you can add custom text, images, or GIFs to your banner for display.

***

### Step 2: Creating a Business Banner

To create a business banner, follow these instructions:

1. Head to the interact point to begin creating a business banner. By default, the coordinates for the interaction points are:
   * **Printers:** `(-1050.323, -242.605, 44.020)`
   * **GOV:** `(-546.980, -207.210, 38.127)`
2. Make sure that you have boss grade in that job, open menu - select Work Stations, that will open UI with option: Create banner/Custom
3. Fill the banner name and your image (recommend to use: gyazo.com)
4. Enjoy your new created business banner, that can be now used on the billboard.

***

### Step 3: Managing and Customizing Banners (Non-Business)

*Note: This section is not related to business banners.*

1. Any player can use the `/banners` command to access available options. However, only **admins** can create custom banners.
2. As an admin, use the `/banners` command and select the **Custom** option. This allows you to define and manage banners for other players on the server.
3. The options available in the `/banners` command are dynamic and depend on the user’s permissions.

### Step 4: Adding New Banners for All Players

Whenever new banners are added to the system, admins can create or modify them as follows:

1. Use the `/banners` command and choose the **Custom** option to add new banners or edit existing ones.

***

Follow these steps to take full advantage of the business banners and billboards system, and bring your business promotions to life in Los Santos!


---

# 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/how_to_begin.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.
