# Installation

## Requirements

Make sure you have the following installed:

* [ox\_lib](https://github.com/communityox/ox_lib)
* [oxmysql](https://github.com/communityox/oxmysql)

***

## Install Steps

{% stepper %}
{% step %}

### Download

Download the resource and extract it to your resources folder
{% endstep %}

{% step %}

### Database

Import the database tables: 

```
sql/collectables.sql
```

{% endstep %}

{% step %}

### Add

Add to your `server.cfg`:

```
start mad_collectables
```

{% endstep %}

{% step %}

### Configuration

Adjust settings in the [config](/docs/premium-resources/mad_collectables/configuration.md) files to your liking:

* `config/shared.lua` - Debug, Sounds, Animations
* `config/client.lua` - UI Settings, Keybinds
* `config/server.lua` - Collectable sets, Commands, Leaderboard, Rewards, Logging
  {% endstep %}

{% step %}

### *Optional*

Add the stickerbook item to your inventory
{% endstep %}
{% endstepper %}

***

## Inventory Item Setup

The stickerbook item lets players open the collectables UI from their inventory.

### ox\_inventory

Add to your items file:

```lua
["mad_collectables_stickerbook"] = {
    label = "Collectables Stickerbook",
    weight = 100,
    client = {
        export = "mad_collectables.openUI",
    },
},
```

### qb-inventory

Add to your shared items:

```lua
mad_collectables_stickerbook = {
    name = 'mad_collectables_stickerbook',
    label = 'Collectables Stickerbook',
    weight = 100,
    type = 'item',
    image = 'mad_collectables_stickerbook.png',
    unique = false,
    useable = true,
    shouldClose = true,
    description = 'Your personal sticker collection book'
},
```

### Item Image

An image for the inventory item is included in the `INSTALL/` folder:

```
INSTALL/mad_collectables_stickerbook.png
```

Copy this to your inventory's images folder.


---

# 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://madcap.gitbook.io/docs/premium-resources/mad_collectables/installation.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.