# Adding a New Corner

## Adding a New Corner

This guide will walk you through modifying the configuration file to add a new corner. Follow the steps below to update your configuration and test your changes in-game.

***

### Prerequisites

* **Access to the File:** Ensure you have access to the file at `rm_illegalcorners/cfg.lua`.
* **Basic Understanding:** Familiarity with editing Lua files and using your script’s commands in-game.

***

### 1. Open the Configuration File

Locate and open the file:

```lua
rm_illegalcorners/cfg.lua
```

### 2. Understand the Configuration Tables

The configuration file contains two primary sections: the **Items Table** and the **Corners Table**.

#### Items Table

This table defines the items that can be selled at any corner. For example:

```lua
cfg.items = {
    ['bandage'] = {
        label = 'Bandage',
        unitPrice = { 1, 10 }, -- A random price between 1 and 10 will be selected.
        qty = { 1, 15 },       -- A random quantity between 1 and 15 will be selected.
        -- image = 'bandage.png', -- Defaults to 'itemname.png' if no image is provided.
    },
}
```

#### Corners Table

This table specifies the corner locations and the items available at each corner. Each corner includes a `zoneData` property that defines its active area.

### 3. Add Your New Corner

To add a new corner, simply append a new configuration object to the `cfg.corners` table. Below are examples for each zone type.

#### Example: Sphere Zone

```lua
{
    name = 'drug_corner',
    label = 'Drugs Corner',
    zoneData = {
        coords = vec3(201.62, -1020.74, 29.0),
        radius = 250,  -- Defines the active area as a sphere.
        -- debug = true, -- Uncomment to enable debugging.
    },
    items = { 'bandage' },
}
```

#### Example: Box Zone

```lua
{
    name = 'new_corner_box',
    label = 'New Corner Box',
    zoneData = {
        coords = vec3(100.0, 200.0, 300.0), -- Center coordinates of the box.
        size = vec3(100.0, 100.0, 50.0),      -- Dimensions of the box.
        -- debug = true, -- Uncomment to enable debugging.
    },
    items = { 'bandage' },
}
```

#### Example: Polygon Zone

```lua
{
    name = 'new_corner_poly',
    label = 'New Corner Polygon',
    zoneData = {
        points = {
            vec3(150.0, 250.0, 300.0),
            vec3(160.0, 260.0, 300.0),
            vec3(155.0, 270.0, 300.0),
        },
        thickness = 5,  -- Defines the thickness of the polygon zone.
        -- debug = true, -- Uncomment to enable debugging.
    },
    items = { 'bandage' },
}
```

Your final configuration might look like this:

```lua
cfg.disableCorners = false -- If set to true, items will appear on random peds with no location restrictions.

cfg.corners = {
    -- Sphere Zone Example
    {
        name = 'drug_corner',
        label = 'Drugs Corner',
        zoneData = {
            coords = vec3(201.62, -1020.74, 29.0),
            radius = 250,
            -- debug = true,
        },
        items = { 'bandage' },
    },
    -- Box Zone Example
    {
        name = 'new_corner_box',
        label = 'New Corner Box',
        zoneData = {
            coords = vec3(100.0, 200.0, 300.0),
            size = vec3(100.0, 100.0, 50.0),
            -- debug = true,
        },
        items = { 'bandage' },
    },
    -- Polygon Zone Example
    {
        name = 'new_corner_poly',
        label = 'New Corner Polygon',
        zoneData = {
            points = {
                vec3(150.0, 250.0, 300.0),
                vec3(160.0, 260.0, 300.0),
                vec3(155.0, 270.0, 300.0),
            },
            thickness = 5,
            -- debug = true,
        },
        items = { 'bandage' },
    },
}
```

### 4. Save and Restart

* **Save the File:** Save your changes to `cfg.lua`.
* **Restart the Script:** Restart your script or resource to load the new configuration.

### 5. Test Your New Corner

1. **Launch the Game:** Start the game and connect to your server.
2. **Navigate to Your Corner:** Head to the coordinates you specified for your new corner.
3. **Start Interaction:** Once you're in the zone, open the chat or console and type:

   ```
   /takecorner
   ```

### 6. Troubleshooting

* **Incorrect Zone Data:**\
  Verify that you are using the correct properties for each zone type:
  * **Polygon:** Use `points` and `thickness`.
  * **Box:** Use `coords` and `size`.
  * **Sphere:** Use `coords` and `radius`.
* **Coordinate Errors:**\
  Check that all coordinates, sizes, and radius values are correct.
* **Item Key Mistakes:**\
  Confirm that every item referenced in the `items` array exists in `cfg.items`.
* **Script Not Reloading:**\
  Ensure you have properly restarted the resource after making changes.

### Conclusion

By following these steps, you have successfully added a new corner using the updated zone configurations. Customize the items, zone types, and coordinates as needed to create a dynamic and flexible experience with your script.

Happy Scripting!


---

# 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.rainmad.com/resources/illegal-corners-selling-goods/adding-a-new-corner.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.