> For the complete documentation index, see [llms.txt](https://falcon-development.gitbook.io/product-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://falcon-development.gitbook.io/product-docs/new-scripts/russian-roulette.md).

# Russian Roulette

### Overview

The **Russian Roulette Script** is a high-quality resource designed with a strong focus on realism, performance, and scalability.\
It integrates smoothly with modern servers while giving developers full control over logic, behavior, and compatibility.

This documentation acts as a complete technical and functional guide to help you understand, configure, and extend the script.

***

### Core Compatibility

The script is **fully core-agnostic** by design.

Supported cores:

* ND\_Core
* QBox
* OXCore
* ESX
* QBCore
* Custom frameworks

All core-specific logic is isolated within the **Bridge layer**, allowing you to change or extend core support without modifying the main gameplay logic.

***

### Configuration System

A centralized configuration system allows you to:

* Control gameplay behavior
* Adjust rules and limitations
* Enable or disable features
* Customize timings, effects, and restrictions

All configuration options are clearly structured and easy to modify.

***

### File Structure

The script is organized into logical components:

#### Config

Handles all customizable settings and script behavior.

#### Bridge

Manages communication with the server core (player data, money handling, inventory, permissions, etc.).

#### Utils

Contains shared helper functions and reusable logic across the script.

#### Client

Responsible for animations, player interactions, UI elements, and visual effects.

#### Server

Handles game logic, validation, synchronization, and security checks.

This structure ensures clean separation of responsibilities and maximum flexibility.

***

### Performance

The script is optimized for live environments:

* No unnecessary loops
* Minimal network usage
* Efficient state management

It is safe to run during high player activity.

***

### Intended Use

Ideal for:

* Roleplay scenarios
* Underground or criminal activities
* Special server events
* Player-driven interactions

Adds tension, risk, and immersion to any FiveM server.

***

### Documentation Purpose

This documentation will guide you through:

* Understanding how the script works
* Installing and configuring the script correctly
* Customizing behavior
* Extending functionality
* Integrating with existing systems

Each section is written to be clear, concise, and practical.