# Introduction

## Introduction

### Overview

**force-characters** is a modern, feature-rich multicharacter system for FiveM servers. Built with performance and flexibility in mind, it provides a seamless character selection and management experience with support for multiple frameworks and appearance systems.

### Key Features

#### 🎯 Multi-Framework Support

* **ESX** - Full support for ESX framework
* **QBCore** - Complete QBCore integration
* **QBox** - Native QBox support
* **Custom** - Flexible custom framework integration
* **Auto-detection** - Automatically detects your framework

#### 🎨 Appearance System Integration

* **force-appearance** - Native integration
* **esx\_skin / skinchanger** - ESX appearance support
* **qb-clothing** - QBCore clothing system
* **illenium-appearance** - Popular appearance system
* **rcore\_clothing** - RCore appearance integration
* **Custom** - Bring your own appearance system

#### ✨ Modern UI

* Built with **React**, **Tailwind CSS**, and **shadcn/ui**
* Smooth animations and transitions
* Multiple color themes (orange, blue, green, purple, red, yellow)
* Grayscale mode support
* Fully responsive design
* Optional music player with playlist support

#### 🎭 Character Management

* Multiple character slots (configurable)
* Character creation and deletion
* Character images support
* Detailed character information display
* Job-based spawn locations
* Last location spawn support

#### 🌍 Instance System

* Player instancing for character selection
* Entity instancing support
* Clean instance management
* Routing bucket integration

#### 🛠️ Developer Friendly

* Extensive exports for integration
* Event-based architecture
* Debug mode for troubleshooting
* Well-documented code
* TypeScript support in UI
* Built with modern best practices

### Technology Stack

#### Client-Side

* **Lua 5.4** - FiveM scripting
* **ox\_lib** - Core library functions

#### UI Layer

* **React** - UI framework
* **TypeScript** - Type-safe development
* **Tailwind CSS** - Utility-first styling
* **shadcn/ui** - UI component library
* **Vite** - Fast build tool

#### Server-Side

* **Lua 5.4** - Server logic
* **oxmysql** - Database operations
* **ox\_lib** - Shared utilities

### Requirements

* **ox\_lib** - Core dependency
* **oxmysql** - Database operations
* A supported framework (ESX, QBCore, QBox) or custom implementation
* A supported appearance system (optional, can use custom)

### Use Cases

This resource is perfect for:

* Roleplay servers requiring multiple character slots per player
* Servers wanting a modern, professional character selection UI
* Developers needing flexible framework integration
* Communities seeking a well-maintained, actively developed solution

### Support & Community

* **Author**: Force Developments (Discord: @force3883)

### What's Next?

Continue to the Configuration page to learn how to set up and customize force-characters for your server, or jump to Usage / Integration to learn how to integrate it with your existing resources.


---

# 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/resources/force-characters/introduction.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.