# Usage / Integration

## Usage / Integration

This page covers how to integrate **force-sling** with your resources using events, exports.

### Table of Contents

* Client Exports

***

### Client Exports

#### StartPositioning

Starts positioning of a weapon with the data that's sent to the parameter.

**Parameters:**

* `selectData` (table, required): table which contains: weaponName, boneId and weapon.

**Usage:**

```lua
exports['force-sling']:StartPositioning({
    weaponName = "weapon_pistol",
    boneId = 24816
})
```

***

#### StartConfiguration

Opens the configuration menu.

**Parameters:**

* `isPreset` (boolean, optional): Controls if the configuration you set should be the new default for the weapon or personal to you.

**Example:**

```lua
-- Wait for character to load before executing code
Citizen.CreateThread(function()
  while not exports['force-characters']:isCharacterLoaded() do
    Citizen.Wait(1000)
  end
  
  exports['force-sling']:StartConfiguration(false)

  -- Character is now loaded, continue with initialization
  print("Character loaded, initializing systems...")
end)
```

***

### Need Help?

If you encounter issues or need assistance with integration:

1. Enable `Config.Debug = true` for detailed logging
2. Check the F8 console for errors
3. Review the server console for server-side issues
4. Ensure all dependencies (`ox_lib`, `oxmysql`) are up to date
5. Contact Force Developments on Discord: @force3883


---

# 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.forcedevelopments.com/free-resources/force-sling/usage-integration.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.