TS-Lib

**TS-Lib** is a comprehensive, universal utility wrapper and bridge library for FiveM.

## [📌 Overview](https://store.toine.me/package/ts-lib#overview)

It is designed to eliminate the headache of supporting multiple frameworks, inventories, garage systems, and key management scripts. Instead of cluttering your resources with endless `if/else` checks, `ts-lib` handles it all under one unified `TS` namespace.

It is designed to be injected dynamically into any script, keeping your resource code clean, fast, and completely independent.

## [📥 Download](https://store.toine.me/package/ts-lib#download)

**[Download the Latest Version](https://store.toine.me/download/ts-lib)**

Contributions are welcome — see the docs if you want to propose new bridges or improvements.

You can also browse the source on **[GitHub](https://github.com/Toine-Scripts/ts-lib)**.

## [🚀 Features](https://store.toine.me/package/ts-lib#features)

- **Automated Framework Detection**: Natively supports `qb-core`, `qbx_core`, `es_extended`, and `standalone`. It prioritizes the most modern framework available automatically or via forced config.

- **Unified Bridges**:

- **Garages**: Native support for `qb-garages`, `esx_garage`, `vms_garagesv2`, `jg-advancedgarages`, and `standalone`.

- **Keys**: Native support for `qb-vehiclekeys`, `qs-vehiclekeys`, and `standalone`.

- **Centralized Utils**: Prints, debugs, and resource checks are completely centralized (`TS.Print`, `TS.DebugPrint`, `TS.ErrorPrint`).

- **Built-in UI helpers**: Simple NUI-based subtitle and text UI helpers (`TS.Lib.Subtitle`, `TS.Lib.TextUI`) that can also be called via exports.

## [🛠️ Installation](https://store.toine.me/package/ts-lib#%EF%B8%8F-installation)

1. Place the `ts-lib` folder in your `resources` directory.

2. In the `fxmanifest.lua` of the script that needs to use `ts-lib`, add this single line to your `shared_scripts`:

```

shared_scripts {

'@ts-lib/import.lua',

-- Your other shared scripts...

}

```

That's it! `ts-lib` will automatically boot up, detect the server's framework, fetch the configurations, expose the `TS` namespace, and dynamically load the required modules.

## [⚙️ Configuration](https://store.toine.me/package/ts-lib#%EF%B8%8F-configuration)

You can configure exactly which systems `ts-lib` uses via `ts-lib/config.lua`.

```

Config = {

debug = true,

-- Framework selection: 'auto', 'qbcore', 'esx', 'qbox', 'standalone'

Framework = 'auto',

-- Garage system: 'auto', 'qb-garages', 'esx_garage', 'vms_garagesv2', 'jg-advancedgarages', 'standalone'

Garages = 'auto',

-- Vehicle keys system: 'auto', 'qb-vehiclekeys', 'qs-vehiclekeys', 'standalone'

VehicleKeys = 'auto',

Data = {

Framework = {

qbcore = 'qb-core',

esx = 'es_extended',

qbox = 'qbx_core',

standalone = 'standalone',

},

Garages = {

['qb-garages'] = 'qb-garages',

['esx_garage'] = 'esx_garage',

['vms_garagesv2'] = 'vms_garagesv2',

['jg-advancedgarages']= 'jg-advancedgarages',

['standalone'] = 'standalone',

},

VehicleKeys = {

['qb-vehiclekeys'] = 'qb-vehiclekeys',

['qs-vehiclekeys'] = 'qs-vehiclekeys',

['standalone'] = 'standalone',

},

},

}

```

## [📖 Documentation](https://store.toine.me/package/ts-lib#documentation)

For full instructions, usage examples (including UI helpers), and a detailed API reference, see the official TS-Lib documentation: **[docs.toine.me/scripts/ts-lib](https://docs.toine.me/scripts/ts-lib)**

## [📝 License](https://store.toine.me/package/ts-lib#license)

Distributed under the MIT License. See `LICENSE` for more information.

## [💬 Support](https://store.toine.me/package/ts-lib#support)

If you need help or want to check out higher-end scripts, join the Discord: **[store.toine.me/discord](https://store.toine.me/discord)**