# Framework

{% hint style="warning" %}
For experienced **DEVELOPERS** only!
{% endhint %}

## Config File

Start by setting the framework to other:

```lua
Config.Framework = 3 --[ 1 = ESX / 2 = QBCore / 3 = Other ]
```

Make sure the following values are left empty:

```lua
Config.FrameworkTriggers = {
    notify = '',
    object = '',
    resourceName = '',
}

Config.FrameworkSQLTables = {
    table = '',
    identifier = '',
}
```

## Database File

Open the `rcore_gangs/server/database/api.lua` file. When you start this resource for the first time a thread will automatically create all the necessary tables, however the default collation for these tables is set to `utf8mb4_general_ci`. Please make sure that's the collation you use for the table where you'll store the gang members, otherwise change it to your currently used collation on the following line:

```lua
-- You can find this in your file by searching the following piece of code
local collation = SQL.Scalar('SELECT TABLE_COLLATION FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = @tableName', { ['@tableName'] = Config.FrameworkSQLTables.table }) or 'utf8mb4_general_ci'
```

Once that's done you'll need to make changes to certain functions which communicate with tables outside this resource. These functions share one thing in common which is the fact that they execute dynamically edited sql queries with the help of the config. The way this needs to be edited is to get rid of `Config.FrameworkSQLTables.table` and `Config.FrameworkSQLTables.identifier` variables.

```lua
-- Config.FrameworkSQLTables.table - This variable represents a table name where the player data is stored
-- Config.FrameworkSQLTables.identifier - This variable represents a column name which is used as an identifier

-- The following functions utilize these variables and need to be edited
SQL.InsertGang
SQL.DeleteGang
SQL.SetPlayerGang
SQL.GetGangMembers
```

## Framework Files

Lastly the most crucial part is to integrate client/server framework files. These files are located in `rcore_gangs/client/framework/framework_other.lua` and `rcore_gangs/server/framework/framework_other.lua`. This is where you connect your framework with the resource using bridge functions which are described in JSDoc. You can get a good idea on what to do from the other framework files. Here's the most used function for example:

{% tabs %}
{% tab title="Client" %}

```lua
-- Gets a unique player identifier typically used in the database
-- @returns {string | number} identifier - The identifier
Framework.GetPlayerId = function()
end
```

{% endtab %}

{% tab title="Server" %}

```lua
-- Gets a unique player identifier typically used in the database
-- @param {number} source - The player's server identifier
-- @returns {string | number} identifier - The identifier
Framework.GetPlayerId = function(source)
end
```

{% endtab %}
{% endtabs %}


---

# 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_gangs/integrations/integrations-framework.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.